xPOS-Core

xPOS-Core is the electronic document issuance engine for points of sale (POS). It runs locally on the customer's device: it receives the document from the POS, transforms it into the format required by the country's tax authority, signs it, sends it and returns the result.

Quick technical reference

API port / Interface

3200 (xPOS-Core)

REST API

http://localhost:3200/api/v1

WebSocket

ws://localhost:3200

Swagger UI

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

Updater port

3400 (xPOS-Updater)

Supported countries

Country	Tax authority	Integration sheet
🇨🇱 Chile	SII	Chile Communication
🇨🇴 Colombia	DIAN	Colombia Communication
🇨🇷 Costa Rica	Ministry of Finance	Costa Rica Communication
🇸🇻 El Salvador	DGII	El Salvador Communication
🇬🇹 Guatemala	SAT / Megaprint	Guatemala Communication
🇵🇦 Panama	DGI / PAC-GS	Panama Communication
🇵🇾 Paraguay	SIFEN	Paraguay Communication
🇩🇴 Dominican Republic	DGII	Dominican Republic Communication

Where to start

I am a POS integrator / developer

1. Communication protocol — base contract: endpoints, request/response structure, operation and inputType parameters.
2. Global architecture — how the document flows from the POS to the tax authority and back.
3. Your country sheet — what changes relative to the base protocol (document types, response fields, local errors).
4. Error codes — what each stage means and what action the POS should take.

I am on the implementation / operations team

1. Installation — hardware requirements and installation on Windows and Unix (Core + Updater).
2. Onboarding — how to link an xPOS with the Gosocket portal, via the graphical interface and via console.
3. xPOS Gadget — real-time monitoring, device pool management, logs and configurations.

Contents of this section

Page	What you will find
Installation	Hardware requirements, installation and uninstallation on Windows and Unix for Core and Updater.
Onboarding	Process of linking the xPOS with the Gosocket portal: via GUI and via console, local and remote access.
Global architecture	Complete flow diagram: POS → xPOS-Core → tax authority → response.
xPOS Gadget	Administration portal: pool, logs (Elasticsearch), contingencies, real-time monitor, versions.
Protocol	Integration contract common to all countries: endpoints, request/response fields, operations.
Country sheets	What is specific to each country: document types, particular response fields, local errors.
Error codes	Catalog of stages and error codes: cause, suggestion and recommended action for the POS.