CUSTOMER_ROW_NOT

Unexpected error while processing the row

Category: Customers


Retry	Yes, unchanged

When it happens

A row could not be processed because of an unexpected error on our side. It is reported in the row's errors; the other rows are not affected.

How to fix it

Import that row again. If it keeps failing, contact support with the request's request_id.

Retry

Retry the same request unchanged, with the same Idempotency-Key if you sent one. Wait first, and honour the Retry-After header when the response carries it.

Returned by

The operations where this code is most likely. The list is not exhaustive.

Example response

When this error occurs, the API returns a JSON response with the following shape:

{
  "type": "https://docs.beel.es/errors/CUSTOMER_ROW_NOT_PROCESSED",
  "title": "CUSTOMER_ROW_NOT_PROCESSED",
  "detail": "Unexpected error while processing the row",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "CUSTOMER_ROW_NOT_PROCESSED",
    "message": "Unexpected error while processing the row",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

The type URI is stable and always resolves to this page.

Message

Unexpected error while processing the row

Error inesperado al procesar la fila

Error inesperat en processar la fila

Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.

Other errors in this category

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

CUSTOMER_ROW_NOT_PROCESSED