Ir al contenido

Estados y modos de Contribuyente, Ubicación y Sistema

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

Sección titulada «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.

Modos

Sección titulada «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): 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 (Degradado) (aún no disponible en LIVE en esta versión): El recurso es operativo pero temporalmente no disponible, p. ej. debido a credenciales no válidas o errores. 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?
Estado y modo del recurso de entidad

Transiciones de estado

Sección titulada «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.

Transiciones de modo

Sección titulada «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.

Was this page helpful?