# 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.

Canonical page: https://magazamhazir.com/fr/yardim/yazarkasa-okc
Menu path in the store admin: Yazarkasa
Available on every plan — no plugin required.
Last updated: 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.

## Avant de commencer

- 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

## Étapes

### 1. Register the device {#adim-1}

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.

### 2. Copy the API key immediately {#adim-2}

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.

### 3. Wait for the device to activate {#adim-3}

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.

### 4. Watch the receipts coming off the register {#adim-4}

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.

### 5. Set the VAT rate and the delivery status {#adim-5}

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.

### 6. Check the Z reports {#adim-6}

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.

## Conseils

### 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.

## Questions fréquentes

### 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.