Service |
Error Field |
Error Message |
Possible Reason |
Solution |
All |
Error Code 401 |
Unauthorized |
You may used a wrong token or your token was being applied on a wrong environment |
Please check if you are using a correct token or the environment (Production or Integration) of the token is correct |
All |
|
must not be null |
You provided a NULL value for required fields |
Please visit API Documentation (Production and Integration) and choose the corresponding service to check if the value is a required one or not |
hscodes |
goods.description |
Size must be between 3 and 512 |
The goods description in the payload is too short (<3) or too long (>512) |
Modify the goods.description in the payload and re-submit |
hscodes |
goods.value.currencyCode |
size must be between 3 and 3 |
The goods currency code is incorrect |
Modify the goods.value.currencyCode in the payload to follow ISO-4217 and re-submit |
hscodes |
countryOfDestination |
size must be between 2 and 2 |
The country code is incorrect |
Modify the countryOfDestination in the payload to follow ISO-3166 and re-submit |
shopping-cart |
description |
size must be between 3 and 512 |
The goods description in the payload is too short (<3) or too long (>512) |
Modify the description in the payload and re-submit |
shopping-cart |
request |
size must be between 1 and 5 |
The Payload is a purely empty one |
The payload should follow the structures and definitions in API documentation |
shopping-cart |
hsCode |
harmonized system code not found |
HS Code provided in the payload is not a valid one |
Validate the existence of HS Code in https://trade.ec.europa.eu/access-to-markets/en/home and re-submit the correct one after correction |
shopping-cart |
hsCode |
size must be between 6 and 10 |
HS Code provided in the payload is shorter than 6 digits or longer than 10 digits |
Modify the HS Code to make sure it's between 6 and 10 digits |
shopping-cart |
hsCode |
HS code has to be provided for all goods items if hsCodeReplaceAllowed is not true |
If hsCodeReplaceAllowed was not set as true, the hsCode field was not included in the payload |
when hsCodeReplaceAllowed is not set as true, the hsCode filed is compulsory |
order |
Error Code 409 |
|
The orderNumber has been submitted before and caused a duplicated order |
Make sure if you want to send another order or you have sent a duplicate order mistakenly |
order |
goods.quantity |
must be greater than or equal to 1.0 |
The quantity was set as a value lower than 1.0 |
Modify the quantity to a value >= 1.0 and re-submit |
order |
goods.value |
must be greater than 0.0 |
The value was set as a value lower than 0 |
Modify the quantity to a value >= 0 and re-submit |
order |
goods.hsCode |
harmonized system code not found |
HS Code provided in the payload is not a valid one |
Validate the existence of HS Code in https://trade.ec.europa.eu/access-to-markets/en/home and re-submit the correct one after correction |
order |
goods.vatPayable |
must be greater than 0.0 |
The vatPayable in the Payload is 0 |
The vatRate or vatPayable in the Payload should be greater than 0 |
order |
goods.vatRate |
must be greater than 0.0 |
The vatRate in the Payload is 0 |
The vatRate in the Payload should be greater than 0 |
order |
goods.hsCode |
harmonized system code not found |
HS Code provided in the payload is not a valid one |
Validate the existence of HS Code in https://trade.ec.europa.eu/access-to-markets/en/home and re-submit the correct one after correction |
order |
date |
VAT declaration for given order date period has already been submitted |
The VAT declaration period of the order has already passed |
Make sure if the current date is the VAT declaration period (normally the next month of shipping date |
order |
destinationCountry |
Must be EU Member State |
The field of destinationCountryin the Payload is not a EU country |
The field of destinationCountryin the Payload should be a EU country |
order |
invoiceDate |
Value not recognized (2021-09-30 23:43:00), please refer to specification for available values. |
The format in the field of invoiceDate is incorrect |
The format in the field of invoiceDate should be YYYY-MM-DD |
order |
N/A |
The marketplace does not have an IOSS number |
Your token haven't been granted to the IOSS service |
Make sure you have got the IOSS service related to your token |