Estados y modos de los Records

⚠️Warning

Está viendo la documentación de la versión de API 2026-05-04. 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: El Record ha sido recibido pero no superó 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 ofrece una descripción general de los errores más comunes al enviar Records a través de SIGN IT lite, junto con orientación sobre cómo resolverlos: SIGN IT - Error Handling Guide

Modos

• Processing: El Record está siendo procesado. El estado correspondiente es Accepted.
• Finished: 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 Record se crea mediante una llamada a la API y entra temporalmente en el estado Accepted si se valida correctamente.
• POST → Rejected: Si el Record falla la validación interna durante la creación, pasa automáticamente al estado Rejected, proporcionando mensajes de registro adicionales sobre el error.
• Accepted → Completed: Esta transición se produce automáticamente una vez que el Record ha sido procesado correctamente.
• Accepted → Failed: Si se produce un error durante el procesamiento, el Record pasa automáticamente al estado Failed, 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 Record ha sido procesado, independientemente de si el resultado es exitoso o no, pasa automáticamente al modo Finished.

📘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.