Codis d'error de Factures
Tots els codis d'error de l'API pública que emet Factures, amb el seu estat HTTP, el seu type i una pàgina per codi.
Codis d'error que emet Factures. Cada code enllaça a la seva pròpia pàgina amb la causa i l'acció a prendre.
| Code | Type | HTTP | Descripció |
|---|---|---|---|
corrective_invoice_inanulable | invalid_request_error | 422 | La factura és al seu torn una rectificativa, i les rectificatives no s'anul·len mai: la cadena de correcció ha de seguir sent auditable de punta a punta. |
export_limit_exceeded | invalid_request_error | 422 | La selecció filtrada supera el límit de 5.000 factures de l'exportació, així que el fitxer es rebutja d'entrada en lloc de truncar-se en silenci. |
invalid_correction_nature | invalid_request_error | 422 | correction_nature només accepta S (substitució: la rectificativa porta els imports corregits complets) o I (per diferències: només porta el delta). |
invalid_correction_reason | invalid_request_error | 422 | El motiu de rectificació queda fora de la llista fiscal tancada (error_fundado, concurso, incobrable, error_importe, error_cliente, devolucion, descuento, otras), que mapeja als codis AEAT R1 a R4. |
invalid_invoice_id | invalid_request_error | 400 | La referència de factura rebuda no és un identificador vàlid; sol voler dir que s'ha colat un valor intern on l'API espera l'id públic. |
invalid_invoice_number | invalid_request_error | 422 | El número de factura no segueix el format canònic SÈRIE-AAAA-NNN, més el sufix -RECn a les rectificatives. |
invalid_invoice_status | invalid_request_error | 422 | El valor enviat com a estat de factura queda fora del catàleg del cicle de vida (draft, scheduled, sent, paid, overdue, cancelled, annulled). |
invalid_invoice_uuid | invalid_request_error | 400 | L'identificador de factura de la ruta o del payload no és un UUID vàlid. |
invalid_payment_method | invalid_request_error | 422 | El mètode de pagament queda fora de l'allowlist tancada: bank_transfer, cash, credit_card, sepa_direct_debit, paypal, bizum, other. |
invoice_already_annulled | invalid_request_error | 422 | La factura ja estava anul·lada. L'anul·lació és terminal i, amb VeriFactu actiu, el seu registre d'anul·lació ja va arribar a l'AEAT. |
invoice_already_paid | invalid_request_error | 422 | La factura ja està cobrada. paid és un estat terminal i comptablement tancat: l'IVA repercutit ja s'ha declarat, o es declararà en el període. |
invoice_already_sent | invalid_request_error | 422 | La factura ja va ser emesa: té número definitiu de sèrie i, amb VeriFactu actiu, l'alta a l'AEAT. L'emissió no passa dues vegades. |
invoice_cannot_assign_number | invalid_request_error | 422 | Es va demanar número definitiu per a una factura que no és esborrany, o que ja en té. La numeració de sèrie és monòtona i els números no es reassignen. |
invoice_invalid_status_transition | invalid_request_error | 422 | L'estat destí no és assolible des de l'actual. El cicle de vida és dirigit: draft passa a scheduled o sent, sent a paid, overdue o annulled, i paid, cancelled i annulled són terminals. |
invoice_not_cancellable_in_current_state | invalid_request_error | 422 | Cancel·lar retira un esborrany que encara no és fiscalment vinculant, així que només s'aplica mentre la factura està en draft. |
invoice_not_correctable_in_current_state | invalid_request_error | 422 | Una rectificativa només s'emet contra una factura ja emesa (sent o paid). Un esborrany, una factura cancel·lada o una anul·lada no tenen res a rectificar. |
invoice_not_deletable_in_current_state | invalid_request_error | 422 | Només s'esborren les factures en draft i cancelled. Una factura numerada no desapareix mai: la sèrie correlativa ha de seguir sent auditable. |
invoice_not_editable_in_current_state | invalid_request_error | 422 | Només un esborrany admet edició. Un cop emesa, la factura és immutable i el seu contingut queda congelat juntament amb el seu registre fiscal. |
invoice_not_eligible_for_action | invalid_request_error | 422 | L'acció sol·licitada no s'aplica a aquesta factura: el seu tipus o el seu estat actual la deixen fora de l'abast de l'operació. |
invoice_not_found | not_found_error | 404 | L'identificador no resol a cap factura de l'empresa autenticada. Les factures d'una altra empresa responen exactament igual. |
invoice_not_modifiable_in_current_state | invalid_request_error | 422 | El camp que intentes canviar està congelat per a l'estat actual — per exemple el règim fiscal d'una factura anul·lada. |
invoice_not_paid | invalid_request_error | 422 | Es va demanar un justificant de pagament d'una factura sense cobrament registrat, així que no hi ha res a certificar. |
invoice_not_reschedulable_in_current_state | invalid_request_error | 422 | Reprogramar mou la data d'emissió d'una factura que espera en scheduled, i aquesta factura no està esperant. |
invoice_not_schedulable_in_current_state | invalid_request_error | 422 | Només un esborrany es pot programar: la programació reserva un moment futur d'emissió sense consumir encara número de sèrie. |
invoice_not_unschedulable_in_current_state | invalid_request_error | 422 | Desprogramar torna la factura de scheduled a draft, així que només s'aplica mentre segueix esperant a emetre's. |
invoice_not_unsendable_in_current_state | invalid_request_error | 422 | Desfer la marca de lliurament només s'aplica a una factura sent: neteja sent_at i manté la factura emesa. |
invoice_requires_at_least_one_line | invalid_request_error | 422 | La factura no porta cap línia d'operació, així que no té base imposable i no es pot emetre. Passa tant quan no envies línies com quan totes les que envies són de suplert: un suplert és una quantitat pagada per compte del client (art. 78.Tres.3 LIVA), no una operació teva. |
invoice_year_required_for_ambiguous_number | invalid_request_error | 422 | Aquest número de factura existeix en més d'un exercici, així que per si sol no identifica una única factura. |
line_total_checksum_mismatch | invalid_request_error | 422 | El line_total declarat no coincideix amb el que calcula Factuarea per a aquella línia (quantitat × preu − descompte + IVA − retenció + recàrrec) i la desviació supera el cèntim de tolerància. L'import que es factura i es declara a l'AEAT és sempre el calculat aquí, així que la discrepància vol dir que el teu sistema i la factura emesa no quadrarien. |
line_type_invalid | invalid_request_error | 422 | El tipus de línia queda fora del catàleg tancat NORMAL / SUPLIDO. Una factura emesa només distingeix dues naturaleses: el que véns tu, que forma base imposable i porta IVA, i el suplert, que són diners avançats en nom i per compte del client i per això queda fora de la base (art. 78.Tres.3 LIVA). |
no_invoices_in_period | invalid_request_error | 422 | L'operació trimestral no va trobar factures en el període demanat, així que no hi ha res a empaquetar ni a enviar. |
payment_method_invalid | invalid_request_error | 422 | La mateixa allowlist tancada que invalid_payment_method, reportada quan el valor es rebutja en llegir el camp de mètode de pagament del payload. |
reminder_not_applicable | invalid_request_error | 422 | El recordatori de pagament no escau: la factura no està en sent ni overdue, no hi ha adreça de destinatari, falta l'enllaç públic o està desactivat, o ja va sortir un altre recordatori les últimes 24 hores. |
scheduled_for_in_past | invalid_request_error | 422 | scheduled_for no és estrictament futur, així que no hi ha cap espera a reservar. |
simplified_invoice_cannot_be_substituted | invalid_request_error | 422 | Una de les factures de la llista de substitució no es pot substituir: no és simplificada, està cancel·lada o anul·lada, pertany a una altra empresa, o ja té substitutiva. |
simplified_invoice_not_allowed | invalid_request_error | 422 | L'operació no és elegible per a factura simplificada: supera els 3.000 €, o és un lliurament intracomunitari, una exportació, una operació amb inversió del subjecte passiu, o el client necessita factura completa per deduir l'IVA. |
simplified_limit_exceeded | invalid_request_error | 422 | Les línies portarien la factura simplificada (F2) per sobre del límit legal absolut de 3.000 € IVA inclòs. |
suplido_line_cannot_carry_taxes | invalid_request_error | 422 | La línia de suplert porta càrrega pròpia: tipus d'IVA, retenció, recàrrec d'equivalència, descompte, clau de règim, causa d'exempció o producte/paquet. Un suplert no és una operació de l'emissor, així que repercutir-hi un impost seria tributar per un lliurament que no has fet, i lligar-lo a un producte mouria un estoc que mai no has venut. |
suplido_not_allowed_in_simplified_invoice | invalid_request_error | 422 | La factura és simplificada (F2) i una simplificada no identifica el destinatari. Sense destinatari identificat no hi ha a qui acreditar el pagament per compte d'altri, així que l'import no admet el tractament de suplert en aquest tipus de factura. |
suplido_requires_source_invoice_reference | invalid_request_error | 422 | La línia de suplert no informa source_invoice_reference, el número del justificant que el tercer va expedir a nom del client. Sense aquest justificant el pagament no s'acredita com a fet per compte d'altri i Hisenda el tractaria com a base imposable pròpia de l'emissor, amb el seu IVA repercutit. |