Skip to main content

Introducción

Gestor de Folios 3.0 (GF 3.0)​

El Gestor de Folios 3.0 (GF 3.0) es el componente del ecosistema xPOS responsable de la administración, control y asignación de folios electrónicos utilizados en la emisión de documentos fiscales.

Su función principal es garantizar que cada documento emitido:

  • utilice un folio válido y único,
  • respete la secuencia autorizada,
  • cumpla con la normativa fiscal vigente de cada país,
  • y mantenga una trazabilidad completa del uso de los folios.

GF 3.0 actúa como la única fuente de verdad para la numeración fiscal, desacoplando la gestión de folios de los sistemas emisores y permitiendo una operación segura, escalable y multi-país.

Alcance del sistema​

El Gestor de Folios 3.0 permite:

  • Registrar rangos primarios de folios autorizados por la autoridad fiscal o proveedor correspondiente.
  • Asignar rangos a uno o más facturadores.
  • Controlar el consumo secuencial de folios en tiempo real.
  • Gestionar umbrales de recarga para evitar quiebres operativos.
  • Soportar escenarios de operación normal y contingencia.
  • Proveer auditoría y trazabilidad completa del ciclo de vida de cada folio.

Diseño y principios​

GF 3.0 ha sido diseñado bajo los siguientes principios:

  • Centralización: un único servicio controla toda la numeración fiscal.
  • Regulación adaptable: comportamiento configurable según país y tipo de documento.
  • Escalabilidad: soporte para múltiples productos emisores y altos volúmenes.
  • Seguridad y consistencia: prevención de duplicidades y saltos de folio.
  • Desacoplamiento: los sistemas emisores solicitan folios, pero no los calculan.

Productos integrados​

El Gestor de Folios 3.0 es consumido por distintos productos del ecosistema, entre ellos:

  • xPOS
  • API SDTA
  • Kioscos de autoservicio
  • Otros sistemas emisores integrados vía API

Todos los productos interactúan con GF 3.0 bajo el mismo modelo de control y validación.

Audiencia del manual​

Este manual está dirigido a:

  • Usuarios técnicos y funcionales
  • Equipos de implementación
  • Soporte y operación
  • Clientes que administran su propia configuración

El documento describe el uso funcional del sistema, sin profundizar en aspectos de implementación técnica o código.

Swagger

https://inbox-emission-numbermanager-all-adminapi-sbx.azurewebsites.net/swagger/index.html