The Spanish version is the authoritative reference. View in Spanish
Onboarding
🚀 xPOS-Core Manual - Onboarding
🧭 Onboarding
The Onboarding process is key to the correct configuration and operation of the xPOS. During this process, the xPOS will be asked to identify itself and will obtain its configuration to operate according to how it was identified.
xPOS will operate in only 1 environment at a time, that is, if Onboarding is carried out in the Sandbox environment it will operate in that environment; if Onboarding is carried out in the Production environment, xPOS will communicate in that environment with the Tax Authority.
Keep in mind that the onboarding process is carried out only per xPOS device.
🧭 Onboarding via graphical interface
Open the browser on the local machine and go to:
We can also carry out the Onboarding process remotely (see the Remote access to xPOS-Core section).
For security reasons, the xPOS has an application access screen; you will be asked to enter a username and password to access the Dashboard. For now, you can only log in with the following user:
Once this action is performed, it will allow you to enter the Onboarding process or access the main xPOS-Core Dashboard.
Start
For this example, a company from Chile will be used.
On the start screen, do the following:
- Select the Sandbox / Production environment
- Enter the xPOS UUID delivered or managed from the xPOS gadget in the Inbox Gosocket portal.
- Continue the process by clicking Continue.
If the xPOS UUID exists in the Gosocket records, the organization's data will be displayed for review. Otherwise, the Gosocket team must be notified for review.
Next, xPOS-Core will mandatorily download the configuration files (transformation XSLT and validation XSD) from the Gosocket backend.
If your organization has the folio manager 3.0 enabled (document numbering), the system will automatically download the folios corresponding to the selected xPOS UUID. If this feature is disabled, this step is not required and will not be shown in the interface.
Finally, the Onboarding process will finish and you must click Continue.
The xPOS UUID is operational in the selected environment and ready to start processing documents.
The POS can start communication with xPOS-Core as defined in the Country - Communication with xPOS document.
🧭 Onboarding via Console
For operating systems that do not have access to a graphical interface, xPOS-Core provides a console to carry out the Onboarding process.
This console must be requested from the Gosocket team or downloaded from the xPOS gadget in the Inbox portal.
For Unix, execution permissions must be granted to the console:
chmod +x console-linux
Then, run the console:
./console-linux
./console-win
Select option 1. New onboarding.
Enter the xPOS UUID and select the country to configure.
Select the environment to configure.
The organization's data will be displayed.
If we cancel, Onboarding will not be carried out.
If we confirm, it will run the Onboarding process.
🌐 Remote access to xPOS-Core
It is possible to carry out the onboarding and access the dashboard remotely, connecting directly to the device where xPOS-Core is installed, provided the following requirements are met:
- The devices must be connected through the internal network (e.g., VPN).
- xPOS-Core must be installed on the host device.
- Port
3200must be enabled for communication between both machines.
From the remote machine, open the browser and replace localhost with the IP of the device running xPOS-Core: