Estados y Modos de Entidad y Sistema

⚠️ Está viendo la documentación de la versión de API 2025-08-12. La versión más reciente es 2026-05-04. 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 Entidades y Sistemas. El diagrama a continuación ilustra las transiciones entre estos estados y modos, detallando cómo evoluciona el recurso desde su creación hasta el decomisionamiento y cómo sus modos operativos se adaptan en función de eventos internos o llamadas API externas.

Comprender estas transiciones es esencial para gestionar los recursos de manera eficaz, garantizar un funcionamiento fluido y resolver problemas como credenciales no válidas o pausas temporales.

Estados

• Acquired: Estado inicial del recurso tras su creación. No se pueden realizar operaciones en este estado.
• Commissioned: El recurso está listo y es totalmente operativo (siempre que el modo sea operative).
• Decommissioned: El recurso ya no es operativo y no puede realizar ninguna tarea. Este estado es irreversible.

Modos

• Inactive: El recurso está inactivo y no es operativo.
• Operative: El recurso es totalmente funcional y opera según lo previsto.
• Suspended: En pausa temporal, que puede iniciarse mediante una llamada API, por ejemplo cuando se necesita actualizar las credenciales.
• Degraded (aún no implementado): El recurso es operativo pero no está disponible temporalmente, por ejemplo debido a credenciales no válidas o errores.

📘Note

Cada transición es desencadenada por una llamada API externa o se produce automáticamente en función de la lógica interna del sistema. PATCH indica que se requiere una llamada 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 producirse en ambos sentidos.

Transiciones de Estado

• Acquired → Commissioned: Requiere una llamada API (PATCH) para actualizar el recurso.
• Commissioned → Decommissioned: Gestionado mediante una llamada API (PATCH) para marcar el recurso como fuera de uso. Este cambio de estado es irreversible.

Transiciones de Modo

• Inactive → Operative: Transiciona automáticamente si el estado se actualiza a Commissioned mediante una llamada API.
• Operative → Suspended: Puede realizarse activamente a través de la API, por ejemplo para suspender temporalmente las operaciones mientras se actualizan las credenciales.
• Operative → Degraded (aún no implementado): Transiciona automáticamente si las credenciales no son válidas o se produce un error.
• Degraded → Suspended (aún no implementado): Debe actualizarse activamente a través de la API para resolver problemas como credenciales no válidas.
• Suspended → Operative: Puede actualizarse a través de la API tras resolver los problemas, por ejemplo actualizando las credenciales.
• Degraded → Operative (aún no implementado): Puede transicionar automáticamente cuando los problemas con el recurso se resuelven internamente.