Error Codes
Author:
Fluent Commerce
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: |
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. |