RECIPIENT_CUSTOMER_AND_DATA

Send a customer or the recipient data, not both.

Category: Invoices


HTTP status	`422` Unprocessable Content
Retry	After fixing the cause

When it happens

The recipient sends customer_id together with other recipient fields (legal_name, nif, address…). They are alternatives: one or the other. Until now the other fields were ignored; now the request is refused.

How to fix it

Send only customer_id to invoice a saved customer (edit the customer to change its data), or only the recipient's details, without customer_id, for a one-off recipient.

Retry

Not as is: the same request fails the same way. Fix the cause described above, then send the request again, under a new Idempotency-Key if the body changed.

Returned by

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

Example response

When this error occurs, the API answers 422 Unprocessable Content with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/RECIPIENT_CUSTOMER_AND_DATA_EXCLUSIVE",
  "title": "RECIPIENT_CUSTOMER_AND_DATA_EXCLUSIVE",
  "detail": "Send a customer or the recipient data, not both.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "RECIPIENT_CUSTOMER_AND_DATA_EXCLUSIVE",
    "message": "Send a customer or the recipient data, not both.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}