xPOS-Core

xPOS-Core es el motor de emisión de documentos electrónicos para puntos de venta (POS). Corre localmente en el dispositivo del cliente: recibe el documento del POS, lo transforma al formato que exige la autoridad tributaria del país, lo firma, lo envía y devuelve el resultado.

Referencia técnica rápida

Puerto API / Interfaz

3200 (xPOS-Core)

API REST

http://localhost:3200/api/v1

WebSocket

ws://localhost:3200

Swagger UI

http://localhost:3200/api/v1/doc/

Puerto Updater

3400 (xPOS-Updater)

Países soportados

País	Autoridad tributaria	Ficha de integración
🇨🇱 Chile	SII	Comunicación Chile
🇨🇴 Colombia	DIAN	Comunicación Colombia
🇨🇷 Costa Rica	Ministerio de Hacienda	Comunicación Costa Rica
🇸🇻 El Salvador	DGII	Comunicación El Salvador
🇬🇹 Guatemala	SAT / Megaprint	Comunicación Guatemala
🇵🇦 Panamá	DGI / PAC-GS	Comunicación Panamá
🇵🇾 Paraguay	SIFEN	Comunicación Paraguay
🇩🇴 República Dominicana	DGII	Comunicación República Dominicana

Por donde empezar

Soy integrador / desarrollador POS

1. Protocolo de comunicación — contrato base: endpoints, estructura request/response, parámetros operation e inputType.
2. Arquitectura global — cómo fluye el documento desde el POS hasta la autoridad tributaria y de vuelta.
3. Ficha de tu país — lo que cambia respecto al protocolo base (tipos de documento, campos de response, errores locales).
4. Códigos de error — qué significa cada stage y qué acción debe tomar el POS.

Soy equipo de implementación / operaciones

1. Instalación — requerimientos de hardware e instalación en Windows y Unix (Core + Updater).
2. Onboarding — cómo vincular un xPOS con el portal Gosocket, por interfaz gráfica y por consola.
3. Gadget xPOS — monitoreo en tiempo real, gestión del pool de dispositivos, logs y configuraciones.

Contenido de esta sección

Página	Qué encontrarás
Instalación	Requisitos de hardware, instalación y desinstalación en Windows y Unix para Core y Updater.
Onboarding	Proceso de vinculación del xPOS con el portal Gosocket: por GUI y por consola, acceso local y remoto.
Arquitectura global	Diagrama de flujo completo: POS → xPOS-Core → autoridad tributaria → respuesta.
Gadget xPOS	Portal de administración: pool, logs (Elasticsearch), contingencias, monitor en tiempo real, versiones.
Protocolo	Contrato de integración común a todos los países: endpoints, campos request/response, operaciones.
Fichas por país	Lo específico de cada país: tipos de documento, campos particulares del response, errores locales.
Códigos de error	Catálogo de stages y códigos de error: causa, sugerencia y acción recomendada al POS.