Below you will find a table with the complete list of errors that could be thrown by our backend. You will find the error name, the error description, the HTTP status of the request, an example of the unexpected input that caused the error to arise and an example of expected input in the situation where the error was raised or some instructions to get your problem solved.
| Error name | Description | HTTP Status | Wrong input example | Correct input example |
|---|---|---|---|---|
| wrong_user_token | The user_token provided is wrong | 400 | {“user_token”: “wrong_input”} | {“user_token”: “output_from_service”} |
| user_token_is_null_or_empty | The user_token provided is either null or an empty string | 400 | {“user_token”: null} | {“userToken”: “output_from_service”} |
| user_token_is_missing | The user_token has not been provided in the body request | 400 | [user_token not provided not within Body] | {“userToken”: “output_from_service”} |
| invalid_user_cert | The user_cert provided is not valid | 400 | {“user_cert”: “wrong_input"} | {“userCert”: “output_from_service”} |
| user_cert_is_null_or_empty | The user_cert provided is either null or an empty string | 400 | {“user_cert”: “”} | {“userCert”: “output_from_service”} |
| user_cert_is_missing_in_the_headers | The user_cert has not been provided in the headers of the request | 400 | [user_cert not provided within Headers] | {“userCert”: “output_from_service”} |
| invalid_shared_provider_id | You do not have any third-party actively associated to this shared_provider_id. Please, check your third-parties dashboard on [URL] | 400 | {“shared_provider_id”: “wrong_input"} | {“shared_provider_id”: “the parameter defined by you”} |
| shared_provider_id_is_null_or_empty | The shared_provider_id provided is either null or an empty string | 400 | {“shared_provider_id”: “”} | {“user_cert”: “output_from_service”} |
| shared_provider_id_is_missing_in_the_body | The shared_provider_id has not been provided in the body of the request | 400 | [shared_provider_id not found within Body] | {“user_cert”: “output_from_service”} |
| inactive_relation_key_for_this_shared_provider_id | The third-party linked to this shared_provider_id does not have an accepted relationship to you, either because you have not accepted it or because they have not done so yet. Please check your third-parties dashboard on [URL]. If you are waiting for them, you may want to contact them on TIDI's platform or by your usual means to get it accepted as soon as possible. | 400 | {“shared_provider_id”: “wrong_input"} | [Either provide a shared_provider_idthat has an active relation or get the relation to this company mutually accepted] |
| more_than_one_third_party_linked_to_this_shared_provider_id | The shared_provider_id provided does not uniquely identify one third-party. Please, check your third-parties dashboard on [URL] and assign a different shared_provider_id code to each third-party. | 400 | {“shared_provider_id”: “wrong_input"} | [Adjust your values of shared_provider_id] |
| more_than_one_third_party_linked_to_this_relation_key | The relation_key provided does not uniquely identify one third-party. Please, contact support on: [URL]. | 500 | {“relation_key”: “wrong_input"} | [Please, contact support] |
| relation_key_not_linked_to_your_third_parties | The relation_key provided is not linked to your third-parties. Please, check its value and format on [URL]. | 400 | {“relation_key”: “wrong_input"} | [Check your dashboard and provide it as a string without any spaces at the beginning nor end of the string] |
| relation_key_is_null_or_empty | The relationKey provided is either null or an empty string | 400 | {“relationKey”: “"} | [Check your dashboard and provide it as a string without any spaces at the beginning nor end of the string] |
| relation_key_missing | The relationKey is not provided in the request body. | 400 | [relation_key not found within Body | [Check your dashboard and provide it as a string without any spaces at the beginning nor end of the string] |
| inactive_relation_with_this_company | The company whose third_party_cert you are trying to retrieve does not currently have any accepted relationship with you. Please, check your dashboard on: [URL]. | 400 | {“relation_key”: “wrong_input"} | [Get the relation to your client accepted] |
| relation_with_this_company_not_accepted_anymore | The relationship to the Company whose third_party_cert you are trying to retrieve is not accepted anymore. This is so because your TIDI's account manager or your clients have eliminated the relationship. Please, get in touch with them. In the mean time, you can check your dashboard on: [URL] and check with your account manager or clients why they eliminated the relationship. | 400 | {“relation_key”: “wrong_input"} | [Get the relation to your client accepted] |
| attempt_to_create_third_party_cert_of_company_with_deleted_account | The Company whose third_party_cert you are trying to retrieve has deleted their account. You may not retrieve certificates on their behalf anymore. Please, get in touch with them to get them create a new account as soon as possible, send a new connection request, get it accepted and substitute the old relationKey by the new one on your connection to the API. In the mean time, you can check your dashboard on: [URL] | 500 | {“relation_Key”: “correct_value"} | [Get your client create a new account, send a new connection request, get it accepted and substitute the old relationKey by the new one in your connection to the API] |
| invalid_third_party_cert | The third_party_cert provided is not valid | 400 | {“third_party_cert”: “wrong_input"} | {“third_party_cert”: “output_from_service”} |
| impossible_relation_action | Some relation action could not be performed due to inconsistencies in the relations table's status parameter | 500 | [Internal error] | [Refresh the page and repeat the action. If this does not work, please contact support] |
| third_party_cert_is_null_or_empty | The third_party_cert provided is either null or an empty string | 400 | {“third_party_cert”: “"} | {“third_party_cert”: “output_from_service”} |
| third_party_cert_is_missing_in_the_headers | The third_party_cert has not been provided in the headers of the request | 400 | [third_party_cert not present within Headers] | {“third_party_cert”: “output_from_service”} |
| units_not_provided_in_input_data | The "units" field has not been provided in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | [some "units" field is missing in the JSON object. Please check the errorMessage for the exact sub-JSON where it's missing] | For instance, "units": 3 |
| currency_not_provided_in_input_data | The "currency" field has not been provided in the {} object of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | [some "currency" field is missing in the JSON object. Please check the errorMessage for the exact sub-JSON where it's missing] | For instance, "currency": "USD" |
| product_name_not_provided_in_input_data | The "product" field has not been provided in the {} object of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | [some "product_name" field is missing in the JSON object. Please check the errorMessage for the exact sub-JSON where it's missing] | For instance, "product_name": "My awesome jeans" |
| sellers_id_reference_not_provided_in_input_data | The "sellersIdReference" field has not been provided in the {} object of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | [some "sellers_id_reference" field is missing in the JSON object. Please check the errorMessage for the exact sub-JSON where it's missing] | For instance, "sellersIdReference": "7894132" |
| vat_not_provided_in_input_data | The "vat" field has not been provided in the {} object of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | [some "vat" field is missing in the JSON object. Please check the errorMessage for the exact sub-JSON where it's missing] | For instance, "vat": 15.5 |
| operation_datetime_not_provided_in_input_data | The operation_datetime field has not been provided in the request body. | 400 | ["operation_datetime" is missing in the request JSON] | For instance, "operation_datetime": "2024-11-12T18:03:48-02:00" |
| time_zone_not_provided_in_input_data | The "timeZone" field has not been provided in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | [some "time_zone" field is missing in the JSON object. Please check the errorMessage for the exact sub-JSON where it's missing] | For instance, "timeZone": "UTC+7" |
| price_and_price_without_vat_not_provided_in_input_data | Both the "price" and "priceWithoutVat" fields have not been provided in the {} object of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | [some "price" and "price_without_vat" fields are missing in the JSON object. Please check the errorMessage for the exact sub-JSON where they're missing] | For instance, "price": 2350 or "price_without_vat": 2350 |
| shipping_not_provided_in_input_data | The "shipping" field has not been provided in the request body. | 400 | [shipping is missing in the request JSON] | For instance, "shipping": 1000 |
| units_null_or_empty_in_input_data | The "units" field is either null or an empty string in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"units": null} | For instance, "units": 3 |
| currency_null_or_empty_in_input_data | The "currency" field is either null or an empty string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"currency": null} | For instance, "currency": "USD" |
| product_name_null_or_empty_in_input_data | The "product_name" field is either null or an empty string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"product_name": null} | For instance, "product_name": "My awesome jeans" |
| shipping_null_or_empty_in_input_data | The "shipping" field is either null or an empty string in the request body. | 400 | {"shipping": null} | {"shipping": 0} |
| sellers_id_reference_null_or_empty_in_input_data | The "sellers_id_reference" field is either null or an empty string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"sellers_id_reference": null} | For instance, "sellers_id_reference": "7894132" |
| vat_null_or_empty_in_input_data | The "vat" field is either null or an empty string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"vat": null} | For instance, "vat": 15.5 |
| operation_datetime_null_or_empty_in_input_data | The "operation_datetime" field is either null or an empty string in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"operation_datetime": null} | For instance, "operation_datetime": "2024-11-12T18:03:48-02:00" |
| time_zone_null_or_empty_in_input_data | The "time_zone" field is either null or an empty string in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"time_zone": null} | For instance, "time_zone": "UTC+7" |
| price_and_price_without_vat_null_or_empty_in_input_data | Both the "price" and "price_without_vat" fields are either null or an empty string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"price": null, "price_without_vat": null} | For instance, "price": 2350 or "price_without_vat": 2350 |
| units_is_not_numeric_in_input_data | The "units" field is not numeric in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"units": "string"} | For instance, "units": 3 |
| currency_is_not_string_in_input_data | The "currency" field is not a string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"currency": 45} | For instance, "currency": "USD" |
| product_name_is_not_string_in_input_data | The "product_name" field is not a string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"product_name": [] } | For instance, "product_name": "My awesome jeans" |
| sellers_id_reference_is_not_string_in_input_data | The "sellers_id_reference" field is not a string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"sellers_id_reference": {} } | For instance, "sellers_id_reference": "7894132" |
| vat_is_not_numeric_in_input_data | The "vat" field is not numeric in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"vat": [] } | For instance, "vat": 15.5 |
| operation_datetime_is_not_string_in_input_data | The "operation_datetime" is not string in the request body. | 400 | {"operation_datetime": {} } | For instance, "operationDatetime": "2024-11-12T18:03:48-02:00" |
| operation_datetime_without_required_format_in_input_data | The "operation_datetime" field does not match the format ISO 8601. Please, check the docs for more information on the format. | 400 | {"operation_datetime": "13/10/2022 18:26:48"} | For instance, "operationDatetime": "2024-11-12T18:03:48-02:00" |
| time_zone_is_not_string_in_input_data | The "time_zone" field is not a string in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"time_zone": 45} | For instance, "time_zone": 25 |
| time_zone_without_required_format_in_input_data | The "time_zone" field does not match the format required in the sub-structure number {} of the {} object, starting the count by 0th row. Please, check the docs for more information on the format. | 400 | {"time_zone": "UTC + 7"} | For instance, "time_zone": "UTC+7" |
| price_is_not_numeric_in_input_data | The "price" field is not numeric in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"price": "string"} | For instance, "price": 2350 |
| price_without_vat_is_not_numeric_in_input_data | The "price_without_vat" field is not numeric in the {} of row number {} of the {} object, starting the count by 0th row. | 400 | {"priceWithoutVat": [] } | For instance, "price_without_vat": 2350 |
| shipping_is_not_numeric_in_input_data | The "shipping" field is not numeric in the request body. | 400 | {"shipping": "string"} | For instance, "shipping": 1000 |
| discount_is_not_numeric_in_input_data | The "discount" field is not numeric in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"discount": [] } | For instance, {"discount": 50} |
| discount_is_greater_than_100_in_input_data | The "discount" field is greater than 100 in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"discount": 150} | For instance, {"discount": 50} |
| promotion_is_not_string_in_input_data | The "promotion" field is not a string in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"promotion": {} } | For instance, {"promotion": "Christmas"} |
| reason_is_not_string_in_input_data | The "reason" field is not a string in the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"reason": [] } | For instance, {"reason": "Wrong size"} |
| brand_is_not_string_in_input_data | The "brand" field is not a string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"brand": 500} | For instance, {"brand": "Nike"} |
| product_type_is_not_string_in_input_data | The "product_type" field is not a string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"product_type": [] } | For instance, {"product_type": "textile"} |
| product_subtype_is_not_string_in_input_data | The "product_subtype" field is not a string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"product_subtype": {} } | For instance, {"product_subtype": "jeans"} |
| purchasers_id_reference_is_not_string_in_input_data | The "purchasers_id_reference" field is not a string in the {} of the sub-structure number {} of the {} object, starting the count by 0th row. | 400 | {"purchasers_id_reference": 500} | For instance, {"purchasers_id_reference": "Christmas"} |
| client_json_is_not_a_dictionary | The "client" object is not a dictionary | 400 | {"client": [] } | {"client": {Keys and values go here} } |
| employee_json_is_not_a_dictionary | The "employee" object is not a dictionary | 400 | {"employee": [] } | {"employee": {} } |
| shop_json_is_not_a_dictionary | The "shop" object is not a dictionary | 400 | {"shop": [] } | {"shop": {} } |
| client_email_is_null_or_empty | The "client_email" field provided is either null or an empty string | 400 | {"client": {"client_email": ""} } | For instance, {"client": {"client_email": "example@gmail.com"} } |
| client_email_does_not_have_correct_email_format_in_request_body | The "client_email" field in the "client" JSON does not have an email-like format. | 400 | {"client": {"client_email": "example@gmail.c"} } | For instance, {"client": {"client_email": "example@gmail.com"} } |
| no_client_reference_provided_in_client_json | The "client" JSON is provided but it does not contain any client reference. A valid client reference is the client_email. | 400 | {"client": {} } | For instance, {"client": {"client_email": "example@gmail.com"} } |
| shared_employee_id_is_null_or_empty | The "shared_employee_id" provided is either null or an empty string | 400 | {"employee": {"shared_employee_id": ""} } | For instance, {"employee": {"shared_employee_id": "1"} } |
| shared_employee_id_is_not_string_in_request_body | The "shared_employee_id" field is not a string in the request body. | 400 | {"employee": {"shared_employee_id": 1} } | For instance, {"employee": {"shared_employee_id": "1"} } |
| no_employee_reference_provided_in_employee_json | The "employee" JSON is provided but it does not contain any employee reference. A valid reference is shared_employee_id as a string. | 400 | {"employee": {} } | For instance, {"employee": {"shared_employee_id": "1"} } |
| shared_shopId_is_null_or_empty | The "shared_shop_id" provided is either null or an empty string | 400 | {"shop": {"shared_shop_id": ""} } | For instance, {"shop": {"shared_shop_id": "1"} } |
| shared_shop_id_is_not_string_in_request_body | The "shared_shop_id" field is not a string in the request body. | 400 | {"shop": {"shared_shop_id": 1} } | For instance, {"shop": {"shared_shop_id": "1"} } |
| no_shop_reference_provided_in_employee_json | The "shop" JSON is provided but it does not contain any employee reference. A valid reference is shared_shop_id as a string. | 400 | {"shop": {} } | For instance, {"shop": {"shared_shop_id": "1"} } |
| unknown_shared_employee_id | The "shared_employee_id" provided is not linked to this Company's employees. Please, cross-check with your client as they may have written the wrong shared_employee_id. | 400 | {"employee": {"shared_employee_id": "wrong_input"} } | [Please, check with your client if they have introduced the shared_employee_id value that you have given to them] |
| unknown_shared_shop_id | The "shared_shop_id" provided is not linked to this Company's shops. Please, cross-check with your client as they may have written the wrong shared_shop_id. | 400 | {"shop": {"shared_shop_id": "wrong_input"} } | [Please, check with your client if they have introduced the shared_shop_idvalue that you have given to them] |
| request_body_is_not_a_dictionary | The body of this request is not a dictionary or JSON-like object. | 400 | [Wrong input in Body] | Body = {Keys and values go here} |
| sales_json_missing_in_exchanges_request | You are missing the "sales" JSON in this request to the Exchanges service. | 400 | ["sales" key missing in Body] | [Please provide "sales" key and value in Body] |
| sales_json_missing_in_sales_request | You are missing the "sales" JSON in this request to the Sales service. | 400 | ["sales" key missing in Body] | [Please provide "sales" key and value in Body] |
| returns_json_missing_in_exchanges_request | You are missing the "returns" JSON in this request to the Exchanges service. | 400 | ["returns" key missing in Body] | [Please provide "returns" key and value in Body] |
| returns_json_missing_in_returns_request | You are missing the "returns" JSON in this request to the Returns service. | 400 | ["returns" key missing in Body] | [Please provide "returns" key and value in Body] |
| sales_json_provided_in_returns_request | You are attempting to provide the commercial data of a Returns request, but you are providing a "sales" structure. Please, do not provide this data to this URL or, if you want to provide the data for an Exchanges request, switch to the appropriate URL. | 400 | ["sales" key cannot be provided in this request type] | [Either change the endpoint you're targetting or remove this key] |
| returns_json_provided_in_sales_request | You are attempting to provide the commercial data of a Sales request, but you are providing a "returns" structure. Please, do not provide this data to this URL or, if you want to provide the data for an Exchanges request, switch to the appropriate URL. | 400 | ["returns" key cannot be provided in this request type] | [Either change the endpoint you're targetting or remove this key] |
| sales_is_an_empty_list_or_array | The "sales" JSON is empty in this request. | 400 | {"sales": [] } | {"sales": [{Keys and values go here}] } |
| returns_is_empty_in_exchanges_request | The "returns" JSON is empty in this request. | 400 | {"returns": [] } | {"returns": [{Keys and values go here}] } |
| sales_is_not_a_list_or_array | The "sales" object is not a list or array. | 400 | {"sales": 50 } | {"sales": [{Keys and values go here}] } |
| returns_is_not_a_list_or_array | The "returns" object is not a list or array. | 400 | {"returns": "string" } | {"returns": [{Keys and values go here}] } |
| sales_object_is_not_a_dictionary | The "sales" object is not a dictionary. | 400 | {"sales": [2] } | {"sales": [{Keys and values go here}] } |
| returns_object_is_not_a_dictionary | The "returns" object is not a dictionary. | 400 | {"returns": [2] } | {"returns": [{Keys and values go here}] } |
| sales_is_an_empty_dictionary | The "sales" dictionary is empty. | 400 | {"sales": [{}] } | {"sales": [{Keys and values go here}] } |
| returns_is_an_empty_dictionary | The "returns" dictionary is empty. | 400 | {"returns": [{}] } | {"returns": [{Keys and values go here}] } |
| some_sales_json_does_not_contain_sale_data_object | Some "sales" JSON does not contain the sale_data dictionary. | 400 | {"sales": [{"units": 50}] } | {"sales": {"units": 50, "sale_data": {Keys and values go here}} } |
| some_returns_json_does_not_contain_return_data_object | Some "returns" JSON does not contain the return_data dictionary. | 400 | {"returns": [{"units": 50}] } | {"returns": {"units": 50, "return_data": {Keys and values go here}} } |
| sale_data_is_not_a_dictionary | Some "sales" object contains a data object that is not a dictionary. | 400 | {"sales": [{"units": 50}, 2]} | {"sales": [{Keys and values go here}]} |
| return_data_is_not_a_dictionary | Some row of the "returns" object contains a data object that is not a dictionary. | 400 | {"returns": [{"units": 50}, 2]} | {"returns": [{Keys and values go here}]} |
| receipt_id_not_provided_in_input_data | The "receipt_id" field has not been provided in the request body. | 400 | [receipt_idis missing in Body] | {"receipt_id": 100} |
| current_receipt_id_not_provided_in_input_data | The "current_receipt_id" field has not been provided in the request body. | 400 | [current_receipt_id is missing in Body] | {"current_receipt_id": 100} |
| receipt_id_null_or_empty_in_input_data | The "receipt_id" field is either null or an empty string in the request body. | 400 | {"receipt_id": null} | {"receipt_id": 100} |
| current_receipt_id_null_or_empty_in_input_data | The "current_receipt_id" field is either null or an empty string in the request body. | 400 | {"current_receipt_id": ""} | {"current_receipt_id": 100} |
| receipt_id_is_not_numeric_in_input_data | The "receipt_id" field is not numeric in the request body. | 400 | {"receipt_id": "string"} | {"receipt_id": 100} |
| current_receipt_id_is_not_numeric_in_input_data | The "current_receipt_id" field is not numeric in the request body. | 400 | {"current_receipt_id": [] } | {"current_receipt_id": 100} |
| invalid_third_party_cert_for_this_request | The certificate provided is not valid for this request. Please, provide a valid third_party_cert in the headers of your request. | 400 | {"third_party_cert": "wrong_input"} | {"third_party_cert": "output_from_service"} |
| invalid_user_cert_for_this_request | The certificate provided is not valid for this request. Please, provide a valid user_cert in the headers of your request. | 400 | {"user_cert": "wrong_input"} | {"user_cert": "output_from_service"} |
| total_is_null_or_empty | The "total" field is either null or an empty string | 400 | [total is missing in Body] | {"total": 100} |
| subtotal_is_null_or_empty | The "subtotal" field is either null or an empty string | 400 | [subtotal is missing in Body] | {"subtotal": 100} |
| taxes_is_null_or_empty | The "taxes" field is either null or an empty string | 400 | [taxes is missing in Body] | {"taxes": 100} |
| total_is_not_numeric | The "total" field is not numeric in the request body. | 400 | {"total": {} } | {"total": 100} |
| subtotal_is_not_numeric | The "subtotal" field is not numeric in the request body. | 400 | {"subtotal": "string"} | {"subtotal": 100} |
| taxes_is_not_numeric | The "taxes" field is not numeric in the request body. | 400 | {"taxes": [] } | {"taxes": 100} |