| 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 |
