I lost the API key — where can I see it?

Nowhere. The key is shown only at the moment it is issued and is not stored. The only route is New key under Paired devices, then passing the new key to Hugin; the old one becomes invalid at that moment.

Receipts arrive but are not applied to orders

If the Applied to order column reads Not applied, click Retry — the panel says how many were applied and how many are still pending. If it keeps happening, no order matches that receipt's amount or date; make sure the counter sale has a counterpart in the panel.

Why do register sales show as processing in the orders list?

Because Mark register sales as delivered is off in the Delivery status setting. If you sell over the counter, turn it on — the customer is walking out with the goods, so the order should not sit in processing.

Can I pair more than one register?

Yes. Each device is added separately with its own fiscal serial number and gets its own API key. The Device column in the receipts list shows which sale came from which register, and filling in the Label makes that far easier to read.

How to connect a fiscal register (ÖKC)

Pair your Hugin fiscal register with the panel, collect its API key, and follow the receipts it pushes into orders along with the daily Z reports.

5 min de lecturaÚltima actualización: 2026-09-01

The receipt cut at the counter and the order list on your website do not have to be two separate worlds. The Fiscal Register (ÖKC) screen pairs your device with the panel; when a sale completes on the register the receipt lands here and is applied to the matching order. Setup is three steps: add the device, pass the API key it produces to Hugin, and once the device activates the receipts start flowing.

Antes de empezar

A Hugin fiscal register contract and the tax ID on that contract
The fiscal serial number printed on the device
A panel account that can see the fiscal register screen

Pasos

Las pantallas son ilustrativas; los datos de tu panel serán distintos.

Paso 1: Register the device
On the Fiscal Register screen click Add a register. Fiscal serial no is the number printed on the device and its receipts. Tax ID (VKN) must be the VKN on your Hugin contract — the device sends it at activation and a mismatch means no pairing. Label is optional but tells your registers apart if you have more than one.
Fiscal Register (ÖKC)
Add a register
Fiscal serial no
FU00001234
The serial printed on the device and its receipts (e.g. FU00001234).
Tax ID (VKN)
1234567890
The VKN on your Hugin contract. The device sends it at activation.
Label
Register 1
So you can tell this device apart at the counter (optional).
Add register
Add a register — vista de ejemplo del panel
Paso 2: Copy the API key immediately
Adding a device produces an API key, and the panel shows it that once only. Close the panel and it is gone; lose it and you must issue a New key, which invalidates the old one. Do not close this window before clicking Copy and passing the key to Hugin.
API key — shown ONLY now
API key — shown ONLY now
okc_live_9f2c8ad41b7e4c5fa03b6d18e7c92aa4
CopyDismiss
Add a device, then pass its API key to Hugin.
API key — shown ONLY now — vista de ejemplo del panel
Paso 3: Wait for the device to activate
In Paired devices a new device starts as Awaiting activation. Once Hugin has loaded the key onto the device and activation completes, the status turns Active and the Last seen column starts filling in. To pause a device there is no need to delete it — Disable it, and Enable it again later.
Paired devices
Fiscal serial no Label Status Last seen
FU00001234 Register 1 Active 01.09.2026 14:22
FU00005678 Register 2 Awaiting activation —
New keyDisable
Paired devices — vista de ejemplo del panel
Paso 4: Watch the receipts coming off the register
Receipts from the register lists every sale with its Receipt no, Device, Amount and Date. Type is either Sale or Void. The Applied to order column says whether the receipt was matched to an order; if you see Not applied, click Retry — the panel reports how many records were applied and how many are still pending.
Receipts from the register
Receipt no Device Type Amount Applied to order
000241 Register 1 Sale 348.00 ₺ Applied to order
000242 Register 1 Void -120.00 ₺ Not applied
Retry
They appear here once a sale completes on the register.
Receipts from the register — vista de ejemplo del panel
Paso 5: Set the VAT rate and the delivery status
Default VAT rate (%) under VAT rate is used when a line off the register carries no rate of its own, and must be a number between 0 and 100. Delivery status decides what state register sales open in on the orders list: tick it and they are marked delivered, leave it and they open as processing. Over-the-counter sales want the first, delivery orders the second.
VAT rate
Default VAT rate (%)
20
What status should register sales appear with in the orders list?
Mark register sales as delivered
açık
Register sales will be marked delivered.
VAT rate — vista de ejemplo del panel
Paso 6: Check the Z reports
Z reports holds the end-of-day reports pushed by the device, one per day. A report lands here after an end-of-day is taken on the register. An empty list means either no end-of-day has been taken or the device cannot reach the panel — in the second case the Last seen column under Paired devices will also be stale.
Z reports
End-of-day reports pushed by the device. One per day.
31.08.2026
Active
Register 1
They appear here after an end-of-day on the register.
Z reports — vista de ejemplo del panel

Fiscal serial no	Label	Status	Last seen
FU00001234	Register 1	Active	01.09.2026 14:22
FU00005678	Register 2	Awaiting activation	—

Receipt no	Device	Type	Amount	Applied to order
000241	Register 1	Sale	348.00 ₺	Applied to order
000242	Register 1	Void	-120.00 ₺	Not applied

Consejos

Issuing a new key kills the old one

New key invalidates the previous key instantly. A device still running on the old key stops sending receipts. After rotating, do not run the register until the new key is loaded at Hugin.

A VKN mismatch fails silently

The device sends the VKN from your contract at activation. Type a different one into the panel and no pairing is made, leaving the device stuck on Awaiting activation. If the status has not moved for days, check this first.

Voids flow through too

A sale voided on the register lands in the list as Void with a negative amount. Bear that in mind when reading turnover: this list is the raw receipt stream, not net sales.

Preguntas frecuentes

I lost the API key — where can I see it?: Nowhere. The key is shown only at the moment it is issued and is not stored. The only route is New key under Paired devices, then passing the new key to Hugin; the old one becomes invalid at that moment.
Receipts arrive but are not applied to orders: If the Applied to order column reads Not applied, click Retry — the panel says how many were applied and how many are still pending. If it keeps happening, no order matches that receipt's amount or date; make sure the counter sale has a counterpart in the panel.
Why do register sales show as processing in the orders list?: Because Mark register sales as delivered is off in the Delivery status setting. If you sell over the counter, turn it on — the customer is walking out with the goods, so the order should not sit in processing.
Can I pair more than one register?: Yes. Each device is added separately with its own fiscal serial number and gets its own API key. The Device column in the receipts list shows which sale came from which register, and filling in the Label makes that far easier to read.