Estados y Modos de Entity y System

⚠️ Está viendo la documentación de la versión de API 2024-10-31. 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 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. Este estado es irreversible.

Modos

• Inactive: El recurso está inactivo y no es operativo.
• Operative: El recurso es completamente funcional y opera según lo previsto.
• Suspended: Pausado temporalmente, lo que puede iniciarse mediante una llamada a la API, p. ej. cuando las credenciales necesitan actualizarse.
• Degraded (aún no implementado): El recurso es operativo pero temporalmente no disponible, p. ej. debido a credenciales no válidas o errores.

📘Note

Cada transición se activa mediante 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 ambas direcciones.

Transiciones de Estado

• Acquired → Commissioned: Requiere una llamada a la API (PATCH) para actualizar el recurso.
• Commissioned → Decommissioned: Se gestiona mediante una llamada a la API (PATCH) para marcar el recurso como ya no en 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 a la API.
• Operative → Suspended: Se puede realizar activamente a través de la API, p. ej. 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 abordar problemas como credenciales no válidas.
• Suspended → Operative: Puede actualizarse a través de la API después de resolver los problemas, p. ej. actualizar credenciales.
• Degraded → Operative (aún no implementado): Puede transicionar automáticamente cuando los problemas con el recurso se resuelven internamente.