ErrorsBy category
Customers errors
All error codes returned by the Customers endpoints (35 total).
Every error returned by the Customers endpoints. Click any code for the full example response and localized messages.
| Code | Message |
|---|---|
ALTERNATIVE_ID_AND_NIF_EXCLUSIVE | The customer cannot carry both a NIF and an alternative identifier. Use only one |
ALTERNATIVE_ID_INVALID | The alternative identifier is not valid |
ALTERNATIVE_ID_REQUIRES_SPAIN | Type NOT_REGISTERED (07) is only valid for Spain; received country: ''{0}'' |
ALTERNATIVE_ID_SPAIN_INVALID_TYPE | For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed |
BULK_VALIDATION_ERROR | One or more customers in the batch are invalid; none were created |
CITY_EMPTY | City cannot be empty |
CITY_MAX_LENGTH | City cannot exceed {0} characters |
CLIENT_DUPLICATE | A client with this NIF already exists |
CLIENT_HAS_INVOICES | This customer has invoices and cannot be deleted: deleting it would release its identifier and allow another customer to be created with the same one, splitting a single identity across two records. To stop using it, deactivate it with active:false |
CLIENT_NOT_FOUND | Client not found |
COUNTRY_EMPTY | Country cannot be empty |
COUNTRY_MAX_LENGTH | Country cannot exceed {0} characters |
CSV_FILE_TOO_LARGE | The file is too large: {0} bytes (maximum: {1} bytes) |
CUSTOMER_IDENTIFIER_REQUIRED | Provide either a NIF or an alternative identifier. |
DUPLICATE_HEADER | File {0} repeats column {1}: there is no way to tell which of the two counts. Leave it just once |
EMPTY_FILE | The file is empty |
ENCODING_ERROR | File encoding error: {0} |
HEADER_ROW_NOT_FOUND | No header row found in the first {1} lines of {0}. Required columns: {2}. {3} |
INVALID_CSV_FORMAT | Invalid CSV file format: {0} |
INVALID_FORMAT | Invalid file format: {0} |
MISSING_HEADERS | Required header not found: ''{0}''. Headers found: {1} |
NIF_INVALID_CONTROL_DIGIT | The control digit of NIF ''{0}'' is incorrect |
NIF_INVALID_FORMAT | The NIF ''{0}'' has an invalid format |
NIF_NOT_IN_CENSUS | The NIF ''{0}'' does not exist in the AEAT census or the fiscal name does not match |
NO_DATA_ROWS | File {0} carries only the header row: there is no data row to import |
NUMBER_EMPTY | Number cannot be empty |
NUMBER_MAX_LENGTH | Number cannot exceed {0} characters |
PARSING_ERROR | Error processing the file: {0} |
POSTAL_CODE_EMPTY | Postal code cannot be empty |
POSTAL_CODE_INVALID_ES | Invalid Spanish postal code: ''{0}''. Must be 5 digits |
PROVINCE_EMPTY | Province cannot be empty |
PROVINCE_MAX_LENGTH | Province cannot exceed {0} characters |
STREET_EMPTY | Street cannot be empty |
STREET_MAX_LENGTH | Street cannot exceed {0} characters |
TOO_MANY_RECORDS | Too many records: {0} (maximum: {1}) |