Fluent Commerce Logo
Docs
Sign In
Essential knowledge

Author:

Fluent Commerce staff

Changed on:

26 Mar 2024

Overview

This document explains the GraphQL error code formats used by Fluent Commerce.

Key points

  • GraphQL Error Code Format
  • GraphQL Client Error Codes
  • GraphQL Server Error Codes

Error Codes

This document explains the GraphQL error code formats used by Fluent Commerce.


Error Code Format

Every error code adheres to the Prefix 4digitcode Suffix format.

Prefix

  • The tables list the prefixes used in the error code.

Code

Type of Issue

Description

C

Client

Resolved by the client.

S

Server

Clients need assistance to resolve the issue.

T

Third Party

Issues caused during third-party interactions.

4digitcode

  • The four digits represent a unique code. For example, C100E, C0020E and so on.

Suffix

  • The table lists the suffixes used in the error code.

Code

Type of Issue

E

Error

W

Warning


Client Error Codes

The table lists the details of the client error codes and works around to fix errors.

Error Code

Classification

Solution

C0001E

Indicates that a GraphQL query was made with a higher complexity than allowed by the server.

Simplify the query by reducing:
- The nesting within the query.
- The requested fields within the query.
-The number of records requested within the query.

C0101E

Indicates that a user is querying on dates without passing 'to' or 'from' parameters.

Pass at least one of these parameters.

C0100E

Indicates that a user passed an invalid UTC date value in their operation.

Pass a valid UTC format for a date field.

C0102E

Indicates that a user is querying on dates without passing 'to' and 'from' parameters.

Pass 'to' and 'from' parameters.

C0103E

Indicates that a GraphQL query was made for a longer timeframe than allowed for the selected granularity.

Reduce the timeframe or change the granularity.

C0020E

Indicates that the user does not have all the required permissions to execute the query (a view query or mutation query).

Assign the role to a user with more permissions. All the missing permissions can be viewed in the error message. This list does not contain permissions of entities in the query that a user can access.

C0120E

A validation error on input occurs when the user is trying to execute an operation on an entity that could not be found. For example, if the user tries to delete an entity that cannot be found, the delete mutation error is displayed.

Validate that the user passes the details for entities that exist and the user can access. For example, if a user has access to data for multiple retailers they can perform permitted operations for all those retailers. Whereas a user who has access to a single retailer can perform the operations for data pertaining to only that retailer.

C0121E

Indicates that a field in the input violates a unique constraint.

Verify the input field.

C0122E

Indicates that the integer field does not allow negative values.

Enter positive values in the integer field.

C0140E

Indicates missing variables in a query or mutations.

Pass the variables in the query.

C0141E

Indicates char limit exceeded exception.

Update the input with the correct char limit and retry.


Server Error Codes

This table lists the details of the server error codes and workaround to fix errors.

Error Code

Description

Workaround

S0001E

Indicates that the entity-level permission setting is missing.

Raise a support ticket to set the permission setting for the client.

S0002E

This indicates that the Me query is disabled on this account.

Me query can be enabled for the account by removing the GRAPHQL.DISABLE_GRAPHQL_ME_QUERY account setting.

S0003E

Indicates that account setting SSO.DETAILS contain invalid JSON values.

Update the value using the existing setting API.

S0040E

This Indicates that MeQuery is reading the username from the JWT token and failed.

Retry the operation in some time. If not resolved, then raise a support ticket to investigate.

S0004E

Indicates that creating a User in Fluent IDP failed.

Raise a support ticket to investigate.

S0005E

Indicates that updating the User in Fluent IDP failed.

Raise a support ticket to investigate.

Fluent Commerce staff

Fluent Commerce staff

Copyright © 2024 Fluent Retail Pty Ltd (trading as Fluent Commerce). All rights reserved. No materials on this docs.fluentcommerce.com site may be used in any way and/or for any purpose without prior written authorisation from Fluent Commerce. Current customers and partners shall use these materials strictly in accordance with the terms and conditions of their written agreements with Fluent Commerce or its affiliates.

Fluent Logo