ErrorsBy category
VeriFactu errors
All error codes returned by the VeriFactu endpoints (48 total).
Every error returned by the VeriFactu endpoints. Click any code for the full example response and localized messages.
| Code | Message |
|---|---|
ALREADY_DISABLED | VeriFactu is already disabled for this user |
ALREADY_ENABLED | VeriFactu is already enabled for this user |
ALREADY_REGISTERED | The NIF is already registered in VeriFactu |
API_COMMUNICATION_ERROR | Error communicating with the VeriFactu API |
API_KEY_NOT_CONFIGURED | The VeriFactu API key has not been configured |
APPLY_BY_DEFAULT_REQUIRES_ENABLED | apply_by_default can only be true when enabled is also true |
CANNOT_SIGN_CANCELLED | Cannot sign a cancelled document |
CANNOT_UPDATE_FINAL_STATE | A VeriFactu record in a final state cannot be updated: {0} |
COMPANY_NIF_MISSING | The issuing company has no NIF configured. Set the NIF before submitting invoices to VeriFactu |
CONFIG_NOT_FOUND | VeriFactu configuration not found |
DIRECCION_FISCAL_REQUIRED | Fiscal address is required to register with VeriFactu |
DOCUMENT_ALREADY_CANCELLED | The document is already cancelled |
ENV_MISMATCH | API key does not match NIF environment: use a live key for production NIFs and a test key for sandbox NIFs |
FACTURA_ALREADY_REGISTERED | This invoice is already registered in VeriFactu |
INVOICE_AXIS_MISSING | The invoice has no company or environment assigned, so the NIF to register it with in VeriFactu cannot be determined |
INVOICE_COMPANY_MISMATCH | The VeriFactu configuration belongs to a different company than the invoice |
INVOICE_NO_NUMBER | The invoice does not have an assigned number |
INVOICE_NOT_EMITIDA | The invoice must be issued before submitting to VeriFactu |
INVOICE_VERIFACTU_DISABLED | VeriFactu is not enabled for this invoice |
NIF_MISMATCH | The provided NIF does not match the user's NIF |
NIF_NOT_REGISTERED | The NIF is not registered in VeriFactu |
NIF_REACTIVATION_FAILED | Error reactivating the NIF in VeriFactu |
NIF_REGISTRATION_FAILED | Error registering the NIF in VeriFactu |
NIF_REPRESENTATION_REQUIRED | You must sign the AEAT representation model before issuing real invoices with this NIF |
NIF_VALIDATION_ERROR | Technical error validating the NIF against the AEAT census |
NIF_VALIDATION_INVALID | The NIF does not exist in the AEAT census |
NIF_VALIDATION_PENDING | The NIF is pending validation against the AEAT census |
NO_UNSIGNED_DOCUMENT | No unsigned representation document exists. Generate one before uploading the signed PDF |
PDF_EMPTY | The PDF file is empty |
PDF_INVALID_EXTENSION | The file must be a PDF (.pdf) |
PDF_INVALID_FORMAT | The file does not have a valid PDF format |
PDF_SIGNATURE_INVALID | The signed PDF is not valid: {0} |
PDF_STORAGE_FAILED | Error saving the signed PDF. Please try again |
PDF_TOO_LARGE | The PDF file exceeds the maximum allowed size: {0} (maximum: {1} MB) |
PDF_VALIDATION_FAILED | Error validating the signed PDF. Please try again later |
PRODUCTION_ACCESS_DENIED | You cannot issue real invoices with this NIF yet: activate a production plan before crossing to VeriFactu production |
RECTIFICATIVA_NO_CODE | The credit note must have a correction code |
RECTIFICATIVA_NO_ORIGINAL | The credit note must reference an original invoice |
RECTIFICATIVA_R1R4_NOT_SIMPLIFICADA | The R1-R4 correction methods do not apply to simplified invoices |
RECTIFICATIVA_R5_ONLY_SIMPLIFICADA | The R5 correction method only applies to simplified invoices |
REGISTRO_NOT_FOUND | VeriFactu registration record not found |
SIGNING_ONLY_IN_LIVE | The AEAT representation can only be signed in Live mode: the document has no test mode |
SUBMISSION_IN_PROGRESS | A submission of this invoice to VeriFactu is already in progress |
UUID_BLANK | The VeriFactu UUID cannot be null or empty |
UUID_INVALID_FORMAT | The VeriFactu UUID format is invalid: {0} |
UUID_NULL | The VeriFactu UUID cannot be null |
VERIFACTU_PROFILE_NOT_FOUND | User profile not found |
VERIFACTU_REPRESENTATION_NOT_SIGNED | You cannot enable VeriFactu on this invoice: the AEAT representation model for this NIF has not been signed yet |