ErrorsBy category
Customers errors
All error codes returned by the Customers endpoints (34 total).
Every error returned by the Customers endpoints. Click any code for the full example response and localized messages.
| Code | Message |
|---|---|
ALTERNATIVE_ID_ACTUALLY_IN_CENSUS | The identifier '‹value›' is registered in the AEAT census, so it cannot be declared as not registered (07). Enter it as a NIF instead. |
ALTERNATIVE_ID_AND_NIF_EXCLUSIVE | The customer cannot carry both a NIF and an alternative identifier. Use only one |
ALTERNATIVE_ID_COUNTRY_REQUIRED | The country of the alternative identifier is missing (alternative_id.country_code). It is required except for the PASSPORT and NOT_REGISTERED types, which are taken as Spanish when it is omitted. |
ALTERNATIVE_ID_INVALID | The alternative identifier is not valid |
ALTERNATIVE_ID_REQUIRES_SPAIN | Type NOT_REGISTERED (07) is only valid for Spain; received country: '‹value›' |
ALTERNATIVE_ID_SPAIN_INVALID_TYPE | For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed |
ALTERNATIVE_ID_VAT_INVALID_FORMAT | '‹value›' is not a valid EU VAT number for that country: it must be the prefix '‹value›' followed by the country's VAT number, in capital letters and without spaces. If it is the recipient of an invoice already issued, correct its data with an R4 corrective invoice |
ALTERNATIVE_ID_VAT_REQUIRES_EU_COUNTRY | An EU VAT number (NIF_IVA, type 02) is only valid for an EU member state other than Spain; received country: '‹value›'. Identify a customer from outside the EU with another type, such as OTHER_DOCUMENT or COUNTRY_ID. If it is the recipient of an invoice already issued, correct its data with an R4 corrective invoice |
BULK_VALIDATION_ERROR | One or more customers in the batch are invalid; none were created |
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 |
CSV_FILE_TOO_LARGE | The file is too large: ‹value› bytes (maximum: ‹value› bytes) |
CUSTOMER_ADDRESS_INVALID | The address is not valid |
CUSTOMER_DUPLICATED_IN_BATCH | NIF duplicated within the batch |
CUSTOMER_DUPLICATED_IN_FILE | Customer with a NIF/CIF duplicated in the file |
CUSTOMER_FIELD_INVALID_CHARACTERS | The field '‹value›' contains characters that are not allowed |
CUSTOMER_FIELD_INVALID_FORMAT | Invalid format for '‹value›': expected ‹value› |
CUSTOMER_FIELD_REQUIRED | The field '‹value›' is required |
CUSTOMER_IDENTIFIER_REQUIRED | Provide either a NIF or an alternative identifier. |
CUSTOMER_NOT_SAVED | The customer could not be saved |
CUSTOMER_ROW_NOT_PROCESSED | Unexpected error while processing the row |
DUPLICATE_HEADER | File ‹value› repeats column ‹value›: 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: ‹value› |
HEADER_ROW_NOT_FOUND | No header row found in the first ‹value› lines of ‹value›. Required columns: ‹value›. ‹value› |
INVALID_FORMAT | Invalid file format: ‹value› |
MISSING_HEADERS | These required headers are missing: ‹value›. Headers found: ‹value› |
NIF_INVALID_CONTROL_DIGIT | The control digit of NIF '‹value›' is incorrect |
NIF_INVALID_FORMAT | The NIF '‹value›' has an invalid format |
NIF_NOT_IN_CENSUS | The NIF '‹value›' does not exist in the AEAT census or the fiscal name does not match |
NO_DATA_ROWS | File ‹value› carries only the header row: there is no data row to import |
PARSING_ERROR | Error processing the file: ‹value› |
TOO_MANY_RECORDS | Too many records: ‹value› (maximum: ‹value›) |