Estados y modos de Taxpayer, Location y System

⚠️Warning

Está viendo la documentación de la versión de API 2026-05-04. La versión más reciente es 2026-06-01.

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.

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 (aún no disponible en LIVE en esta versión): El recurso es operativo pero temporalmente no disponible — p. ej. debido a errores de credenciales de Fisconline. En TEST, este modo puede activarse manualmente enviando el record TRANSACTION con el header X-Taxpayer-Credentials-Expired: true para preparar su integración antes del lanzamiento en producción. Más información en el artículo dedicado: ¿Qué es el modo DEGRADED y cómo intervenir?

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 (aún no disponible en LIVE en esta versión): Transiciona automáticamente — p. ej. debido a errores persistentes de credenciales de Fisconline. En TEST, esta transición puede activarse manualmente enviando el record TRANSACTION con el header X-Taxpayer-Credentials-Expired: true para preparar su integración antes del lanzamiento en producción. Más información en el artículo dedicado: ¿Qué es el modo DEGRADED y cómo intervenir?
• Degraded → Suspended (aún no disponible en LIVE en esta versión): 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.