ErrorsAll codes
INVOICE_DUPLICATE_EXTERNAL_REFERENCE
An invoice with this external reference already exists
Category: Invoices
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/INVOICE_DUPLICATE_EXTERNAL_REFERENCE",
"title": "INVOICE_DUPLICATE_EXTERNAL_REFERENCE",
"detail": "An invoice with this external reference already exists",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "INVOICE_DUPLICATE_EXTERNAL_REFERENCE",
"message": "An invoice with this external reference already exists",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
An invoice with this external reference already exists
Ya existe una factura con esta referencia externa
Ja existeix una factura amb aquesta referència externa
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
ATTACH_SOURCE_INVOICE_UNAVAILABLE
A source invoice is not available (it does not exist or you no longer have access); uncheck the source invoices attachment to send without the folder
ATTACH_SOURCE_INVOICES_NO_SOURCES
The invoice has no consolidation disbursements: there are no source invoices to attach
ATTACH_SOURCE_INVOICES_REQUIRES_PDF
Attaching the source invoices also requires attaching the invoice PDF
ATTACH_SOURCE_PDF_MISSING
These source invoices have no generated PDF: {0}
ATTACH_SOURCE_ZIP_TOO_LARGE
The source invoices ZIP ({0} MB) exceeds the maximum sendable size ({1} MB)