Estados y modos de Contribuyente, Ubicación y Sistema

⚠️ Está viendo la documentación de la versión de API 2026-02-03. La versión más reciente es 2026-05-04. La nueva versión de la API no trae cambios en la integración italiana. Sin embargo, añade soporte para SIGN PT, lo que permite a los equipos que planean expandirse a Portugal reutilizar la misma integración ya existente para Italia.

Esta sección ofrece 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 siguiente 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 API externas.

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

Estados

• Acquired (Adquirido): Estado inicial del recurso al crearlo. No se pueden realizar operaciones en este estado.
• Commissioned (Comisionado): El recurso está listo y es totalmente operativo (siempre que el modo sea operativo).
• Decommissioned (Desactivado): El recurso ya no es 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 totalmente funcional y opera según lo previsto.
• Suspended (Suspendido): Pausado temporalmente, lo que puede iniciarse mediante una llamada API, p. ej. cuando las credenciales necesitan actualizarse.
• Degraded (Degradado) (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 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 ocurrir en ambos sentidos.

Transiciones de estado

• Acquired → Commissioned: Requiere una llamada API (PATCH) para actualizar el recurso.
• Commissioned → Decommissioned: Gestionada mediante una llamada 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 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): 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 tras resolver los problemas, p. ej. actualizando las credenciales.
• Degraded → Operative (aún no implementado): Puede transicionar automáticamente cuando los problemas con el recurso se resuelven internamente.