Tras crear una factura, SIGN ES la envía a la administración tributaria correspondiente, y el campo transmission.registration indica en qué punto está el envío. Este artículo explica cada estado y qué hacer cuando la administración no está disponible.
| Estado | Significado | Qué hacer |
|---|---|---|
PENDING |
La solicitud de registro está a la espera de ser procesada. Con Verifactu suele cambiar en torno a 60 segundos, y con TicketBAI casi de inmediato | Consultar de nuevo la factura |
REGISTERED |
La administración ha recibido y registrado la factura. No implica que el contenido sea fiscalmente correcto | No es necesario hacer nada |
REQUIRES_CORRECTION |
La factura se registró, pero se detectaron errores | Consultar el campo validations para confirmar cuál es el error y proceder con la rectificación o la subsanación según corresponda |
REQUIRES_INSPECTION |
La administración rechazó la factura porque detectó errores | Consultar el campo validations para confirmar cuál es el error y proceder con la rectificación o la subsanación según corresponda |
STORED |
SIGN ES guardó la factura sin enviarla a la administración. Este estado solo se da en Bizkaia, cuando falta el epígrafe de actividad en la factura de un autónomo | Añadir el epígrafe con un PATCH sobre la factura (annotations con type: "INDIVIDUAL" y activity_code) |
INVALID |
Es el estado de las facturas de tipo EXTERNAL
|
No es necesario hacer nada |
El estado de la anulación se indica en transmission.cancellation, con valores equivalentes: NOT_CANCELLED, PENDING, CANCELLED, REQUIRES_INSPECTION, STORED e INVALID.
Cuando la administración tributaria no está disponible
Si fiskaly pierde la conexión con la administración tributaria (por ejemplo, por un mantenimiento por parte de la administración), las facturas permanecen en PENDING y SIGN ES reintenta el envío de forma automática. Se registran poco a poco cuando el servicio se restablece, y puede llevar varias horas.
No hay que reenviar la factura ni crear otra: hacerlo duplicaría el registro de la operación. Las incidencias y los mantenimientos de las administraciones se publican en la página de estado.
Cómo consultar el estado
No hay webhooks, así que el estado se consulta mediante polling con GET /clients/{client_id}/invoices/{invoice_id}. Todos los estados anteriores, salvo PENDING y STORED, son estados finales. No hace falta seguir consultando las facturas en REGISTERED, REQUIRES_CORRECTION, REQUIRES_INSPECTION o INVALID, porque esos estados ya no cambian.