# BeeL. API error codes > Every error code the API returns (522), by category. Each page says when it happens, how to fix it, its HTTP status and the rules that cite it. ## Accounts - [CLAIM_TOKEN_EMAIL_REQUIRED](https://docs.beel.es/errors/CLAIM_TOKEN_EMAIL_REQUIRED.md): The account has no holder yet and the request carries no `email`: the holder is created from it, so there is nobody to issue the claim link… - [CLAIM_TOKEN_HOLDER_MISMATCH](https://docs.beel.es/errors/CLAIM_TOKEN_HOLDER_MISMATCH.md): That account already has a holder with a different email. Omit the field to re-issue the link to them. - [DISPLAY_NAME_BLANK](https://docs.beel.es/errors/DISPLAY_NAME_BLANK.md): The account name must not be blank. - [GRANTS_ONLY_FOR_MEMBER](https://docs.beel.es/errors/GRANTS_ONLY_FOR_MEMBER.md): Per-company access can only be granted to members with the MEMBER role. - [GRANT_ACCESS_LEVEL_INVALID](https://docs.beel.es/errors/GRANT_ACCESS_LEVEL_INVALID.md): 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](https://docs.beel.es/errors/GRANT_COMPANY_NOT_IN_ACCOUNT.md): One of the specified companies does not belong to this account. - [GRANT_NOT_FOUND](https://docs.beel.es/errors/GRANT_NOT_FOUND.md): This member has no access to that company. - [INVITATION_NOT_FOUND](https://docs.beel.es/errors/INVITATION_NOT_FOUND.md): No invitation with that id in this account. - [LAST_OWNER_PROTECTED](https://docs.beel.es/errors/LAST_OWNER_PROTECTED.md): The change would leave the account without an `OWNER`: the last one cannot be demoted or removed. - [MEMBER_ALREADY_IN_ACCOUNT](https://docs.beel.es/errors/MEMBER_ALREADY_IN_ACCOUNT.md): The email already belongs to a member of this account, so there is nobody to invite. - [MEMBER_NOT_FOUND](https://docs.beel.es/errors/MEMBER_NOT_FOUND.md): No such member in this account. - [OWNER_ROLE_NOT_ASSIGNABLE](https://docs.beel.es/errors/OWNER_ROLE_NOT_ASSIGNABLE.md): The OWNER role cannot be assigned: account ownership is only handed over through transfer-ownership. - [PENDING_INVITATION_NOT_FOUND](https://docs.beel.es/errors/PENDING_INVITATION_NOT_FOUND.md): No `PENDING` invitation with that id exists in this account. An accepted, revoked or expired one answers the same way. - [PROVISIONING_ACCOUNT_CLAIMED](https://docs.beel.es/errors/PROVISIONING_ACCOUNT_CLAIMED.md): The holder has already claimed that account and it is now theirs: there is nothing left to claim, and only they can grant you further… - [PROVISIONING_ACCOUNT_NOT_ACCESSIBLE](https://docs.beel.es/errors/PROVISIONING_ACCOUNT_NOT_ACCESSIBLE.md): The account is not one you provisioned and still manage, which is also the answer when it does not exist. On the usage endpoint, any id… - [PROVISIONING_EMAIL_ALREADY_REGISTERED](https://docs.beel.es/errors/PROVISIONING_EMAIL_ALREADY_REGISTERED.md): That email is already registered with BeeL. Use a different email, or ask the owner to grant you access from their account. - [PROVISIONING_EMAIL_REQUIRED](https://docs.beel.es/errors/PROVISIONING_EMAIL_REQUIRED.md): `send_email` is `true` and the request has no `email`, so there is nobody to send the claim link to. - [PROVISIONING_EXTERNAL_REF_CONFLICT](https://docs.beel.es/errors/PROVISIONING_EXTERNAL_REF_CONFLICT.md): An account with that external reference already exists; retry the request and the existing account will be returned. - [PROVISIONING_INVALID_CURSOR](https://docs.beel.es/errors/PROVISIONING_INVALID_CURSOR.md): `cursor` is not a `next_cursor` this operation returned. - [PROVISIONING_TAX_PROFILE_REQUIRED](https://docs.beel.es/errors/PROVISIONING_TAX_PROFILE_REQUIRED.md): `access_level` is `OPERATE` and the request has no `tax_profile`. Invoicing on the account's behalf needs its NIF, so it is refused when… - [TRANSFER_TARGET_ALREADY_OWNER](https://docs.beel.es/errors/TRANSFER_TARGET_ALREADY_OWNER.md): That member is already an owner; ownership cannot be transferred to them. ## Administration - [INVOICE_COLLECTION_NOT_SUPPORTED](https://docs.beel.es/errors/INVOICE_COLLECTION_NOT_SUPPORTED.md): Invoice/bank-transfer collection is not supported yet. Use GRANT or CHECKOUT. ## Authentication - [ACCOUNT_MANAGEMENT_FORBIDDEN](https://docs.beel.es/errors/ACCOUNT_MANAGEMENT_FORBIDDEN.md): Only the owner or an admin can manage account settings. - [ACCOUNT_NOT_ACCESSIBLE](https://docs.beel.es/errors/ACCOUNT_NOT_ACCESSIBLE.md): You do not have access to that account - [ACCOUNT_REQUIRES_FOCUS_SWITCH](https://docs.beel.es/errors/ACCOUNT_REQUIRES_FOCUS_SWITCH.md): You are a member of that account, but it is not your active account right now. Switch your active account and try again. - [ACTIVE_COMPANY_HEADER_INVALID](https://docs.beel.es/errors/ACTIVE_COMPANY_HEADER_INVALID.md): Header ‹value› must contain a company identifier (UUID). - [ACTIVE_COMPANY_NOT_ACCESSIBLE](https://docs.beel.es/errors/ACTIVE_COMPANY_NOT_ACCESSIBLE.md): The selected company does not belong to your account - [ACTIVE_COMPANY_REQUIRED](https://docs.beel.es/errors/ACTIVE_COMPANY_REQUIRED.md): Select an active company (NIF) for this operation - [API_KEY_COLLISION](https://docs.beel.es/errors/API_KEY_COLLISION.md): API key collision detected. Please try again - [API_KEY_INVALID](https://docs.beel.es/errors/API_KEY_INVALID.md): The API key is invalid or has expired - [API_KEY_LIVE_NOT_AVAILABLE](https://docs.beel.es/errors/API_KEY_LIVE_NOT_AVAILABLE.md): The request uses a live API key, but the account does not have live mode available yet. - [API_KEY_PREFIX_COLLISION](https://docs.beel.es/errors/API_KEY_PREFIX_COLLISION.md): API key prefix collision detected. Please try again - [COMPANY_ACCESS_REVOKED](https://docs.beel.es/errors/COMPANY_ACCESS_REVOKED.md): Your access to this company was revoked while the operation was running - [COMPANY_READ_ONLY](https://docs.beel.es/errors/COMPANY_READ_ONLY.md): Your role on this company is read-only; you cannot perform this action - [ENVIRONMENT_HEADER_INVALID](https://docs.beel.es/errors/ENVIRONMENT_HEADER_INVALID.md): Header ‹value› has an invalid value. Accepted values: TEST, PROD (legacy aliases: sandbox, test, production, live) - [INSUFFICIENT_SCOPE](https://docs.beel.es/errors/INSUFFICIENT_SCOPE.md): The API key is valid but lacks a permission (scope) the operation needs. It can happen on any operation, and it is checked before the body… - [LIVE_CREDENTIAL_REQUIRED](https://docs.beel.es/errors/LIVE_CREDENTIAL_REQUIRED.md): The operation changes the real account (members, invitations, access to a managed account) and was called with a sandbox key. Those changes… - [MANAGED_ACCESS_INSUFFICIENT](https://docs.beel.es/errors/MANAGED_ACCESS_INSUFFICIENT.md): Management access over that account is not enough for this operation - [MANAGED_ACCOUNT_HOLDER_REQUIRED](https://docs.beel.es/errors/MANAGED_ACCOUNT_HOLDER_REQUIRED.md): This managed NIF has no holder yet; it must be claimed before connecting a payment provider - [MANAGED_SCOPE_ELEVATION_REQUIRES_OWNER](https://docs.beel.es/errors/MANAGED_SCOPE_ELEVATION_REQUIRES_OWNER.md): The holder has claimed the account, so only they can raise the access level you hold over it. You can still keep it or lower it. - [MEMBER_MANAGEMENT_FORBIDDEN](https://docs.beel.es/errors/MEMBER_MANAGEMENT_FORBIDDEN.md): Members and invitations are managed by an `OWNER` or `ADMIN` of the account. A `MEMBER`, or a provisioner acting on an account it manages… - [OPERATION_REQUIRES_API_KEY](https://docs.beel.es/errors/OPERATION_REQUIRES_API_KEY.md): This operation is privileged and only available with an API key holding the matching scope (e.g. accounts:write); it cannot be performed… - [OPERATION_REQUIRES_SESSION](https://docs.beel.es/errors/OPERATION_REQUIRES_SESSION.md): The operation is available only from a signed-in dashboard session. No API key, live or test, can perform it, whatever scopes it holds. - [OWNER_ROLE_RESERVED](https://docs.beel.es/errors/OWNER_ROLE_RESERVED.md): Only the current `OWNER` can hand the account over; an `ADMIN` cannot. - [UNAUTHORIZED](https://docs.beel.es/errors/UNAUTHORIZED.md): The request has no valid credential: the `Authorization` header is missing, or the API key in it is wrong or no longer valid (for example… ## Customers - [ALTERNATIVE_ID_AND_NIF_EXCLUSIVE](https://docs.beel.es/errors/ALTERNATIVE_ID_AND_NIF_EXCLUSIVE.md): The customer cannot carry both a NIF and an alternative identifier. Use only one - [BULK_VALIDATION_ERROR](https://docs.beel.es/errors/BULK_VALIDATION_ERROR.md): One or more customers in the batch are invalid; none were created - [CLIENT_HAS_INVOICES](https://docs.beel.es/errors/CLIENT_HAS_INVOICES.md): This customer has invoices and cannot be deleted: deleting it would release its identifier and allow another customer to be created with… - [CLIENT_DUPLICATE](https://docs.beel.es/errors/CLIENT_DUPLICATE.md): A client with this NIF already exists - [CLIENT_NOT_FOUND](https://docs.beel.es/errors/CLIENT_NOT_FOUND.md): Client not found - [CUSTOMER_IDENTIFIER_REQUIRED](https://docs.beel.es/errors/CUSTOMER_IDENTIFIER_REQUIRED.md): Provide either a NIF or an alternative identifier. - [ALTERNATIVE_ID_COUNTRY_REQUIRED](https://docs.beel.es/errors/ALTERNATIVE_ID_COUNTRY_REQUIRED.md): An `alternative_id` has no `country_code`, and its type needs one. Only `PASSPORT` and `NOT_REGISTERED` can omit it: without it they are… - [ALTERNATIVE_ID_INVALID](https://docs.beel.es/errors/ALTERNATIVE_ID_INVALID.md): The alternative identifier is not valid - [ALTERNATIVE_ID_VAT_INVALID_FORMAT](https://docs.beel.es/errors/ALTERNATIVE_ID_VAT_INVALID_FORMAT.md): An `alternative_id` of type `NIF_IVA` has a `number` without the EU VAT structure AEAT defines for its country: the country prefix (`EL`… - [ALTERNATIVE_ID_VAT_REQUIRES_EU_COUNTRY](https://docs.beel.es/errors/ALTERNATIVE_ID_VAT_REQUIRES_EU_COUNTRY.md): An `alternative_id` of type `NIF_IVA` carries a `country_code` that is not an EU Member State other than Spain. AEAT accepts an EU VAT… - [ALTERNATIVE_ID_REQUIRES_SPAIN](https://docs.beel.es/errors/ALTERNATIVE_ID_REQUIRES_SPAIN.md): Type NOT_REGISTERED (07) is only valid for Spain; received country: ‹value› - [ALTERNATIVE_ID_SPAIN_INVALID_TYPE](https://docs.beel.es/errors/ALTERNATIVE_ID_SPAIN_INVALID_TYPE.md): For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed - [INVALID_CSV_FORMAT](https://docs.beel.es/errors/INVALID_CSV_FORMAT.md): Invalid CSV file format: ‹value› - [NIF_INVALID_CONTROL_DIGIT](https://docs.beel.es/errors/NIF_INVALID_CONTROL_DIGIT.md): The control digit of NIF ‹value› is incorrect - [NIF_INVALID_FORMAT](https://docs.beel.es/errors/NIF_INVALID_FORMAT.md): The NIF ‹value› has an invalid format - [NIF_NOT_IN_CENSUS](https://docs.beel.es/errors/NIF_NOT_IN_CENSUS.md): The tax authority's census has no taxpayer with that NIF, or the name registered for it does not match the fiscal name you sent. Typos in… - [CUSTOMER_FIELD_REQUIRED](https://docs.beel.es/errors/CUSTOMER_FIELD_REQUIRED.md): A row lacks a field a customer needs. The message names the field. It is reported in the row's errors. - [CUSTOMER_FIELD_INVALID_CHARACTERS](https://docs.beel.es/errors/CUSTOMER_FIELD_INVALID_CHARACTERS.md): A field of a row contains characters that are not allowed. The message names the field. It is reported in the row's errors. - [CUSTOMER_NOT_SAVED](https://docs.beel.es/errors/CUSTOMER_NOT_SAVED.md): A row passed validation but the customer could not be saved. It is reported in the row's errors. - [CUSTOMER_ADDRESS_INVALID](https://docs.beel.es/errors/CUSTOMER_ADDRESS_INVALID.md): The address of a row is not valid. It is reported in the row's errors. - [CUSTOMER_ROW_NOT_PROCESSED](https://docs.beel.es/errors/CUSTOMER_ROW_NOT_PROCESSED.md): 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… - [CUSTOMER_FIELD_INVALID_FORMAT](https://docs.beel.es/errors/CUSTOMER_FIELD_INVALID_FORMAT.md): A field of a row does not have the expected format. The message names the field and the format expected. It is reported in the row's errors. - [CUSTOMER_DUPLICATED_IN_FILE](https://docs.beel.es/errors/CUSTOMER_DUPLICATED_IN_FILE.md): A row of the file has the same NIF as an earlier row of the same file. It is reported in the row's errors. - [CUSTOMER_DUPLICATED_IN_BATCH](https://docs.beel.es/errors/CUSTOMER_DUPLICATED_IN_BATCH.md): A row of the batch has the same NIF as an earlier row of the same batch. It is reported in the row's errors, not as the request's… - [DUPLICATE_HEADER](https://docs.beel.es/errors/DUPLICATE_HEADER.md): File ‹value› repeats column ‹value›: there is no way to tell which of the two counts. Leave it just once - [EMPTY_FILE](https://docs.beel.es/errors/EMPTY_FILE.md): The file is empty - [ENCODING_ERROR](https://docs.beel.es/errors/ENCODING_ERROR.md): File encoding error: ‹value› - [CSV_FILE_TOO_LARGE](https://docs.beel.es/errors/CSV_FILE_TOO_LARGE.md): The file is too large: ‹value› bytes (maximum: ‹value› bytes) - [HEADER_ROW_NOT_FOUND](https://docs.beel.es/errors/HEADER_ROW_NOT_FOUND.md): No header row found in the first ‹value› lines of ‹value›. Required columns: ‹value›. ‹value› - [INVALID_FORMAT](https://docs.beel.es/errors/INVALID_FORMAT.md): Invalid file format: ‹value› - [MISSING_HEADERS](https://docs.beel.es/errors/MISSING_HEADERS.md): These required headers are missing: ‹value›. Headers found: ‹value› - [NO_DATA_ROWS](https://docs.beel.es/errors/NO_DATA_ROWS.md): File ‹value› carries only the header row: there is no data row to import - [PARSING_ERROR](https://docs.beel.es/errors/PARSING_ERROR.md): Error processing the file: ‹value› - [TOO_MANY_RECORDS](https://docs.beel.es/errors/TOO_MANY_RECORDS.md): Too many records: ‹value› (maximum: ‹value›) - [STREET_EMPTY](https://docs.beel.es/errors/STREET_EMPTY.md): Street cannot be empty - [STREET_MAX_LENGTH](https://docs.beel.es/errors/STREET_MAX_LENGTH.md): Street cannot exceed ‹value› characters - [POSTAL_CODE_EMPTY](https://docs.beel.es/errors/POSTAL_CODE_EMPTY.md): Postal code cannot be empty - [POSTAL_CODE_INVALID_ES](https://docs.beel.es/errors/POSTAL_CODE_INVALID_ES.md): Invalid Spanish postal code: ‹value›. Must be 5 digits - [NUMBER_MAX_LENGTH](https://docs.beel.es/errors/NUMBER_MAX_LENGTH.md): Number cannot exceed ‹value› characters - [COUNTRY_EMPTY](https://docs.beel.es/errors/COUNTRY_EMPTY.md): Country cannot be empty - [COUNTRY_MAX_LENGTH](https://docs.beel.es/errors/COUNTRY_MAX_LENGTH.md): Country cannot exceed ‹value› characters - [COUNTRY_CODE_MISMATCH](https://docs.beel.es/errors/COUNTRY_CODE_MISMATCH.md): An address carries a `country` and a `country_code` that name different countries. `España` alone yields to a foreign `country_code`. - [COUNTRY_CODE_REQUIRED](https://docs.beel.es/errors/COUNTRY_CODE_REQUIRED.md): An address carries a `country` that is neither a real ISO 3166-1 alpha-2 code nor the official name of a country in Spanish, English or… - [CITY_EMPTY](https://docs.beel.es/errors/CITY_EMPTY.md): City cannot be empty - [CITY_MAX_LENGTH](https://docs.beel.es/errors/CITY_MAX_LENGTH.md): City cannot exceed ‹value› characters - [PROVINCE_EMPTY](https://docs.beel.es/errors/PROVINCE_EMPTY.md): Province is required for an address in Spain - [PROVINCE_MAX_LENGTH](https://docs.beel.es/errors/PROVINCE_MAX_LENGTH.md): Province cannot exceed ‹value› characters ## Account settings - [INVALID_IBAN](https://docs.beel.es/errors/INVALID_IBAN.md): The IBAN format is not valid. It must start with the country code and be 15 to 34 characters long (e.g. ES9121000418450200051332) - [FISCAL_IDENTITY_LIVE_ONLY](https://docs.beel.es/errors/FISCAL_IDENTITY_LIVE_ONLY.md): This company is live. In Test mode you can only change how the invoice looks (logo, colour, template, languages and additional… - [IMMUTABLE_LEGAL_FORM](https://docs.beel.es/errors/IMMUTABLE_LEGAL_FORM.md): The request changes the company's `legal_form`, which cannot change once set. Nothing was written. - [IMMUTABLE_NIF](https://docs.beel.es/errors/IMMUTABLE_NIF.md): The request changes the company's `nif`, which cannot change once set. Nothing was written. - [IMMUTABLE_ENTITY_TYPE](https://docs.beel.es/errors/IMMUTABLE_ENTITY_TYPE.md): The request changes the company's `entity_type`, which cannot change once set. Nothing was written. - [NIF_CENSUS_MISMATCH](https://docs.beel.es/errors/NIF_CENSUS_MISMATCH.md): The NIF does not match the fiscal name in the AEAT census. Please verify that both values match your official records exactly. Detail… - [NIF_VALIDATION_TECHNICAL_ERROR](https://docs.beel.es/errors/NIF_VALIDATION_TECHNICAL_ERROR.md): Technical error validating the NIF. Please try again later - [PROFILE_INCOMPLETE](https://docs.beel.es/errors/PROFILE_INCOMPLETE.md): Your tax profile is incomplete. Complete the required data before issuing invoices - [PHYSICAL_PERSON_CANNOT_HAVE_LEGAL_FORM](https://docs.beel.es/errors/PHYSICAL_PERSON_CANNOT_HAVE_LEGAL_FORM.md): Individuals cannot have a legal form - [PHYSICAL_PERSON_CANNOT_HAVE_REPRESENTATIVE](https://docs.beel.es/errors/PHYSICAL_PERSON_CANNOT_HAVE_REPRESENTATIVE.md): Individuals cannot have a legal representative - [PROFILE_DUPLICATED](https://docs.beel.es/errors/PROFILE_DUPLICATED.md): Your account has more than one profile and we cannot tell which one to use. Contact us and we will sort it out. - [PROFILE_NOT_FOUND](https://docs.beel.es/errors/PROFILE_NOT_FOUND.md): User profile not found - [ENTITY_TYPE_INCONSISTENT_WITH_NIF](https://docs.beel.es/errors/ENTITY_TYPE_INCONSISTENT_WITH_NIF.md): The company's `entity_type` does not match its NIF: an individual is identified with a DNI or NIE, and a company or entity with a NIF that… - [ACTIVE_CANNOT_DELETE](https://docs.beel.es/errors/ACTIVE_CANNOT_DELETE.md): Cannot delete an active series. Deactivate it first - [SERIES_ANNUAL_REQUIRES_YEAR](https://docs.beel.es/errors/SERIES_ANNUAL_REQUIRES_YEAR.md): Annual reset requires the format to include the year ({YYYY} or {YY}); otherwise the invoice number would repeat every year. - [SERIES_TYPE_CHANGE_LEAVES_TYPE_UNCOVERED](https://docs.beel.es/errors/SERIES_TYPE_CHANGE_LEAVES_TYPE_UNCOVERED.md): Cannot change the type of this series: it is the default for ‹value›, and that type still has other active series that would be left… - [SERIES_CODE_LOCKED_HAS_INVOICES](https://docs.beel.es/errors/SERIES_CODE_LOCKED_HAS_INVOICES.md): You tried to change the `code` of a series that has already numbered at least one invoice (`numbering_locked` is `true`). Drafts do not… - [SERIES_CODE_DUPLICATED](https://docs.beel.es/errors/SERIES_CODE_DUPLICATED.md): The code ‹value› is already taken by a series, existing or deleted. Series codes are never reused: they identify invoices already issued.… - [DEFAULT_CANNOT_BE_UNMARKED](https://docs.beel.es/errors/DEFAULT_CANNOT_BE_UNMARKED.md): Cannot unmark the default series. Set another series as default first - [DEFAULT_CANNOT_DEACTIVATE](https://docs.beel.es/errors/DEFAULT_CANNOT_DEACTIVATE.md): Cannot deactivate the default series. Set another series as default first - [DEFAULT_CANNOT_DELETE](https://docs.beel.es/errors/DEFAULT_CANNOT_DELETE.md): Cannot delete the default series. Set another series as default first - [SERIES_FORMAT_LOCKED_HAS_INVOICES](https://docs.beel.es/errors/SERIES_FORMAT_LOCKED_HAS_INVOICES.md): You tried to change the `format` of a series that has already numbered at least one invoice (`numbering_locked` is `true`). Changing it… - [SERIES_FORMAT_INVALID_CHARACTERS](https://docs.beel.es/errors/SERIES_FORMAT_INVALID_CHARACTERS.md): The numbers the series would generate contain a character the AEAT does not accept in an invoice number: only printable ASCII is allowed… - [SERIES_FORMAT_NUMBER_TOO_LONG](https://docs.beel.es/errors/SERIES_FORMAT_NUMBER_TOO_LONG.md): The longest number the series can generate — the format with the code, the year, the month and the counter substituted — exceeds the 60… - [SERIES_FORMAT_OVERLAPS](https://docs.beel.es/errors/SERIES_FORMAT_OVERLAPS.md): The series' `code` and `format` could print a number that another series of the company, in the same environment and active or not, can… - [HAS_INVOICES_CANNOT_DELETE](https://docs.beel.es/errors/HAS_INVOICES_CANNOT_DELETE.md): Cannot delete a series that has associated invoices. Delete the invoices first - [INACTIVE_CANNOT_BE_DEFAULT](https://docs.beel.es/errors/INACTIVE_CANNOT_BE_DEFAULT.md): Cannot set an inactive series as default - [SERIES_MONTHLY_REQUIRES_MONTH_AND_YEAR](https://docs.beel.es/errors/SERIES_MONTHLY_REQUIRES_MONTH_AND_YEAR.md): Monthly reset requires the format to include the month ({MM}) and the year ({YYYY} or {YY}); otherwise the invoice number would repeat… - [SERIES_NUMBERING_FROZEN](https://docs.beel.es/errors/SERIES_NUMBERING_FROZEN.md): This series has already assigned invoice numbers: its code, format, reset policy and initial number cannot be modified. - [SERIES_INITIAL_NUMBER_LOCKED_HAS_INVOICES](https://docs.beel.es/errors/SERIES_INITIAL_NUMBER_LOCKED_HAS_INVOICES.md): You tried to change `initial_number` on a series that has already numbered at least one invoice (`numbering_locked` is `true`). - [SERIES_INITIAL_NUMBER_OUT_OF_RANGE](https://docs.beel.es/errors/SERIES_INITIAL_NUMBER_OUT_OF_RANGE.md): The initial number must be between 1 and 999999 - [REFERENCED_BY_PAYMENT_CONNECTION](https://docs.beel.es/errors/REFERENCED_BY_PAYMENT_CONNECTION.md): Cannot delete or deactivate the series: it is configured in a payment connection. Remove it from the connection settings first or choose… - [REFERENCED_BY_RECURRING_INVOICE](https://docs.beel.es/errors/REFERENCED_BY_RECURRING_INVOICE.md): Cannot delete or deactivate the series: there are active or paused recurring invoice templates using it. Finish them or switch them to… - [SERIES_RESET_LOCKED_HAS_INVOICES](https://docs.beel.es/errors/SERIES_RESET_LOCKED_HAS_INVOICES.md): You tried to change `counter_reset` on a series that has already numbered at least one invoice (`numbering_locked` is `true`). - [SERIES_COMPANY_DELETED](https://docs.beel.es/errors/SERIES_COMPANY_DELETED.md): The series belongs to a deleted tax ID: it cannot be activated or set as default. - [SERIES_INCOMPATIBLE_DOC_TYPE](https://docs.beel.es/errors/SERIES_INCOMPATIBLE_DOC_TYPE.md): The series and the invoice's type do not match: a series numbers only documents of its own type. The `series_id` you sent belongs to a… - [SERIES_NOT_FOUND](https://docs.beel.es/errors/SERIES_NOT_FOUND.md): Invoice series not found - [SERIES_DEFAULT_CONFLICT](https://docs.beel.es/errors/SERIES_DEFAULT_CONFLICT.md): Another operation changed the default series for this document type at the same time. Please try again. - [SERIES_DEFAULT_NOT_FOUND](https://docs.beel.es/errors/SERIES_DEFAULT_NOT_FOUND.md): The request did not send `series_id`, and the company has no default series for standard invoices. The default series for simplified and… - [SERIES_DOCUMENT_TYPE_LOCKED_HAS_INVOICES](https://docs.beel.es/errors/SERIES_DOCUMENT_TYPE_LOCKED_HAS_INVOICES.md): You tried to change `document_type` on a series that has already numbered at least one invoice (`numbering_locked` is `true`). It would… - [SERIES_UNASSIGNED_TYPE_NOT_ALLOWED](https://docs.beel.es/errors/SERIES_UNASSIGNED_TYPE_NOT_ALLOWED.md): The request creates a series with `document_type: UNASSIGNED`, or moves an existing series to it. `UNASSIGNED` only survives on series… ## Email delivery - [ENVIO_NO_PERMITIDO](https://docs.beel.es/errors/ENVIO_NO_PERMITIDO.md): In the test environment you can only send to your own address. Use tags to separate sends: youremail+test1@domain.com - [SIN_DESTINATARIO_RESOLUBLE](https://docs.beel.es/errors/SIN_DESTINATARIO_RESOLUBLE.md): The recurring invoice has `send_automatically` on, but there is nobody to send it to: `email_configuration.recipients` is empty and the… ## Holded import - [INVALID_EXCEL_FORMAT](https://docs.beel.es/errors/INVALID_EXCEL_FORMAT.md): Invalid Holded Excel file format: ‹value› - [INVALID_EXCEL_STRUCTURE](https://docs.beel.es/errors/INVALID_EXCEL_STRUCTURE.md): The Excel file does not have the expected Holded contacts structure ## Invoices - [CANCELLATION_VIA_SPECIFIC_ENDPOINT](https://docs.beel.es/errors/CANCELLATION_VIA_SPECIFIC_ENDPOINT.md): To cancel an invoice use the specific cancellation endpoint - [BULK_EMAIL_ITEM_ERROR](https://docs.beel.es/errors/BULK_EMAIL_ITEM_ERROR.md): Unexpected error processing this invoice. - [BULK_EMAIL_INVOICE_IS_DRAFT](https://docs.beel.es/errors/BULK_EMAIL_INVOICE_IS_DRAFT.md): One of the invoices of a batch email is not issued yet: a `DRAFT` or a `SCHEDULED` invoice. It is left out of the email, which still goes… - [BULK_EMAIL_LIMIT_EXCEEDED](https://docs.beel.es/errors/BULK_EMAIL_LIMIT_EXCEEDED.md): You selected ‹value› invoices, but the maximum allowed per email is ‹value›. Reduce the selection and try again. - [BULK_EMAIL_NO_VALID_INVOICES](https://docs.beel.es/errors/BULK_EMAIL_NO_VALID_INVOICES.md): No valid invoices to send. All selected invoices are drafts or have no generated PDF. - [BULK_PDF_ERROR](https://docs.beel.es/errors/BULK_PDF_ERROR.md): Error processing bulk PDF download - [INVOICE_CLIENT_NOT_FOUND](https://docs.beel.es/errors/INVOICE_CLIENT_NOT_FOUND.md): Customer not found: ‹value› - [INVALID_IVA_SURCHARGE_PAIR](https://docs.beel.es/errors/INVALID_IVA_SURCHARGE_PAIR.md): Surcharge ‹value›% is not valid for VAT ‹value›%. Allowed pairs: 21↔5.2, 10↔1.4, 4↔0.5 - [COMPANY_NOT_ACTIVATED](https://docs.beel.es/errors/COMPANY_NOT_ACTIVATED.md): The company is not activated in the environment of the request (test or live), so it cannot issue fiscal documents there. You receive it as… - [CONVERSION_REQUIRES_PROFORMA](https://docs.beel.es/errors/CONVERSION_REQUIRES_PROFORMA.md): Only a proforma invoice can be converted into an invoice; this document is not a proforma - [CORRECTIVE_BAD_DEBT_BASE_TOO_LOW](https://docs.beel.es/errors/CORRECTIVE_BAD_DEBT_BASE_TOO_LOW.md): A bad-debt corrective (`R3`) on an operation with a taxable base of 50 € or less, without `recipient_is_business`. The law allows that… - [CORRECTIVE_BAD_DEBT_TOO_EARLY](https://docs.beel.es/errors/CORRECTIVE_BAD_DEBT_TOO_EARLY.md): A bad-debt corrective (`R3`) was requested less than six months after the original's operation date. `error.details` carries… - [CORRECTIVE_CIRCUMSTANCE_DATE_NOT_APPLICABLE](https://docs.beel.es/errors/CORRECTIVE_CIRCUMSTANCE_DATE_NOT_APPLICABLE.md): `circumstance_date` was sent with a `rectification_code` that is not a cause of article 80 of the VAT Act (`R4`). - [CORRECTIVE_CIRCUMSTANCE_DATE_OUT_OF_RANGE](https://docs.beel.es/errors/CORRECTIVE_CIRCUMSTANCE_DATE_OUT_OF_RANGE.md): `circumstance_date` is before the original's operation date or after today. - [CORRECTIVE_EXCEEDS_INVOICED_AMOUNT](https://docs.beel.es/errors/CORRECTIVE_EXCEEDS_INVOICED_AMOUNT.md): A `PARTIAL` corrective would take the taxable base of one rate (tax, rate and equivalence surcharge; `SUPLIDO` lines by their amount) below… - [CORRECTIVE_NOTHING_LEFT_TO_RECTIFY](https://docs.beel.es/errors/CORRECTIVE_NOTHING_LEFT_TO_RECTIFY.md): A `TOTAL` corrective was requested on an invoice that previous correctives already brought to zero: there is nothing left to rectify. - [CORRECTIVE_ORIGINAL_RECORD_REJECTED](https://docs.beel.es/errors/CORRECTIVE_ORIGINAL_RECORD_REJECTED.md): The original's VeriFactu record was rejected by the AEAT and has not been resubmitted, so the original is not in the AEAT's books. A… - [CORRECTIVE_OUT_OF_TIME](https://docs.beel.es/errors/CORRECTIVE_OUT_OF_TIME.md): The four-year period to issue a corrective has ended. It counts from the original's operation date (its `operation_date`, or its… - [CORRECTIVE_RECIPIENT_IS_ANOTHER_PERSON](https://docs.beel.es/errors/CORRECTIVE_RECIPIENT_IS_ANOTHER_PERSON.md): A recipient-data corrective (`PARTIAL`, `R4`, no `lines`) names a customer other than the one the invoice went to. It corrects the data of… - [CORRECTIVE_RECIPIENT_NOT_ESTABLISHED](https://docs.beel.es/errors/CORRECTIVE_RECIPIENT_NOT_ESTABLISHED.md): `R2` (insolvency) or `R3` (bad debt) was used with a recipient not established in Spain, the Canary Islands, Ceuta or Melilla. The base is… - [CORRECTIVE_RECIPIENT_UNCHANGED](https://docs.beel.es/errors/CORRECTIVE_RECIPIENT_UNCHANGED.md): A recipient-data corrective carries the same name, tax ID and address the invoice already recorded: there is nothing to correct. - [CORRECTIVE_WITHHOLDING_ONLY](https://docs.beel.es/errors/CORRECTIVE_WITHHOLDING_ONLY.md): The lines of a `PARTIAL` corrective leave the taxable base of every rate unchanged and only change the withholding (IRPF). A withholding is… - [CANNOT_DUPLICATE_DELETED_INVOICE](https://docs.beel.es/errors/CANNOT_DUPLICATE_DELETED_INVOICE.md): Cannot duplicate a deleted invoice - [DELETION_FAILED](https://docs.beel.es/errors/DELETION_FAILED.md): Error deleting the invoice - [EMISSION_NOT_READY](https://docs.beel.es/errors/EMISSION_NOT_READY.md): The company cannot issue fiscal documents in this environment yet. `error.details.blockers[]` lists why, each with its own `code`… - [INVOICE_EMAIL_NO_RECIPIENTS](https://docs.beel.es/errors/INVOICE_EMAIL_NO_RECIPIENTS.md): There is nobody to send the email to. On a single invoice: the request carries no `recipients`, the invoice has none in its `email_config`… - [PREVIEW_GENERATION_ERROR](https://docs.beel.es/errors/PREVIEW_GENERATION_ERROR.md): Error generating PDF preview - [ZIP_GENERATION_ERROR](https://docs.beel.es/errors/ZIP_GENERATION_ERROR.md): Error generating ZIP file - [STATUS_NOT_DELETABLE](https://docs.beel.es/errors/STATUS_NOT_DELETABLE.md): Only an invoice that is not yet a fiscal record can be deleted: a `DRAFT`, a `SCHEDULED` invoice or an `ACTIVE` proforma. An issued invoice… - [STATUS_NOT_IMPLEMENTED](https://docs.beel.es/errors/STATUS_NOT_IMPLEMENTED.md): Status ‹value› is not implemented - [STATUS_NOT_MODIFIABLE](https://docs.beel.es/errors/STATUS_NOT_MODIFIABLE.md): The invoice is past the point where it can change. Editing an invoice (`422`) is only possible while it is `DRAFT` or `SCHEDULED`, or an… - [INVOICE_STATUS_NOT_SCHEDULABLE](https://docs.beel.es/errors/INVOICE_STATUS_NOT_SCHEDULABLE.md): The current invoice status does not allow scheduling - [EXCHANGE_DUPLICATED_SIMPLIFIED](https://docs.beel.es/errors/EXCHANGE_DUPLICATED_SIMPLIFIED.md): The same simplified invoice appears more than once in `simplified_invoice_ids`. The message names it. Nothing was issued or numbered. - [EXCHANGE_INVOICE_NOT_CORRECTABLE](https://docs.beel.es/errors/EXCHANGE_INVOICE_NOT_CORRECTABLE.md): The invoice was issued in exchange for simplified invoices and recorded with VeriFactu as `F3`. Correcting an `F3` exchange invoice is not… - [EXCHANGE_INVOICE_NOT_VOIDABLE](https://docs.beel.es/errors/EXCHANGE_INVOICE_NOT_VOIDABLE.md): The invoice was issued in exchange for simplified invoices, which it replaced. It cannot be voided. - [EXCHANGE_REQUIRES_SIMPLIFIED](https://docs.beel.es/errors/EXCHANGE_REQUIRES_SIMPLIFIED.md): One of `simplified_invoice_ids` is not a simplified invoice. Only simplified invoices are exchanged. - [EXCHANGE_SIMPLIFIED_NOT_YET_ACCEPTED](https://docs.beel.es/errors/EXCHANGE_SIMPLIFIED_NOT_YET_ACCEPTED.md): The exchange invoice is recorded with VeriFactu as `F3`, which only replaces simplified invoices the AEAT has accepted, and the record of… - [EXCHANGE_SIMPLIFIED_RECORD_REJECTED](https://docs.beel.es/errors/EXCHANGE_SIMPLIFIED_RECORD_REJECTED.md): The exchange invoice is recorded with VeriFactu as `F3`, which only replaces simplified invoices the AEAT has accepted, and the record of… - [EXEMPTION_NOT_FOR_ISSUED_INVOICE](https://docs.beel.es/errors/EXEMPTION_NOT_FOR_ISSUED_INVOICE.md): A line carries `exemption_reason` `EXENTA_ART_26`. Article 26 of the VAT Act exempts the intra-EU acquisition the buyer declares, not a… - [EXEMPTION_INCOMPATIBLE_WITH_REGIME](https://docs.beel.es/errors/EXEMPTION_INCOMPATIBLE_WITH_REGIME.md): A line combines an `exemption_reason` with a `regime_key` that cannot go with it. Exports (`EXENTA_ART_21` and `EXENTA_ART_22`), for… - [EXEMPTION_REGIME_NOT_SUPPORTED_IN_VERIFACTU](https://docs.beel.es/errors/EXEMPTION_REGIME_NOT_SUPPORTED_IN_VERIFACTU.md): A line uses an `exemption_reason` that names a special regime (`EXENTA_ART_140` or one of the `REGIMEN_ART_*` values), not a VAT exemption.… - [EXEMPTION_REQUIRES_RECIPIENT_ID_TYPE](https://docs.beel.es/errors/EXEMPTION_REQUIRES_RECIPIENT_ID_TYPE.md): A line uses an exemption that requires the recipient to be identified with a specific kind of `alternative_id`. Today that is… - [EXEMPT_ZERO_RATE_REQUIRES_REASON](https://docs.beel.es/errors/EXEMPT_ZERO_RATE_REQUIRES_REASON.md): Lines with 0% tax rate must declare an exemption reason. Use one of: ‹value› - [EXPORT_LIMIT_EXCEEDED](https://docs.beel.es/errors/EXPORT_LIMIT_EXCEEDED.md): The export selects ‹value› invoices and the maximum per download is ‹value›. Narrow the date range or reduce the selection and export again. - [EXPORT_SELECTION_REQUIRED](https://docs.beel.es/errors/EXPORT_SELECTION_REQUIRED.md): Provide invoice_ids or at least one filter: an export with no criteria does not export the whole account. - [INVOICE_DRAFT_NOT_SENDABLE](https://docs.beel.es/errors/INVOICE_DRAFT_NOT_SENDABLE.md): The invoice is not issued yet: a `DRAFT` or a `SCHEDULED` invoice. Only an issued invoice can be emailed. - [INVOICE_DUPLICATE_EXTERNAL_REFERENCE](https://docs.beel.es/errors/INVOICE_DUPLICATE_EXTERNAL_REFERENCE.md): An invoice with this external reference already exists - [INVOICE_NOT_FOUND](https://docs.beel.es/errors/INVOICE_NOT_FOUND.md): Invoice not found - [INVOICE_NOT_SCHEDULED](https://docs.beel.es/errors/INVOICE_NOT_SCHEDULED.md): The invoice is not scheduled - [INVOICE_NOT_CORRECTIBLE_IN_CURRENT_STATUS](https://docs.beel.es/errors/INVOICE_NOT_CORRECTIBLE_IN_CURRENT_STATUS.md): A corrective invoice can only be created from an issued invoice that is still in force: `ISSUED`, `SENT`, `PAID` or `RECTIFIED`. Drafts… - [INVOICE_NOT_REGISTERED_NO_PDF](https://docs.beel.es/errors/INVOICE_NOT_REGISTERED_NO_PDF.md): The invoice is under VeriFactu and is not registered with the AEAT, so it has no PDF: the PDF carries the QR code of that registration. Its… - [INVOICE_REQUIRES_AT_LEAST_ONE_NORMAL_LINE](https://docs.beel.es/errors/INVOICE_REQUIRES_AT_LEAST_ONE_NORMAL_LINE.md): Every line of the invoice is a disbursement (`SUPLIDO`). An invoice of disbursements alone documents no operation, so it is not an invoice. - [INVOICE_NOT_ISSUED_NO_PDF](https://docs.beel.es/errors/INVOICE_NOT_ISSUED_NO_PDF.md): The invoice is a draft and has no fiscal PDF: issue it, or use the preview endpoint. - [INVOICE_NO_LINES](https://docs.beel.es/errors/INVOICE_NO_LINES.md): The invoice must have at least one line - [NEGATIVE_TOTAL_REQUIRES_RECTIFICATIVE](https://docs.beel.es/errors/NEGATIVE_TOTAL_REQUIRES_RECTIFICATIVE.md): The lines add up to a negative total on an invoice that is not a corrective one. Individual negative lines (a discount, a deposit) are… - [INVOICE_ALREADY_VOIDED](https://docs.beel.es/errors/INVOICE_ALREADY_VOIDED.md): The invoice was already voided, by an earlier call (a retry after a timeout, or two clients voiding at once) or from the dashboard. - [VOID_DATE_BEFORE_ISSUE_DATE](https://docs.beel.es/errors/VOID_DATE_BEFORE_ISSUE_DATE.md): The void request carries the deprecated `void_date` with a date earlier than the invoice's issue date. - [ISSUE_DATE_IN_FUTURE](https://docs.beel.es/errors/ISSUE_DATE_IN_FUTURE.md): Issue date cannot be in the future. To issue an invoice on a future date, use PUT /v1/companies/{company_id}/invoices/{invoice_id}/schedule - [ISSUE_DATE_REQUIRED](https://docs.beel.es/errors/ISSUE_DATE_REQUIRED.md): Issue date is required - [OPERATION_DATE_AFTER_ISSUE_DATE](https://docs.beel.es/errors/OPERATION_DATE_AFTER_ISSUE_DATE.md): `operation_date` is later than the invoice's issue date. The operation date is when the goods were delivered or the service was provided… - [PAYMENT_DATE_REQUIRED](https://docs.beel.es/errors/PAYMENT_DATE_REQUIRED.md): Payment date is required to mark the invoice as paid - [SCHEDULED_DATE_REQUIRED](https://docs.beel.es/errors/SCHEDULED_DATE_REQUIRED.md): The scheduling date is required - [SCHEDULED_DATE_IN_PAST](https://docs.beel.es/errors/SCHEDULED_DATE_IN_PAST.md): The scheduling date cannot be in the past - [DUE_DATE_BEFORE_ISSUE_DATE](https://docs.beel.es/errors/DUE_DATE_BEFORE_ISSUE_DATE.md): Due date cannot be before the issue date - [METADATA_FILTER_TOO_MANY_KEYS](https://docs.beel.es/errors/METADATA_FILTER_TOO_MANY_KEYS.md): The metadata filter supports at most ‹value› key/value pairs per request - [SERIES_FORMAT_NUM_REQUIRED](https://docs.beel.es/errors/SERIES_FORMAT_NUM_REQUIRED.md): Variable {NUM} is required in the format. Sequential numbering is required by law - [SERIES_FORMAT_INVALID_PADDING](https://docs.beel.es/errors/SERIES_FORMAT_INVALID_PADDING.md): Invalid padding for '{NUM}': ‹value› - [SERIES_FORMAT_EMPTY](https://docs.beel.es/errors/SERIES_FORMAT_EMPTY.md): The format cannot be empty - [SERIES_FORMAT_LOWERCASE_VARS](https://docs.beel.es/errors/SERIES_FORMAT_LOWERCASE_VARS.md): Lowercase variables detected: ‹value›. Variables must be UPPERCASE (e.g., '{CODIGO}', '{YYYY}', '{MM}', '{NUM}') - [SERIES_FORMAT_UNRECOGNIZED_VARS](https://docs.beel.es/errors/SERIES_FORMAT_UNRECOGNIZED_VARS.md): Unrecognized variables: ‹value›. Valid variables: '{CODIGO}', '{YYYY}', '{YY}', '{MM}', '{NUM}', '{NUM:X}' - [RECIPIENT_UNREGISTERED_ID_MUST_BE_DNI_OR_NIE](https://docs.beel.es/errors/RECIPIENT_UNREGISTERED_ID_MUST_BE_DNI_OR_NIE.md): An identifier of type 07 (not registered) with country ES only accepts a Spanish DNI or NIE - [INVALID_TAX](https://docs.beel.es/errors/INVALID_TAX.md): The tax type ‹value› is not valid - [INVOICE_HAS_LIVE_CORRECTIVES](https://docs.beel.es/errors/INVOICE_HAS_LIVE_CORRECTIVES.md): The invoice already has corrective invoices that are not voided. It was corrected, so the operation took place and it cannot be voided. - [INVALID_IRPF](https://docs.beel.es/errors/INVALID_IRPF.md): The IRPF withholding rate is not one of the rates BeeL. accepts. The message gives the value sent and the accepted ones. A product and an… - [IRPF_RATE_NOT_FOR_CORPORATE_ISSUER](https://docs.beel.es/errors/IRPF_RATE_NOT_FOR_CORPORATE_ISSUER.md): The withholding rate is not one the issuing company can bear by its NIF. Only individuals pay IRPF: an entity (`A`, `B`, `C`, `D`, `F`… - [IRPF_RATE_ONLY_FOR_CORPORATE_ISSUER](https://docs.beel.es/errors/IRPF_RATE_ONLY_FOR_CORPORATE_ISSUER.md): An individual sends `irpf_rate` `9.5`, the Corporate Income Tax rate for rents in Ceuta and Melilla, which only a company can use. - [ISP_INCOMPATIBLE_WITH_SURCHARGE](https://docs.beel.es/errors/ISP_INCOMPATIBLE_WITH_SURCHARGE.md): Reverse-charge (ISP) lines cannot carry equivalence surcharge: the buyer auto-liquidates VAT in their country and Spanish retail surcharge… - [INVALID_VAT](https://docs.beel.es/errors/INVALID_VAT.md): Invalid VAT type: ‹value›. Allowed values: ‹value› - [LINE_INVALID_QUANTITY](https://docs.beel.es/errors/LINE_INVALID_QUANTITY.md): A line's `quantity` is zero or missing. A negative quantity is accepted, as long as the invoice total stays positive. - [LINE_INVALID_DISCOUNT](https://docs.beel.es/errors/LINE_INVALID_DISCOUNT.md): The discount must be between 0 and 100. Received value: ‹value› - [LINE_EXEMPTION_WITH_TAX](https://docs.beel.es/errors/LINE_EXEMPTION_WITH_TAX.md): Line has an exemption reason but the tax rate is not 0%. Current value: ‹value›% - [LINE_EXEMPTION_TEXT_REQUIRED](https://docs.beel.es/errors/LINE_EXEMPTION_TEXT_REQUIRED.md): A descriptive text is required when the exemption reason is OTHER - [LINE_MAIN_TAX_REQUIRED](https://docs.beel.es/errors/LINE_MAIN_TAX_REQUIRED.md): Each line must specify its main tax (main_tax). No default tax is applied. - [INVALID_LINE](https://docs.beel.es/errors/INVALID_LINE.md): The invoice line is not valid: ‹value› - [LINE_NEGATIVE_PRICE](https://docs.beel.es/errors/LINE_NEGATIVE_PRICE.md): The unit price cannot be negative - [LINE_UNIT_PRICE_OUT_OF_RANGE](https://docs.beel.es/errors/LINE_UNIT_PRICE_OUT_OF_RANGE.md): The unit price derived from a line's declared total does not fit the accepted range, typically a large total over a tiny quantity.… - [LINE_UNIT_PRICE_XOR_DECLARED_TOTAL](https://docs.beel.es/errors/LINE_UNIT_PRICE_XOR_DECLARED_TOTAL.md): A line must carry exactly one of `unit_price`, `total_excluding_tax` or `total_including_tax`; this one carries none or more than one. - [LINE_DECLARED_TOTAL_FORBIDS_DISCOUNT](https://docs.beel.es/errors/LINE_DECLARED_TOTAL_FORBIDS_DISCOUNT.md): A line priced by a declared total (`total_excluding_tax` or `total_including_tax`) also sends a `discount_percentage` other than `0`. A… - [LINE_TOTAL_INCONSISTENT](https://docs.beel.es/errors/LINE_TOTAL_INCONSISTENT.md): A line's total does not match the sum of its parts (base + VAT + equivalence surcharge − IRPF) within one cent. Lines under a margin scheme… - [MARK_SENT_FROM_DRAFT_NOT_ALLOWED](https://docs.beel.es/errors/MARK_SENT_FROM_DRAFT_NOT_ALLOWED.md): Cannot mark an invoice in DRAFT status as SENT. Issue it first. - [MARK_SENT_FROM_INVALID_STATE](https://docs.beel.es/errors/MARK_SENT_FROM_INVALID_STATE.md): Cannot mark as SENT from status ‹value›. - [MARK_SENT_FROM_LATER_STATE](https://docs.beel.es/errors/MARK_SENT_FROM_LATER_STATE.md): Cannot mark an invoice in ‹value› status as SENT. The invoice is already in a later state. - [MARK_SENT_ALREADY_SENT](https://docs.beel.es/errors/MARK_SENT_ALREADY_SENT.md): The invoice is already in SENT status. - [RECTIFICATION_REASON_TOO_SHORT](https://docs.beel.es/errors/RECTIFICATION_REASON_TOO_SHORT.md): The rectification reason must be at least ‹value› characters - [RECIPIENT_NIF_AND_ID_OTHER_EXCLUSIVE](https://docs.beel.es/errors/RECIPIENT_NIF_AND_ID_OTHER_EXCLUSIVE.md): The recipient cannot carry both a Spanish NIF and an alternative identifier. Use only one - [LINE_NORMAL_DESCRIPTION_REQUIRED](https://docs.beel.es/errors/LINE_NORMAL_DESCRIPTION_REQUIRED.md): Normal lines must include a description of the concept - [NO_INVOICES_PROVIDED](https://docs.beel.es/errors/NO_INVOICES_PROVIDED.md): No invoices provided - [NO_PDFS_AVAILABLE](https://docs.beel.es/errors/NO_PDFS_AVAILABLE.md): No PDFs available for download - [INVOICE_NUMBER_INVALID_CHARACTERS](https://docs.beel.es/errors/INVOICE_NUMBER_INVALID_CHARACTERS.md): At issue time, the generated invoice number contains a character the AEAT does not accept: only printable ASCII is allowed, except `"`… - [INVOICE_NUMBER_TOO_LONG](https://docs.beel.es/errors/INVOICE_NUMBER_TOO_LONG.md): At issue time, the generated invoice number has more than the 60 characters characters the AEAT accepts. The invoice is not issued and the… - [OPERATION_DATE_TOO_OLD](https://docs.beel.es/errors/OPERATION_DATE_TOO_OLD.md): Operation date ‹value› is more than ‹value› years old: AEAT does not accept an operation earlier than the issue date minus ‹value› years - [OSS_REGIME_INCOMPATIBLE_WITH_ISP](https://docs.beel.es/errors/OSS_REGIME_INCOMPATIBLE_WITH_ISP.md): OSS/IOSS regime (key 17) is incompatible with reverse charge. The destination-country VAT is declared separately (Modelo 369), not as S2 - [PDF_HASH_ERROR](https://docs.beel.es/errors/PDF_HASH_ERROR.md): Error calculating PDF hash - [PDF_NOT_GENERATED](https://docs.beel.es/errors/PDF_NOT_GENERATED.md): The invoice has no stored PDF yet to take the file from: the PDF of an issued invoice is generated after issuing, and under VeriFactu once… - [PDF_URL_EMPTY](https://docs.beel.es/errors/PDF_URL_EMPTY.md): The PDF URL is empty - [PERCENTAGE_OUT_OF_RANGE](https://docs.beel.es/errors/PERCENTAGE_OUT_OF_RANGE.md): The percentage ‹value› is not valid. It must be between 0 and 100 - [INVALID_PERCENTAGE](https://docs.beel.es/errors/INVALID_PERCENTAGE.md): Tax percentage ‹value›% is not valid for ‹value›. Valid rates: ‹value›. A 0% that is not listed is not a rate but the exemption sentinel… - [PREVIEW_DRAFT_ONLY](https://docs.beel.es/errors/PREVIEW_DRAFT_ONLY.md): PDF preview is only available for draft invoices - [PROFORMA_PAYMENT_FORBIDDEN](https://docs.beel.es/errors/PROFORMA_PAYMENT_FORBIDDEN.md): A proforma invoice cannot be marked as paid; it is not part of the payment cycle - [PROFORMA_NOT_CONVERTIBLE](https://docs.beel.es/errors/PROFORMA_NOT_CONVERTIBLE.md): Only an `ACTIVE` proforma can be converted. This one is in another status, for example `VOIDED`. - [PROFORMA_NOT_ISSUABLE](https://docs.beel.es/errors/PROFORMA_NOT_ISSUABLE.md): The document is a proforma. Proformas are not issued: they are created `ACTIVE` and become an invoice when converted. - [PROFORMA_SCHEDULE_FORBIDDEN](https://docs.beel.es/errors/PROFORMA_SCHEDULE_FORBIDDEN.md): A proforma invoice cannot be scheduled; scheduling is a fiscal issuance flow - [PROFORMA_CORRECTIVE_FORBIDDEN](https://docs.beel.es/errors/PROFORMA_CORRECTIVE_FORBIDDEN.md): A proforma invoice cannot be corrected; it is not a fiscal document - [PROFORMA_NOT_RECURRING](https://docs.beel.es/errors/PROFORMA_NOT_RECURRING.md): A proforma invoice cannot be recurring; a quote is a one-off offer, not a subscription - [PROFORMA_OVERDUE_FORBIDDEN](https://docs.beel.es/errors/PROFORMA_OVERDUE_FORBIDDEN.md): A proforma invoice never becomes overdue; its validity date is informational - [PROFORMA_RECIPIENT_REQUIRED](https://docs.beel.es/errors/PROFORMA_RECIPIENT_REQUIRED.md): A proforma invoice requires a recipient (customer or complete recipient data) - [PROFORMA_TRANSITION_FORBIDDEN](https://docs.beel.es/errors/PROFORMA_TRANSITION_FORBIDDEN.md): A proforma invoice can only be active, converted or voided; that status change belongs to the fiscal cycle - [PROFORMA_ALREADY_CONVERTED](https://docs.beel.es/errors/PROFORMA_ALREADY_CONVERTED.md): The proforma is already `CONVERTED`: an earlier call turned it into an invoice. - [INVALID_SURCHARGE](https://docs.beel.es/errors/INVALID_SURCHARGE.md): The equivalence surcharge rate is not one of the rates BeeL. accepts. The message gives the value sent and the accepted ones. A product and… - [SURCHARGE_REQUIRES_REGIME](https://docs.beel.es/errors/SURCHARGE_REQUIRES_REGIME.md): Recargo de equivalencia is only compatible with regime 18; the line is on regime ‹value› - [RECIPIENT_CUSTOMER_AND_DATA_EXCLUSIVE](https://docs.beel.es/errors/RECIPIENT_CUSTOMER_AND_DATA_EXCLUSIVE.md): The recipient sends `customer_id` together with other recipient fields (`legal_name`, `nif`, `address`…). They are alternatives: one or the… - [RECIPIENT_ADDRESS_REQUIRED](https://docs.beel.es/errors/RECIPIENT_ADDRESS_REQUIRED.md): Recipient address is required for standard invoices - [RECIPIENT_ID_REQUIRED](https://docs.beel.es/errors/RECIPIENT_ID_REQUIRED.md): Recipient must have a NIF or alternative identifier - [RECIPIENT_FISCAL_NAME_REQUIRED](https://docs.beel.es/errors/RECIPIENT_FISCAL_NAME_REQUIRED.md): Recipient legal name is required for standard invoices - [RECIPIENT_NOT_PROVIDED](https://docs.beel.es/errors/RECIPIENT_NOT_PROVIDED.md): The invoice names no recipient: neither `customer_id` nor `recipient` data. - [RECIPIENT_REQUIRED_FOR_ORDINARY](https://docs.beel.es/errors/RECIPIENT_REQUIRED_FOR_ORDINARY.md): Ordinary invoices require a valid recipient - [CORRECTIVE_INVOICE_INCOMPLETE](https://docs.beel.es/errors/CORRECTIVE_INVOICE_INCOMPLETE.md): A corrective invoice must declare its rectification type and VeriFactu code (R1-R5). Create the corrective invoice from the original… - [CORRECTIVE_RECENT_DUPLICATE](https://docs.beel.es/errors/CORRECTIVE_RECENT_DUPLICATE.md): A corrective identical to this one was created for the same original less than 2 minutes ago: same `rectification_type`… - [CORRECTIVE_ORIGINAL_MIXED_IRPF](https://docs.beel.es/errors/CORRECTIVE_ORIGINAL_MIXED_IRPF.md): A `PARTIAL` corrective line does not set `irpf_rate`, and the original invoice applies different IRPF rates on different lines, so there is… - [RECTIFICATION_REASON_REQUIRED](https://docs.beel.es/errors/RECTIFICATION_REASON_REQUIRED.md): The corrective invoice does not say why it corrects the original. The reason is part of the fiscal record. - [CORRECTIVE_NOT_RECTIFIABLE](https://docs.beel.es/errors/CORRECTIVE_NOT_RECTIFIABLE.md): The invoice you tried to correct is itself a corrective invoice. Corrective invoices are not chained. - [CORRECTIVE_ORIGINAL_IS_DRAFT](https://docs.beel.es/errors/CORRECTIVE_ORIGINAL_IS_DRAFT.md): The invoice to correct is a `DRAFT`. Only an issued invoice is corrected. - [CORRECTIVE_ORIGINAL_DELETED](https://docs.beel.es/errors/CORRECTIVE_ORIGINAL_DELETED.md): The invoice to correct was deleted. - [CORRECTIVE_ORIGINAL_NOT_FOUND](https://docs.beel.es/errors/CORRECTIVE_ORIGINAL_NOT_FOUND.md): The invoice to correct does not exist, or it is not one this credential can see. - [CORRECTIVE_ORIGINAL_REQUIRED](https://docs.beel.es/errors/CORRECTIVE_ORIGINAL_REQUIRED.md): A corrective invoice was requested without the original invoice it corrects. - [RECTIFICATIVA_PARCIAL_SIN_LINEAS](https://docs.beel.es/errors/RECTIFICATIVA_PARCIAL_SIN_LINEAS.md): The request sets `rectification_type` to `PARTIAL` but sends no `lines`. A partial correction is made of the lines you declare. - [CORRECTIVE_ORIGINAL_MIXED_SURCHARGE](https://docs.beel.es/errors/CORRECTIVE_ORIGINAL_MIXED_SURCHARGE.md): A `PARTIAL` corrective line does not set `equivalence_surcharge_rate`, and the original invoice applies the equivalence surcharge on some… - [CORRECTIVE_RECIPIENT_NOT_ACCEPTED](https://docs.beel.es/errors/CORRECTIVE_RECIPIENT_NOT_ACCEPTED.md): The request to create a corrective invoice carries a `recipient` (a `customer_id` or inline data) outside a recipient-data correction. A… - [RECTIFICATIVA_TOTAL_CON_LINEAS](https://docs.beel.es/errors/RECTIFICATIVA_TOTAL_CON_LINEAS.md): The request sets `rectification_type` to `TOTAL` and also sends `lines`. A total correction rectifies everything still invoiced on the… - [CORRECTIVE_TOTAL_ALREADY_EXISTS](https://docs.beel.es/errors/CORRECTIVE_TOTAL_ALREADY_EXISTS.md): The original invoice already has a `TOTAL` corrective, which replaces it whole, so it admits no other. The message names it. - [RECURRING_NOT_STARTED](https://docs.beel.es/errors/RECURRING_NOT_STARTED.md): The recurring template does not start until ‹value›: there is no occurrence to bring forward yet. If you need to bill before that date… - [RECURRING_INVALID_DAY_OF_MONTH](https://docs.beel.es/errors/RECURRING_INVALID_DAY_OF_MONTH.md): The day of the month must be between 1 and 31 - [RECURRING_INVOICE_DELETED](https://docs.beel.es/errors/RECURRING_INVOICE_DELETED.md): Cannot create recurrence from a deleted invoice - [RECURRING_END_DATE_BEFORE_START](https://docs.beel.es/errors/RECURRING_END_DATE_BEFORE_START.md): The end date must be after the first scheduled generation (‹value›) - [RECURRING_START_DATE_NOT_EDITABLE](https://docs.beel.es/errors/RECURRING_START_DATE_NOT_EDITABLE.md): Cannot modify the start date because invoices have already been generated - [RECURRING_END_MODE_CONFLICT](https://docs.beel.es/errors/RECURRING_END_MODE_CONFLICT.md): The recurring invoice would end up with both `end_date` and `max_invoices` set. It is judged on the result, not on the body: a `PATCH` that… - [RECURRING_MAX_INVOICES_ABOVE_MAXIMUM](https://docs.beel.es/errors/RECURRING_MAX_INVOICES_ABOVE_MAXIMUM.md): A recurring template cannot be capped above 600 invoices, fifty years of monthly billing - [RECURRING_MAX_INVOICES_BELOW_GENERATED](https://docs.beel.es/errors/RECURRING_MAX_INVOICES_BELOW_GENERATED.md): The new `max_invoices` is lower than the number of invoices the recurrence has already generated. Issued invoices are not undone by… - [RECURRING_MAX_INVOICES_BELOW_MINIMUM](https://docs.beel.es/errors/RECURRING_MAX_INVOICES_BELOW_MINIMUM.md): A recurring template cannot be capped below 2 invoices. For a single invoice you do not need a recurrence: schedule the invoice with PUT… - [RECURRING_NOT_ACTIVE](https://docs.beel.es/errors/RECURRING_NOT_ACTIVE.md): The operation needs an `ACTIVE` recurring invoice and this one is `PAUSED` or `COMPLETED`. `error.details.current_status` carries its… - [RECURRING_NOT_FOUND](https://docs.beel.es/errors/RECURRING_NOT_FOUND.md): Recurring invoice not found - [RECURRING_OCCURRENCE_ALREADY_CONSUMED](https://docs.beel.es/errors/RECURRING_OCCURRENCE_ALREADY_CONSUMED.md): An invoice already exists for the occurrence you asked to generate, from the scheduled run or from an earlier call. - [PAYMENT_DETAILS_REQUIRE_METHOD](https://docs.beel.es/errors/PAYMENT_DETAILS_REQUIRE_METHOD.md): payment_iban, payment_swift and payment_term_days are only accepted together with a payment_method that is present, not null and not NONE.… - [RECURRING_NO_LINES](https://docs.beel.es/errors/RECURRING_NO_LINES.md): At least one line must be included - [RECURRING_TYPE_NOT_SUPPORTED](https://docs.beel.es/errors/RECURRING_TYPE_NOT_SUPPORTED.md): Cannot create a recurrence from a rectificative invoice - [RECURRING_STATE_TRANSITION_INVALID](https://docs.beel.es/errors/RECURRING_STATE_TRANSITION_INVALID.md): The recurring invoice cannot move from its current status to the one you asked for; for example, a `COMPLETED` recurrence cannot become… - [RECURRING_NO_OCCURRENCE_IN_WINDOW](https://docs.beel.es/errors/RECURRING_NO_OCCURRENCE_IN_WINDOW.md): With this cadence the first invoice would fall on ‹value›, after the end date: the window never contains a single generation. Extend the… - [RECURRING_ALREADY_ENDED](https://docs.beel.es/errors/RECURRING_ALREADY_ENDED.md): The recurrence has ended: it is `COMPLETED`, or it has passed its `end_date` or reached `max_invoices`. An ended recurrence accepts no… - [INVALID_REGIME_KEY_FOR_TAX_TYPE](https://docs.beel.es/errors/INVALID_REGIME_KEY_FOR_TAX_TYPE.md): Regime key ‹value› is not valid for ‹value›. Valid regime keys: ‹value› - [REGIME_REQUIRES_INCOMPATIBLE_EXEMPTION](https://docs.beel.es/errors/REGIME_REQUIRES_INCOMPATIBLE_EXEMPTION.md): Regime ‹value› requires exemption reason ‹value›; the line does not carry it - [REGIME_REQUIRES_SURCHARGE](https://docs.beel.es/errors/REGIME_REQUIRES_SURCHARGE.md): Regime ‹value› requires recargo de equivalencia and the line does not carry it - [REGIME_KEY_CLASSIFICATION_NOT_ACCEPTED](https://docs.beel.es/errors/REGIME_KEY_CLASSIFICATION_NOT_ACCEPTED.md): The line's `exemption_reason` (or its absence) is not one AEAT accepts with its regime key: `04` needs reverse charge or an exemption; `08`… - [REGIME_KEY_NOT_SUPPORTED](https://docs.beel.es/errors/REGIME_KEY_NOT_SUPPORTED.md): A line, or the default of the tax configuration, carries `regime_key` `03`, `06` or `14`. Under `03` the invoice must not show the tax… - [REGIME_KEY_REQUIRES_RECIPIENT_NIF](https://docs.beel.es/errors/REGIME_KEY_REQUIRES_RECIPIENT_NIF.md): `regime_key` `10` is used with a recipient identified by an `alternative_id`; AEAT requires a Spanish `nif` with that key. - [REGIME_KEY_REQUIRES_STANDARD_INVOICE](https://docs.beel.es/errors/REGIME_KEY_REQUIRES_STANDARD_INVOICE.md): `regime_key` `10` is used on an invoice that is not a full (`STANDARD`) invoice; AEAT rejects it on a simplified or corrective invoice. - [REGIME_KEY_REQUIRES_VAT_RATE](https://docs.beel.es/errors/REGIME_KEY_REQUIRES_VAT_RATE.md): A subject IVA line under `regime_key` `11` carries a rate AEAT does not accept with that key; it only accepts 21 %. - [REVERSE_CHARGE_CASE_NOT_SUPPORTED](https://docs.beel.es/errors/REVERSE_CHARGE_CASE_NOT_SUPPORTED.md): A line carries `exemption_reason` `ISP_ART_84_2_G` (silver, platinum, palladium, mobile phones, consoles, laptops and tablets). The law… - [REVERT_ONLY_FROM_SENT](https://docs.beel.es/errors/REVERT_ONLY_FROM_SENT.md): Can only revert from SENT status. Current status: ‹value› - [SERIES_INACTIVE](https://docs.beel.es/errors/SERIES_INACTIVE.md): The invoice series ‹value› is inactive - [INVOICE_SERIES_NOT_FOUND](https://docs.beel.es/errors/INVOICE_SERIES_NOT_FOUND.md): Invoice series ‹value› not found - [SERIES_NUMBER_COLLISION](https://docs.beel.es/errors/SERIES_NUMBER_COLLISION.md): At issue time, the number the series would assign is already used by another invoice of the same company, in this series or in another one.… - [SIMPLIFICADA_FORBIDS_CROSS_BORDER](https://docs.beel.es/errors/SIMPLIFICADA_FORBIDS_CROSS_BORDER.md): A line of a `SIMPLIFIED` invoice uses an `exemption_reason` for an intra-EU supply or an operation located outside Spain. Those require an… - [SIMPLIFICADA_FORBIDS_IRPF](https://docs.beel.es/errors/SIMPLIFICADA_FORBIDS_IRPF.md): A line of a `SIMPLIFIED` invoice sets an `irpf_rate` above zero. Withholding needs an identified payer, and a simplified invoice has none.… - [SIMPLIFICADA_FORBIDS_ISP](https://docs.beel.es/errors/SIMPLIFICADA_FORBIDS_ISP.md): A line of a `SIMPLIFIED` invoice uses a reverse-charge `exemption_reason` (`ISP_*`). Under reverse charge the recipient pays the VAT, so… - [SIMPLIFICADA_FORBIDS_SURCHARGE](https://docs.beel.es/errors/SIMPLIFICADA_FORBIDS_SURCHARGE.md): A line of a `SIMPLIFIED` invoice carries an equivalence surcharge. A retailer under that regime must receive a full invoice with its… - [SIMPLIFIED_INVOICE_FORBIDS_IDENTIFIED_RECIPIENT](https://docs.beel.es/errors/SIMPLIFIED_INVOICE_FORBIDS_IDENTIFIED_RECIPIENT.md): The invoice is `SIMPLIFIED` and its recipient carries a `nif` or an `alternative_id`, whether sent in `recipient` or taken from the… - [SIMPLIFIED_INVOICE_EXCEEDS_LEGAL_LIMIT](https://docs.beel.es/errors/SIMPLIFIED_INVOICE_EXCEEDS_LEGAL_LIMIT.md): The total of a `SIMPLIFIED` invoice, VAT included, is above the maximum BeeL. accepts for simplified invoices (3,000 €). It is checked when… - [SIMPLIFIED_EXCHANGE_NOT_RECORDABLE](https://docs.beel.es/errors/SIMPLIFIED_EXCHANGE_NOT_RECORDABLE.md): The exchange invoice is recorded with VeriFactu as `F3`, which only replaces simplified invoices already on file with the AEAT, and one of… - [SIMPLIFIED_NOT_EXCHANGEABLE](https://docs.beel.es/errors/SIMPLIFIED_NOT_EXCHANGEABLE.md): One of `simplified_invoice_ids` cannot be exchanged: it is not issued, it was already voided, exchanged or corrected, or it belongs to… - [ONLY_DRAFT_EMITTABLE](https://docs.beel.es/errors/ONLY_DRAFT_EMITTABLE.md): You asked to issue an invoice that is not a `DRAFT`. Most often it is already `ISSUED`, for example because an earlier call succeeded and… - [ORIGINAL_REFERENCE_ONLY_ON_CORRECTIVE](https://docs.beel.es/errors/ORIGINAL_REFERENCE_ONLY_ON_CORRECTIVE.md): An invoice that is not a corrective references an original invoice. Only a corrective points at the invoice it corrects. - [ATTACH_SOURCE_INVOICE_UNAVAILABLE](https://docs.beel.es/errors/ATTACH_SOURCE_INVOICE_UNAVAILABLE.md): A source invoice is not available (it does not exist or you no longer have access); uncheck the source invoices attachment to send without… - [ATTACH_SOURCE_PDF_MISSING](https://docs.beel.es/errors/ATTACH_SOURCE_PDF_MISSING.md): These source invoices have no generated PDF: ‹value› - [ATTACH_SOURCE_INVOICES_REQUIRES_PDF](https://docs.beel.es/errors/ATTACH_SOURCE_INVOICES_REQUIRES_PDF.md): Attaching the source invoices also requires attaching the invoice PDF - [ATTACH_SOURCE_INVOICES_NO_SOURCES](https://docs.beel.es/errors/ATTACH_SOURCE_INVOICES_NO_SOURCES.md): The invoice has no consolidation disbursements: there are no source invoices to attach - [ATTACH_SOURCE_ZIP_TOO_LARGE](https://docs.beel.es/errors/ATTACH_SOURCE_ZIP_TOO_LARGE.md): The source invoices ZIP (‹value› MB) exceeds the maximum sendable size (‹value› MB) - [LINE_SUPLIDO_QUANTITY_REQUIRED](https://docs.beel.es/errors/LINE_SUPLIDO_QUANTITY_REQUIRED.md): Quantity is required on SUPLIDO lines - [LINE_SUPLIDO_TOO_MANY_SOURCE_ACCOUNTS](https://docs.beel.es/errors/LINE_SUPLIDO_TOO_MANY_SOURCE_ACCOUNTS.md): A disbursement line cannot consolidate invoices from that many different accounts - [LINE_SUPLIDO_TOO_MANY_SOURCES](https://docs.beel.es/errors/LINE_SUPLIDO_TOO_MANY_SOURCES.md): A disbursement line cannot consolidate that many source invoices - [LINE_SUPLIDO_PRICE_REQUIRED](https://docs.beel.es/errors/LINE_SUPLIDO_PRICE_REQUIRED.md): SUPLIDO lines require either a unit price or a line total - [LINE_SUPLIDO_REFERENCE_REQUIRED](https://docs.beel.es/errors/LINE_SUPLIDO_REFERENCE_REQUIRED.md): SUPLIDO lines must declare a reference to the original third-party invoice - [LINE_SUPLIDO_MUST_HAVE_NO_TAX](https://docs.beel.es/errors/LINE_SUPLIDO_MUST_HAVE_NO_TAX.md): SUPLIDO lines cannot apply VAT — the main tax must be 0% or empty - [LINE_SUPLIDO_MUST_HAVE_NO_IRPF](https://docs.beel.es/errors/LINE_SUPLIDO_MUST_HAVE_NO_IRPF.md): SUPLIDO lines cannot apply withholding tax (IRPF) - [LINE_SUPLIDO_MUST_HAVE_NO_RECARGO](https://docs.beel.es/errors/LINE_SUPLIDO_MUST_HAVE_NO_RECARGO.md): SUPLIDO lines cannot apply equivalence surcharge - [LINE_SUPLIDO_SOURCE_INVOICE_NOT_FOUND](https://docs.beel.es/errors/LINE_SUPLIDO_SOURCE_INVOICE_NOT_FOUND.md): One of the disbursement's source invoices does not exist or does not belong to you - [LINE_SUPLIDO_SOURCE_INVOICE_NOT_ISSUED](https://docs.beel.es/errors/LINE_SUPLIDO_SOURCE_INVOICE_NOT_ISSUED.md): A disbursement's source invoices must be issued - [SURCHARGE_RATE_NOT_ACCEPTED_ON_DATE](https://docs.beel.es/errors/SURCHARGE_RATE_NOT_ACCEPTED_ON_DATE.md): The equivalence surcharge and the VAT rate of a line form a pair AEAT does not accept on the operation date: with VAT at 5 %, `0.5` up to… - [SURCHARGE_RATE_REQUIRES_RECALCULATION](https://docs.beel.es/errors/SURCHARGE_RATE_REQUIRES_RECALCULATION.md): A draft, scheduled invoice or proforma still carries the `0.625` surcharge of VAT at 5 %, which is `0.62` since 2023-01-01, and its amounts… - [INVOICE_TAX_BREAKDOWN_TOO_LONG](https://docs.beel.es/errors/INVOICE_TAX_BREAKDOWN_TOO_LONG.md): The invoice has ‹value› different combinations of tax, regime, rate and exemption, and the AEAT record accepts at most ‹value›. The invoice… - [INVOICE_TAX_RATE_TOO_MANY_DECIMALS](https://docs.beel.es/errors/INVOICE_TAX_RATE_TOO_MANY_DECIMALS.md): On an invoice recorded with VeriFactu, a tax or surcharge rate has more than two decimals, and AEAT only accepts two. The invoice was not… - [TEMPLATE_MISSING_REQUIRED_VARIABLE](https://docs.beel.es/errors/TEMPLATE_MISSING_REQUIRED_VARIABLE.md): Template requires variable: ‹value› - [TEMPLATE_UNKNOWN_VARIABLE](https://docs.beel.es/errors/TEMPLATE_UNKNOWN_VARIABLE.md): Template contains unknown variable: ‹value› - [PROFORMA_TYPE_CHANGE_FORBIDDEN](https://docs.beel.es/errors/PROFORMA_TYPE_CHANGE_FORBIDDEN.md): Cannot change type to/from PROFORMA; use the conversion flow - [TYPE_CHANGE_CORRECTIVE_FORBIDDEN](https://docs.beel.es/errors/TYPE_CHANGE_CORRECTIVE_FORBIDDEN.md): Cannot change type to/from CORRECTIVE - [TYPE_REQUIRED](https://docs.beel.es/errors/TYPE_REQUIRED.md): Invoice type is required - [TOTAL_CORRECTIVE_NOT_VOIDABLE](https://docs.beel.es/errors/TOTAL_CORRECTIVE_NOT_VOIDABLE.md): The invoice is a `TOTAL` corrective. Voiding it would leave the invoice it rectifies voided with nothing to offset it. - [TRANSITION_NOT_SUPPORTED](https://docs.beel.es/errors/TRANSITION_NOT_SUPPORTED.md): The target status cannot be reached from the invoice's current status. For example, a `DRAFT` or `SCHEDULED` invoice cannot be voided… - [VAT_RATE_NOT_ACCEPTED_ON_DATE](https://docs.beel.es/errors/VAT_RATE_NOT_ACCEPTED_ON_DATE.md): A line carries a temporary VAT rate on an operation outside its period: 5 % is accepted only on operations dated from 2022-07-01 to… - [VERIFACTU_RECORD_NOT_DECLARABLE](https://docs.beel.es/errors/VERIFACTU_RECORD_NOT_DECLARABLE.md): AEAT would reject this invoice's record: it breaks section ‹value› of its VERI*FACTU validations. The invoice was not issued and the number… - [VOID_REQUIRES_ISSUED_IN_ERROR](https://docs.beel.es/errors/VOID_REQUIRES_ISSUED_IN_ERROR.md): The invoice was already sent or paid, and the void request does not confirm it was issued by mistake. A void is only for an invoice that… ## Payment integrations - [COMPANY_NOT_ACTIVATED_IN_ENVIRONMENT](https://docs.beel.es/errors/COMPANY_NOT_ACTIVATED_IN_ENVIRONMENT.md): This company is not activated in ‹value› mode. Activate it in that mode before connecting the payment provider: activation is what creates… - [CONNECTION_NOT_ACTIVE](https://docs.beel.es/errors/CONNECTION_NOT_ACTIVE.md): Payment connection is not active - [CONNECTION_NOT_FOUND](https://docs.beel.es/errors/CONNECTION_NOT_FOUND.md): Payment connection not found - [CONNECTION_SERIE_INACTIVE](https://docs.beel.es/errors/CONNECTION_SERIE_INACTIVE.md): The selected series is deactivated - [CONNECTION_SERIE_NOT_FOUND](https://docs.beel.es/errors/CONNECTION_SERIE_NOT_FOUND.md): The selected series does not exist in this company and environment - [CONNECTION_SERIE_TIPO_INCOMPATIBLE](https://docs.beel.es/errors/CONNECTION_SERIE_TIPO_INCOMPATIBLE.md): The series document type (‹value›) is not compatible with this field (‹value›) - [EVENT_DRAFT_NOT_POSSIBLE](https://docs.beel.es/errors/EVENT_DRAFT_NOT_POSSIBLE.md): The draft cannot be generated: ‹value› - [EVENT_FILTER_RANGE_INVALID](https://docs.beel.es/errors/EVENT_FILTER_RANGE_INVALID.md): The filter range is inverted: the minimum value cannot be greater than the maximum - [EVENT_INVALID_STATUS_FOR_DISCARD](https://docs.beel.es/errors/EVENT_INVALID_STATUS_FOR_DISCARD.md): Cannot discard a processed event. The event has an issued invoice linked and must remain in the history. - [EVENT_INVALID_STATUS_FOR_DRAFT](https://docs.beel.es/errors/EVENT_INVALID_STATUS_FOR_DRAFT.md): Cannot generate a draft from an event in status ‹value› - [EVENT_INVALID_STATUS_FOR_RESOLVE](https://docs.beel.es/errors/EVENT_INVALID_STATUS_FOR_RESOLVE.md): Event cannot be marked as resolved in its current status (‹value›) - [EVENT_INVALID_STATUS_FOR_RETRY](https://docs.beel.es/errors/EVENT_INVALID_STATUS_FOR_RETRY.md): Event cannot be retried in its current status - [EVENT_MAX_RETRIES_EXCEEDED](https://docs.beel.es/errors/EVENT_MAX_RETRIES_EXCEEDED.md): Maximum retry limit of ‹value› reached for this event - [EVENT_NOT_FOUND](https://docs.beel.es/errors/EVENT_NOT_FOUND.md): Payment event not found - [EVENT_SOURCE_PAYLOAD_UNAVAILABLE](https://docs.beel.es/errors/EVENT_SOURCE_PAYLOAD_UNAVAILABLE.md): The event no longer holds the original provider data, so it cannot be reprocessed or turned into a draft - [FILTER_CATEGORY_NOT_ACTIONABLE](https://docs.beel.es/errors/FILTER_CATEGORY_NOT_ACTIONABLE.md): Category "‹value›" cannot be disabled: auto-invoicing filters only act on DIRECT_PAYMENT and SUBSCRIPTION. - [FILTER_PATTERNS_TOO_MANY](https://docs.beel.es/errors/FILTER_PATTERNS_TOO_MANY.md): You can configure at most ‹value› description patterns per list (received ‹value›). - [FILTER_PATTERN_INVALID](https://docs.beel.es/errors/FILTER_PATTERN_INVALID.md): The description pattern "‹value›" is not a valid regular expression. - [FILTER_PATTERN_TOO_LONG](https://docs.beel.es/errors/FILTER_PATTERN_TOO_LONG.md): A description pattern cannot exceed ‹value› characters (received one of ‹value›). - [PAYMENT_RETURN_URL_INVALID](https://docs.beel.es/errors/PAYMENT_RETURN_URL_INVALID.md): return_url must be an absolute https:// URL with a host (for example https://your-portal.com/return) - [PROVIDER_NOT_SUPPORTED](https://docs.beel.es/errors/PROVIDER_NOT_SUPPORTED.md): The `provider` is not one BeeL. connects. Today only `stripe` is supported. - [SIMPLIFICADA_THRESHOLD_INVALID](https://docs.beel.es/errors/SIMPLIFICADA_THRESHOLD_INVALID.md): The simplified invoice threshold must be greater than 0 and not exceed €3000. - [TAX_INCLUSIVE_RATE_REQUIRED](https://docs.beel.es/errors/TAX_INCLUSIVE_RATE_REQUIRED.md): You must provide the tax type, rate and regime when enabling "prices already include VAT". ## Products - [PRODUCT_DUPLICATE](https://docs.beel.es/errors/PRODUCT_DUPLICATE.md): A product with code ‹value› already exists - [PRODUCT_INACTIVE](https://docs.beel.es/errors/PRODUCT_INACTIVE.md): The product ‹value› is inactive and cannot be used - [PRODUCT_NOT_FOUND](https://docs.beel.es/errors/PRODUCT_NOT_FOUND.md): Product not found: ‹value› ## API Logs - [REQUEST_LOG_INVALID_CURSOR](https://docs.beel.es/errors/REQUEST_LOG_INVALID_CURSOR.md): Invalid pagination cursor - [REQUEST_LOG_INVALID_TIME_RANGE](https://docs.beel.es/errors/REQUEST_LOG_INVALID_TIME_RANGE.md): The start of the range must not be later than its end - [REQUEST_LOG_NOT_FOUND](https://docs.beel.es/errors/REQUEST_LOG_NOT_FOUND.md): Request log not found ## General - [NIF_DE_BAJA](https://docs.beel.es/errors/NIF_DE_BAJA.md): The NIF ‹value› is deregistered in the AEAT census and cannot issue invoices - [NIF_REVOCADO](https://docs.beel.es/errors/NIF_REVOCADO.md): The NIF is registered in the AEAT census as revoked. - [REQUEST_BLOCKED](https://docs.beel.es/errors/REQUEST_BLOCKED.md): A security filter at the edge rejected this request before the API saw its body. This usually happens because a text field contains… - [FILE_CORRUPTED](https://docs.beel.es/errors/FILE_CORRUPTED.md): File is damaged or corrupt - [FILE_EMPTY](https://docs.beel.es/errors/FILE_EMPTY.md): The file is empty - [FILE_TOO_LARGE](https://docs.beel.es/errors/FILE_TOO_LARGE.md): File is too large. Maximum allowed size: ‹value› - [INVALID_CONTENT](https://docs.beel.es/errors/INVALID_CONTENT.md): File content is not valid - [INVALID_DIMENSIONS](https://docs.beel.es/errors/INVALID_DIMENSIONS.md): Image dimensions are not valid - [INVALID_EXTENSION](https://docs.beel.es/errors/INVALID_EXTENSION.md): File extension not allowed - [INVALID_FILE_TYPE](https://docs.beel.es/errors/INVALID_FILE_TYPE.md): File type not allowed. Accepted types: ‹value› - [IBAN_INVALID](https://docs.beel.es/errors/IBAN_INVALID.md): Invalid IBAN: ‹value›. Must match ISO 13616 format (e.g.: ES1234567890123456789012) - [IBAN_REQUIRED](https://docs.beel.es/errors/IBAN_REQUIRED.md): Payment method ‹value› requires an IBAN - [PLAZO_DIAS_OUT_OF_RANGE](https://docs.beel.es/errors/PLAZO_DIAS_OUT_OF_RANGE.md): Payment term must be between ‹value› and ‹value› days - [SWIFT_INVALID](https://docs.beel.es/errors/SWIFT_INVALID.md): Invalid SWIFT code: ‹value›. Must be 8 or 11 characters (e.g.: ABCDESMMXXX) - [BAD_REQUEST](https://docs.beel.es/errors/BAD_REQUEST.md): The provided data is not valid. - [BUSINESS_RULE_VIOLATION](https://docs.beel.es/errors/BUSINESS_RULE_VIOLATION.md): The operation breaks a business rule. - [CONCURRENT_MODIFICATION](https://docs.beel.es/errors/CONCURRENT_MODIFICATION.md): Another request changed the same resource while yours was being processed, so yours was rolled back and nothing of it was applied. - [CONFLICT](https://docs.beel.es/errors/CONFLICT.md): The operation conflicts with the current state of the resource. - [ENDPOINT_NOT_FOUND](https://docs.beel.es/errors/ENDPOINT_NOT_FOUND.md): The requested endpoint does not exist. - [EXTERNAL_SERVICE_ERROR](https://docs.beel.es/errors/EXTERNAL_SERVICE_ERROR.md): The AEAT census could not be reached to validate the NIF, so the account or company was not created. Nothing was stored. - [IDEMPOTENCY_KEY_MISMATCH](https://docs.beel.es/errors/IDEMPOTENCY_KEY_MISMATCH.md): The `Idempotency-Key` was already used, within the last 24 hours, for a request with a different body. A key identifies one operation, so… - [IDEMPOTENCY_KEY_PROCESSING](https://docs.beel.es/errors/IDEMPOTENCY_KEY_PROCESSING.md): A request with the same `Idempotency-Key` is still being processed, usually because a client retried before the first call answered. It can… - [IDEMPOTENCY_KEY_REQUIRED](https://docs.beel.es/errors/IDEMPOTENCY_KEY_REQUIRED.md): The operation requires the `Idempotency-Key` header and the request did not send it. It is mandatory where a repeated call would duplicate… - [INTERNAL_ERROR](https://docs.beel.es/errors/INTERNAL_ERROR.md): An unexpected error occurred. Please try again later. - [INVALID_IDEMPOTENCY_KEY](https://docs.beel.es/errors/INVALID_IDEMPOTENCY_KEY.md): The `Idempotency-Key` header is empty, longer than 255 characters, or contains characters other than letters, digits, `_` and `-`. It can… - [INVALID_JSON_FORMAT](https://docs.beel.es/errors/INVALID_JSON_FORMAT.md): The body could not be read: it is not valid JSON, or a property has the wrong type or format (a string where a number is expected, a date… - [METHOD_NOT_ALLOWED](https://docs.beel.es/errors/METHOD_NOT_ALLOWED.md): The HTTP method used is not allowed on this path. - [MISSING_HEADER](https://docs.beel.es/errors/MISSING_HEADER.md): A required request header is missing. - [MISSING_PARAMETER](https://docs.beel.es/errors/MISSING_PARAMETER.md): A required request parameter is missing. - [MISSING_PART](https://docs.beel.es/errors/MISSING_PART.md): A required part of the multipart request is missing. - [NOT_ACCEPTABLE](https://docs.beel.es/errors/NOT_ACCEPTABLE.md): The response cannot be returned in the requested content type. - [NOT_FOUND](https://docs.beel.es/errors/NOT_FOUND.md): ‹value› with identifier ‹value› does not exist or is not available to this credential. - [UNSUPPORTED_MEDIA_TYPE](https://docs.beel.es/errors/UNSUPPORTED_MEDIA_TYPE.md): The submitted content type is not supported. - [VALIDATION_ERROR](https://docs.beel.es/errors/VALIDATION_ERROR.md): Part of the request is not acceptable. With `422`, the body parsed but a value breaks a rule: a missing required property, a length or… - [RATE_LIMIT_EXCEEDED](https://docs.beel.es/errors/RATE_LIMIT_EXCEEDED.md): You sent more requests than your rate-limit tier allows in its 60-second window. It can happen on any operation. Most endpoints count per… - [AUTOMATIC_EMAIL_CONFIG_INVALID](https://docs.beel.es/errors/AUTOMATIC_EMAIL_CONFIG_INVALID.md): For automatic sending, you must provide an email configuration or a client with email - [CONFIGURATION_INVALID](https://docs.beel.es/errors/CONFIGURATION_INVALID.md): The configuration is not valid - [EXEMPTION_REASON_NOT_ALLOWED_AS_DEFAULT](https://docs.beel.es/errors/EXEMPTION_REASON_NOT_ALLOWED_AS_DEFAULT.md): That reason depends on each invoice and cannot be declared as a default: choose art. 20 exemption or other - [EXEMPTION_REASON_REQUIRES_ZERO_RATE](https://docs.beel.es/errors/EXEMPTION_REASON_REQUIRES_ZERO_RATE.md): An exemption reason is only compatible with a 0% tax rate - [EXEMPTION_REASON_TEXT_REQUIRED](https://docs.beel.es/errors/EXEMPTION_REASON_TEXT_REQUIRED.md): Provide the text explaining the exemption when the reason is "Other" - [FIELD_BLANK](https://docs.beel.es/errors/FIELD_BLANK.md): The field ‹value› cannot be empty - [FIELD_OUT_OF_RANGE](https://docs.beel.es/errors/FIELD_OUT_OF_RANGE.md): A numeric field is outside the range it accepts. The message names the field and its minimum and maximum. - [FIELD_TOO_LONG](https://docs.beel.es/errors/FIELD_TOO_LONG.md): A text field is longer than it may be. The message names the field and its maximum length. - [FORBIDDEN](https://docs.beel.es/errors/FORBIDDEN.md): You do not have permission to perform this action - [INVALID_EMAIL_FORMAT](https://docs.beel.es/errors/INVALID_EMAIL_FORMAT.md): The email ‹value› has an invalid format - [INVALID_TOKEN](https://docs.beel.es/errors/INVALID_TOKEN.md): The token is invalid or has expired - [IRPF_REQUIRED_WHEN_NOT_EXEMPT](https://docs.beel.es/errors/IRPF_REQUIRED_WHEN_NOT_EXEMPT.md): The income tax withholding percentage is required when not exempt - [MAIN_TAX_REQUIRED](https://docs.beel.es/errors/MAIN_TAX_REQUIRED.md): You must configure a main tax (VAT, IGIC or IPSI) - [MISSING_REQUIRED_FIELD](https://docs.beel.es/errors/MISSING_REQUIRED_FIELD.md): The field ‹value› is required - [RECARGO_EQUIVALENCIA_REQUIRED](https://docs.beel.es/errors/RECARGO_EQUIVALENCIA_REQUIRED.md): The equivalence surcharge is required for this type of operation - [RECARGO_IVA_COMBINATION_INVALID](https://docs.beel.es/errors/RECARGO_IVA_COMBINATION_INVALID.md): The equivalence surcharge does not match the chosen VAT rate. - [RECARGO_REQUIRES_REGIME_RE](https://docs.beel.es/errors/RECARGO_REQUIRES_REGIME_RE.md): When equivalence surcharge is enabled, the main tax regime must be "18 - Equivalence surcharge". Change the regime to 18 or disable the… - [REQUEST_BODY_TOO_LARGE](https://docs.beel.es/errors/REQUEST_BODY_TOO_LARGE.md): The request body is larger than the API accepts. It is rejected before being read. `error.details` carries `max_size_formatted`… - [SERVICE_UNAVAILABLE](https://docs.beel.es/errors/SERVICE_UNAVAILABLE.md): The service is temporarily unavailable. Please try again in a few seconds. - [STORAGE_URL_EMPTY](https://docs.beel.es/errors/STORAGE_URL_EMPTY.md): Storage URL cannot be empty - [TAX_CONFIG_CONFLICT](https://docs.beel.es/errors/TAX_CONFIG_CONFLICT.md): Another operation created the tax configuration at the same time. Please try again. - [TOO_MANY_REQUESTS](https://docs.beel.es/errors/TOO_MANY_REQUESTS.md): You have exceeded the request limit. Please try again in ‹value› seconds - [VALUE_OUT_OF_RANGE](https://docs.beel.es/errors/VALUE_OUT_OF_RANGE.md): The value provided exceeds the range allowed for that field - [VALUE_TOO_LONG](https://docs.beel.es/errors/VALUE_TOO_LONG.md): The value provided exceeds the maximum length allowed for that field - [ZERO_RATE_REQUIRES_EXEMPTION_REASON](https://docs.beel.es/errors/ZERO_RATE_REQUIRES_EXEMPTION_REASON.md): 0% is not a tax rate: state why the operation carries no tax (art. 20 exemption or another reason) ## Companies - [ACCOUNT_HAS_NO_HOLDER](https://docs.beel.es/errors/ACCOUNT_HAS_NO_HOLDER.md): The target account has no registered holder yet, so a NIF cannot be created on its behalf - [CANNOT_DELETE_PRIMARY](https://docs.beel.es/errors/CANNOT_DELETE_PRIMARY.md): The company is the account's primary NIF, which cannot be deleted. - [CHECKOUT_REQUIRED](https://docs.beel.es/errors/CHECKOUT_REQUIRED.md): A payment method is required to create a production company - [COMPANY_ACTIVE_IN_PRODUCTION](https://docs.beel.es/errors/COMPANY_ACTIVE_IN_PRODUCTION.md): This company is active in Live and cannot be deleted. Deactivate it in Live first: the deactivation is scheduled, the current cycle is… - [COMPANY_HAS_INVOICES](https://docs.beel.es/errors/COMPANY_HAS_INVOICES.md): This company has invoices in Live and cannot be deleted. Delete its drafts and proformas first; if it has already issued invoices, the way… - [COMPANY_NOT_FOUND](https://docs.beel.es/errors/COMPANY_NOT_FOUND.md): Company not found - [ENVIRONMENT_ESCALATION](https://docs.beel.es/errors/ENVIRONMENT_ESCALATION.md): A sandbox (test) API key cannot create a production (live) API key - [MAX_PROFILES_REACHED](https://docs.beel.es/errors/MAX_PROFILES_REACHED.md): You have reached the maximum number of business profiles (‹value›). Upgrade your plan for more - [NIF_ALREADY_REGISTERED](https://docs.beel.es/errors/NIF_ALREADY_REGISTERED.md): The NIF is already registered - [NIF_PROD_ALREADY_ACTIVE_IN_ANOTHER_ACCOUNT](https://docs.beel.es/errors/NIF_PROD_ALREADY_ACTIVE_IN_ANOTHER_ACCOUNT.md): This NIF is already registered in production under another account. A NIF can only issue real invoices from a single account. - [NUMBERING_REQUIRES_ACTIVATION](https://docs.beel.es/errors/NUMBERING_REQUIRES_ACTIVATION.md): Series numbering can only be configured in a creation request that activates the company. Remove the numbering block or activate a mode… - [PAYMENT_REQUIRED](https://docs.beel.es/errors/PAYMENT_REQUIRED.md): You have an outstanding payment. Settle it to keep operating in production - [PLAN_ACTIVATION_REQUIRED](https://docs.beel.es/errors/PLAN_ACTIVATION_REQUIRED.md): Your plan is still in its trial period. Activate it to start invoicing in production - [PRODUCTION_TWIN_SOURCE_ALREADY_PRODUCTION](https://docs.beel.es/errors/PRODUCTION_TWIN_SOURCE_ALREADY_PRODUCTION.md): The source company is already in production; cannot create a twin - [SUBACCOUNT_PROFILE_NOT_FOUND](https://docs.beel.es/errors/SUBACCOUNT_PROFILE_NOT_FOUND.md): Business profile not found - [PROFILE_NOT_OWNED](https://docs.beel.es/errors/PROFILE_NOT_OWNED.md): The business profile does not belong to your account - [SCOPE_ESCALATION](https://docs.beel.es/errors/SCOPE_ESCALATION.md): Child API key cannot have more scopes than the parent key - [SUBACCOUNT_USER_NOT_FOUND](https://docs.beel.es/errors/SUBACCOUNT_USER_NOT_FOUND.md): User not found ## Subscriptions - [BILLING_MANAGED_BY_PROVIDER](https://docs.beel.es/errors/BILLING_MANAGED_BY_PROVIDER.md): This account's subscription is managed by your provider; you cannot change it here. - [CHECKOUT_URLS_REQUIRED](https://docs.beel.es/errors/CHECKOUT_URLS_REQUIRED.md): success_url and cancel_url are required to set up billing - [FEATURE_NOT_AVAILABLE](https://docs.beel.es/errors/FEATURE_NOT_AVAILABLE.md): The ‹value› feature is not available in your plan - [NIF_LIMIT_REACHED](https://docs.beel.es/errors/NIF_LIMIT_REACHED.md): You have reached the maximum of ‹value› active NIFs in Live included in your agreement. Contact BeeL to increase it. - [NOT_BILLING_OWNER](https://docs.beel.es/errors/NOT_BILLING_OWNER.md): Only the account owner can manage the subscription and billing. - [PAID_PLAN_REQUIRED](https://docs.beel.es/errors/PAID_PLAN_REQUIRED.md): This feature is only available on paid plans. Upgrade your plan to use it - [QUOTA_EXCEEDED](https://docs.beel.es/errors/QUOTA_EXCEEDED.md): You have exceeded your ‹value› limit: ‹value›/‹value› used. Resets on ‹value› - [SUBSCRIPTION_REQUIRED](https://docs.beel.es/errors/SUBSCRIPTION_REQUIRED.md): An active subscription is required to access this resource ## VeriFactu - [ALREADY_DISABLED](https://docs.beel.es/errors/ALREADY_DISABLED.md): VeriFactu is already disabled for this user - [ALREADY_ENABLED](https://docs.beel.es/errors/ALREADY_ENABLED.md): VeriFactu is already enabled for this user - [ALREADY_REGISTERED](https://docs.beel.es/errors/ALREADY_REGISTERED.md): The NIF is already registered in VeriFactu - [API_COMMUNICATION_ERROR](https://docs.beel.es/errors/API_COMMUNICATION_ERROR.md): Error communicating with the VeriFactu API - [API_KEY_NOT_CONFIGURED](https://docs.beel.es/errors/API_KEY_NOT_CONFIGURED.md): The VeriFactu API key has not been configured - [CANNOT_SIGN_CANCELLED](https://docs.beel.es/errors/CANNOT_SIGN_CANCELLED.md): Cannot sign a cancelled document - [CANNOT_UPDATE_FINAL_STATE](https://docs.beel.es/errors/CANNOT_UPDATE_FINAL_STATE.md): A VeriFactu record in a final state cannot be updated: ‹value› - [COMPANY_NIF_MISSING](https://docs.beel.es/errors/COMPANY_NIF_MISSING.md): The issuing company has no NIF configured: every invoice carries the NIF of its issuer (RD 1619/2012, art. 6.1.d). Set the NIF before… - [CONFIG_NOT_FOUND](https://docs.beel.es/errors/CONFIG_NOT_FOUND.md): VeriFactu configuration not found - [DIRECCION_FISCAL_REQUIRED](https://docs.beel.es/errors/DIRECCION_FISCAL_REQUIRED.md): Fiscal address is required to register with VeriFactu - [DOCUMENT_ALREADY_CANCELLED](https://docs.beel.es/errors/DOCUMENT_ALREADY_CANCELLED.md): The document is already cancelled - [ENV_MISMATCH](https://docs.beel.es/errors/ENV_MISMATCH.md): API key does not match NIF environment: use a live key for production NIFs and a test key for sandbox NIFs - [FACTURA_ALREADY_REGISTERED](https://docs.beel.es/errors/FACTURA_ALREADY_REGISTERED.md): This invoice is already registered in VeriFactu - [INVOICE_AXIS_MISSING](https://docs.beel.es/errors/INVOICE_AXIS_MISSING.md): The invoice has no company or environment assigned, so the NIF to register it with in VeriFactu cannot be determined - [INVOICE_COMPANY_MISMATCH](https://docs.beel.es/errors/INVOICE_COMPANY_MISMATCH.md): The VeriFactu configuration belongs to a different company than the invoice - [INVOICE_NOT_EMITIDA](https://docs.beel.es/errors/INVOICE_NOT_EMITIDA.md): The invoice must be issued before submitting to VeriFactu - [INVOICE_NO_NUMBER](https://docs.beel.es/errors/INVOICE_NO_NUMBER.md): The invoice does not have an assigned number - [INVOICE_VERIFACTU_DISABLED](https://docs.beel.es/errors/INVOICE_VERIFACTU_DISABLED.md): VeriFactu is not enabled for this invoice - [NIF_MISMATCH](https://docs.beel.es/errors/NIF_MISMATCH.md): The provided NIF does not match the user's NIF - [NIF_NOT_CONFIGURED](https://docs.beel.es/errors/NIF_NOT_CONFIGURED.md): The company has no NIF yet, and the operation acts before the AEAT on that NIF. - [NIF_NOT_REGISTERED](https://docs.beel.es/errors/NIF_NOT_REGISTERED.md): The NIF is not registered in VeriFactu - [NIF_REACTIVATION_FAILED](https://docs.beel.es/errors/NIF_REACTIVATION_FAILED.md): Error reactivating the NIF in VeriFactu - [NIF_REGISTRATION_FAILED](https://docs.beel.es/errors/NIF_REGISTRATION_FAILED.md): Error registering the NIF in VeriFactu - [NIF_REPRESENTATION_REQUIRED](https://docs.beel.es/errors/NIF_REPRESENTATION_REQUIRED.md): The company's NIF is registered but it has not signed the representation that lets BeeL. submit its invoices to the tax authority. It is… - [NIF_VALIDATION_ERROR](https://docs.beel.es/errors/NIF_VALIDATION_ERROR.md): Technical error validating the NIF against the AEAT census - [NIF_VALIDATION_INVALID](https://docs.beel.es/errors/NIF_VALIDATION_INVALID.md): The NIF is not registered in the AEAT census. It is checked in the sandbox too, so a made-up NIF with a valid check digit is rejected. - [NIF_VALIDATION_PENDING](https://docs.beel.es/errors/NIF_VALIDATION_PENDING.md): The NIF is pending validation against the AEAT census - [NO_UNSIGNED_DOCUMENT](https://docs.beel.es/errors/NO_UNSIGNED_DOCUMENT.md): No unsigned representation document exists. Generate one before uploading the signed PDF - [PDF_EMPTY](https://docs.beel.es/errors/PDF_EMPTY.md): The PDF file is empty - [PDF_INVALID_EXTENSION](https://docs.beel.es/errors/PDF_INVALID_EXTENSION.md): The uploaded file is not a PDF. - [PDF_INVALID_FORMAT](https://docs.beel.es/errors/PDF_INVALID_FORMAT.md): The file does not have a valid PDF format - [PDF_SIGNATURE_INVALID](https://docs.beel.es/errors/PDF_SIGNATURE_INVALID.md): The uploaded PDF carries no valid electronic signature. - [PDF_STORAGE_FAILED](https://docs.beel.es/errors/PDF_STORAGE_FAILED.md): Error saving the signed PDF. Please try again - [PDF_TOO_LARGE](https://docs.beel.es/errors/PDF_TOO_LARGE.md): The PDF file exceeds the maximum allowed size: ‹value› (maximum: ‹value› MB) - [PDF_VALIDATION_FAILED](https://docs.beel.es/errors/PDF_VALIDATION_FAILED.md): Error validating the signed PDF. Please try again later - [VERIFACTU_PROFILE_NOT_FOUND](https://docs.beel.es/errors/VERIFACTU_PROFILE_NOT_FOUND.md): User profile not found - [PRODUCTION_ACCESS_DENIED](https://docs.beel.es/errors/PRODUCTION_ACCESS_DENIED.md): You cannot issue real invoices with this NIF yet: activate a production plan before crossing to VeriFactu production - [RECTIFICATIVA_NO_CODE](https://docs.beel.es/errors/RECTIFICATIVA_NO_CODE.md): The credit note must have a correction code - [RECTIFICATIVA_NO_ORIGINAL](https://docs.beel.es/errors/RECTIFICATIVA_NO_ORIGINAL.md): The credit note must reference an original invoice - [RECTIFICATIVA_R1R4_NOT_SIMPLIFICADA](https://docs.beel.es/errors/RECTIFICATIVA_R1R4_NOT_SIMPLIFICADA.md): The original invoice is `SIMPLIFIED`, and `R1`–`R4` do not apply to simplified invoices. - [RECTIFICATIVA_R5_ONLY_SIMPLIFICADA](https://docs.beel.es/errors/RECTIFICATIVA_R5_ONLY_SIMPLIFICADA.md): `rectification_code` is `R5`, which only corrects simplified invoices, but the original invoice is not `SIMPLIFIED`. - [REGISTRO_NOT_FOUND](https://docs.beel.es/errors/REGISTRO_NOT_FOUND.md): VeriFactu registration record not found - [REPRESENTATION_ALREADY_ACTIVE](https://docs.beel.es/errors/REPRESENTATION_ALREADY_ACTIVE.md): The company already has an active representation document, so a new one is not generated. - [REPRESENTATION_DOCUMENT_NOT_STORED](https://docs.beel.es/errors/REPRESENTATION_DOCUMENT_NOT_STORED.md): The company's representation document has no stored PDF to download. - [REPRESENTATION_NOT_ACTIVE](https://docs.beel.es/errors/REPRESENTATION_NOT_ACTIVE.md): The company has no active representation document (generated and signed), so there is nothing to cancel. - [REPRESENTATION_NOT_FOUND](https://docs.beel.es/errors/REPRESENTATION_NOT_FOUND.md): No representation document has been generated for the company, so there is nothing to download. - [SIGNING_ONLY_IN_LIVE](https://docs.beel.es/errors/SIGNING_ONLY_IN_LIVE.md): The signed VeriFactu representation is only submitted in Live; it has no test mode. - [SUBMISSION_IN_PROGRESS](https://docs.beel.es/errors/SUBMISSION_IN_PROGRESS.md): A submission of this invoice to VeriFactu is already in progress - [UUID_BLANK](https://docs.beel.es/errors/UUID_BLANK.md): The VeriFactu UUID cannot be null or empty - [UUID_INVALID_FORMAT](https://docs.beel.es/errors/UUID_INVALID_FORMAT.md): The VeriFactu UUID format is invalid: ‹value› - [UUID_NULL](https://docs.beel.es/errors/UUID_NULL.md): The VeriFactu UUID cannot be null - [VERIFACTU_ALWAYS_ON_IN_SANDBOX](https://docs.beel.es/errors/VERIFACTU_ALWAYS_ON_IN_SANDBOX.md): You tried to disable VeriFactu with a sandbox credential. In sandbox VeriFactu is always on, so that integrations are always tested against… - [VERIFACTU_REPRESENTATION_REQUIRED](https://docs.beel.es/errors/VERIFACTU_REPRESENTATION_REQUIRED.md): You tried to enable VeriFactu in production for a company that has no signed representation. In production the signed representation is a… ## Webhooks - [WEBHOOK_ACTIVE_SUBSCRIPTION_LIMIT_REACHED](https://docs.beel.es/errors/WEBHOOK_ACTIVE_SUBSCRIPTION_LIMIT_REACHED.md): The account already has 10 active webhook subscriptions, and the request would add an eleventh: creating one, or turning a paused one back… - [DELIVERY_LOG_NOT_FOUND](https://docs.beel.es/errors/DELIVERY_LOG_NOT_FOUND.md): Webhook delivery log not found - [WEBHOOK_REACTIVATION_REQUIRES_LIVE_ENDPOINT](https://docs.beel.es/errors/WEBHOOK_REACTIVATION_REQUIRES_LIVE_ENDPOINT.md): BeeL. paused this subscription. To reactivate it, the endpoint must first answer a test delivery successfully. - [WEBHOOK_SUBSCRIPTION_NOT_FOUND](https://docs.beel.es/errors/WEBHOOK_SUBSCRIPTION_NOT_FOUND.md): Webhook subscription not found - [WEBHOOK_URL_INVALID](https://docs.beel.es/errors/WEBHOOK_URL_INVALID.md): The webhook URL uses `https://` but has no deliverable host, for example `https:///path` or `https://.example.com`. A value that is not a… - [URL_MUST_BE_HTTPS](https://docs.beel.es/errors/URL_MUST_BE_HTTPS.md): The webhook URL does not start with `https://`. Events are only delivered over TLS. - [URL_TARGET_NOT_ALLOWED](https://docs.beel.es/errors/URL_TARGET_NOT_ALLOWED.md): The webhook URL points to an internal network address: a private, loopback or link-local IP, or a host name that resolves to one. If any of…