Estados y Modos de Entity y System

⚠️Warning

Está viendo la documentación de la versión de API 2024-10-31. 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 proporciona una descripción general del state y el mode que definen el ciclo de vida y el comportamiento operativo de los recursos Entities y Systems. El siguiente diagrama ilustra las transiciones entre estos estados y modos, detallando cómo evoluciona el recurso desde su creación hasta su desactivación y cómo sus modos operativos se adaptan en función de eventos internos o llamadas a la API externas.

Comprender estas transiciones es esencial para gestionar los recursos de manera efectiva, garantizar operaciones fluidas y resolver problemas como credenciales no válidas o pausas temporales.

Estados

• Acquired: Estado inicial del recurso al crearse. No se pueden realizar operaciones en este estado.
• Commissioned: El recurso está listo y es completamente operativo (siempre que el modo sea operativo).
• Decommissioned: El recurso ya no es operativo y no puede realizar ninguna tarea.

Modos

• Inactive: Modo inicial del recurso en el momento de su creación. No se pueden realizar operaciones en este modo.
• Operative: El recurso es completamente funcional y opera según lo previsto.
• Suspended: El recurso está temporalmente pausado mediante una llamada a la API (PATCH) — p. ej. para actualizar las credenciales de Fisconline u otra información del recurso. Una vez completada la actualización, el recurso puede volver al modo Operative.
• Degraded (aún no disponible en LIVE en esta versión): El recurso es operativo pero temporalmente no disponible — p. ej. debido a errores de credenciales de Fisconline. En TEST, este modo puede activarse manualmente enviando el record TRANSACTION con el header X-Taxpayer-Credentials-Expired: true para preparar su integración antes del lanzamiento en producción. Más información en el artículo dedicado: ¿Qué es el modo DEGRADED y cómo intervenir?

📘Note

Cada transición es activada por una llamada a la API externa o se produce automáticamente según la lógica interna del sistema:

• PATCH indica que se requiere una llamada a la API externa para iniciar la transición.
• INTERNAL indica que la transición se activa automáticamente dentro del sistema.

Las flechas bidireccionales indican que la transición puede ocurrir en ambos sentidos.

Transiciones de Estado

Todas las transiciones de state son irreversibles.

• Acquired → Commissioned: Requiere una llamada a la API (PATCH) para activar el recurso. Si tiene éxito, el modo correspondiente pasa automáticamente de Inactive a Operative.
• Commissioned → Decommissioned: Requiere una llamada a la API (PATCH) para marcar el recurso como ya no en uso. Si tiene éxito, el modo correspondiente pasa de Operative a Inactive, marcando el fin del ciclo de vida del recurso.

⚠️Advertencia de facturación

La puesta en servicio de un Sistema en el entorno LIVE marca el inicio de la facturación y activa la transmisión de facturas oficiales a las autoridades fiscales. No se realizan facturaciones ni transmisiones reales en el entorno TEST.

Transiciones de Modo

• Inactive → Operative: Transiciona automáticamente cuando el estado se actualiza correctamente a Commissioned mediante una llamada a la API (PATCH).
• Operative → Suspended: Se activa mediante una llamada a la API (PATCH) — p. ej. para suspender temporalmente las operaciones mientras se actualizan las credenciales de Fisconline u otra información del recurso.
• Operative → Degraded (aún no disponible en LIVE en esta versión): Transiciona automáticamente — p. ej. debido a errores persistentes de credenciales de Fisconline. En TEST, esta transición puede activarse manualmente enviando el record TRANSACTION con el header X-Taxpayer-Credentials-Expired: true para preparar su integración antes del lanzamiento en producción. Más información en el artículo dedicado: ¿Qué es el modo DEGRADED y cómo intervenir?
• Degraded → Suspended (aún no disponible en LIVE en esta versión): Debe activarse manualmente mediante una llamada a la API (PATCH) para abordar errores persistentes de credenciales de Fisconline antes de restaurar el Taxpayer a Operative. Más información en el artículo dedicado: ¿Qué es el modo DEGRADED y cómo intervenir?
• Suspended → Operative: Se activa mediante una llamada a la API (PATCH) una vez completadas las actualizaciones necesarias — p. ej. credenciales de Fisconline u otra información del recurso.