Technical guides
Error codes
API errors return structured error codes with specific messages. Use these codes to diagnose issues and implement appropriate error handling.
Use case
Translate API errors into clear UI messages and reliable alerts.
System errors
| Code | Meaning |
|---|---|
| SYS0001 | Invalid Token |
Account errors
| Code | Meaning |
|---|---|
| ACC0001 | Request must contain at least one label |
| ACC0002 | No content found |
| ACC0003 | Invalid items in label update: {0} |
| ACC0004 | No invoice found |
| ACC0005 | Invoice number is mandatory |
Order errors
| Code | Meaning |
|---|---|
| ORD0001 | dateFrom must be prior or equal to dateTo |
| ORD0002 | Sales orders creation disabled |
| ORD0003 | Doorstep Delivery access not granted |
| ORD0004 | Error during cart creation |
| ORD0005 | Delivery address is not valid |
| ORD0006 | ReturnAddressID is not valid |
| ORD0007 | Document language must be en or fr |
| ORD0008 | Product identifier cannot be resolved |
| ORD0009 | Product defined multiple times |
| ORD0010 | Not enough inventory available |
| ORD0011 | No content found |
| ORD0012 | Product not allowed for doorstep delivery |
| ORD0013 | Request must contain items |
| ORD0014 | Doorstep delivery payment preferences not set |
| ORD0015 | Call customer service to order product |
| ORD0016 | Items with missing quantities: {0} |
| ORD0017 | Order number is mandatory for tracking |
| ORD0018 | No tracking number found or not available yet |
| ORD0019 | Authorized dealers only for product {0} |
| ORD0020 | PO box addresses are not supported |
Payment errors
| Code | Meaning |
|---|---|
| PMT0001 | Transaction declined – try a different card |
| PMT0002 | Billing address verification failed |
| PMT0003 | Transaction declined – try a different card |
| PMT0004 | Invalid expiration date |
| PMT0005 | Withdrawal limit reached |
| PMT0006 | Insufficient funds |
| PMT0007 | Invalid security code |
| PMT0008 | Invalid account number |
| PMT0009 | Error – contact customer service |
| PMT0010 | Transaction declined – contact card provider |
| PMT0011 | Request declined – try again |
Catalog errors
| Code | Meaning |
|---|---|
| CAT0001 | Invalid product status |
| CAT0002 | No content found |
Example: error mapping
const errorMap = {
SYS0001: 'Your API key is invalid or expired.',
ORD0010: 'Inventory is short—reduce quantity or try later.',
}
function toUserMessage(code) {
return errorMap[code] ?? 'Something went wrong.'
}