Get StartedVeriFactuStripeAPI Reference
Errors

All error codes

Every error code returned by the BeeL. API in one flat table — useful as a cheat sheet or to import as constants in your codebase.

Every code the API can return, in one alphabetical table. 203 codes across 10 domains.

Each Code cell links to the per-code reference page with the full example response and localised messages.

Codes as a copy/paste list

Drop this into your codebase to declare every error code as a constant. The fenced code block has a one-click copy button.

ACTIVE_CANNOT_DELETE
ALREADY_DISABLED
ALREADY_ENABLED
ALREADY_REGISTERED
ALTERNATIVE_ID_INVALID
ALTERNATIVE_ID_INVALID
ALTERNATIVE_ID_INVALID
API_COMMUNICATION_ERROR
API_KEY_INVALID
API_KEY_NOT_CONFIGURED
AUTOMATIC_EMAIL_CONFIG_INVALID
BULK_PDF_ERROR
CANCELLATION_VIA_SPECIFIC_ENDPOINT
CANNOT_DELETE_PRIMARY
CANNOT_DUPLICATE_DELETED_INVOICE
CANNOT_SIGN_CANCELLED
CITY_EMPTY
CITY_MAX_LENGTH
CLIENT_DUPLICATE
CLIENT_NOT_FOUND
CLIENT_NOT_FOUND
COMPANY_NOT_FOUND
CONFIG_NOT_FOUND
CONFIGURATION_INVALID
COUNTRY_EMPTY
COUNTRY_MAX_LENGTH
DEFAULT_CANNOT_DEACTIVATE
DEFAULT_CANNOT_DELETE
DELETION_FAILED
DELIVERY_LOG_NOT_FOUND
DIRECCION_FISCAL_REQUIRED
DOCUMENT_ALREADY_CANCELLED
DUE_DATE_BEFORE_ISSUE_DATE
EMPTY_FILE
ENCODING_ERROR
EXEMPT_ZERO_RATE_REQUIRES_REASON
EXEMPTION_REGIME_NOT_SUPPORTED_IN_VERIFACTU
EXEMPTION_REQUIRES_RECIPIENT_ID_TYPE
FIELD_BLANK
FILE_CORRUPTED
FILE_EMPTY
FILE_TOO_LARGE
FILE_TOO_LARGE
FORBIDDEN
HAS_INVOICES_CANNOT_DELETE
IBAN_INVALID
IBAN_REQUIRED
INACTIVE_CANNOT_BE_DEFAULT
INVALID_CONTENT
INVALID_CSV_FORMAT
INVALID_DIMENSIONS
INVALID_EMAIL_FORMAT
INVALID_EXCEL_FORMAT
INVALID_EXCEL_STRUCTURE
INVALID_EXTENSION
INVALID_FILE_TYPE
INVALID_FORMAT
INVALID_IRPF
INVALID_IVA_SURCHARGE_PAIR
INVALID_LINE
INVALID_PERCENTAGE
INVALID_SURCHARGE
INVALID_TAX
INVALID_TOKEN
INVALID_VAT
INVOICE_NO_LINES
INVOICE_NO_NUMBER
INVOICE_NOT_EMITIDA
INVOICE_NOT_FOUND
INVOICE_VERIFACTU_DISABLED
IRPF_REQUIRED_WHEN_NOT_EXEMPT
ISP_INCOMPATIBLE_WITH_SURCHARGE
ISSUE_DATE_IN_FUTURE
ISSUE_DATE_REQUIRED
LINE_EXEMPTION_TEXT_REQUIRED
LINE_EXEMPTION_WITH_TAX
LINE_INVALID_DISCOUNT
LINE_INVALID_QUANTITY
LINE_NEGATIVE_PRICE
LINE_TOTAL_INCONSISTENT
LINE_ZERO_PRICE
MAIN_TAX_REQUIRED
MARK_SENT_ALREADY_SENT
MARK_SENT_FROM_DRAFT_NOT_ALLOWED
MARK_SENT_FROM_INVALID_STATE
MARK_SENT_FROM_LATER_STATE
MAX_PROFILES_REACHED
METADATA_FILTER_TOO_MANY_KEYS
MISSING_HEADERS
MISSING_REQUIRED_FIELD
NEGATIVE_TOTAL_REQUIRES_RECTIFICATIVE
NIF_ALREADY_REGISTERED
NIF_INVALID_CONTROL_DIGIT
NIF_INVALID_FORMAT
NIF_MISMATCH
NIF_NOT_IN_CENSUS
NIF_NOT_REGISTERED
NIF_REACTIVATION_FAILED
NIF_REGISTRATION_FAILED
NIF_VALIDATION_ERROR
NIF_VALIDATION_INVALID
NIF_VALIDATION_PENDING
NO_INVOICES_PROVIDED
NO_PDFS_AVAILABLE
NO_UNSIGNED_DOCUMENT
NUMBER_EMPTY
NUMBER_MAX_LENGTH
ONLY_DRAFT_EMITTABLE
OPERATION_DATE_AFTER_ISSUE_DATE
OSS_REGIME_INCOMPATIBLE_WITH_ISP
PARSING_ERROR
PAYMENT_DATE_REQUIRED
PDF_EMPTY
PDF_HASH_ERROR
PDF_INVALID_EXTENSION
PDF_INVALID_FORMAT
PDF_NOT_GENERATED
PDF_SIGNATURE_INVALID
PDF_STORAGE_FAILED
PDF_TOO_LARGE
PDF_URL_EMPTY
PDF_VALIDATION_FAILED
PERFIL_NO_ENCONTRADO
PLAZO_DIAS_OUT_OF_RANGE
POSTAL_CODE_EMPTY
POSTAL_CODE_INVALID_ES
PREVIEW_DRAFT_ONLY
PREVIEW_GENERATION_ERROR
PRODUCT_DUPLICATE
PRODUCT_INACTIVE
PRODUCT_NOT_FOUND
PROFILE_NOT_FOUND
PROFILE_NOT_OWNED
PROVINCE_EMPTY
PROVINCE_MAX_LENGTH
RECARGO_EQUIVALENCIA_REQUIRED
RECIPIENT_ADDRESS_REQUIRED
RECIPIENT_FISCAL_NAME_REQUIRED
RECIPIENT_ID_REQUIRED
RECIPIENT_NIF_AND_ID_OTHER_EXCLUSIVE
RECIPIENT_REQUIRED_FOR_ORDINARY
RECTIFICATION_REASON_TOO_SHORT
RECTIFICATIVA_NO_CODE
RECTIFICATIVA_NO_ORIGINAL
RECTIFICATIVA_PARCIAL_SIN_LINEAS
RECTIFICATIVA_R1R4_NOT_SIMPLIFICADA
RECTIFICATIVA_R5_ONLY_SIMPLIFICADA
RECTIFICATIVA_TOTAL_CON_LINEAS
RECURRING_END_DATE_BEFORE_START
RECURRING_INVALID_DAY_OF_MONTH
RECURRING_INVOICE_DELETED
RECURRING_NO_LINES
RECURRING_NOT_FOUND
RECURRING_START_DATE_NOT_EDITABLE
RECURRING_TYPE_NOT_SUPPORTED
REGIME_REQUIRES_INCOMPATIBLE_EXEMPTION
REGIME_REQUIRES_SURCHARGE
REGISTRO_NOT_FOUND
REVERT_ONLY_FROM_SENT
SCHEDULED_DATE_IN_PAST
SCHEDULED_DATE_REQUIRED
SCOPE_ESCALATION
SERIES_CODE_DUPLICATED
SERIES_CODIGO_LOCKED_HAS_INVOICES
SERIES_DEFAULT_NOT_FOUND
SERIES_DOCUMENT_TYPE_INCOMPATIBLE
SERIES_FORMAT_EMPTY
SERIES_FORMAT_INVALID_PADDING
SERIES_FORMAT_LOWERCASE_VARS
SERIES_FORMAT_NUM_REQUIRED
SERIES_FORMAT_UNRECOGNIZED_VARS
SERIES_FORMATO_LOCKED_HAS_INVOICES
SERIES_INACTIVE
SERIES_INCOMPATIBLE_DOC_TYPE
SERIES_NOT_FOUND
SERIES_NOT_FOUND
SERIES_NUMERO_INICIAL_LOCKED_HAS_INVOICES
SERIES_RESETEO_LOCKED_HAS_INVOICES
SIMPLIFICADA_FORBIDS_CROSS_BORDER
SIMPLIFICADA_FORBIDS_IRPF
SIMPLIFICADA_FORBIDS_ISP
STATUS_NOT_DELETABLE
STATUS_NOT_IMPLEMENTED
STATUS_NOT_MODIFIABLE
STORAGE_URL_EMPTY
STREET_EMPTY
STREET_MAX_LENGTH
SUBSCRIPTION_NOT_FOUND
SURCHARGE_REQUIRES_REGIME
SWIFT_INVALID
TEMPLATE_MISSING_REQUIRED_VARIABLE
TEMPLATE_UNKNOWN_VARIABLE
TOO_MANY_RECORDS
TOO_MANY_REQUESTS
TRANSITION_NOT_SUPPORTED
TYPE_CHANGE_CORRECTIVE_FORBIDDEN
TYPE_REQUIRED
UNAUTHORIZED
USER_NOT_FOUND
UUID_BLANK
UUID_INVALID_FORMAT
UUID_NULL
ZIP_GENERATION_ERROR

Full table

CodeCategoryEnglish message
ACTIVE_CANNOT_DELETEAccount settingsCannot delete an active series. Deactivate it first
ALREADY_DISABLEDVeriFactuVeriFactu is already disabled for this user
ALREADY_ENABLEDVeriFactuVeriFactu is already enabled for this user
ALREADY_REGISTEREDVeriFactuThe NIF is already registered in VeriFactu
ALTERNATIVE_ID_INVALIDCustomersThe alternative identifier is not valid
ALTERNATIVE_ID_INVALIDCustomersType NOT_REGISTERED (07) is only valid for Spain; received country: ''{0}''
ALTERNATIVE_ID_INVALIDCustomersFor customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed
API_COMMUNICATION_ERRORVeriFactuError communicating with the VeriFactu API
API_KEY_INVALIDAuthenticationThe API key is invalid or has expired
API_KEY_NOT_CONFIGUREDVeriFactuThe VeriFactu API key has not been configured
AUTOMATIC_EMAIL_CONFIG_INVALIDGeneralFor automatic sending, you must provide an email configuration or a client with email
BULK_PDF_ERRORInvoicesError processing bulk PDF download
CANCELLATION_VIA_SPECIFIC_ENDPOINTInvoicesTo cancel an invoice use the specific cancellation endpoint
CANNOT_DELETE_PRIMARYCompaniesCannot delete the primary account through this endpoint
CANNOT_DUPLICATE_DELETED_INVOICEInvoicesCannot duplicate a deleted invoice
CANNOT_SIGN_CANCELLEDVeriFactuCannot sign a cancelled document
CITY_EMPTYCustomersCity cannot be empty
CITY_MAX_LENGTHCustomersCity cannot exceed {0} characters
CLIENT_DUPLICATECustomersA client with this NIF already exists
CLIENT_NOT_FOUNDCustomersClient not found
CLIENT_NOT_FOUNDInvoicesCustomer not found: {0}
COMPANY_NOT_FOUNDCompaniesCompany not found
CONFIG_NOT_FOUNDVeriFactuVeriFactu configuration not found
CONFIGURATION_INVALIDGeneralThe configuration is not valid
COUNTRY_EMPTYCustomersCountry cannot be empty
COUNTRY_MAX_LENGTHCustomersCountry cannot exceed {0} characters
DEFAULT_CANNOT_DEACTIVATEAccount settingsCannot deactivate the default series. Set another series as default first
DEFAULT_CANNOT_DELETEAccount settingsCannot delete the default series. Set another series as default first
DELETION_FAILEDInvoicesError deleting the invoice
DELIVERY_LOG_NOT_FOUNDWebhooksWebhook delivery log not found
DIRECCION_FISCAL_REQUIREDVeriFactuFiscal address is required to register with VeriFactu
DOCUMENT_ALREADY_CANCELLEDVeriFactuThe document is already cancelled
DUE_DATE_BEFORE_ISSUE_DATEInvoicesDue date cannot be before the issue date
EMPTY_FILECustomersThe file is empty
ENCODING_ERRORCustomersFile encoding error: {0}
EXEMPT_ZERO_RATE_REQUIRES_REASONInvoicesLines with 0% tax rate must declare an exemption reason. Use one of: EXENTA_ART_20..26, NO_SUJETA_ART_7_9, NO_SUJETA_LOCALIZACION, ISP_ART_84_2_*, OTRO
EXEMPTION_REGIME_NOT_SUPPORTED_IN_VERIFACTUInvoicesThe given exemption reason corresponds to a special regime (REAEA, equivalence surcharge, cash basis, investment gold…), not to an art. 20-26 LIVA exemption. VeriFactu models it with clave_regimen, not operacion_exenta. Switch to the appropriate clave_regimen.
EXEMPTION_REQUIRES_RECIPIENT_ID_TYPEInvoicesExemption {0} requires the recipient to carry an alternative identifier of type {1}
FIELD_BLANKGeneralThe field ''{0}'' cannot be empty
FILE_CORRUPTEDGeneralFile is damaged or corrupt
FILE_EMPTYGeneralThe file is empty
FILE_TOO_LARGECustomersThe file is too large: {0} bytes (maximum: {1} bytes)
FILE_TOO_LARGEGeneralFile is too large. Maximum allowed size: {0}
FORBIDDENGeneralYou do not have permission to perform this action
HAS_INVOICES_CANNOT_DELETEAccount settingsCannot delete a series that has associated invoices. Delete the invoices first
IBAN_INVALIDGeneralInvalid IBAN: ''{0}''. Must match ISO 13616 format (e.g.: ES1234567890123456789012)
IBAN_REQUIREDGeneralPayment method {0} requires an IBAN
INACTIVE_CANNOT_BE_DEFAULTAccount settingsCannot set an inactive series as default
INVALID_CONTENTGeneralFile content is not valid
INVALID_CSV_FORMATCustomersInvalid CSV file format: {0}
INVALID_DIMENSIONSGeneralImage dimensions are not valid
INVALID_EMAIL_FORMATGeneralThe email ''{0}'' has an invalid format
INVALID_EXCEL_FORMATHolded importInvalid Holded Excel file format: {0}
INVALID_EXCEL_STRUCTUREHolded importThe Excel file does not have the expected Holded contacts structure
INVALID_EXTENSIONGeneralFile extension not allowed
INVALID_FILE_TYPEGeneralFile type not allowed. Accepted types: {0}
INVALID_FORMATCustomersInvalid file format: {0}
INVALID_IRPFInvoicesInvalid income tax withholding type: ''{0}''. Allowed values: {1}
INVALID_IVA_SURCHARGE_PAIRInvoicesSurcharge {0}% is not valid for VAT {1}%. Allowed pairs: 21↔5.2, 10↔1.4, 4↔0.5
INVALID_LINEInvoicesThe invoice line is not valid: {0}
INVALID_PERCENTAGEInvoicesThe percentage {0} is not valid. It must be between 0 and 100
INVALID_SURCHARGEInvoicesInvalid equivalence surcharge type: ''{0}''. Allowed values: {1}
INVALID_TAXInvoicesThe tax type ''{0}'' is not valid
INVALID_TOKENGeneralThe token is invalid or has expired
INVALID_VATInvoicesInvalid VAT type: ''{0}''. Allowed values: {1}
INVOICE_NO_LINESInvoicesThe invoice must have at least one line
INVOICE_NO_NUMBERVeriFactuThe invoice does not have an assigned number
INVOICE_NOT_EMITIDAVeriFactuThe invoice must be issued before submitting to VeriFactu
INVOICE_NOT_FOUNDInvoicesInvoice not found
INVOICE_VERIFACTU_DISABLEDVeriFactuVeriFactu is not enabled for this invoice
IRPF_REQUIRED_WHEN_NOT_EXEMPTGeneralThe income tax withholding percentage is required when not exempt
ISP_INCOMPATIBLE_WITH_SURCHARGEInvoicesReverse-charge (ISP) lines cannot carry equivalence surcharge: the buyer auto-liquidates VAT in their country and Spanish retail surcharge does not apply
ISSUE_DATE_IN_FUTUREInvoicesIssue date cannot be in the future. To issue an invoice on a future date, use POST /v1/invoices/{id}/schedule
ISSUE_DATE_REQUIREDInvoicesIssue date is required
LINE_EXEMPTION_TEXT_REQUIREDInvoicesA descriptive text is required when the exemption reason is OTHER
LINE_EXEMPTION_WITH_TAXInvoicesLine has an exemption reason but the tax rate is not 0%. Current value: {0}%
LINE_INVALID_DISCOUNTInvoicesThe discount must be between 0 and 100. Received value: {0}
LINE_INVALID_QUANTITYInvoicesThe quantity cannot be zero or null
LINE_NEGATIVE_PRICEInvoicesThe unit price cannot be negative
LINE_TOTAL_INCONSISTENTInvoicesLine totals do not reconcile: expected {0}€ (base + VAT + surcharge - IRPF), declared {1}€. Difference exceeds 0.01€
LINE_ZERO_PRICEInvoicesThe unit price cannot be zero
MAIN_TAX_REQUIREDGeneralYou must configure a main tax (VAT, IGIC or IPSI)
MARK_SENT_ALREADY_SENTInvoicesThe invoice is already in SENT status.
MARK_SENT_FROM_DRAFT_NOT_ALLOWEDInvoicesCannot mark an invoice in DRAFT status as SENT. Issue it first.
MARK_SENT_FROM_INVALID_STATEInvoicesCannot mark as SENT from status {0}.
MARK_SENT_FROM_LATER_STATEInvoicesCannot mark an invoice in {0} status as SENT. The invoice is already in a later state.
MAX_PROFILES_REACHEDCompaniesYou have reached the maximum number of business profiles ({0}). Upgrade your plan for more
METADATA_FILTER_TOO_MANY_KEYSInvoicesThe metadata filter supports at most {0} key/value pairs per request
MISSING_HEADERSCustomersRequired header not found: ''{0}''. Headers found: {1}
MISSING_REQUIRED_FIELDGeneralThe field ''{0}'' is required
NEGATIVE_TOTAL_REQUIRES_RECTIFICATIVEInvoicesThe invoice total cannot be negative. Use corrective invoices (R1-R5) for refunds.
NIF_ALREADY_REGISTEREDCompaniesThe NIF is already registered
NIF_INVALID_CONTROL_DIGITCustomersThe control digit of NIF ''{0}'' is incorrect
NIF_INVALID_FORMATCustomersThe NIF ''{0}'' has an invalid format
NIF_MISMATCHVeriFactuThe provided NIF does not match the user's NIF
NIF_NOT_IN_CENSUSCustomersThe NIF ''{0}'' does not exist in the AEAT census or the fiscal name does not match
NIF_NOT_REGISTEREDVeriFactuThe NIF is not registered in VeriFactu
NIF_REACTIVATION_FAILEDVeriFactuError reactivating the NIF in VeriFactu
NIF_REGISTRATION_FAILEDVeriFactuError registering the NIF in VeriFactu
NIF_VALIDATION_ERRORVeriFactuTechnical error validating the NIF against the AEAT census
NIF_VALIDATION_INVALIDVeriFactuThe NIF does not exist in the AEAT census
NIF_VALIDATION_PENDINGVeriFactuThe NIF is pending validation against the AEAT census
NO_INVOICES_PROVIDEDInvoicesNo invoices provided
NO_PDFS_AVAILABLEInvoicesNo PDFs available for download
NO_UNSIGNED_DOCUMENTVeriFactuNo unsigned representation document exists. Generate one before uploading the signed PDF
NUMBER_EMPTYCustomersNumber cannot be empty
NUMBER_MAX_LENGTHCustomersNumber cannot exceed {0} characters
ONLY_DRAFT_EMITTABLEInvoicesOnly draft invoices can be issued. Current status: {0}
OPERATION_DATE_AFTER_ISSUE_DATEInvoicesOperation date cannot be after the issue date
OSS_REGIME_INCOMPATIBLE_WITH_ISPInvoicesOSS/IOSS regime (key 17) is incompatible with reverse charge. The destination-country VAT is declared separately (Modelo 369), not as S2
PARSING_ERRORCustomersError processing the file: {0}
PAYMENT_DATE_REQUIREDInvoicesPayment date is required to mark the invoice as paid
PDF_EMPTYVeriFactuThe PDF file is empty
PDF_HASH_ERRORInvoicesError calculating PDF hash
PDF_INVALID_EXTENSIONVeriFactuThe file must be a PDF (.pdf)
PDF_INVALID_FORMATVeriFactuThe file does not have a valid PDF format
PDF_NOT_GENERATEDInvoicesThe invoice PDF has not been generated yet
PDF_SIGNATURE_INVALIDVeriFactuThe signed PDF is not valid: {0}
PDF_STORAGE_FAILEDVeriFactuError saving the signed PDF. Please try again
PDF_TOO_LARGEVeriFactuThe PDF file exceeds the maximum allowed size: {0} (maximum: {1} MB)
PDF_URL_EMPTYInvoicesThe PDF URL is empty
PDF_VALIDATION_FAILEDVeriFactuError validating the signed PDF. Please try again later
PERFIL_NO_ENCONTRADOVeriFactuUser profile not found
PLAZO_DIAS_OUT_OF_RANGEGeneralPayment term must be between {0} and {1} days
POSTAL_CODE_EMPTYCustomersPostal code cannot be empty
POSTAL_CODE_INVALID_ESCustomersInvalid Spanish postal code: ''{0}''. Must be 5 digits
PREVIEW_DRAFT_ONLYInvoicesPDF preview is only available for draft invoices
PREVIEW_GENERATION_ERRORInvoicesError generating PDF preview
PRODUCT_DUPLICATEProductsA product with code ''{0}'' already exists
PRODUCT_INACTIVEProductsThe product ''{0}'' is inactive and cannot be used
PRODUCT_NOT_FOUNDProductsProduct not found: {0}
PROFILE_NOT_FOUNDCompaniesBusiness profile not found
PROFILE_NOT_OWNEDCompaniesThe business profile does not belong to your account
PROVINCE_EMPTYCustomersProvince cannot be empty
PROVINCE_MAX_LENGTHCustomersProvince cannot exceed {0} characters
RECARGO_EQUIVALENCIA_REQUIREDGeneralThe equivalence surcharge is required for this type of operation
RECIPIENT_ADDRESS_REQUIREDInvoicesRecipient address is required for standard invoices
RECIPIENT_FISCAL_NAME_REQUIREDInvoicesRecipient legal name is required for standard invoices
RECIPIENT_ID_REQUIREDInvoicesRecipient must have a NIF or alternative identifier
RECIPIENT_NIF_AND_ID_OTHER_EXCLUSIVEInvoicesThe recipient cannot carry both a Spanish NIF and an alternative identifier. Use only one
RECIPIENT_REQUIRED_FOR_ORDINARYInvoicesOrdinary invoices require a valid recipient
RECTIFICATION_REASON_TOO_SHORTInvoicesThe rectification reason must be at least {0} characters
RECTIFICATIVA_NO_CODEVeriFactuThe credit note must have a correction code
RECTIFICATIVA_NO_ORIGINALVeriFactuThe credit note must reference an original invoice
RECTIFICATIVA_PARCIAL_SIN_LINEASInvoicesPartial rectificative invoices must include correction lines. Use negative quantities/amounts to subtract, positive to add.
RECTIFICATIVA_R1R4_NOT_SIMPLIFICADAVeriFactuThe R1-R4 correction methods do not apply to simplified invoices
RECTIFICATIVA_R5_ONLY_SIMPLIFICADAVeriFactuThe R5 correction method only applies to simplified invoices
RECTIFICATIVA_TOTAL_CON_LINEASInvoicesTotal rectificative invoices must not include lines. Lines are automatically copied from the original invoice with negative amounts.
RECURRING_END_DATE_BEFORE_STARTInvoicesThe end date must be after the first scheduled generation ({0})
RECURRING_INVALID_DAY_OF_MONTHInvoicesThe day of the month must be between 1 and 31
RECURRING_INVOICE_DELETEDInvoicesCannot create recurrence from a deleted invoice
RECURRING_NO_LINESInvoicesAt least one line must be included
RECURRING_NOT_FOUNDInvoicesRecurring invoice not found
RECURRING_START_DATE_NOT_EDITABLEInvoicesCannot modify the start date because invoices have already been generated
RECURRING_TYPE_NOT_SUPPORTEDInvoicesCannot create a recurrence from a rectificative invoice
REGIME_REQUIRES_INCOMPATIBLE_EXEMPTIONInvoicesRegime {0} requires exemption reason {1}; the line does not carry it
REGIME_REQUIRES_SURCHARGEInvoicesRegime {0} requires recargo de equivalencia and the line does not carry it
REGISTRO_NOT_FOUNDVeriFactuVeriFactu registration record not found
REVERT_ONLY_FROM_SENTInvoicesCan only revert from SENT status. Current status: {0}
SCHEDULED_DATE_IN_PASTInvoicesThe scheduling date cannot be in the past
SCHEDULED_DATE_REQUIREDInvoicesThe scheduling date is required
SCOPE_ESCALATIONCompaniesChild API key cannot have more scopes than the parent key
SERIES_CODE_DUPLICATEDAccount settingsA series with code ''{0}'' already exists in environment {1}. Choose a different code or delete the existing series before creating a new one.
SERIES_CODIGO_LOCKED_HAS_INVOICESAccount settingsCannot modify the series code because it has associated invoices. This would affect numbering integrity.
SERIES_DEFAULT_NOT_FOUNDAccount settingsYou have no default invoice series. Create a series in settings before issuing invoices.
SERIES_DOCUMENT_TYPE_INCOMPATIBLEInvoicesSeries ''{0}'' (type {1}) is not compatible with invoices of type {2}
SERIES_FORMAT_EMPTYInvoicesThe format cannot be empty
SERIES_FORMAT_INVALID_PADDINGInvoicesInvalid padding for {NUM}: {0}
SERIES_FORMAT_LOWERCASE_VARSInvoicesLowercase variables detected: {0}. Variables must be UPPERCASE (e.g., {CODIGO}, {YYYY}, {MM}, {NUM})
SERIES_FORMAT_NUM_REQUIREDInvoicesVariable {NUM} is required in the format. Sequential numbering is required by law
SERIES_FORMAT_UNRECOGNIZED_VARSInvoicesUnrecognized variables: {0}. Valid variables: {CODIGO}, {YYYY}, {YY}, {MM}, {NUM}, {NUM:X}
SERIES_FORMATO_LOCKED_HAS_INVOICESAccount settingsCannot modify the series format because it has associated invoices. This would affect numbering integrity.
SERIES_INACTIVEInvoicesThe invoice series ''{0}'' is inactive
SERIES_INCOMPATIBLE_DOC_TYPEAccount settingsThe selected series is not compatible with this document type. Please select a series of the correct type.
SERIES_NOT_FOUNDAccount settingsInvoice series not found
SERIES_NOT_FOUNDInvoicesInvoice series ''{0}'' not found
SERIES_NUMERO_INICIAL_LOCKED_HAS_INVOICESAccount settingsCannot modify the initial number because the series has associated invoices. This would affect numbering integrity.
SERIES_RESETEO_LOCKED_HAS_INVOICESAccount settingsCannot modify the counter reset policy because the series has associated invoices. This would affect numbering integrity.
SIMPLIFICADA_FORBIDS_CROSS_BORDERInvoicesSimplified invoices cannot cover intra-EU or OSS operations: identify the recipient and issue an ordinary invoice
SIMPLIFICADA_FORBIDS_IRPFInvoicesSimplified invoices cannot carry IRPF withholding (AEAT: retention must not be reported)
SIMPLIFICADA_FORBIDS_ISPInvoicesSimplified invoices cannot carry reverse-charge: the anonymous recipient cannot auto-liquidate
STATUS_NOT_DELETABLEInvoicesCannot delete an invoice in status {0}
STATUS_NOT_IMPLEMENTEDInvoicesStatus ''{0}'' is not implemented
STATUS_NOT_MODIFIABLEInvoicesThe invoice status cannot be modified
STORAGE_URL_EMPTYGeneralStorage URL cannot be empty
STREET_EMPTYCustomersStreet cannot be empty
STREET_MAX_LENGTHCustomersStreet cannot exceed {0} characters
SUBSCRIPTION_NOT_FOUNDWebhooksWebhook subscription not found
SURCHARGE_REQUIRES_REGIMEInvoicesRecargo de equivalencia is only compatible with regime 18; the line is on regime {0}
SWIFT_INVALIDGeneralInvalid SWIFT code: ''{0}''. Must be 8 or 11 characters (e.g.: ABCDESMMXXX)
TEMPLATE_MISSING_REQUIRED_VARIABLEInvoicesTemplate requires variable: {0}
TEMPLATE_UNKNOWN_VARIABLEInvoicesTemplate contains unknown variable: {0}
TOO_MANY_RECORDSCustomersToo many records: {0} (maximum: {1})
TOO_MANY_REQUESTSGeneralYou have exceeded the request limit. Please try again in {0} seconds
TRANSITION_NOT_SUPPORTEDInvoicesTransition to status {0} is not supported
TYPE_CHANGE_CORRECTIVE_FORBIDDENInvoicesCannot change type to/from CORRECTIVE
TYPE_REQUIREDInvoicesInvoice type is required
UNAUTHORIZEDAuthenticationAuthentication is required to access this resource
USER_NOT_FOUNDCompaniesUser not found
UUID_BLANKVeriFactuThe VeriFactu UUID cannot be null or empty
UUID_INVALID_FORMATVeriFactuThe VeriFactu UUID format is invalid: {0}
UUID_NULLVeriFactuThe VeriFactu UUID cannot be null
ZIP_GENERATION_ERRORInvoicesError generating ZIP file

Overview

Browse every error code the BeeL. API can return, organised by domain. Every error response includes a stable type URI pointing to its page here.

Account settings errors

All error codes returned by the Account settings endpoints (13 total).

On this page

Codes as a copy/paste listFull table