Gestor de Folios 3.0
El Gestor de Folios 3.0 (GF 3.0) es el componente del ecosistema Gosocket responsable de la administración, control y asignación de folios electrónicos utilizados en la emisión de documentos fiscales. Actúa como la única fuente de verdad para la numeración fiscal: los sistemas emisores solicitan folios, pero no los calculan.
Su función es garantizar que cada documento emitido utilice un folio válido y único, respete la secuencia autorizada, cumpla la normativa fiscal de cada país y mantenga trazabilidad completa del uso de los folios.
Referencia técnica rápida
Qué permite
- Registrar rangos primarios de folios autorizados por la autoridad fiscal o el proveedor correspondiente.
- Asignar rangos a uno o más facturadores (perfil local con subrangos, o centralizado número a número).
- 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.
Productos integrados
GF 3.0 es consumido por distintos productos del ecosistema bajo el mismo modelo de control y validación: xPOS, API SDTA, kioscos de autoservicio y otros sistemas emisores integrados vía API.
Países soportados
| País | Autoridad tributaria | Particularidades |
|---|---|---|
| 🇨🇱 Chile | SII | GF 3.0 en Chile |
| 🇨🇴 Colombia | DIAN | GF 3.0 en Colombia |
| 🇨🇷 Costa Rica | Ministerio de Hacienda | GF 3.0 en Costa Rica |
| 🇸🇻 El Salvador | Ministerio de Hacienda | GF 3.0 en El Salvador |
| 🇬🇹 Guatemala | SAT | GF 3.0 en Guatemala |
| 🇵🇦 Panamá | DGI | GF 3.0 en Panamá |
| 🇵🇾 Paraguay | SIFEN | GF 3.0 en Paraguay |
| 🇵🇪 Perú | SUNAT | GF 3.0 en Perú |
| 🇩🇴 República Dominicana | DGII | GF 3.0 en República Dominicana |
| 🇺🇾 Uruguay | DGI | GF 3.0 en Uruguay |
Por dónde empezar
Soy integrador / desarrollador
- Métodos y parámetros — modelo de operación (facturador local vs. centralizado), URLs base, flujos recomendados y buenas prácticas.
- Referencia Biller — alta, actualización y configuración de facturadores.
- Referencia Primary Range — registro y consulta de rangos primarios.
- API de Emisión — obtención de numeración en runtime: número a número o por subrangos.
Soy equipo de implementación / usuario del portal
- Módulos del portal — pantallas de Facturadores y Rangos primarios en Inbox.
- Particularidades por país — lo que cambia según la normativa local.
Contenido de esta sección
| Página | Qué encontrarás |
|---|---|
| Módulos GF 3.0 | Pantallas del portal: listado y creación de facturadores y rangos primarios. |
| Métodos y parámetros | Referencia de la API REST: modelo de operación, flujos y una página por método. |
| Particularidades por país | Comportamiento específico de GF 3.0 según la autoridad tributaria de cada país. |
Audiencia
Manual dirigido a usuarios técnicos y funcionales, equipos de implementación, soporte y operación, y clientes que administran su propia configuración. Describe el uso funcional del sistema, sin profundizar en detalles de implementación.