Connecting on iiko

Installing QR✓OK for venues as an integrator? The partners' guide — QR✓OK for iiko integrators.

What you need

• Your own UzQR code — the table tent your venue's bank issues. If you do not have one yet — how to get UzQR.
• iiko with iikoFront on the register and an 80 mm thermal pre-bill printer. We tested on iiko 9.5.
• Access to iikoOffice with the right to change receipt templates — through the integrator who services your iiko, or the venue's IT person.

What the pre-bill looks like

The pre-bill is the same as at venues on Poster: the logo and name, table and waiter, the dishes, the amount to pay, then the UzQR code and the tips code.

The pre-bill is drawn as a picture, so the printer must print graphics — any 80 mm ESC/POS printer does. If a register cannot draw the picture, the same pre-bill prints as text, with the codes drawn by the printer itself.

While printing, the register tells us about the pre-bill and takes the venue's current UzQR code and logo from our server. Without internet the pre-bill still prints — with what the register kept last time — and is held up by no more than a second and a half.

The codes print only while there is something left to pay on the bill.

Step by step

1. Leave a request on the connect page or in @qrokuzbot, register — iiko. Attach a photo of your UzQR table tent.
2. We prepare the template file with your venue's code and send it to you or your integrator.
3. The integrator or IT person sets up the template — following the guide below.
4. Test pre-bill. Open the top code in Click or Payme — the venue name and amount should appear. Open the bottom code with the phone camera.
5. Waiters and payment notices — sections below.

The register picks up a new UzQR code, logo or plan by itself; the template file does not need replacing.

For the integrator or IT

Everything is done in iikoOffice. We send the file qrok-iiko-prebill-<number>.cshtml — the whole pre-bill. For a venue that wants to keep its own pre-bill there is qrok-iiko-prebill-<number>-pieces.txt: only our block with the codes, in three pieces; how to paste them is written at the top of the file.

1. Open the receipt templates: Administration → Receipt templates (Russian interface: Администрирование → Шаблоны чеков).
2. Add a template: «Add», name «QR OK», type Guest Bill («Пречек»). Paste the whole file into the template text. The file is large, about 200 KB: after pasting, check that the text ends with a closing curly brace }.
3. Check the preview: it should show the pre-bill with the codes on iiko's test data. Tick Main («Основной») and save. The first pre-bill after that prints a few seconds slower: iikoFront builds the new template.
4. Check the pre-bill printer: Administration → Equipment settings — printer type ESC/POS, 80 mm wide (576 dots), code page 866, QR printing mode GS ( k. This printer must be the guest bill printer of the halls or the point of sale.
5. The register must reach the internet at iiko.qrok.uz (HTTPS), as it reaches the iiko server.
6. Print a test pre-bill on an iikoFront register and check the codes as in step 4 above.

To roll back: tick Main on the previous pre-bill template.

Waiters

For tips to go to a particular waiter, each waiter needs their own employee code in iikoOffice — the «Code» field on the employee card. It is usually filled in already. If the code is used for something else, add a hash and a number to the employee's name: «Aziza Karimova #104» — the number after the hash wins over the code and does not print on our pre-bill. With neither, the tips code opens the venue's page.

A waiter appears in the manager's cabinet after the first pre-bill with their code. The cabinet opens in the bot: Menu → «Manage». There each waiter's «⋯» menu has «Invite» — a link through which the waiter enters @qrokuzbot and adds a card number or a Click link. From then on, tips on their code go to them.

Want the waiters listed right away, with names? Send us their codes and names.

Payment notices

Create a Telegram group and add the bank's bot @cbu_uzqrbot and @qrokuzbot. Send /chatid in the group — the bot replies with the group number. In the uzqr.uz cabinet, next to your code tap ⋮ → «Привязать к боту Telegram» (Link to Telegram bot) and paste that number. Payment notices will come to the group, and we will show payment statistics by pre-bill. Step by step with screenshots.

Questions — to @qrokuzbot, business days 9:00–21:00 Tashkent time. Terms — in the Public Offer.