Skip to main content
An unlinked POS doesn’t know which store it belongs to: it has no menu, no cashiers and no fiscal numbering. Linking is the step that turns it into one of the store’s registers. You do it once per device, with a 6-digit code that the manager generates in the backoffice and that you enter in the POS. If the device was already a register and the cache was cleared, the device was replaced, or the register was deleted by mistake, you don’t need to create a new register: you re-pair the same one, and it keeps its name, its history and its fiscal ID.
The minimum you need to know
  • You generate the code in Fire POS → Terminals → Create slot, and it expires after 30 minutes if nobody uses it.
  • Pair a new register creates a new terminal. Re-pair an existing register recovers one that already existed.
  • The backoffice and the POS must be on the same environment: a production code doesn’t work on staging.

​
Prerequisites

  • Access to the Fire backoffice at app.fire.rest, with permissions on the store.
  • The device powered on, with internet and a supported browser. See the terminal requirements.
FIRE POS is not installed. It is a web application that opens in the device’s browser. Optionally, you can install it as a PWA from the browser itself so it opens full screen.This guide uses two applications: the backoffice, where you generate the code, and the POS, where you enter it.
To print receipts and vouchers, the device also needs the Fire Agent. See the Fire Agent guide.

Download Fire Agent (Windows)

Folder with fireAgentSetup-<version>.zip: download it and unzip it.

​
1. Choose the store

In the backoffice, choose the country and vendor in the selector at the top right, the Channel - POS channel and, in the header, the store where the device will work. The register belongs to that store.
Header store selector with Laboratorio Colombia selected

​
2. Create the slot

Open Fire POS → Terminals and tap Create slot.
Terminals page with the Create slot button
In What do you want to do, choose Pair a new register. Validity (minutes) stays at 30, which is enough time to walk to the device; you can choose between 1 and 60.
Create linking slot dialog with the target store, the mode and the validity
Tap Generate code. The dialog shows the 6-digit code, a button to copy it and when it expires.
6-digit linking code with the Copy button and the expiration time
While nobody uses it, the code appears in the Pending slots tab.

​
3. Enter the code in the POS

Open the POS in the device’s browser. When it is not linked, it shows Link terminal and a numeric keypad.
POS Link terminal screen with the numeric keypad
Type the 6 digits with the on-screen keypad, with the physical keyboard or with Paste code. On the sixth digit, the POS links itself.
Linking keypad with five digits entered

​
4. Set up the printer

Right after linking, the POS offers to choose the thermal printer. If the Fire Agent is installed, choose the printer, tap Print test and Save. If you haven’t installed it yet, tap Skip for now: you can do it later from the menu.
POS printer setup dialog, without the local agent installed

​
5. Check the register

The POS shows the cashier sign-in, with the register name at the top right.
Cashier sign-in with the name of the newly linked register
In the backoffice, the register appears in Terminals → Active with a name like CO-K000-POS-15: country, store code, type and number.
Card of the newly linked register in the active terminals list
If the POS already shows the cashier list, you’re done. To sign in with a cashier, see Start a shift.

​
Re-pair an existing register

Use it when the device was already a register and is no longer linked: the browser cache was cleared, the device was replaced, or the register was deleted by mistake. The register keeps its name, its history and its fiscal ID.
  1. In Create slot, choose Re-pair an existing register.
  2. In Register to re-pair, choose the register.
  3. Tap Generate code and enter it in the POS, as with a new link.
Create slot dialog in re-pair mode, with the chosen register and the register-in-operation warning
If the register is operating, you can only re-pair it from the same device it is on today. To move it to another device, revoke it first in Terminal administration. Your user is recorded in the audit log as the one who authorized the re-pairing.

​
Mistakes that cost money

Pairing a new register when you needed to re-pair. The previous register is left with its shift open, the cashier can’t open another one, and the new register starts its own fiscal numbering. If the device was already a register, re-pair it.
Mixing environments. A code generated in the staging backoffice doesn’t work on the production POS, or the other way around: the POS rejects it as an invalid code.

​
Frequently asked questions

Check that it hasn’t expired (30 minutes by default), that it hasn’t been used, and that the backoffice and the POS are on the same environment. If needed, generate another one.
The system sets the name: country, store code, type and number, like CO-K000-POS-15. You don’t choose it.
Install and open the Fire Agent on the device, and tap Retry in the printer setup.