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. 363 codes across 16 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.
ACCOUNT_HAS_NO_HOLDER
ACCOUNT_MANAGEMENT_FORBIDDEN
ACCOUNT_NOT_ACCESSIBLE
ACCOUNT_REQUIRES_FOCUS_SWITCH
ACTIVE_CANNOT_DELETE
ACTIVE_COMPANY_HEADER_INVALID
ACTIVE_COMPANY_NOT_ACCESSIBLE
ACTIVE_COMPANY_REQUIRED
ALREADY_DISABLED
ALREADY_ENABLED
ALREADY_REGISTERED
ALTERNATIVE_ID_AND_NIF_EXCLUSIVE
ALTERNATIVE_ID_INVALID
ALTERNATIVE_ID_REQUIRES_SPAIN
ALTERNATIVE_ID_SPAIN_INVALID_TYPE
API_COMMUNICATION_ERROR
API_KEY_COLLISION
API_KEY_INVALID
API_KEY_LIVE_NOT_AVAILABLE
API_KEY_NOT_CONFIGURED
API_KEY_PREFIX_COLLISION
APPLY_BY_DEFAULT_REQUIRES_ENABLED
ATTACH_SOURCE_INVOICE_UNAVAILABLE
ATTACH_SOURCE_INVOICES_NO_SOURCES
ATTACH_SOURCE_INVOICES_REQUIRES_PDF
ATTACH_SOURCE_PDF_MISSING
ATTACH_SOURCE_ZIP_TOO_LARGE
AUTOMATIC_EMAIL_CONFIG_INVALID
BILLING_MANAGED_BY_PROVIDER
BULK_PDF_ERROR
BULK_VALIDATION_ERROR
CANCELLATION_VIA_SPECIFIC_ENDPOINT
CANNOT_DELETE_PRIMARY
CANNOT_DUPLICATE_DELETED_INVOICE
CANNOT_SIGN_CANCELLED
CANNOT_UPDATE_FINAL_STATE
CHECKOUT_REQUIRED
CHECKOUT_URLS_REQUIRED
CITY_EMPTY
CITY_MAX_LENGTH
CLAIM_TOKEN_HOLDER_MISMATCH
CLIENT_DUPLICATE
CLIENT_HAS_INVOICES
CLIENT_NOT_FOUND
COMPANY_ACCESS_REVOKED
COMPANY_ACTIVE_IN_PRODUCTION
COMPANY_HAS_INVOICES
COMPANY_NIF_MISSING
COMPANY_NOT_ACTIVATED
COMPANY_NOT_ACTIVATED_IN_ENVIRONMENT
COMPANY_NOT_FOUND
COMPANY_READ_ONLY
CONFIG_NOT_FOUND
CONFIGURATION_INVALID
CONNECTION_NOT_FOUND
CONVERSION_REQUIRES_PROFORMA
CORRECTIVE_INVOICE_INCOMPLETE
CORRECTIVE_NOT_RECTIFIABLE
COUNTRY_EMPTY
COUNTRY_MAX_LENGTH
CSV_FILE_TOO_LARGE
CUSTOMER_IDENTIFIER_REQUIRED
DEFAULT_CANNOT_BE_UNMARKED
DEFAULT_CANNOT_DEACTIVATE
DEFAULT_CANNOT_DELETE
DELETION_FAILED
DELIVERY_LOG_NOT_FOUND
DIRECCION_FISCAL_REQUIRED
DISPLAY_NAME_BLANK
DOCUMENT_ALREADY_CANCELLED
DUE_DATE_BEFORE_ISSUE_DATE
DUPLICATE_HEADER
EMISSION_NOT_READY
EMPTY_FILE
ENCODING_ERROR
ENV_MISMATCH
ENVIO_NO_PERMITIDO
ENVIRONMENT_ESCALATION
ENVIRONMENT_HEADER_INVALID
EVENT_INVALID_STATUS_FOR_DRAFT
EVENT_INVALID_STATUS_FOR_RETRY
EVENT_MAX_RETRIES_EXCEEDED
EVENT_NOT_FOUND
EVENT_SOURCE_PAYLOAD_UNAVAILABLE
EXEMPT_ZERO_RATE_REQUIRES_REASON
EXEMPTION_REASON_NOT_ALLOWED_AS_DEFAULT
EXEMPTION_REASON_REQUIRES_ZERO_RATE
EXEMPTION_REASON_TEXT_REQUIRED
EXEMPTION_REGIME_NOT_SUPPORTED_IN_VERIFACTU
EXEMPTION_REQUIRES_RECIPIENT_ID_TYPE
FACTURA_ALREADY_REGISTERED
FEATURE_NOT_AVAILABLE
FIELD_BLANK
FILE_CORRUPTED
FILE_EMPTY
FILE_TOO_LARGE
FISCAL_IDENTITY_LIVE_ONLY
FORBIDDEN
GRANT_ACCESS_LEVEL_INVALID
GRANT_COMPANY_NOT_IN_ACCOUNT
GRANT_NOT_FOUND
GRANTS_ONLY_FOR_MEMBER
HAS_INVOICES_CANNOT_DELETE
HEADER_ROW_NOT_FOUND
IBAN_INVALID
IBAN_REQUIRED
INACTIVE_CANNOT_BE_DEFAULT
INSUFFICIENT_SCOPE
INVALID_CONTENT
INVALID_CSV_FORMAT
INVALID_DIMENSIONS
INVALID_EMAIL_FORMAT
INVALID_EXCEL_FORMAT
INVALID_EXCEL_STRUCTURE
INVALID_EXTENSION
INVALID_FILE_TYPE
INVALID_FORMAT
INVALID_IBAN
INVALID_IRPF
INVALID_IVA_SURCHARGE_PAIR
INVALID_LINE
INVALID_PERCENTAGE
INVALID_REGIME_KEY_FOR_TAX_TYPE
INVALID_SURCHARGE
INVALID_TAX
INVALID_TOKEN
INVALID_VAT
INVITATION_NOT_FOUND
INVOICE_ALREADY_VOIDED
INVOICE_AXIS_MISSING
INVOICE_CLIENT_NOT_FOUND
INVOICE_COLLECTION_NOT_SUPPORTED
INVOICE_COMPANY_MISMATCH
INVOICE_DUPLICATE_EXTERNAL_REFERENCE
INVOICE_EXCEEDS_SIMPLIFIED_LIMIT_NO_NIF
INVOICE_EXCEEDS_SIMPLIFIED_LIMIT_WITH_NIF
INVOICE_NO_LINES
INVOICE_NO_NUMBER
INVOICE_NOT_CORRECTIBLE_IN_CURRENT_STATUS
INVOICE_NOT_EMITIDA
INVOICE_NOT_FOUND
INVOICE_NOT_SCHEDULED
INVOICE_REQUIRES_AT_LEAST_ONE_NORMAL_LINE
INVOICE_SERIES_NOT_FOUND
INVOICE_STATUS_NOT_SCHEDULABLE
INVOICE_VERIFACTU_DISABLED
IRPF_REQUIRED_WHEN_NOT_EXEMPT
ISP_INCOMPATIBLE_WITH_SURCHARGE
ISSUE_DATE_IN_FUTURE
ISSUE_DATE_REQUIRED
LAST_OWNER_PROTECTED
LINE_DECLARED_TOTAL_FORBIDS_DISCOUNT
LINE_EXEMPTION_TEXT_REQUIRED
LINE_EXEMPTION_WITH_TAX
LINE_INVALID_DISCOUNT
LINE_INVALID_QUANTITY
LINE_MAIN_TAX_REQUIRED
LINE_NEGATIVE_PRICE
LINE_NORMAL_DESCRIPTION_REQUIRED
LINE_SUPLIDO_MUST_HAVE_NO_IRPF
LINE_SUPLIDO_MUST_HAVE_NO_RECARGO
LINE_SUPLIDO_MUST_HAVE_NO_TAX
LINE_SUPLIDO_PRICE_REQUIRED
LINE_SUPLIDO_QUANTITY_REQUIRED
LINE_SUPLIDO_REFERENCE_REQUIRED
LINE_SUPLIDO_SOURCE_INVOICE_NOT_FOUND
LINE_SUPLIDO_SOURCE_INVOICE_NOT_ISSUED
LINE_SUPLIDO_TOO_MANY_SOURCE_ACCOUNTS
LINE_SUPLIDO_TOO_MANY_SOURCES
LINE_TOTAL_INCONSISTENT
LINE_UNIT_PRICE_XOR_DECLARED_TOTAL
LINE_ZERO_PRICE
LIVE_CREDENTIAL_REQUIRED
MAIN_TAX_REQUIRED
MANAGED_ACCOUNT_HOLDER_REQUIRED
MANAGED_SCOPE_ELEVATION_REQUIRES_OWNER
MARK_SENT_ALREADY_SENT
MARK_SENT_FROM_DRAFT_NOT_ALLOWED
MARK_SENT_FROM_INVALID_STATE
MARK_SENT_FROM_LATER_STATE
MAX_PROFILES_REACHED
MEMBER_ALREADY_IN_ACCOUNT
MEMBER_MANAGEMENT_FORBIDDEN
MEMBER_NOT_FOUND
METADATA_FILTER_TOO_MANY_KEYS
MISSING_HEADERS
MISSING_REQUIRED_FIELD
NEGATIVE_TOTAL_REQUIRES_RECTIFICATIVE
NIF_ALREADY_REGISTERED
NIF_DE_BAJA
NIF_INVALID_CONTROL_DIGIT
NIF_INVALID_FORMAT
NIF_MISMATCH
NIF_NOT_IN_CENSUS
NIF_NOT_REGISTERED
NIF_PROD_ALREADY_ACTIVE_IN_ANOTHER_ACCOUNT
NIF_REACTIVATION_FAILED
NIF_REGISTRATION_FAILED
NIF_REPRESENTATION_REQUIRED
NIF_REVOCADO
NIF_VALIDATION_ERROR
NIF_VALIDATION_INVALID
NIF_VALIDATION_PENDING
NO_DATA_ROWS
NO_INVOICES_PROVIDED
NO_PDFS_AVAILABLE
NO_UNSIGNED_DOCUMENT
NOT_BILLING_OWNER
NUMBER_EMPTY
NUMBER_MAX_LENGTH
NUMBERING_REQUIRES_ACTIVATION
ONLY_DRAFT_EMITTABLE
OPERATION_DATE_AFTER_ISSUE_DATE
OPERATION_REQUIRES_API_KEY
OPERATION_REQUIRES_SESSION
OSS_REGIME_INCOMPATIBLE_WITH_ISP
OWNER_ROLE_NOT_ASSIGNABLE
OWNER_ROLE_RESERVED
PAID_PLAN_REQUIRED
PARSING_ERROR
PAYMENT_DATE_REQUIRED
PAYMENT_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
PERCENTAGE_OUT_OF_RANGE
PHYSICAL_PERSON_CANNOT_HAVE_LEGAL_FORM
PHYSICAL_PERSON_CANNOT_HAVE_REPRESENTATIVE
PLAN_ACTIVATION_REQUIRED
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
PRODUCTION_ACCESS_DENIED
PRODUCTION_TWIN_SOURCE_ALREADY_PRODUCTION
PROFILE_DUPLICATED
PROFILE_INCOMPLETE
PROFILE_NOT_FOUND
PROFILE_NOT_OWNED
PROFORMA_ALREADY_CONVERTED
PROFORMA_CORRECTIVE_FORBIDDEN
PROFORMA_NOT_CONVERTIBLE
PROFORMA_NOT_ISSUABLE
PROFORMA_NOT_RECURRING
PROFORMA_OVERDUE_FORBIDDEN
PROFORMA_PAYMENT_FORBIDDEN
PROFORMA_RECIPIENT_REQUIRED
PROFORMA_SCHEDULE_FORBIDDEN
PROFORMA_TRANSITION_FORBIDDEN
PROFORMA_TYPE_CHANGE_FORBIDDEN
PROVIDER_NOT_SUPPORTED
PROVINCE_EMPTY
PROVINCE_MAX_LENGTH
PROVISIONING_ACCOUNT_CLAIMED
PROVISIONING_ACCOUNT_NOT_ACCESSIBLE
PROVISIONING_EMAIL_ALREADY_REGISTERED
PROVISIONING_EXTERNAL_REF_CONFLICT
QUOTA_EXCEEDED
RECARGO_EQUIVALENCIA_REQUIRED
RECARGO_REQUIRES_REGIME_RE
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_ALREADY_ENDED
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
REFERENCED_BY_PAYMENT_CONNECTION
REGIME_REQUIRES_INCOMPATIBLE_EXEMPTION
REGIME_REQUIRES_SURCHARGE
REGISTRO_NOT_FOUND
REQUEST_LOG_INVALID_CURSOR
REQUEST_LOG_NOT_FOUND
REVERT_ONLY_FROM_SENT
SCHEDULED_DATE_IN_PAST
SCHEDULED_DATE_REQUIRED
SCOPE_ESCALATION
SERIES_ANNUAL_REQUIRES_YEAR
SERIES_CODE_DUPLICATED
SERIES_CODE_LOCKED_HAS_INVOICES
SERIES_DEFAULT_CONFLICT
SERIES_DEFAULT_NOT_FOUND
SERIES_DOCUMENT_TYPE_INCOMPATIBLE
SERIES_FORMAT_EMPTY
SERIES_FORMAT_INVALID_PADDING
SERIES_FORMAT_LOCKED_HAS_INVOICES
SERIES_FORMAT_LOWERCASE_VARS
SERIES_FORMAT_NUM_REQUIRED
SERIES_FORMAT_UNRECOGNIZED_VARS
SERIES_INACTIVE
SERIES_INCOMPATIBLE_DOC_TYPE
SERIES_INITIAL_NUMBER_LOCKED_HAS_INVOICES
SERIES_INITIAL_NUMBER_OUT_OF_RANGE
SERIES_MONTHLY_REQUIRES_MONTH_AND_YEAR
SERIES_NOT_FOUND
SERIES_NUMBER_COLLISION
SERIES_NUMBERING_FROZEN
SERIES_RESET_LOCKED_HAS_INVOICES
SERIES_TYPE_CHANGE_LEAVES_TYPE_UNCOVERED
SERVICE_UNAVAILABLE
SIGNING_ONLY_IN_LIVE
SIMPLIFICADA_FORBIDS_CROSS_BORDER
SIMPLIFICADA_FORBIDS_IRPF
SIMPLIFICADA_FORBIDS_ISP
SIMPLIFICADA_FORBIDS_SURCHARGE
STATUS_NOT_DELETABLE
STATUS_NOT_IMPLEMENTED
STATUS_NOT_MODIFIABLE
STORAGE_URL_EMPTY
STREET_EMPTY
STREET_MAX_LENGTH
SUBACCOUNT_PROFILE_NOT_FOUND
SUBACCOUNT_USER_NOT_FOUND
SUBMISSION_IN_PROGRESS
SURCHARGE_REQUIRES_REGIME
SWIFT_INVALID
TAX_CONFIG_CONFLICT
TEMPLATE_MISSING_REQUIRED_VARIABLE
TEMPLATE_UNKNOWN_VARIABLE
TOO_MANY_RECORDS
TOO_MANY_REQUESTS
TRANSFER_TARGET_ALREADY_OWNER
TRANSITION_NOT_SUPPORTED
TYPE_CHANGE_CORRECTIVE_FORBIDDEN
TYPE_REQUIRED
UNAUTHORIZED
URL_MUST_BE_HTTPS
URL_TARGET_NOT_ALLOWED
UUID_BLANK
UUID_INVALID_FORMAT
UUID_NULL
VALUE_OUT_OF_RANGE
VERIFACTU_PROFILE_NOT_FOUND
VERIFACTU_REPRESENTATION_NOT_SIGNED
WEBHOOK_REACTIVATION_REQUIRES_LIVE_ENDPOINT
WEBHOOK_SUBSCRIPTION_NOT_FOUND
WEBHOOK_URL_INVALID
ZERO_RATE_REQUIRES_EXEMPTION_REASON
ZIP_GENERATION_ERRORFull table
| Code | Category | English message |
|---|---|---|
ACCOUNT_HAS_NO_HOLDER | Companies | The target account has no registered holder yet, so a NIF cannot be created on its behalf |
ACCOUNT_MANAGEMENT_FORBIDDEN | Authentication | Only the owner or an admin can manage account settings. |
ACCOUNT_NOT_ACCESSIBLE | Authentication | You do not have access to that account |
ACCOUNT_REQUIRES_FOCUS_SWITCH | Authentication | You are a member of that account, but it is not your active account right now. Switch your active account and try again. |
ACTIVE_CANNOT_DELETE | Account settings | Cannot delete an active series. Deactivate it first |
ACTIVE_COMPANY_HEADER_INVALID | Authentication | Header ''{0}'' must contain a company identifier (UUID). |
ACTIVE_COMPANY_NOT_ACCESSIBLE | Authentication | The selected company does not belong to your account |
ACTIVE_COMPANY_REQUIRED | Authentication | Select an active company (NIF) for this operation |
ALREADY_DISABLED | VeriFactu | VeriFactu is already disabled for this user |
ALREADY_ENABLED | VeriFactu | VeriFactu is already enabled for this user |
ALREADY_REGISTERED | VeriFactu | The NIF is already registered in VeriFactu |
ALTERNATIVE_ID_AND_NIF_EXCLUSIVE | Customers | The customer cannot carry both a NIF and an alternative identifier. Use only one |
ALTERNATIVE_ID_INVALID | Customers | The alternative identifier is not valid |
ALTERNATIVE_ID_REQUIRES_SPAIN | Customers | Type NOT_REGISTERED (07) is only valid for Spain; received country: ''{0}'' |
ALTERNATIVE_ID_SPAIN_INVALID_TYPE | Customers | For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed |
API_COMMUNICATION_ERROR | VeriFactu | Error communicating with the VeriFactu API |
API_KEY_COLLISION | Authentication | API key collision detected. Please try again |
API_KEY_INVALID | Authentication | The API key is invalid or has expired |
API_KEY_LIVE_NOT_AVAILABLE | Authentication | This is a live API key, but your account does not have live mode available yet. |
API_KEY_NOT_CONFIGURED | VeriFactu | The VeriFactu API key has not been configured |
API_KEY_PREFIX_COLLISION | Authentication | API key prefix collision detected. Please try again |
APPLY_BY_DEFAULT_REQUIRES_ENABLED | VeriFactu | apply_by_default can only be true when enabled is also true |
ATTACH_SOURCE_INVOICE_UNAVAILABLE | Invoices | 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 | Invoices | The invoice has no consolidation disbursements: there are no source invoices to attach |
ATTACH_SOURCE_INVOICES_REQUIRES_PDF | Invoices | Attaching the source invoices also requires attaching the invoice PDF |
ATTACH_SOURCE_PDF_MISSING | Invoices | These source invoices have no generated PDF: {0} |
ATTACH_SOURCE_ZIP_TOO_LARGE | Invoices | The source invoices ZIP ({0} MB) exceeds the maximum sendable size ({1} MB) |
AUTOMATIC_EMAIL_CONFIG_INVALID | General | For automatic sending, you must provide an email configuration or a client with email |
BILLING_MANAGED_BY_PROVIDER | Subscriptions | This account's subscription is managed by your provider; you cannot change it here. |
BULK_PDF_ERROR | Invoices | Error processing bulk PDF download |
BULK_VALIDATION_ERROR | Customers | One or more customers in the batch are invalid; none were created |
CANCELLATION_VIA_SPECIFIC_ENDPOINT | Invoices | To cancel an invoice use the specific cancellation endpoint |
CANNOT_DELETE_PRIMARY | Companies | Cannot delete the primary account through this endpoint |
CANNOT_DUPLICATE_DELETED_INVOICE | Invoices | Cannot duplicate a deleted invoice |
CANNOT_SIGN_CANCELLED | VeriFactu | Cannot sign a cancelled document |
CANNOT_UPDATE_FINAL_STATE | VeriFactu | A VeriFactu record in a final state cannot be updated: {0} |
CHECKOUT_REQUIRED | Companies | A payment method is required to create a production company |
CHECKOUT_URLS_REQUIRED | Subscriptions | success_url and cancel_url are required to set up billing |
CITY_EMPTY | Customers | City cannot be empty |
CITY_MAX_LENGTH | Customers | City cannot exceed {0} characters |
CLAIM_TOKEN_HOLDER_MISMATCH | Accounts | That account already has a holder with a different email. Omit the field to re-issue the link to them. |
CLIENT_DUPLICATE | Customers | A client with this NIF already exists |
CLIENT_HAS_INVOICES | Customers | 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 | Customers | Client not found |
COMPANY_ACCESS_REVOKED | Authentication | Your access to this company was revoked while the operation was running |
COMPANY_ACTIVE_IN_PRODUCTION | Companies | This company is active in Live and cannot be deleted. Deactivate it in Live first: the deactivation is scheduled, the current cycle is charged and served in full, and from its effective date you will be able to delete the company |
COMPANY_HAS_INVOICES | Companies | This company has invoices in Live and cannot be deleted. Delete its drafts and proformas first; if it has already issued invoices, the way out is to deactivate it in Live, not to delete it |
COMPANY_NIF_MISSING | VeriFactu | The issuing company has no NIF configured. Set the NIF before submitting invoices to VeriFactu |
COMPANY_NOT_ACTIVATED | Invoices | The company is not activated in this environment: it cannot issue fiscal documents |
COMPANY_NOT_ACTIVATED_IN_ENVIRONMENT | Payment integrations | This company is not activated in {0} mode. Activate it in that mode before connecting the payment provider: activation is what creates the invoice series and tax configuration that charges need |
COMPANY_NOT_FOUND | Companies | Company not found |
COMPANY_READ_ONLY | Authentication | Your role on this company is read-only; you cannot perform this action |
CONFIG_NOT_FOUND | VeriFactu | VeriFactu configuration not found |
CONFIGURATION_INVALID | General | The configuration is not valid |
CONNECTION_NOT_FOUND | Payment integrations | Payment connection not found |
CONVERSION_REQUIRES_PROFORMA | Invoices | Only a proforma invoice can be converted into an invoice; this document is not a proforma |
CORRECTIVE_INVOICE_INCOMPLETE | Invoices | A corrective invoice must declare its rectification type and VeriFactu code (R1-R5). Create the corrective invoice from the original invoice. |
CORRECTIVE_NOT_RECTIFIABLE | Invoices | A corrective invoice cannot be rectified. To fix an erroneous corrective, issue another corrective against the original invoice. |
COUNTRY_EMPTY | Customers | Country cannot be empty |
COUNTRY_MAX_LENGTH | Customers | Country cannot exceed {0} characters |
CSV_FILE_TOO_LARGE | Customers | The file is too large: {0} bytes (maximum: {1} bytes) |
CUSTOMER_IDENTIFIER_REQUIRED | Customers | Provide either a NIF or an alternative identifier. |
DEFAULT_CANNOT_BE_UNMARKED | Account settings | Cannot unmark the default series. Set another series as default first |
DEFAULT_CANNOT_DEACTIVATE | Account settings | Cannot deactivate the default series. Set another series as default first |
DEFAULT_CANNOT_DELETE | Account settings | Cannot delete the default series. Set another series as default first |
DELETION_FAILED | Invoices | Error deleting the invoice |
DELIVERY_LOG_NOT_FOUND | Webhooks | Webhook delivery log not found |
DIRECCION_FISCAL_REQUIRED | VeriFactu | Fiscal address is required to register with VeriFactu |
DISPLAY_NAME_BLANK | Accounts | The account name must not be blank. |
DOCUMENT_ALREADY_CANCELLED | VeriFactu | The document is already cancelled |
DUE_DATE_BEFORE_ISSUE_DATE | Invoices | Due date cannot be before the issue date |
DUPLICATE_HEADER | Customers | File {0} repeats column {1}: there is no way to tell which of the two counts. Leave it just once |
EMISSION_NOT_READY | Invoices | The company is not ready to issue invoices in this environment |
EMPTY_FILE | Customers | The file is empty |
ENCODING_ERROR | Customers | File encoding error: {0} |
ENV_MISMATCH | VeriFactu | API key does not match NIF environment: use a live key for production NIFs and a test key for sandbox NIFs |
ENVIO_NO_PERMITIDO | Email delivery | In the test environment you can only send to your own address. Use tags to separate sends: youremail+test1@domain.com |
ENVIRONMENT_ESCALATION | Companies | A sandbox (test) API key cannot create a production (live) API key |
ENVIRONMENT_HEADER_INVALID | Authentication | Header ''{0}'' has an invalid value. Accepted values: TEST, PROD (legacy aliases: sandbox, test, production, live) |
EVENT_INVALID_STATUS_FOR_DRAFT | Payment integrations | Cannot generate a draft from an event in status {0} |
EVENT_INVALID_STATUS_FOR_RETRY | Payment integrations | Event cannot be retried in its current status |
EVENT_MAX_RETRIES_EXCEEDED | Payment integrations | Maximum retry limit of {0} reached for this event |
EVENT_NOT_FOUND | Payment integrations | Payment event not found |
EVENT_SOURCE_PAYLOAD_UNAVAILABLE | Payment integrations | The event no longer holds the original provider data, so it cannot be reprocessed or turned into a draft |
EXEMPT_ZERO_RATE_REQUIRES_REASON | Invoices | Lines 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_REASON_NOT_ALLOWED_AS_DEFAULT | General | That reason depends on each invoice and cannot be declared as a default: choose art. 20 exemption or other |
EXEMPTION_REASON_REQUIRES_ZERO_RATE | General | An exemption reason is only compatible with a 0% tax rate |
EXEMPTION_REASON_TEXT_REQUIRED | General | Provide the text explaining the exemption when the reason is "Other" |
EXEMPTION_REGIME_NOT_SUPPORTED_IN_VERIFACTU | Invoices | The 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_TYPE | Invoices | Exemption {0} requires the recipient to carry an alternative identifier of type {1} |
FACTURA_ALREADY_REGISTERED | VeriFactu | This invoice is already registered in VeriFactu |
FEATURE_NOT_AVAILABLE | Subscriptions | The ''{0}'' feature is not available in your plan |
FIELD_BLANK | General | The field ''{0}'' cannot be empty |
FILE_CORRUPTED | General | File is damaged or corrupt |
FILE_EMPTY | General | The file is empty |
FILE_TOO_LARGE | General | File is too large. Maximum allowed size: {0} |
FISCAL_IDENTITY_LIVE_ONLY | Account settings | This company is live. In Test mode you can only change how the invoice looks (logo, colour, template and languages). Fiscal details are edited in Live mode |
FORBIDDEN | General | You do not have permission to perform this action |
GRANT_ACCESS_LEVEL_INVALID | Accounts | A grant's access level must be VIEW or OPERATE. To remove access to a company, omit it from the set. |
GRANT_COMPANY_NOT_IN_ACCOUNT | Accounts | One of the specified companies does not belong to this account. |
GRANT_NOT_FOUND | Accounts | This member has no access to that company. |
GRANTS_ONLY_FOR_MEMBER | Accounts | Per-company access can only be granted to members with the MEMBER role. |
HAS_INVOICES_CANNOT_DELETE | Account settings | Cannot delete a series that has associated invoices. Delete the invoices first |
HEADER_ROW_NOT_FOUND | Customers | No header row found in the first {1} lines of {0}. Required columns: {2}. {3} |
IBAN_INVALID | General | Invalid IBAN: ''{0}''. Must match ISO 13616 format (e.g.: ES1234567890123456789012) |
IBAN_REQUIRED | General | Payment method {0} requires an IBAN |
INACTIVE_CANNOT_BE_DEFAULT | Account settings | Cannot set an inactive series as default |
INSUFFICIENT_SCOPE | Authentication | The API key lacks the required permissions (scopes) for this operation. |
INVALID_CONTENT | General | File content is not valid |
INVALID_CSV_FORMAT | Customers | Invalid CSV file format: {0} |
INVALID_DIMENSIONS | General | Image dimensions are not valid |
INVALID_EMAIL_FORMAT | General | The email ''{0}'' has an invalid format |
INVALID_EXCEL_FORMAT | Holded import | Invalid Holded Excel file format: {0} |
INVALID_EXCEL_STRUCTURE | Holded import | The Excel file does not have the expected Holded contacts structure |
INVALID_EXTENSION | General | File extension not allowed |
INVALID_FILE_TYPE | General | File type not allowed. Accepted types: {0} |
INVALID_FORMAT | Customers | Invalid file format: {0} |
INVALID_IBAN | Account settings | The IBAN format is not valid. It must start with the country code and be 15 to 34 characters long (e.g. ES9121000418450200051332) |
INVALID_IRPF | Invoices | Invalid income tax withholding type: ''{0}''. Allowed values: {1} |
INVALID_IVA_SURCHARGE_PAIR | Invoices | Surcharge {0}% is not valid for VAT {1}%. Allowed pairs: 21↔5.2, 10↔1.4, 4↔0.5 |
INVALID_LINE | Invoices | The invoice line is not valid: {0} |
INVALID_PERCENTAGE | Invoices | Tax percentage {0}% is not valid for {1}. Valid rates: {2} |
INVALID_REGIME_KEY_FOR_TAX_TYPE | Invoices | Regime key {0} is not valid for {1}. Valid regime keys: {2} |
INVALID_SURCHARGE | Invoices | Invalid equivalence surcharge type: ''{0}''. Allowed values: {1} |
INVALID_TAX | Invoices | The tax type ''{0}'' is not valid |
INVALID_TOKEN | General | The token is invalid or has expired |
INVALID_VAT | Invoices | Invalid VAT type: ''{0}''. Allowed values: {1} |
INVITATION_NOT_FOUND | Accounts | No pending invitation with that id in this account. |
INVOICE_ALREADY_VOIDED | Invoices | This invoice is already voided; voiding cannot be repeated |
INVOICE_AXIS_MISSING | VeriFactu | The invoice has no company or environment assigned, so the NIF to register it with in VeriFactu cannot be determined |
INVOICE_CLIENT_NOT_FOUND | Invoices | Customer not found: {0} |
INVOICE_COLLECTION_NOT_SUPPORTED | Administration | Invoice/bank-transfer collection is not supported yet. Use GRANT or CHECKOUT. |
INVOICE_COMPANY_MISMATCH | VeriFactu | The VeriFactu configuration belongs to a different company than the invoice |
INVOICE_DUPLICATE_EXTERNAL_REFERENCE | Invoices | An invoice with this external reference already exists |
INVOICE_EXCEEDS_SIMPLIFIED_LIMIT_NO_NIF | Payment integrations | Amount {0}€ exceeds the {1}€ limit for simplified invoices without NIF. Configure a customer mapping with NIF for payments of this amount |
INVOICE_EXCEEDS_SIMPLIFIED_LIMIT_WITH_NIF | Payment integrations | Amount {0}€ exceeds the {1}€ limit for simplified invoices with NIF. Configure a customer with complete data for ordinary invoices |
INVOICE_NO_LINES | Invoices | The invoice must have at least one line |
INVOICE_NO_NUMBER | VeriFactu | The invoice does not have an assigned number |
INVOICE_NOT_CORRECTIBLE_IN_CURRENT_STATUS | Invoices | This invoice cannot be corrected in its current status. Only an issued, non-voided invoice can be corrected. |
INVOICE_NOT_EMITIDA | VeriFactu | The invoice must be issued before submitting to VeriFactu |
INVOICE_NOT_FOUND | Invoices | Invoice not found |
INVOICE_NOT_SCHEDULED | Invoices | The invoice is not scheduled |
INVOICE_REQUIRES_AT_LEAST_ONE_NORMAL_LINE | Invoices | The invoice must contain at least one NORMAL line (disbursements cannot be invoiced alone) |
INVOICE_SERIES_NOT_FOUND | Invoices | Invoice series ''{0}'' not found |
INVOICE_STATUS_NOT_SCHEDULABLE | Invoices | The current invoice status does not allow scheduling |
INVOICE_VERIFACTU_DISABLED | VeriFactu | VeriFactu is not enabled for this invoice |
IRPF_REQUIRED_WHEN_NOT_EXEMPT | General | The income tax withholding percentage is required when not exempt |
ISP_INCOMPATIBLE_WITH_SURCHARGE | Invoices | Reverse-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_FUTURE | Invoices | Issue date cannot be in the future. To issue an invoice on a future date, use POST /v1/invoices/{id}/schedule |
ISSUE_DATE_REQUIRED | Invoices | Issue date is required |
LAST_OWNER_PROTECTED | Accounts | You cannot leave the account without an owner: at least one OWNER must remain. |
LINE_DECLARED_TOTAL_FORBIDS_DISCOUNT | Invoices | A declared total is incompatible with an explicit discount: any discount is already included in the total |
LINE_EXEMPTION_TEXT_REQUIRED | Invoices | A descriptive text is required when the exemption reason is OTHER |
LINE_EXEMPTION_WITH_TAX | Invoices | Line has an exemption reason but the tax rate is not 0%. Current value: {0}% |
LINE_INVALID_DISCOUNT | Invoices | The discount must be between 0 and 100. Received value: {0} |
LINE_INVALID_QUANTITY | Invoices | The quantity cannot be zero or null |
LINE_MAIN_TAX_REQUIRED | Invoices | Each line must specify its main tax (main_tax). No default tax is applied. |
LINE_NEGATIVE_PRICE | Invoices | The unit price cannot be negative |
LINE_NORMAL_DESCRIPTION_REQUIRED | Invoices | Normal lines must include a description of the concept |
LINE_SUPLIDO_MUST_HAVE_NO_IRPF | Invoices | SUPLIDO lines cannot apply withholding tax (IRPF) |
LINE_SUPLIDO_MUST_HAVE_NO_RECARGO | Invoices | SUPLIDO lines cannot apply equivalence surcharge |
LINE_SUPLIDO_MUST_HAVE_NO_TAX | Invoices | SUPLIDO lines cannot apply VAT — the main tax must be 0% or empty |
LINE_SUPLIDO_PRICE_REQUIRED | Invoices | Unit price is required on SUPLIDO lines |
LINE_SUPLIDO_QUANTITY_REQUIRED | Invoices | Quantity is required on SUPLIDO lines |
LINE_SUPLIDO_REFERENCE_REQUIRED | Invoices | SUPLIDO lines must declare a reference to the original third-party invoice |
LINE_SUPLIDO_SOURCE_INVOICE_NOT_FOUND | Invoices | One of the disbursement's source invoices does not exist or does not belong to you |
LINE_SUPLIDO_SOURCE_INVOICE_NOT_ISSUED | Invoices | A disbursement's source invoices must be issued |
LINE_SUPLIDO_TOO_MANY_SOURCE_ACCOUNTS | Invoices | A disbursement line cannot consolidate invoices from that many different accounts |
LINE_SUPLIDO_TOO_MANY_SOURCES | Invoices | A disbursement line cannot consolidate that many source invoices |
LINE_TOTAL_INCONSISTENT | Invoices | Line totals do not reconcile: expected {0}€ (base + VAT + surcharge - IRPF), declared {1}€. Difference exceeds 0.01€ |
LINE_UNIT_PRICE_XOR_DECLARED_TOTAL | Invoices | The line must carry exactly one of unit_price, total_excluding_tax or total_including_tax |
LINE_ZERO_PRICE | Invoices | The unit price cannot be zero |
LIVE_CREDENTIAL_REQUIRED | Authentication | This operation changes the real account; it requires a live API key or a dashboard session. |
MAIN_TAX_REQUIRED | General | You must configure a main tax (VAT, IGIC or IPSI) |
MANAGED_ACCOUNT_HOLDER_REQUIRED | Authentication | This managed NIF has no holder yet; it must be claimed before connecting a payment provider |
MANAGED_SCOPE_ELEVATION_REQUIRES_OWNER | Authentication | Only the account holder can raise management access over their account once it has been claimed |
MARK_SENT_ALREADY_SENT | Invoices | The invoice is already in SENT status. |
MARK_SENT_FROM_DRAFT_NOT_ALLOWED | Invoices | Cannot mark an invoice in DRAFT status as SENT. Issue it first. |
MARK_SENT_FROM_INVALID_STATE | Invoices | Cannot mark as SENT from status {0}. |
MARK_SENT_FROM_LATER_STATE | Invoices | Cannot mark an invoice in {0} status as SENT. The invoice is already in a later state. |
MAX_PROFILES_REACHED | Companies | You have reached the maximum number of business profiles ({0}). Upgrade your plan for more |
MEMBER_ALREADY_IN_ACCOUNT | Accounts | That person is already a member of the account. |
MEMBER_MANAGEMENT_FORBIDDEN | Authentication | Only the owner or an admin can manage account members. |
MEMBER_NOT_FOUND | Accounts | No such member in this account. |
METADATA_FILTER_TOO_MANY_KEYS | Invoices | The metadata filter supports at most {0} key/value pairs per request |
MISSING_HEADERS | Customers | Required header not found: ''{0}''. Headers found: {1} |
MISSING_REQUIRED_FIELD | General | The field ''{0}'' is required |
NEGATIVE_TOTAL_REQUIRES_RECTIFICATIVE | Invoices | The invoice total cannot be negative. Use corrective invoices (R1-R5) for refunds. |
NIF_ALREADY_REGISTERED | Companies | The NIF is already registered |
NIF_DE_BAJA | General | The NIF ''{0}'' is deregistered in the AEAT census and cannot issue invoices |
NIF_INVALID_CONTROL_DIGIT | Customers | The control digit of NIF ''{0}'' is incorrect |
NIF_INVALID_FORMAT | Customers | The NIF ''{0}'' has an invalid format |
NIF_MISMATCH | VeriFactu | The provided NIF does not match the user's NIF |
NIF_NOT_IN_CENSUS | Customers | The NIF ''{0}'' does not exist in the AEAT census or the fiscal name does not match |
NIF_NOT_REGISTERED | VeriFactu | The NIF is not registered in VeriFactu |
NIF_PROD_ALREADY_ACTIVE_IN_ANOTHER_ACCOUNT | Companies | This NIF is already registered in production under another account. A NIF can only issue real invoices from a single account. |
NIF_REACTIVATION_FAILED | VeriFactu | Error reactivating the NIF in VeriFactu |
NIF_REGISTRATION_FAILED | VeriFactu | Error registering the NIF in VeriFactu |
NIF_REPRESENTATION_REQUIRED | VeriFactu | You must sign the AEAT representation model before issuing real invoices with this NIF |
NIF_REVOCADO | General | The NIF ''{0}'' has been revoked by the AEAT and cannot operate |
NIF_VALIDATION_ERROR | VeriFactu | Technical error validating the NIF against the AEAT census |
NIF_VALIDATION_INVALID | VeriFactu | The NIF does not exist in the AEAT census |
NIF_VALIDATION_PENDING | VeriFactu | The NIF is pending validation against the AEAT census |
NO_DATA_ROWS | Customers | File {0} carries only the header row: there is no data row to import |
NO_INVOICES_PROVIDED | Invoices | No invoices provided |
NO_PDFS_AVAILABLE | Invoices | No PDFs available for download |
NO_UNSIGNED_DOCUMENT | VeriFactu | No unsigned representation document exists. Generate one before uploading the signed PDF |
NOT_BILLING_OWNER | Subscriptions | Only the account owner can manage the subscription and billing. |
NUMBER_EMPTY | Customers | Number cannot be empty |
NUMBER_MAX_LENGTH | Customers | Number cannot exceed {0} characters |
NUMBERING_REQUIRES_ACTIVATION | Companies | Series numbering can only be configured in a creation request that activates the company. Remove the numbering block or activate a mode (activate:true) |
ONLY_DRAFT_EMITTABLE | Invoices | Only draft invoices can be issued. Current status: {0} |
OPERATION_DATE_AFTER_ISSUE_DATE | Invoices | Operation date cannot be after the issue date |
OPERATION_REQUIRES_API_KEY | Authentication | This operation is privileged and only available with an API key holding the matching scope (e.g. accounts:write); it cannot be performed from the web session. |
OPERATION_REQUIRES_SESSION | Authentication | This operation is only available from the web session; it cannot be performed with an API key or OAuth. |
OSS_REGIME_INCOMPATIBLE_WITH_ISP | Invoices | OSS/IOSS regime (key 17) is incompatible with reverse charge. The destination-country VAT is declared separately (Modelo 369), not as S2 |
OWNER_ROLE_NOT_ASSIGNABLE | Accounts | The OWNER role cannot be assigned: account ownership is only handed over through transfer-ownership. |
OWNER_ROLE_RESERVED | Authentication | Only an owner can assign or transfer the owner role. |
PAID_PLAN_REQUIRED | Subscriptions | This feature is only available on paid plans. Upgrade your plan to use it |
PARSING_ERROR | Customers | Error processing the file: {0} |
PAYMENT_DATE_REQUIRED | Invoices | Payment date is required to mark the invoice as paid |
PAYMENT_REQUIRED | Companies | You have an outstanding payment. Settle it to keep operating in production |
PDF_EMPTY | VeriFactu | The PDF file is empty |
PDF_HASH_ERROR | Invoices | Error calculating PDF hash |
PDF_INVALID_EXTENSION | VeriFactu | The file must be a PDF (.pdf) |
PDF_INVALID_FORMAT | VeriFactu | The file does not have a valid PDF format |
PDF_NOT_GENERATED | Invoices | The invoice PDF has not been generated yet |
PDF_SIGNATURE_INVALID | VeriFactu | The signed PDF is not valid: {0} |
PDF_STORAGE_FAILED | VeriFactu | Error saving the signed PDF. Please try again |
PDF_TOO_LARGE | VeriFactu | The PDF file exceeds the maximum allowed size: {0} (maximum: {1} MB) |
PDF_URL_EMPTY | Invoices | The PDF URL is empty |
PDF_VALIDATION_FAILED | VeriFactu | Error validating the signed PDF. Please try again later |
PERCENTAGE_OUT_OF_RANGE | Invoices | The percentage {0} is not valid. It must be between 0 and 100 |
PHYSICAL_PERSON_CANNOT_HAVE_LEGAL_FORM | Account settings | Individuals cannot have a legal form |
PHYSICAL_PERSON_CANNOT_HAVE_REPRESENTATIVE | Account settings | Individuals cannot have a legal representative |
PLAN_ACTIVATION_REQUIRED | Companies | Your plan is still in its trial period. Activate it to start invoicing in production |
PLAZO_DIAS_OUT_OF_RANGE | General | Payment term must be between {0} and {1} days |
POSTAL_CODE_EMPTY | Customers | Postal code cannot be empty |
POSTAL_CODE_INVALID_ES | Customers | Invalid Spanish postal code: ''{0}''. Must be 5 digits |
PREVIEW_DRAFT_ONLY | Invoices | PDF preview is only available for draft invoices |
PREVIEW_GENERATION_ERROR | Invoices | Error generating PDF preview |
PRODUCT_DUPLICATE | Products | A product with code ''{0}'' already exists |
PRODUCT_INACTIVE | Products | The product ''{0}'' is inactive and cannot be used |
PRODUCT_NOT_FOUND | Products | Product not found: {0} |
PRODUCTION_ACCESS_DENIED | VeriFactu | You cannot issue real invoices with this NIF yet: activate a production plan before crossing to VeriFactu production |
PRODUCTION_TWIN_SOURCE_ALREADY_PRODUCTION | Companies | The source company is already in production; cannot create a twin |
PROFILE_DUPLICATED | Account settings | Your account has more than one profile and we cannot tell which one to use. Contact us and we will sort it out. |
PROFILE_INCOMPLETE | Account settings | Your tax profile is incomplete. Complete the required data before issuing invoices |
PROFILE_NOT_FOUND | Account settings | User profile not found |
PROFILE_NOT_OWNED | Companies | The business profile does not belong to your account |
PROFORMA_ALREADY_CONVERTED | Invoices | This proforma has already been converted into an invoice; conversion cannot be repeated |
PROFORMA_CORRECTIVE_FORBIDDEN | Invoices | A proforma invoice cannot be corrected; it is not a fiscal document |
PROFORMA_NOT_CONVERTIBLE | Invoices | A proforma can only be converted while it is active; its current status ({0}) does not allow it |
PROFORMA_NOT_ISSUABLE | Invoices | A proforma invoice is not issued: it is born active and becomes an invoice when the customer accepts it |
PROFORMA_NOT_RECURRING | Invoices | A proforma invoice cannot be recurring; a quote is a one-off offer, not a subscription |
PROFORMA_OVERDUE_FORBIDDEN | Invoices | A proforma invoice never becomes overdue; its validity date is informational |
PROFORMA_PAYMENT_FORBIDDEN | Invoices | A proforma invoice cannot be marked as paid; it is not part of the payment cycle |
PROFORMA_RECIPIENT_REQUIRED | Invoices | A proforma invoice requires a recipient (customer or complete recipient data) |
PROFORMA_SCHEDULE_FORBIDDEN | Invoices | A proforma invoice cannot be scheduled; scheduling is a fiscal issuance flow |
PROFORMA_TRANSITION_FORBIDDEN | Invoices | A proforma invoice can only be active, converted or voided; that status change belongs to the fiscal cycle |
PROFORMA_TYPE_CHANGE_FORBIDDEN | Invoices | Cannot change type to/from PROFORMA; use the conversion flow |
PROVIDER_NOT_SUPPORTED | Payment integrations | Payment provider ''{0}'' not supported |
PROVINCE_EMPTY | Customers | Province cannot be empty |
PROVINCE_MAX_LENGTH | Customers | Province cannot exceed {0} characters |
PROVISIONING_ACCOUNT_CLAIMED | Accounts | Management of that account ended and its holder has already claimed it: only they can grant you access again from their account. |
PROVISIONING_ACCOUNT_NOT_ACCESSIBLE | Accounts | That account is not managed by your organisation. |
PROVISIONING_EMAIL_ALREADY_REGISTERED | Accounts | That email already has a Beel account. Use a different email, or ask the owner to grant you access from their account. |
PROVISIONING_EXTERNAL_REF_CONFLICT | Accounts | An account with that external reference already exists; retry the request and the existing account will be returned. |
QUOTA_EXCEEDED | Subscriptions | You have exceeded your ''{0}'' limit: {1}/{2} used. Resets on {3} |
RECARGO_EQUIVALENCIA_REQUIRED | General | The equivalence surcharge is required for this type of operation |
RECARGO_REQUIRES_REGIME_RE | General | When equivalence surcharge is enabled, the main tax regime must be "18 - Equivalence surcharge". Change the regime to 18 or disable the surcharge. |
RECIPIENT_ADDRESS_REQUIRED | Invoices | Recipient address is required for standard invoices |
RECIPIENT_FISCAL_NAME_REQUIRED | Invoices | Recipient legal name is required for standard invoices |
RECIPIENT_ID_REQUIRED | Invoices | Recipient must have a NIF or alternative identifier |
RECIPIENT_NIF_AND_ID_OTHER_EXCLUSIVE | Invoices | The recipient cannot carry both a Spanish NIF and an alternative identifier. Use only one |
RECIPIENT_REQUIRED_FOR_ORDINARY | Invoices | Ordinary invoices require a valid recipient |
RECTIFICATION_REASON_TOO_SHORT | Invoices | The rectification reason must be at least {0} characters |
RECTIFICATIVA_NO_CODE | VeriFactu | The credit note must have a correction code |
RECTIFICATIVA_NO_ORIGINAL | VeriFactu | The credit note must reference an original invoice |
RECTIFICATIVA_PARCIAL_SIN_LINEAS | Invoices | Partial rectificative invoices must include correction lines. Use negative quantities/amounts to subtract, positive to add. |
RECTIFICATIVA_R1R4_NOT_SIMPLIFICADA | VeriFactu | The R1-R4 correction methods do not apply to simplified invoices |
RECTIFICATIVA_R5_ONLY_SIMPLIFICADA | VeriFactu | The R5 correction method only applies to simplified invoices |
RECTIFICATIVA_TOTAL_CON_LINEAS | Invoices | Total rectificative invoices must not include lines. Lines are automatically copied from the original invoice with negative amounts. |
RECURRING_ALREADY_ENDED | Invoices | The recurrence has already reached its end date and cannot generate more invoices |
RECURRING_END_DATE_BEFORE_START | Invoices | The end date must be after the first scheduled generation ({0}) |
RECURRING_INVALID_DAY_OF_MONTH | Invoices | The day of the month must be between 1 and 31 |
RECURRING_INVOICE_DELETED | Invoices | Cannot create recurrence from a deleted invoice |
RECURRING_NO_LINES | Invoices | At least one line must be included |
RECURRING_NOT_FOUND | Invoices | Recurring invoice not found |
RECURRING_START_DATE_NOT_EDITABLE | Invoices | Cannot modify the start date because invoices have already been generated |
RECURRING_TYPE_NOT_SUPPORTED | Invoices | Cannot create a recurrence from a rectificative invoice |
REFERENCED_BY_PAYMENT_CONNECTION | Account settings | Cannot delete or deactivate the series: it is configured in a payment connection. Remove it from the connection settings first or choose another series there |
REGIME_REQUIRES_INCOMPATIBLE_EXEMPTION | Invoices | Regime {0} requires exemption reason {1}; the line does not carry it |
REGIME_REQUIRES_SURCHARGE | Invoices | Regime {0} requires recargo de equivalencia and the line does not carry it |
REGISTRO_NOT_FOUND | VeriFactu | VeriFactu registration record not found |
REQUEST_LOG_INVALID_CURSOR | API Logs | Invalid pagination cursor |
REQUEST_LOG_NOT_FOUND | API Logs | Request log not found |
REVERT_ONLY_FROM_SENT | Invoices | Can only revert from SENT status. Current status: {0} |
SCHEDULED_DATE_IN_PAST | Invoices | The scheduling date cannot be in the past |
SCHEDULED_DATE_REQUIRED | Invoices | The scheduling date is required |
SCOPE_ESCALATION | Companies | Child API key cannot have more scopes than the parent key |
SERIES_ANNUAL_REQUIRES_YEAR | Account settings | Annual reset requires the format to include the year ({YYYY} or {YY}); otherwise the invoice number would repeat every year. |
SERIES_CODE_DUPLICATED | Account settings | The code ''{0}'' is already taken by a series, existing or deleted. Series codes are never reused: they identify invoices already issued. Choose a different code. |
SERIES_CODE_LOCKED_HAS_INVOICES | Account settings | Cannot modify the series code because it has associated invoices. This would affect numbering integrity. |
SERIES_DEFAULT_CONFLICT | Account settings | Another operation changed the default series for this document type at the same time. Please try again. |
SERIES_DEFAULT_NOT_FOUND | Account settings | You have no default invoice series. Create a series in settings before issuing invoices. |
SERIES_DOCUMENT_TYPE_INCOMPATIBLE | Invoices | Series ''{0}'' (type {1}) is not compatible with invoices of type {2} |
SERIES_FORMAT_EMPTY | Invoices | The format cannot be empty |
SERIES_FORMAT_INVALID_PADDING | Invoices | Invalid padding for {NUM}: {0} |
SERIES_FORMAT_LOCKED_HAS_INVOICES | Account settings | Cannot modify the series format because it has associated invoices. This would affect numbering integrity. |
SERIES_FORMAT_LOWERCASE_VARS | Invoices | Lowercase variables detected: {0}. Variables must be UPPERCASE (e.g., '{CODIGO}', '{YYYY}', '{MM}', '{NUM}') |
SERIES_FORMAT_NUM_REQUIRED | Invoices | Variable {NUM} is required in the format. Sequential numbering is required by law |
SERIES_FORMAT_UNRECOGNIZED_VARS | Invoices | Unrecognized variables: {0}. Valid variables: '{CODIGO}', '{YYYY}', '{YY}', '{MM}', '{NUM}', '{NUM:X}' |
SERIES_INACTIVE | Invoices | The invoice series ''{0}'' is inactive |
SERIES_INCOMPATIBLE_DOC_TYPE | Account settings | The selected series is not compatible with this document type. Please select a series of the correct type. |
SERIES_INITIAL_NUMBER_LOCKED_HAS_INVOICES | Account settings | Cannot modify the initial number because the series has associated invoices. This would affect numbering integrity. |
SERIES_INITIAL_NUMBER_OUT_OF_RANGE | Account settings | The initial number must be between 1 and 999999 |
SERIES_MONTHLY_REQUIRES_MONTH_AND_YEAR | Account settings | Monthly reset requires the format to include the month ({MM}) and the year ({YYYY} or {YY}); otherwise the invoice number would repeat every month. |
SERIES_NOT_FOUND | Account settings | Invoice series not found |
SERIES_NUMBER_COLLISION | Invoices | The number assigned by the series is already in use. Please contact support: the series numbering needs review |
SERIES_NUMBERING_FROZEN | Account settings | This series has already assigned invoice numbers: its code, format, reset policy and initial number cannot be modified. |
SERIES_RESET_LOCKED_HAS_INVOICES | Account settings | Cannot modify the counter reset policy because the series has associated invoices. This would affect numbering integrity. |
SERIES_TYPE_CHANGE_LEAVES_TYPE_UNCOVERED | Account settings | Cannot change the type of this series: it is the default for {0}, and that type still has other active series that would be left without a default. Set another {0} series as default first |
SERVICE_UNAVAILABLE | General | The service is temporarily unavailable. Please try again in a few seconds. |
SIGNING_ONLY_IN_LIVE | VeriFactu | The AEAT representation can only be signed in Live mode: the document has no test mode |
SIMPLIFICADA_FORBIDS_CROSS_BORDER | Invoices | Simplified invoices cannot cover intra-EU or OSS operations: identify the recipient and issue an ordinary invoice |
SIMPLIFICADA_FORBIDS_IRPF | Invoices | Simplified invoices cannot carry IRPF withholding (AEAT: retention must not be reported) |
SIMPLIFICADA_FORBIDS_ISP | Invoices | Simplified invoices cannot carry reverse-charge: the anonymous recipient cannot auto-liquidate |
SIMPLIFICADA_FORBIDS_SURCHARGE | Invoices | Simplified invoices cannot carry recargo de equivalencia: the retailer must receive an identified ordinary (F1) invoice |
STATUS_NOT_DELETABLE | Invoices | Cannot delete an invoice in status {0} |
STATUS_NOT_IMPLEMENTED | Invoices | Status ''{0}'' is not implemented |
STATUS_NOT_MODIFIABLE | Invoices | The invoice status cannot be modified |
STORAGE_URL_EMPTY | General | Storage URL cannot be empty |
STREET_EMPTY | Customers | Street cannot be empty |
STREET_MAX_LENGTH | Customers | Street cannot exceed {0} characters |
SUBACCOUNT_PROFILE_NOT_FOUND | Companies | Business profile not found |
SUBACCOUNT_USER_NOT_FOUND | Companies | User not found |
SUBMISSION_IN_PROGRESS | VeriFactu | A submission of this invoice to VeriFactu is already in progress |
SURCHARGE_REQUIRES_REGIME | Invoices | Recargo de equivalencia is only compatible with regime 18; the line is on regime {0} |
SWIFT_INVALID | General | Invalid SWIFT code: ''{0}''. Must be 8 or 11 characters (e.g.: ABCDESMMXXX) |
TAX_CONFIG_CONFLICT | General | Another operation created the tax configuration at the same time. Please try again. |
TEMPLATE_MISSING_REQUIRED_VARIABLE | Invoices | Template requires variable: {0} |
TEMPLATE_UNKNOWN_VARIABLE | Invoices | Template contains unknown variable: {0} |
TOO_MANY_RECORDS | Customers | Too many records: {0} (maximum: {1}) |
TOO_MANY_REQUESTS | General | You have exceeded the request limit. Please try again in {0} seconds |
TRANSFER_TARGET_ALREADY_OWNER | Accounts | That member is already an owner; ownership cannot be transferred to them. |
TRANSITION_NOT_SUPPORTED | Invoices | Transition to status {0} is not supported |
TYPE_CHANGE_CORRECTIVE_FORBIDDEN | Invoices | Cannot change type to/from CORRECTIVE |
TYPE_REQUIRED | Invoices | Invoice type is required |
UNAUTHORIZED | Authentication | Authentication is required to access this resource |
URL_MUST_BE_HTTPS | Webhooks | The webhook URL must use HTTPS |
URL_TARGET_NOT_ALLOWED | Webhooks | The webhook URL points to an internal network address. Use an endpoint reachable from the internet. |
UUID_BLANK | VeriFactu | The VeriFactu UUID cannot be null or empty |
UUID_INVALID_FORMAT | VeriFactu | The VeriFactu UUID format is invalid: {0} |
UUID_NULL | VeriFactu | The VeriFactu UUID cannot be null |
VALUE_OUT_OF_RANGE | General | The value provided exceeds the range allowed for that field |
VERIFACTU_PROFILE_NOT_FOUND | VeriFactu | User profile not found |
VERIFACTU_REPRESENTATION_NOT_SIGNED | VeriFactu | You cannot enable VeriFactu on this invoice: the AEAT representation model for this NIF has not been signed yet |
WEBHOOK_REACTIVATION_REQUIRES_LIVE_ENDPOINT | Webhooks | BeeL paused this subscription. To reactivate it, the endpoint must first answer a test delivery successfully. |
WEBHOOK_SUBSCRIPTION_NOT_FOUND | Webhooks | Webhook subscription not found |
WEBHOOK_URL_INVALID | Webhooks | The webhook URL is not valid: it must include a host (for example https://mydomain.com/webhook) |
ZERO_RATE_REQUIRES_EXEMPTION_REASON | General | 0% is not a tax rate: state why the operation carries no tax (art. 20 exemption or another reason) |
ZIP_GENERATION_ERROR | Invoices | Error generating ZIP file |