Estados y Modos de Registro

⚠️Warning

Está viendo la documentación de la versión de API 2025-08-12. La versión más reciente es 2026-06-01. Los cambios principales incluyen terminología actualizada (Asset → Organization, Entity → Taxpayer/Location).

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 Registro ha sido recibido pero no ha superado nuestras comprobaciones de validación internas. Los detalles están disponibles en los mensajes de registro.
• 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.

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 Registro se crea mediante una llamada API y entra temporalmente en el estado Accepted si se valida con éxito.
• POST → Rejected: Si el Registro no supera la validación interna durante su creación, transiciona 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 Registro ha sido procesado con éxito.
• Accepted → Failed: Si se produce un error durante el procesamiento, el Registro transiciona 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 Registro ha sido procesado, independientemente de si el resultado es exitoso o no, transiciona 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.