Estados y modos del contribuyente, ubicación y sistema

Esta sección ofrece una descripción general del state y mode que definen el ciclo de vida y el comportamiento operativo de los recursos Taxpayer, Location y System. El diagrama a continuación ilustra las transiciones entre estados y modos, detallando cómo evoluciona el recurso desde su creación hasta su baja y cómo sus modos operativos se adaptan según eventos internos o llamadas externas a la API.

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

📘Note

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

• PATCH indica que se requiere una llamada externa a la API 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.

Estados

• Acquired (Adquirido): Estado inicial del recurso al ser creado. No se pueden realizar operaciones en este estado.
• Commissioned (En servicio): El recurso está listo y completamente operativo (siempre que el modo sea operativo).
• Decommissioned (Dado de baja): El recurso ya no está operativo y no puede realizar ninguna tarea. Este estado es irreversible.

Modos

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

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: Se produce automáticamente si el estado se actualiza a Commissioned mediante una llamada a la API.
• Operative → Suspended: Puede realizarse 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): Se produce 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., al actualizar las credenciales.
• Degraded → Operative (aún no implementado): Puede producirse automáticamente cuando los problemas con el recurso se resuelven internamente.