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.

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:
PATCHindica que se requiere una llamada externa a la API para iniciar la transición.INTERNALindica 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
Sección titulada «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.
- 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
Sección titulada «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.
Para la mayoría de los contratos, los System son las unidades utilizadas para la facturación con fiskaly.
Un System pasa a ser relevante para la facturación en cuanto su estado cambia de ACQUIRED a COMMISSIONED en el entorno LIVE.
Los recursos en el entorno TEST no se facturan.
Para conocer las condiciones exactas de facturación, consulte su contrato con fiskaly.
Transiciones de modo
Sección titulada «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.