Estados y modos de Taxpayer, Location y System

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 Taxpayer, Location y System. El diagrama a continuación ilustra las transiciones entre estados y modos, detallando cómo el recurso evoluciona desde la creación hasta la descomisió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.

📘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 — por ejemplo, una llamada PATCH puede mover el modo del recurso de OPERATIVE → SUSPENDED o de SUSPENDED → OPERATIVE.

Estados

• Acquired: Estado inicial del recurso en el momento de su creación. Las operaciones no se pueden realizar en este estado.
• Commissioned: El recurso está listo y completamente operativo (siempre que el modo sea operativo).
• Decommissioned: El recurso ya no está 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: El recurso ha encontrado un error persistente de credenciales de Fisconline con AdE. El envío de Records queda bloqueado hasta que las credenciales de Fisconline sean corregidas y el Taxpayer sea restaurado manualmente a Operative.
  Más información en el artículo dedicado: ¿Qué es el modo DEGRADED y cómo recuperarse?

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 System en el entorno LIVE marca el inicio de la facturación y desencadena la transmisión de facturas oficiales a las autoridades fiscales. No se produce ninguna facturación ni transmisión real 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: Transiciona automáticamente — p. ej. debido a errores persistentes de credenciales de Fisconline. Más información en el artículo dedicado: ¿Qué es el modo DEGRADED y cómo intervenir?
• Degraded → Suspended: 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.