Saltar al contenido principal

Arquitectura Global xPOS

Este documento presenta los diagramas de arquitectura y flujos de integracion de xPOS para los distintos paises de operacion.

🏗️ Arquitectura General​

El componente xPOS Core funciona como un agente multiplataforma encargado de la transformacion, validacion, firma y auditoria de documentos electronicos antes de su envio a la entidad tributaria o a la nube de Gosocket.

Arquitectura General xPOS

Flujos de integración por país​

xPOS opera con tres modelos de integración según cómo cada autoridad tributaria recibe y responde el estado del documento electrónico. El proceso interno de xPOS Core (validación XSD/Schematron, asignación de folios y firma) es común a los tres; lo que cambia es quién dialoga con la entidad tributaria y cuándo se conoce el estado oficial.

ModeloPaísesQuién envía al ente tributarioCuándo se conoce el estado oficial
SíncronoColombia, Guatemala, PanamáxPOS CoreEn la misma llamada
Mixto (síncrono + asíncrono)Costa Rica, República Dominicana, El Salvador, Chile, ParaguayxPOS CoreEn una consulta posterior
AsíncronoChile, ParaguayNube GosocketLo gestiona la nube Gosocket
nota

Chile y Paraguay aparecen en dos modelos porque el cliente puede elegir si el envío al ente tributario lo realiza xPOS Core directamente (modelo mixto) o si lo delega a la nube Gosocket (modelo asíncrono).

Flujo síncrono — Colombia, Guatemala y Panamá​

Flujo síncrono de xPOS

xPOS Core dialoga directamente con la entidad tributaria y obtiene el estado definitivo dentro de la misma llamada. La respuesta al POS ya contiene el resultado oficial.

  1. POS Cliente → xPOS Core: envía el documento (JSON / XML / TXT).
  2. xPOS Core: ejecuta validación XSD / Schematron, asignación de folios y firma.
  3. xPOS Core → Entidad tributaria: envío síncrono. xPOS Core espera la respuesta oficial.
  4. Entidad tributaria → xPOS Core: acknowledge con el estado aprobado o rechazado. xPOS Core actualiza el DTE y sincroniza el Inbox (Emitidos).
  5. xPOS Core → POS Cliente: respuesta de proceso con el estado definitivo.

Flujo mixto (síncrono + asíncrono) — Costa Rica, República Dominicana, El Salvador, Chile, Paraguay​

Flujo mixto síncrono + asíncrono de xPOS

La autoridad tributaria exige el envío directo desde el emisor, pero el estado oficial se entrega de forma diferida. xPOS Core realiza dos viajes contra la entidad tributaria: el primero entrega el documento, el segundo consulta el estado.

  1. POS Cliente → xPOS Core: envía el documento (JSON / XML / TXT).
  2. xPOS Core: ejecuta validación XSD / Schematron, asignación de folios y firma.
  3. Primer envío (asíncrono). xPOS Core entrega el documento a la entidad tributaria y recibe un acknowledge de recepción. El DTE se registra en el Inbox sin estado (sincronizado).
  4. xPOS Core → POS Cliente: respuesta de proceso confirmando que el documento fue aceptado para procesar.
  5. Consulta posterior. xPOS Core consulta el estado del DTE a la entidad tributaria.
  6. Entidad tributaria → xPOS Core: acknowledge con el estado aprobado o rechazado. xPOS Core actualiza el DTE en el Inbox (Emitidos) y notifica al POS la sincronización del estado final.
Por qué este modelo

Permite que el POS no quede bloqueado esperando la validación oficial: recibe el acuse de recepción de inmediato y la sincronización del estado definitivo llega cuando la autoridad tributaria lo emite.

Flujo asíncrono — Chile y Paraguay​

Flujo asíncrono de xPOS

xPOS Core no dialoga con la entidad tributaria: entrega el documento a la API de Gosocket y es la nube quien se comunica con el SII (Chile) o el SIFEN (Paraguay).

  1. POS Cliente → xPOS Core: envía el documento (JSON / XML / TXT).
  2. xPOS Core: ejecuta validación XSD / Schematron, asignación de folios y firma.
  3. xPOS Core → API Gosocket: envío asíncrono. Recibe acknowledge de la nube.
  4. xPOS Core: sincroniza el Inbox (Emitidos) y devuelve al POS la respuesta de proceso.
  5. API Gosocket → Entidad tributaria: la nube envía el documento de forma asíncrona y procesa el acknowledge correspondiente.
Por qué este modelo

xPOS Core se desentiende de la comunicación con la autoridad tributaria: una vez entregado el documento a la nube, la responsabilidad del envío, los reintentos y la conciliación del estado oficial queda en Gosocket.