Estados y modos de registro

⚠️Warning

Está viendo la documentación de la versión de API 2026-02-03. La versión más reciente es 2026-06-01.

Esta sección describe el ciclo de vida de un Record — los posibles valores de state y mode y las transiciones entre ellos, todas activadas automáticamente por el sistema.

Estados

• Accepted: El Record ha sido recibido y ha superado la validación inicial, pero aún no se ha persistido ningún resultado final. Este es un estado temporal.
• Rejected (Rechazado): El Registro ha sido recibido pero no ha superado nuestras verificaciones de validación internas. Los detalles están disponibles en los mensajes de registro. Este es un estado final.
• Completed: El Record fue enviado con éxito y aceptado por la Agencia Tributaria. Este es un estado final.
• Failed: Se produjo un error durante el procesamiento. El Record no superó las comprobaciones de validación de la Agencia Tributaria, o un error impidió que nuestro sistema confirmara el resultado de la transmisión. Los detalles están disponibles en los mensajes de registro. Este es un estado final.

💡Sugerencia: consulta nuestra Guía de gestión de errores

El siguiente artículo proporciona una descripción general de los errores más comunes al enviar registros a través de SIGN IT lite, junto con orientación sobre cómo resolverlos: SIGN IT - Error Handling Guide

Modos

• Processing (Procesando): El Record está siendo procesado. El estado correspondiente es Accepted.
• Finished (Finalizado): El Record ha sido procesado, con un resultado exitoso o no exitoso. El estado correspondiente es Rejected, Completed o Failed.

Transiciones de estado

• POST → Accepted: El Registro se crea a través de una llamada API y entra temporalmente en el estado Aceptado si se valida correctamente.
• POST → Rejected: Si el Registro no supera la validación interna durante la creación, pasa automáticamente al estado Rechazado, proporcionando mensajes de registro adicionales sobre el error.
• Accepted → Completed: Esta transición ocurre automáticamente una vez que el Registro ha sido procesado correctamente.
• Accepted → Failed: Si se produce un error durante el procesamiento, el Registro pasa automáticamente al estado Fallido, proporcionando mensajes de registro adicionales para la depuración.

⚠️Importante

El estado final de un registro TRANSACTION se devuelve directamente en la respuesta POST sincrónica — no se requieren polling ni webhooks.

Transiciones de modo

• Processing → Finished: Una vez que el Registro ha sido procesado, independientemente de si el resultado es exitoso o no, pasa automáticamente al modo Finalizado.

📘Nota

Processing es el modo predeterminado de cada INTENTION al momento de su creación. Una vez que la INTENTION es referenciada en una TRANSACTION, toma el estado y el modo de esa TRANSACTION.

Para los registros TRANSACTION, Processing es normalmente temporal y debería resolverse en modo Finished en segundos. Si una TRANSACTION permanece en modo Processing durante más de unos minutos, trátelo como una transición bloqueada y contáctenos con el ID del registro para que podamos investigar.