Changelog

Změna platby účtenky bez stornaChanging the payment of a receipt without a cancellation

Pokladna může změnit, jak se vydaná účtenka zaplatila – třeba hotově místo kartou – bez storna a nové účtenky (changeReceiptPayment). Účtenka si nechá číslo, položky i celkovou částku, mění se jen platby; součty směny, pokladní kniha a administrace se přizpůsobí hned. Mění se platby hotově, stravenkami, na firemní účet a fakturou, do uzávěrky směny. Platby kartou a dárkovým voucherem zůstávají. Když se změní evidovaná tržba EET 2.0, server pošle opravu sám.

A register can change how an issued receipt was paid – for example by card instead of cash – without a cancellation and a new receipt (changeReceiptPayment). The receipt keeps its number, items and total, only the payments change; the shift totals, the cash book and the administration follow at once. Cash, meal voucher, company account and invoice payments change, until the shift close. Card and gift voucher payments stay. When the recorded EET 2.0 sale changes, the server sends the correction itself.

PřidánoAdded

• changeReceiptPayment (POST …/receipts/{receipt_id}/payment-change) – změna platby vydané účtenky, kdo smí podle pos.receipt_cancel_by jako u storna.changeReceiptPayment (POST …/receipts/{receipt_id}/payment-change) – changing the payment of an issued receipt, who may as for a cancellation by pos.receipt_cancel_by.
• Kódy chyb receipt_payment_not_changeable (409) a pos_shift_closed (409).The error codes receipt_payment_not_changeable (409) and pos_shift_closed (409).
• Událost receipt.updated – pokladna změnila platbu účtenky.The event receipt.updated – a register changed the payment of a receipt.

ZměněnoChanged

• listBackups vynechá zálohy, jejichž soubor server nenajde (getBackup a downloadBackup pro ně vrátí 404) – v seznamu je jen to, co jde stáhnout.listBackups leaves out backups whose file the server cannot find (getBackup and downloadBackup answer 404 for them) – the list holds only what can be downloaded.

DokumentaceDocumentation

• Přechod z API v1: changePayment má v API v2 vlastní operaci, už ne storno a novou účtenku.Moving from API v1: changePayment has its own operation in API v2, no longer a cancellation and a new receipt.

Reference ve verzi 26.11.28Reference at version 26.11.28 · Porovnat s 26.11.27Compare with 26.11.27

Propadlá licence a offline účtenky obsluhyAn expired licence and offline receipts of the staff

Zařízení provozovny s propadlou licencí dostanou 403 license_expired, jako kód 700 v API v1. Nastavení zařízení, zálohy, diagnostika a offline účtenky z doby licence fungují dál. Offline účtenka s ruční slevou nebo vlastní položkou bez vedoucího se přijme a Časová osa ji označí. Vystavitel offline účtenky smí být mezitím smazaný zaměstnanec. Relace pokladny a mobilního číšníka vydrží celou směnu.

Devices of a restaurant with an expired licence get 403 license_expired, like code 700 in API v1. The device settings, backups, diagnostics and offline receipts from the time of the licence keep working. An offline receipt with a manual discount or an open item and no manager is accepted and the action timeline marks it. The issuer of an offline receipt may be an employee deleted meanwhile. Sessions of the register and the waiter app last the whole shift.

PřidánoAdded

• Kód chyby license_expired (403) – licence provozovny vypršela a z kreditu ji obnovit nešlo.The error code license_expired (403) – the licence of the restaurant expired and could not be renewed from the credit.

ZměněnoChanged

• createReceipt s offline: true přijme ruční slevu a vlastní položku i bez vedoucího (dřív 403 manager_approval_required) a zapíše ji do Časové osy.createReceipt with offline: true accepts a manual discount and an open item also without a manager (before 403 manager_approval_required) and notes it in the timeline.
• issued_by_id offline účtenky smí být zaměstnanec účtu smazaný nebo odebraný z provozovny.issued_by_id of an offline receipt may be an employee of the account deleted or removed from the restaurant.
• Relace aplikace profirest-pos nekončí po 5 minutách nečinnosti, ale až s max_expires_at (idle_timeout_seconds 43 200).A session of the profirest-pos app does not end after 5 minutes without use but at max_expires_at (idle_timeout_seconds 43,200).

Reference ve verzi 26.11.27Reference at version 26.11.27 · Porovnat s 26.11.26Compare with 26.11.26

Uzavřené směny, prodej voucheru a přihlášení offlineClosed shifts, selling a voucher and signing in offline

Pokladna může zpětně přečíst uzavřené směny (listPosShifts, getPosShiftClose) i účtenky jedné uzávěrky (listReceipts?shift_id=). Spárovaná pokladna v checkVoucher uvidí i dosud neprodaný voucher s jeho hodnotou a prodá ho bez zadávání ceny. Pro přihlášení obsluhy bez spojení dostane pokladna v listStaff kontrolu PINu každého zaměstnance s rolí na pokladně (offline_sign_in).

A register can read closed shifts back (listPosShifts, getPosShiftClose) and the receipts of one close (listReceipts?shift_id=). A paired register sees in checkVoucher also a voucher not sold yet with its value and sells it without typing the price. For signing employees in without connection a register gets in listStaff a PIN check of every employee with a register role (offline_sign_in).

PřidánoAdded

• listPosShifts a getPosShiftClose – uzavřené směny provozovny tak, jak je vrátil closePosShift.listPosShifts and getPosShiftClose – closed shifts of the restaurant as closePosShift returned them.
• Parametr shift_id v listReceipts – účtenky jedné uzávěrky, i převzaté doklady z API v1.The shift_id parameter of listReceipts – the receipts of one close, also API v1 documents taken over.
• for_sale v Voucher.status – neprodaný voucher, jen pro spárovanou pokladnu.for_sale in Voucher.status – a voucher not sold yet, for a paired register only.
• offline_sign_in v StaffMember – kontrola PINu pro přihlášení bez spojení, stejné hodnoty jako offline_approval.offline_sign_in in StaffMember – a PIN check for signing in without connection, the same values as offline_approval.

ZměněnoChanged

• unit_price řádku voucher_sale je nepovinná – bez ní se voucher prodá za svou hodnotu.unit_price of a voucher_sale line is optional – without it the voucher sells at its value.

Reference ve verzi 26.11.26Reference at version 26.11.26 · Porovnat s 26.11.25Compare with 26.11.25

Příjem objednávek zvlášť od otevírací dobyOrder hours apart from the opening hours

Provozovna může přijímat objednávky z e-shopů kratší dobu, než má otevřeno – třeba „Otevřeno do 22:00 · Objednávky do 21:30“. Nová operace getOrderHours vrací příjem objednávek (výchozí je stejně jako otevírací doba) a ordering.venue_open_now říká, jestli má provozovna podle otevírací doby otevřeno. Aplikace web se řídí příjmem objednávek: ordering.open_now, listTimeSlots i kalkulace.

A restaurant may accept orders from e-shops for a shorter time than it is open – for example „Open until 22:00 · Orders until 21:30“. The new operation getOrderHours returns the order hours (by default the same as the opening hours) and ordering.venue_open_now says whether the restaurant is open by its opening hours. web applications follow the order hours: ordering.open_now, listTimeSlots and the quote.

PřidánoAdded

• getOrderHours – příjem objednávek aplikací web po dnech a týdenní šablona, same_as_opening_hours.getOrderHours – the order hours of web applications per day and the weekly template, same_as_opening_hours.
• venue_open_now v Restaurant.ordering – otevřeno podle otevírací doby, jen pro zobrazení.venue_open_now in Restaurant.ordering – open by the opening hours, for display only.

ZměněnoChanged

• U aplikací web se open_now, next_change_at, listTimeSlots, kalkulace a rozvozové zóny bez vlastních časů řídí příjmem objednávek místo otevírací doby. Bez vlastního příjmu objednávek se nic nemění.For web applications open_now, next_change_at, listTimeSlots, the quote and delivery zones without own times follow the order hours instead of the opening hours. Without own order hours nothing changes.

Reference ve verzi 26.11.25Reference at version 26.11.25 · Porovnat s 26.11.24Compare with 26.11.24

Režim Kalkulačka na pokladněThe Calculator mode of the register

Pokladna umí prodávat bez sortimentu: obsluha napíše počet a cenu a klepne na tlačítko skupiny, třeba „Pečivo 12 %“. Tlačítka (název, sazba DPH, barva) nastavuje provozovna a pokladna je dostane v nastavení zařízení. Řádek z tlačítka je položka s vlastní cenou, kterou smí prodat kdokoli s rolí pos bez PINu vedoucího.

The register can sell without a catalog: the cashier types a quantity and a price and taps a key of a group, for example „Bakery 12 %“. The restaurant sets the keys (name, VAT rate, colour) and the register gets them in the device settings. A line of a key is an open item any employee with the pos role may sell, no manager's PIN.

PřidánoAdded

• pos.calculator v getDeviceSettings – zda je režim zapnutý a tlačítka skupin (id, name, vat_rate, color, position).pos.calculator in getDeviceSettings – whether the mode is on and the keys of the groups (id, name, vat_rate, color, position).
• calculator_key_id u položky open_item v createReceipt a previewReceipt – řádek obsluhy bez vedoucího, v účtence price_source calculator.calculator_key_id on an open_item in createReceipt and previewReceipt – a line of a cashier without a manager, price_source calculator on the receipt.
• Kód pole calculator_key_mismatch – sazba řádku není sazba tlačítka.The field code calculator_key_mismatch – the rate of the line is not the rate of the key.

Reference ve verzi 26.11.24Reference at version 26.11.24 · Porovnat s 26.11.23Compare with 26.11.23

Práva recepce a pokojské, úklid s přihlášeným zaměstnancemReception and maid permissions, housekeeping with a signed-in employee

Recepce a pokojská mají vlastní práva zaměstnance pro zařízení jako pokladna a kuchyň: role reception, nová reception_manager a housekeeping plynou z nich, ne z oprávnění webové administrace. Storno dokladu za pobyt a mazání plateb smí jen správce recepce. Operace úklidu nově přijímají token zaměstnance a zapíšou, kdo úkol udělal nebo závadu nahlásil.

The reception and maids have their own employee permissions for devices like the register and the kitchen: the roles reception, the new reception_manager and housekeeping come from them, not from permissions of the web administration. Only a reception manager may cancel the receipt for a stay and remove payments. Housekeeping operations now accept the staff token and record who did the task or reported the fault.

PřidánoAdded

• Role reception_manager v StaffMember.roles – storno dokladu (cancelStayReceipt) a mazání plateb (deleteStayPayment), ostatní recepční dostanou 403 staff_role_missing.The role reception_manager in StaffMember.roles – cancelling the receipt (cancelStayReceipt) and removing payments (deleteStayPayment); other receptionists get 403 staff_role_missing.
• Profirest-Staff-Token u operací úklidu (getHousekeepingDay … fixRoomIssue).Profirest-Staff-Token with housekeeping operations (getHousekeepingDay … fixRoomIssue).

ZměněnoChanged

• Role reception a housekeeping plynou z vlastních práv zaměstnance Recepce a Pokojská, ne z oprávnění webové administrace Ubytování, plného přístupu a Pokojská.The roles reception and housekeeping come from the employee permissions Reception and Maid, not from the web administration permissions Accommodation, full access and Maid.

OpravenoFixed

• Úkol úklidu a závada zapsané s tokenem zaměstnance teď nesou zaměstnance (done_by_employee_id, created_by_employee_id).A housekeeping task and a fault recorded with a staff token now carry the employee (done_by_employee_id, created_by_employee_id).

Reference ve verzi 26.11.23Reference at version 26.11.23 · Porovnat s 26.11.22Compare with 26.11.22

Recepce hotelu – účet pokoje a vyúčtováníHotel reception – the account of the room and the bill

Aplikace recepce vyúčtuje pobyt sama: přidá služby z ceníku a vlastní položky, zapíše platby hosta, vystaví nebo stornuje doklad za pobyt, ukáže QR kód hosta s tím, co smí, a pohlídá cizince čekající na hlášení do Ubyportu (i s odesláním hned). Seznam pobytů nově ukazuje zůstatek účtu.

The reception application settles a stay itself: it adds services of the price list and own items, records the guest's payments, issues or cancels the receipt for the stay, shows the guest's QR code with what the guest may use, and watches foreigners waiting for the report to Ubyport (also sending it now). The list of stays now shows the balance of the account.

PřidánoAdded

• listLodgingServices, addStayService, addStayCharge a removeStayFolioLine – služby a položky na účtu pokoje.listLodgingServices, addStayService, addStayCharge and removeStayFolioLine – services and items on the account of the room.
• addStayPayment a deleteStayPayment – platby hosta; doplatek po odjezdu vystaví doklad za pobyt.addStayPayment and deleteStayPayment – the guest's payments; settling after the departure issues the receipt for the stay.
• issueStayReceipt a cancelStayReceipt – doklad za pobyt a protidoklad (LodgingReceipt).issueStayReceipt and cancelStayReceipt – the receipt for the stay and the cancelling receipt (LodgingReceipt).
• getStayGuestPass – obsah QR kódu hosta a co host smí (wellness, snídaně, parkoviště).getStayGuestPass – the content of the guest's QR code and what the guest may use (wellness, breakfast, car park).
• getUbyportStatus a sendUbyport – cizinci čekající na hlášení policii se lhůtou a odeslání hned.getUbyportStatus and sendUbyport – foreigners waiting for the report to the police with the deadline, and sending now.
• LodgingStay.balance – zůstatek účtu i v seznamu pobytů.LodgingStay.balance – the balance of the account also in the list of stays.

Reference ve verzi 26.11.22Reference at version 26.11.22 · Porovnat s 26.11.21Compare with 26.11.21

Recepce hotelu – plán obsazenosti, pobyty a hostéHotel reception – the occupancy plan, stays and guests

Základ pro aplikaci recepce Profirestu: pokoje a typy pokojů se stavem úklidu, pobyty plánu obsazenosti za období (i dnešní příjezdy, odjezdy a ubytovaní jedním dotazem) a detail pobytu se zapsanými hosty, jejich doklady, zůstatkem účtu, dokladem za pobyt a historií. Recepce najde volné pokoje s cenou, založí, změní a přesune pobyt, potvrdí ho, ubytuje a odhlásí hosty nebo pobyt zruší a zapíše hosty s doklady pro domovní knihu a cizineckou policii. Server u každého pobytu říká, které kroky teď dovolí. Operace jsou jen pro vlastní aplikace Profirestu a potřebují přihlášeného zaměstnance s rolí recepce.

The base for Profirest's reception application: rooms and room types with the state of cleaning, stays of the occupancy plan for a period (also today's arrivals, departures and guests staying now in one call) and the detail of a stay with the registered guests, their documents, the balance of the account, the receipt for the stay and the history. The reception finds free rooms with prices, creates, changes and moves a stay, confirms it, checks guests in and out or cancels the stay, and registers guests with their documents for the guest book and the foreign police. For every stay the server says which steps it allows now. The operations are only for Profirest's own applications and need a signed-in employee with the reception role.

PřidánoAdded

• listLodgingRooms – typy pokojů a pokoje v pořadí plánu obsazenosti se stavem úklidu a počtem neopravených závad.listLodgingRooms – room types and rooms in the order of the occupancy plan with the state of cleaning and the number of faults not fixed.
• listStays – pobyty, které zasahují do období (nejvýš 62 dní), s povolenými kroky actions a verzí version.listStays – stays touching a period (at most 62 days) with the allowed steps actions and the version.
• getStay – pobyt se zapsanými hosty a doklady, zůstatkem účtu, dokladem za pobyt a historií; ETag je verze pobytu.getStay – a stay with the registered guests and their documents, the balance, the receipt for the stay and the history; the ETag is the version of the stay.
• getLodgingAvailability – volné pokoje každého typu a cena pobytu podle ceníku, přistýlek a balíčku; getLodgingRegistrationLists – státy, doklady a účely pobytu pro zápis hostů.getLodgingAvailability – free rooms of every type and the price of the stay by the price list, extra beds and the package; getLodgingRegistrationLists – countries, documents and purposes of stay for registering guests.
• createStay, updateStay a moveStay – založení, změna a přesun nebo prodloužení pobytu; změny s If-Match.createStay, updateStay and moveStay – creating, changing and moving or extending a stay; changes with If-Match.
• confirmStay, checkInStay, checkOutStay, cancelStay a markStayNoShow – kroky pobytu; odhlášení z vyrovnaného účtu vystaví doklad za pobyt.confirmStay, checkInStay, checkOutStay, cancelStay and markStayNoShow – the steps of a stay; checking out of a settled account issues the receipt for the stay.
• addStayGuest, updateStayGuest a deleteStayGuest – zapsaní hosté s doklady; cizinci jdou do Ubyportu.addStayGuest, updateStayGuest and deleteStayGuest – registered guests with documents; foreigners go to Ubyport.
• Chyby stay_state_conflict a lodging_room_unavailable (409).The errors stay_state_conflict and lodging_room_unavailable (409).
• Oprávnění lodging_desk:read a lodging_desk:write jen pro vlastní aplikace Profirestu.The scopes lodging_desk:read and lodging_desk:write, only for Profirest's own applications.
• Role zaměstnance reception (recepce) a housekeeping (pokojská) v StaffMember.roles.The employee roles reception and housekeeping in StaffMember.roles.

Reference ve verzi 26.11.21Reference at version 26.11.21 · Porovnat s 26.11.20Compare with 26.11.20

Živá poloha a jízda kurýrůLive location and driving of couriers

Telefon kurýra během směny posílá polohu, rychlost, směr a prudké manévry (brzdění, zrychlení, zatáčky v g). Kuchyňské displeje, dispečink a partnerské aplikace vidí kurýry živě – seznamem i událostmi v proudu – a u každé trasy projetou stopu se souhrnem (vzdálenost, čas v jízdě, nejvyšší rychlost). Poloha se zapisuje jen během směny a jen v provozovnách, které sledování kurýrů zapnuly.

During the shift the courier's phone sends the location, speed, heading and harsh manoeuvres (braking, acceleration, turns in g). Kitchen displays, dispatchers and partner applications see the couriers live – as a list and as events in the stream – and the driven track of every route with its summary (distance, time moving, top speed). The location is recorded only during the shift and only in restaurants that turned courier tracking on.

PřidánoAdded

• postCourierTelemetry – telefon kurýra posílá dávky bodů, prudkých manévrů a stavu telefonu; odpověď říká, jak často posílat (mode, send_every_s).postCourierTelemetry – the courier's phone sends batches of points, harsh manoeuvres and the state of the phone; the answer says how often to send (mode, send_every_s).
• listCourierPositions – kde jsou kurýři na směně: stav, rychlost, otevřená trasa a zbývající objednávky, baterie a oprávnění telefonu.listCourierPositions – where the couriers on shift are: the state, speed, the open route and the orders left, the battery and the permission of the phone.
• getDeliveryRouteTrack – projetá stopa trasy s prudkými manévry a souhrnem; body se drží 14 dní, souhrn zůstává.getDeliveryRouteTrack – the driven track of a route with harsh manoeuvres and the summary; points are kept for 14 days, the summary stays.
• Události courier.position (jen proud a listEvents, drží se 24 hodin) a courier.shift_changed pod deliveries:read.The events courier.position (only the feed and listEvents, kept for 24 hours) and courier.shift_changed under deliveries:read.

Reference ve verzi 26.11.20Reference at version 26.11.20 · Porovnat s 26.11.19Compare with 26.11.19

Gastro, ubytování a vstupenky v přehledech tržebFood, accommodation and tickets in the revenue reports

Provozovna, která kromě jídla a pití prodává i ubytování nebo vstupenky, si přehledy tržeb omezí na jeden druh tržby nebo je rozdělí – stejně jako Statistiky a Měsíční přehledy v administraci. Průměrná objednávka gastra tak není zkreslená doklady za pobyt a nákupy vstupenek.

A restaurant that also sells accommodation or tickets besides food and drinks can limit the revenue reports to one kind of revenue or split them – like the Statistics and the Monthly reports of the administration. The average order of the food is then not skewed by documents of stays and ticket purchases.

PřidánoAdded

• Parametr segment (food, lodging, tickets) u getSalesSummary a getProductSales.The segment parameter (food, lodging, tickets) of getSalesSummary and getProductSales.
• getSalesSummary s group_by=segment – tržba a počet objednávek za gastro, ubytování a vstupenky.getSalesSummary with group_by=segment – revenue and orders of food, accommodation and tickets.
• Pole segment v odpovědi getSalesSummary a getProductSales (null = všechno).The segment field in the answer of getSalesSummary and getProductSales (null = all).

Reference ve verzi 26.11.19Reference at version 26.11.19 · Porovnat s 26.11.18Compare with 26.11.18

Útrata na pokoj bez účtenky z pokladnyCharge to a room without a receipt from the register

Ubytování vystavuje při odjezdu hosta doklad za celý pobyt – s ubytováním, službami i útratou z restaurace a baru zapsanou na pokoj. Pokladna proto na útratu zapsanou na pokoj účtenku nevystavuje.

The accommodation issues a document for the whole stay at the guest's departure – with the accommodation, services and the bill of the restaurant or the bar charged to the room. The register therefore issues no receipt for a charge to a room.

DokumentaceDocumentation

• chargeToStay – pokladna účtenku nevystaví, tržbou je útrata na dokladu za pobyt při odjezdu.chargeToStay – the register issues no receipt; the charge is revenue on the document of the stay at departure.

Tvar API se nezměnil – jen texty, příklady a chování podle smlouvy.The shape of the API did not change – texts, examples and behaviour by the contract only.

Reference ve verzi 26.11.18Reference at version 26.11.18 · Porovnat s 26.11.17Compare with 26.11.17

Přehled ubytováníAccommodation statistics

Čísla ubytování za období pro majitele a BI: obsazenost, průměrná cena za noc, tržba na dostupný pokoj, tržby, hosté podle zemí a věku, zdroje rezervací, délka a předstih pobytů, storna, služby, balíčky a srovnání s loňskem.

Accommodation numbers of a period for the owner and BI: occupancy, ADR, RevPAR, revenue, guests by country and age, booking sources, length and lead time of stays, cancellations, services, packages and a comparison with last year.

PřidánoAdded

• getLodgingStats – přehled za období po dnech, typech pokojů, zdrojích, zemích a věku hostů, s previous za stejné období loni.getLodgingStats – statistics of a period by day, room type, source, country and age of guests, with previous for the same period last year.

Reference ve verzi 26.11.17Reference at version 26.11.17 · Porovnat s 26.11.16Compare with 26.11.16

Recenze ubytováníAccommodation reviews

Hodnocení hostů po pobytu i recenze z portálů na jednom místě s přehledem (průměr, zdroje, hvězdičky, dílčí hodnocení) a odpovídání – u hodnocení hosta i e-mailem.

Ratings of guests after their stay and reviews from portals in one place with an overview (average, sources, stars, sub-ratings) and replies – for a guest's rating also by e-mail.

PřidánoAdded

• listLodgingReviews – recenze s filtrem (bez odpovědi, nízké, zveřejněné) a přehledem.listLodgingReviews – reviews with a filter (unanswered, low, public) and an overview.
• replyToLodgingReview – odpověď na recenzi, s send_to_guest i e-mailem hostovi.replyToLodgingReview – a reply to a review, with send_to_guest also by e-mail to the guest.

Reference ve verzi 26.11.16Reference at version 26.11.16 · Porovnat s 26.11.15Compare with 26.11.15

Pobytové balíčky a QR kód hostaStay packages and guest passes

Seznam pobytových balíčků (noci zdarma, sleva, příplatek, služby v ceně) a čtečka QR kódu hosta pro turnikety wellness, snídaně a parkoviště: server řekne, jestli host smí dovnitř, a vstup zapíše. Bez jmen hostů.

The list of stay packages (free nights, discount, surcharge, included services) and a reader of the guest's QR code for wellness gates, breakfast and the car park: the server says whether the guest may go in and records the entry. Without guests' names.

PřidánoAdded

• listLodgingPackages – balíčky, které provozovna nabízí, s pravidly ceny a službami v ceně.listLodgingPackages – the packages the restaurant offers with their price rules and included services.
• checkGuestPass a undoGuestPassCheck – ověření QR kódu hosta na místě (wellness, snídaně, polopenze, parkoviště) a vrácení vstupu.checkGuestPass and undoGuestPassCheck – checking the guest's QR code at a place (wellness, breakfast, half board, car park) and undoing an entry.
• InHouseStay.package a StayFolio.package – balíček pobytu.InHouseStay.package and StayFolio.package – the package of the stay.
• Oprávnění guest_passes:check.Scope guest_passes:check.

Reference ve verzi 26.11.15Reference at version 26.11.15 · Porovnat s 26.11.14Compare with 26.11.14

Úklid pokojů a závadyRoom cleaning and faults

Aplikace pro pokojské a údržbu: úkoly úklidu na den po pokojích (po odjezdu, obsazené pokoje, přistýlky pro příjezdy, výměna ručníků a povlečení podle pravidel provozovny), odškrtávání a hlášení závad, které můžou pokoj vyřadit z prodeje. Bez jmen a údajů hostů.

Applications for housekeepers and maintenance: the cleaning tasks of the day by room (after departure, occupied rooms, extra beds for arrivals, towels and linen by the rules of the restaurant), ticking them off and reporting faults that can take a room out of sale. Without guests' names and data.

PřidánoAdded

• getHousekeepingDay – pokoje s úkoly na den, nejnaléhavější první (příjezd do neuklizeného pokoje), stav pokoje, příjezd, odjezd a otevřené závady.getHousekeepingDay – rooms with the tasks of the day, the most urgent first (an arrival to a room not cleaned yet), the state of the room, arrival, departure and open faults.
• completeHousekeepingTask a undoHousekeepingTask – odškrtnutí a vrácení úkolu; úklid po odjezdu přepne pokoj na clean, kontrola na inspected.completeHousekeepingTask and undoHousekeepingTask – tick a task off and back; cleaning after departure makes the room clean, the inspection inspected.
• listRoomIssues, reportRoomIssue a fixRoomIssue – závady pokojů; s blocks_room je pokoj mimo provoz, dokud se závada neopraví.listRoomIssues, reportRoomIssue and fixRoomIssue – faults of rooms; with blocks_room the room is out of order until the fault is fixed.
• Oprávnění housekeeping:read a housekeeping:write.Scopes housekeeping:read and housekeeping:write.

Reference ve verzi 26.11.14Reference at version 26.11.14 · Porovnat s 26.11.13Compare with 26.11.13

Útrata na pokojCharging bills to a room

Pokladna restaurace nebo baru hotelu zapíše útratu ubytovaného hosta na účet jeho pokoje a host ji zaplatí při odjezdu. Seznam právě ubytovaných hostů, účet pokoje s platbami a zůstatkem a zápis útraty, který se při opakování nezdvojí.

The register of a hotel restaurant or bar charges the bill of a staying guest to the account of the room and the guest pays it at departure. The list of guests staying now, the account of the room with payments and balance, and a charge that is never written twice when repeated.

PřidánoAdded

• listInHouseStays – kdo je právě ubytovaný: pokoj, jméno, termín, počet osob a co zbývá zaplatit.listInHouseStays – guests staying now: room, name, dates, number of guests and what is left to pay.
• getStayFolio – účet pokoje: ubytování, poplatek z pobytu, služby a útraty, platby a zůstatek.getStayFolio – the account of the room: accommodation, city tax, services and charges, payments and balance.
• chargeToStay – útrata na pokoj s vaší reference, která se nikdy nezapíše dvakrát; jen u právě ubytovaného hosta, jinak lodging_state_conflict.chargeToStay – a charge to the room with your reference that is never written twice; only for a guest staying now, otherwise lodging_state_conflict.
• Oprávnění lodging:read a lodging:write; DeviceSettings.features.lodging říká pokladně, že může nabízet „na pokoj“.Scopes lodging:read and lodging:write; DeviceSettings.features.lodging tells the register it may offer „to the room“.

DokumentaceDocumentation

• DeviceSettings.features.reservations už neříká, že je vyhrazené – Rezervační systém Profirest má.DeviceSettings.features.reservations no longer says it is reserved – Profirest has the Reservation system.

Reference ve verzi 26.11.13Reference at version 26.11.13 · Porovnat s 26.11.12Compare with 26.11.12

Přehled rezervací a pravidla zálohReservation statistics and deposit rules

Přehled rezervací za období se stejnými čísly jako v administraci, včetně skutečné doby u stolu s návrhem lepšího nastavení. Pravidla rezervací nově říkají, kdy a kolik zálohy provozovna chce, připomínky a hodnocení.

Reservation statistics for a period with the same numbers as the administration, including how long guests really sit with a suggestion for better rules. The reservation rules now tell when and how much deposit the restaurant wants, the reminders and the ratings.

PřidánoAdded

• getReservationStats – rezervace, hosté, nepřišlí, zdroje, dny a hodiny, zálohy, hodnocení a table_turn (skutečná doba u stolu a návrhy).getReservationStats – reservations, guests, no-shows, sources, weekdays and hours, deposits, ratings and table_turn (real table time and suggestions).
• getReservationSettings: deposit (režim, částky, lhůty, no_show_guests – záloha od hostů, kteří už nepřišli), reminders, feedback_enabled, guest_max_moves.getReservationSettings: deposit (mode, amounts, time limits, no_show_guests – a deposit from guests who did not come before), reminders, feedback_enabled, guest_max_moves.

Reference ve verzi 26.11.12Reference at version 26.11.12 · Porovnat s 26.11.11Compare with 26.11.11

Čekací listina a hodnocení hostůWaiting list and guest ratings

Aplikace obsluhy vede čekací listinu hostů bez stolu – zapíše je, pošle jim SMS, že je stůl připravený, a usadí je. Hodnocení po návštěvě (1–5 hvězdiček a komentář) si vezmete za období i s průměrem.

An application of the staff keeps the waiting list of guests without a table – adds them, sends them an SMS that the table is ready and seats them. Ratings after the visit (1–5 stars and a comment) for a period, with the average.

PřidánoAdded

• listWaitlist, addToWaitlist, notifyWaitlistEntry (SMS, že je stůl připravený), closeWaitlistEntry (usazen / odešel).listWaitlist, addToWaitlist, notifyWaitlistEntry (an SMS that the table is ready), closeWaitlistEntry (seated / left).
• listReservationFeedback – hodnocení hostů po návštěvě za období a jejich průměr.listReservationFeedback – guest ratings after the visit for a period and their average.

Reference ve verzi 26.11.11Reference at version 26.11.11 · Porovnat s 26.11.10Compare with 26.11.10

Rezervace pro obsluhu – zálohy, délka, hosté bez rezervace a historie hostaReservations for the staff – deposits, length, walk-ins and guest history

Aplikace obsluhy pošle hostovi odkaz k zaplacení zálohy (i rezervace přijaté po telefonu), zálohu odpustí, zadá vlastní délku rezervace stolu, usadí hosty bez rezervace a při telefonu uvidí, kolikrát host přišel, nepřišel nebo zrušil a jaké měl štítky (alergie, VIP).

An application of the staff sends the guest the link to pay a deposit (also for bookings taken by phone), waives a deposit, sets its own length of a table reservation, seats guests without a reservation and, on the phone, sees how many times the guest came, did not come or cancelled and their tags (allergies, VIP).

PřidánoAdded

• sendReservationPaymentLink – nový odkaz na stránku rezervace hosta, kde zaplatí zálohu kartou; pošle ho na e-mail hosta a vrátí ho i pro SMS.sendReservationPaymentLink – a new link to the guest's page of the reservation where the deposit is paid by card; sent to the guest's e-mail and returned for an SMS too.
• waiveReservationDeposit – odpuštění čekající zálohy; rezervace čekající jen na zálohu se potvrdí.waiveReservationDeposit – waives a pending deposit; a reservation waiting only for the deposit is confirmed.
• getReservationGuest – historie hosta podle telefonu nebo e-mailu napříč provozovnami účtu.getReservationGuest – the history of a guest by phone or e-mail across the restaurants of the account.
• createReservation: duration_minutes (vlastní délka stolu), walk_in (hosté bez rezervace – teď a hned usazení), deposit: false (bez zálohy) – jen channel=staff. updateReservation: duration_minutes.createReservation: duration_minutes (own length at a table), walk_in (guests without a reservation – now and seated at once), deposit: false (no deposit) – only channel=staff. updateReservation: duration_minutes.

Reference ve verzi 26.11.10Reference at version 26.11.10 · Porovnat s 26.11.9Compare with 26.11.9

Rezervace stolů a služebReservations of tables and services

Nové operace pro rezervace: pravidla provozovny, služby k rezervaci, volné časy dne, založení, změny a stavy rezervace (potvrdit, odmítnout, zrušit, usadit, odešli, nepřišli) a stav stolů v tuto chvíli. Kapacitu hlídá server – stůl, pracovník ani místnost nejsou nikdy rezervované dvakrát. Pro rezervační platformy, weby provozoven i aplikace obsluhy.

New operations for reservations: the rules of the restaurant, bookable services, free times of a day, creating, changing and moving a reservation through its states (confirm, reject, cancel, seat, left, no-show) and the state of the tables now. The server keeps the capacity – a table, an employee or a room is never booked twice. For booking platforms, websites of restaurants and applications of the staff.

PřidánoAdded

• getReservationSettings, listReservationServices, getReservationAvailability – pravidla, služby a volné časy.getReservationSettings, listReservationServices, getReservationAvailability – rules, services and free times.
• listReservations, createReservation, getReservation, updateReservation a stavy confirmReservation, rejectReservation, cancelReservation, seatReservation, completeReservation, markReservationNoShow.listReservations, createReservation, getReservation, updateReservation and the states confirmReservation, rejectReservation, cancelReservation, seatReservation, completeReservation, markReservationNoShow.
• getTableStatus – které stoly jsou teď volné, rezervované nebo obsazené (i hosté bez rezervace).getTableStatus – which tables are free, reserved or occupied now (also guests without a reservation).
• Oprávnění reservations:read a reservations:write; události reservation.created, reservation.updated, reservation.status_changed.Scopes reservations:read and reservations:write; events reservation.created, reservation.updated, reservation.status_changed.
• Chyby reservation_unavailable, reservation_not_allowed, reservation_state_conflict.Errors reservation_unavailable, reservation_not_allowed, reservation_state_conflict.

ZměněnoChanged

• Výdejna bez stolů (getDeviceSettings, pos.takeaway_only): kalkulace s fulfillment.type dine_in se spočítá jako pickup – s obalem a sazbou DPH s sebou – a objednávka je osobní odběr. Kiosek v takové provozovně volbu „Tady“ nenabízí.A takeaway-only restaurant (getDeviceSettings, pos.takeaway_only): a quote with fulfillment.type dine_in is priced as pickup – with packaging and the takeaway VAT rate – and the order is a pickup. A kiosk in such a restaurant does not offer the "eat in" choice.

Reference ve verzi 26.11.9Reference at version 26.11.9 · Porovnat s 26.11.8Compare with 26.11.8

Výdejna bez stolůTakeaway-only restaurant

Provozovna bez stolů (třeba výdejna pizzy) si zapne, že každá účtenka a bon z pokladny je s sebou: server připočte obal produktů, i když pokladna pošle jídlo na místě. Pokladna to čte v nastavení zařízení.

A restaurant without tables (a pizza counter, say) turns on that every receipt and ticket of the register is takeaway: the server adds the packaging fee of the products, also when the register sends eating in. The register reads it in the device settings.

PřidánoAdded

• DeviceSettings.pos.takeaway_only – výdejna bez stolů, vše s sebou s obalem.DeviceSettings.pos.takeaway_only – a takeaway-only restaurant, everything takeaway with packaging.

ZměněnoChanged

• createReceipt, previewReceipt a createKitchenTicket: při pos.takeaway_only je order_type vždy takeaway.createReceipt, previewReceipt and createKitchenTicket: with pos.takeaway_only the order_type is always takeaway.

Reference ve verzi 26.11.8Reference at version 26.11.8 · Porovnat s 26.11.7Compare with 26.11.7

Storno účtenky podle nastavení provozovnyReceipt cancellation by the rules of the restaurant

Provozovna si volí, kdo smí na pokladně stornovat účtenku, a tím změnit platbu: kdokoli s rolí pos (výchozí, jako v API v1), nebo jen vedoucí pokladny. Pokladna to čte v nastavení zařízení, ať se na PIN vedoucího ptá předem, a ne až po chybě.

A restaurant chooses who may cancel a receipt at the register, and so change its payment: anybody with the pos role (default, as in API v1), or only a register manager. The register reads it in the device settings, so it asks for the manager's PIN beforehand, not after an error.

PřidánoAdded

• DeviceSettings.pos.receipt_cancel_by (staff | manager) – kdo smí stornovat účtenku.DeviceSettings.pos.receipt_cancel_by (staff | manager) – who may cancel a receipt.

ZměněnoChanged

• cancelReceipt podle pos.receipt_cancel_by: při staff stačí role pos, PIN vedoucího se jen zapíše; manager_approval_required jen při manager.cancelReceipt follows pos.receipt_cancel_by: with staff the pos role is enough, the manager's PIN is only recorded; manager_approval_required only with manager.

Reference ve verzi 26.11.7Reference at version 26.11.7 · Porovnat s 26.11.6Compare with 26.11.6

Přechod vlastních zařízení Profirestu mezi API v1 a v2Profirest's own devices moving between API v1 and v2

Profirest pouští provozovny na API v2 postupně a umí je vrátit. Vlastní aplikace pokladny, kuchyňského displeje a kurýra přitom přecházejí samy, bez nového párování: identitu z API v1 vymění za tokeny zařízení a zařízení spárované rovnou na API v2 si vyzvedne záložní identitu pro návrat. Kam mají být, říká hlavička Profirest-Api-Target a pole api_target. Účet stolu, jehož pokladna přešla na API v1, je převedený.

Profirest moves restaurants to API v2 one by one and can move them back. Its own register, kitchen display and courier apps follow on their own, without pairing again: they exchange their API v1 identity for device tokens, and a device paired straight to API v2 picks up a backup identity for the way back. Where they belong is told by the header Profirest-Api-Target and the field api_target. A tab whose register moved to API v1 is transferred.

PřidánoAdded

• Grant urn:profirest:params:oauth:grant-type:v1-device v oauthToken – jen vlastní pokladna, kuchyňský displej a kurýr Profirestu: identita API v1 za tokeny zařízení, když je provozovna na API v2.The grant urn:profirest:params:oauth:grant-type:v1-device of oauthToken – only Profirest's own register, kitchen display and courier: an API v1 identity for device tokens while the restaurant is on API v2.
• createLegacyIdentity – záložní identita API v1 pro zařízení spárované rovnou na API v2; kódy chyb legacy_identity_unsupported a no_legacy_identity.createLegacyIdentity – a backup API v1 identity for a device paired straight to API v2; the error codes legacy_identity_unsupported and no_legacy_identity.
• Device.api_target (v getConnection) a DeviceCheckInResult.api_target – kam má vlastní zařízení Profirestu patřit (ApiTarget), u ostatních null; totéž v hlavičce Profirest-Api-Target každé odpovědi takovému zařízení.Device.api_target (in getConnection) and DeviceCheckInResult.api_target – where Profirest's own device belongs (ApiTarget), null for others; the same in the header Profirest-Api-Target of every answer to such a device.
• OAuthError.api_target – v1 u obnovy tokenu zařízení vráceného na API v1, jinak null.OAuthError.api_target – v1 on a refresh of a device moved back to API v1, otherwise null.
• PosShiftCloseRequest.legacy_receipt_ids – účtenky směny vystavené v API v1; uzávěrka je vezme také.PosShiftCloseRequest.legacy_receipt_ids – receipts of the shift issued in API v1; the close takes them in as well.
• Stav účtu stolu transferred – pokladna přešla na API v1 a účet převzala, nebo ji někdo odpojil.The tab status transferred – its register moved to API v1 and took the tab over, or the register was unpaired.

ZměněnoChanged

• Uzávěrka pokladny (closePosShift, getPosShift) počítá otevřené účty stolů jen za uzavírané pokladny, ne za celou provozovnu.A register close (closePosShift, getPosShift) counts the open tabs of the closed registers only, not of the whole restaurant.

Reference ve verzi 26.11.6Reference at version 26.11.6 · Porovnat s 26.11.5Compare with 26.11.5

Rozvozová zóna u kuchyňského bonuThe delivery zone at a kitchen ticket

Kuchyňský displej může sčítat frontu podle rozvozových zón – co pojede jedním kurýrem, se peče a balí spolu. Bon rozvozu nese zónu, do které padne adresa, spočítanou Profirestem z polohy adresy stejně jako v e-shopu a na kuchyňském displeji Profirestu.

A kitchen display can sum up the queue by delivery zones – what goes with one courier is baked and packed together. A delivery ticket carries the zone its address lies in, computed by Profirest from the location of the address the same way as in the e-shop and on the Profirest kitchen display.

PřidánoAdded

• KitchenTicket.delivery_zone (id a name jako v listDeliveryZones) – rozvozová zóna adresy bonu s delivery; null u ostatních bonů, u adresy bez souřadnic, mimo všechny zóny a v provozovně bez zón.KitchenTicket.delivery_zone (id and name as in listDeliveryZones) – the delivery zone of the address of a ticket with delivery; null for other tickets, an address without coordinates, outside all zones and in a restaurant without zones.

Reference ve verzi 26.11.5Reference at version 26.11.5 · Porovnat s 26.11.4Compare with 26.11.4

Složení – host odebere surovinu („bez žampionů“)Composition – the guest removes an ingredient („without mushrooms“)

Produkt může mít složení: suroviny, které si host smí odebrat. Aplikace je ukáže zaškrtnuté a odškrtnuté pošle s položkou – u pizzy z dílů u každého dílu zvlášť. Cena se nemění. Kuchyň dostane u jídla (u dílu) výrazné „BEZ: ŽAMPIONY“ a sklad odebranou surovinu neodepíše. Funguje v kalkulaci a objednávce, při přidání položek k bonu, na účtence, bonu a účtu stolu pokladny i v objednávkách od stolu.

A product can have a composition: ingredients the guest may remove. An application shows them ticked and sends the unticked ones with the item – for a pizza from parts at every part. The price does not change. The kitchen gets a prominent „WITHOUT: MUSHROOMS“ at the dish (at the part) and the stock does not write the removed ingredient off. It works in a quote and an order, when adding items to a ticket, on a receipt, a ticket and a tab of the register and in orders from the table.

PřidánoAdded

• Product.removable_ingredients a TableMenuProduct.removable_ingredients (RemovableIngredient: id, name) – složení ve všech kanálech sortimentu, [], když produkt žádné nemá.Product.removable_ingredients and TableMenuProduct.removable_ingredients (RemovableIngredient: id, name) – the composition in every channel of the catalog, [] when the product has none.
• removed_ingredient_ids ve vstupech QuoteItemInput (i addKitchenTicketItems), SplitPartInput (u dílu), ReceiptItemInput, KitchenTicketCreate.items[], TabInput.items[], TableOrderLineInput a TableOrderApplyInput.lines[] – nejvýš 30, každé ID jednou.removed_ingredient_ids in the inputs QuoteItemInput (also addKitchenTicketItems), SplitPartInput (at the part), ReceiptItemInput, KitchenTicketCreate.items[], TabInput.items[], TableOrderLineInput and TableOrderApplyInput.lines[] – at most 30, every ID once.
• removed_ingredients (id a název z doby objednání) v OrderLine, OrderLinePart, TabLine a TableOrderLine; u starších kalkulací, objednávek a účtů []. Nepovinné TableOrderLineState.removed_ingredients pro hlavní kasu.removed_ingredients (the ID and the name from the time of ordering) in OrderLine, OrderLinePart, TabLine and TableOrderLine; [] for older quotes, orders and tabs. The optional TableOrderLineState.removed_ingredients for the main register.
• KitchenItem.removed_ingredients a KitchenModifier.removed_ingredients – názvy odebraných surovin u jídla a u dílu dělené pizzy (poznámka note zůstává beze změny).KitchenItem.removed_ingredients and KitchenModifier.removed_ingredients – the names of the removed ingredients at the dish and at a part of a split pizza (the note stays unchanged).
• Kód pole ingredient_not_removable (u 422 validation_failed) – produkt takovou surovinu k odebrání nemá, nebo je v seznamu dvakrát.The field code ingredient_not_removable (with 422 validation_failed) – the product has no such removable ingredient, or it is in the list twice.

Reference ve verzi 26.11.4Reference at version 26.11.4 · Porovnat s 26.11.3Compare with 26.11.3

Živý proud změn přes Server-Sent EventsThe live change feed over Server-Sent Events

Změny už nemusíte zjišťovat dotazováním. streamEvents posílá tytéž události jako listEvents jednou dlouhou odpovědí text/event-stream, ve stejném pořadí a se stejným kurzorem: id každé zprávy je kurzor, po výpadku se pokračuje hlavičkou Last-Event-ID a mezi proudem a dotazováním jde kdykoli přecházet. Telefon hosta u stolu dostává přes streamTableEvents upozornění, že se změnila jeho objednávka, volání, účet stolu nebo návštěva – stejně jako na hlavní kase.

You no longer have to poll for changes. streamEvents sends the same events as listEvents over one long-lived text/event-stream response, in the same order and with the same cursor: the id of every message is the cursor, after a disconnection you continue with the header Last-Event-ID and you can switch between the stream and polling at any time. A guest's phone at the table gets from streamTableEvents notices that its order, call, the tab of the table or the visit changed – the same as on the main register.

PřidánoAdded

• streamEvents – živý proud změn (Server-Sent Events): zprávy ready (StreamReady), jedna zpráva za každou událost (event: typ, data: Event, id: kurzor) a closing (StreamClosing s důvodem max_age, token_expired, token_revoked, restart, forbidden). Parametry restaurant_id a types jako u listEvents, pokračování hlavičkou Last-Event-ID nebo cursor.streamEvents – the live change feed (Server-Sent Events): messages ready (StreamReady), one message for every event (event: the type, data: the Event, id: the cursor) and closing (StreamClosing with the reason max_age, token_expired, token_revoked, restart, forbidden). Parameters restaurant_id and types as in listEvents, continuing with the header Last-Event-ID or cursor.
• streamTableEvents – upozornění pro telefon hosta u stolu (TableGuestEvent: session, orders, calls, tab, visit_ended), stejně jako události místního API hlavní kasy.streamTableEvents – notices for a guest's phone at the table (TableGuestEvent: session, orders, calls, tab, visit_ended), the same as the events of the main register's local API.

ZměněnoChanged

• ApiRoot.stream_url je adresa streamEvents, když proud běží (dřív vždy null); null znamená dotazovat listEvents.ApiRoot.stream_url is the address of streamEvents while the stream runs (always null before); null means poll listEvents.

Reference ve verzi 26.11.3Reference at version 26.11.3 · Porovnat s 26.11.2Compare with 26.11.2

Kurýr u dveří – platba kartou i hotově a nepřevzaté objednávkyThe courier at the door – card or cash payment and orders not taken over

Aplikace kurýra zapíše platbu, kterou vybral u dveří – kartou na terminálu nebo hotově, oběma směry (hotovostní objednávka zaplacená kartou i karta, která neprošla, zaplacená hotově) – a uzávěrka podle toho přesune tržbu mezi hotovostí a kartou. Bon říká, kolik zbývá vybrat a čím se zaplatilo. Když zákazník jídlo nepřevezme, kurýr to zapíše s důvodem; objednávka nejde do tržby, trasa se dokončí a provozovna ji pak odepíše, pošle znovu, nebo označí jako doručenou.

A courier application records the payment taken at the door – by card on the terminal or in cash, both ways (a cash order paid by card and a card that failed paid in cash) – and the shift close moves the takings between cash and card accordingly. A ticket tells how much is left to collect and how it was paid. When the customer does not take the food over, the courier records it with the reason; the order does not go into the takings, the route is completed and the restaurant then writes it off, sends it out again or marks it delivered.

PřidánoAdded

• handoverTicketPayment – platba vybraná kurýrem u dveří (HandoverPayment: method card/cash, amount včetně tip, gateway_payment_id terminálu, card_brand, card_last4, paid_at). Kódy chyb already_paid (s Problem.paid_by), payment_method_not_changeable a amount_mismatch.handoverTicketPayment – the payment the courier took at the door (HandoverPayment: method card/cash, amount including tip, the terminal's gateway_payment_id, card_brand, card_last4, paid_at). Error codes already_paid (with Problem.paid_by), payment_method_not_changeable and amount_mismatch.
• markTicketNotDelivered – nepřevzatá objednávka s důvodem (NotDeliveredReport: reason, note, attempted_at, location s přesností, call_attempts). Kódy chyb note_required a ticket_already_delivered.markTicketNotDelivered – an order not taken over, with the reason (NotDeliveredReport: reason, note, attempted_at, location with its accuracy, call_attempts). Error codes note_required and ticket_already_delivered.
• KitchenTicket.amount_due (kolik zbývá vybrat), KitchenTicket.paid_by (PaidBy), KitchenTicket.not_delivered (NotDeliveredInfo) a u zákazníka bonu not_delivered_count a last_not_delivered_at.KitchenTicket.amount_due (what is left to collect), KitchenTicket.paid_by (PaidBy), KitchenTicket.not_delivered (NotDeliveredInfo), and not_delivered_count and last_not_delivered_at at the customer of a ticket.
• Stav not_delivered v KitchenTicket.status, Order.status a EventKitchenTicketData.status.The status not_delivered in KitchenTicket.status, Order.status and EventKitchenTicketData.status.
• KitchenTicketCancel.write_off – storno bez vrácení surovin na sklad (odpis nepřevzaté objednávky).KitchenTicketCancel.write_off – a cancellation without returning stock (writing off an order not taken over).
• ShiftTotals.not_delivered – počet a hodnota nepřevzatých objednávek v uzávěrce kuchyně a kurýra.ShiftTotals.not_delivered – the number and the value of orders not taken over in the close of the kitchen and of a courier.

ZměněnoChanged

• Trasa se dokončí, i když jsou její zbylé objednávky nepřevzaté; markTicketDelivered jde i u nepřevzaté objednávky a createDeliveryRoute ji pošle znovu.A route is completed also when its remaining orders were not taken over; markTicketDelivered works for an order not taken over too and createDeliveryRoute sends it out again.

Reference ve verzi 26.11.2Reference at version 26.11.2 · Porovnat s 26.11.1Compare with 26.11.1

Ceny a účtenka na kuchyňském bonu, půl porce pro personálPrices and the receipt on a kitchen ticket, a half portion for the staff

Kuchyňský displej a kurýr vytisknou účtenku rozvozu přímo z bonu: bon nese účtenku spočítanou serverem stejně jako kopie účtenky v administraci (položky, slevy na účet, doprava, zaokrouhlení, celkem, k úhradě, rozpis DPH, nadpis a číslo dokladu) a každá položka cenu za kus, obal, slevu, příznak dárku z akce, sazbu DPH a velikost jako štítek. Aplikace personálu objednají půl porce – v kalkulaci, objednávce i při přidání položek k bonu.

The kitchen display and the courier print the delivery receipt straight from the ticket: a ticket carries the receipt computed by the server the same way as the copy of the receipt in the administration (items, discounts of the whole receipt, delivery, rounding, total, amount to pay, VAT by rates, the title and the number of the document), and every item its price per piece, packaging, discount, the mark of a gift of a promotion, the VAT rate and the size as a label. Staff applications order a half portion – in a quote, an order and when adding items to a ticket.

PřidánoAdded

• KitchenTicket.receipt (KitchenTicketReceipt) – účtenka bonu: items, discounts (záporně, s názvem akce), delivery, rounding, adjustment, total, to_pay, vat po sazbách a document (nadpis, číslo dokladu, zjednodušený daňový doklad).KitchenTicket.receipt (KitchenTicketReceipt) – the receipt of a ticket: items, discounts (negative, with the name of the promotion), delivery, rounding, adjustment, total, to_pay, vat by rates and document (the title, the number of the document, simplified tax document).
• KitchenItem a KitchenModifier: unit_price (za kus po slevě), packaging_price, discount (na kus, záporně), gift (dárek z akce), vat_rate a size (KitchenItemSize – velikost a název jídla bez ní).KitchenItem and KitchenModifier: unit_price (per piece after the discount), packaging_price, discount (per piece, negative), gift (a gift of a promotion), vat_rate and size (KitchenItemSize – the size and the name of the dish without it).
• QuoteItemInput.variant (full | half) – půl porce za Product.half_price v sortimentu kitchen a pos; jinde 422 validation_failed s kódem not_allowed. Platí pro createQuote i addKitchenTicketItems; v kuchyni je půlka KitchenItem.kind half.QuoteItemInput.variant (full | half) – a half portion at Product.half_price in the catalogs kitchen and pos; elsewhere 422 validation_failed with the code not_allowed. It applies to createQuote and addKitchenTicketItems; in the kitchen a half is KitchenItem.kind half.
• Product.half_price (kanály kitchen a pos, ve web null) a OrderLine.variant.Product.half_price (the channels kitchen and pos, null in web) and OrderLine.variant.
• AppVersion.sha256 a AppVersion.size – otisk a velikost souboru k ověření staženého instalátoru; hodnota kitchen_windows v AppVersion.app (kuchyňský displej pro Windows).AppVersion.sha256 and AppVersion.size – the fingerprint and the size of the file to check a downloaded installer; the value kitchen_windows in AppVersion.app (the kitchen display for Windows).

Reference ve verzi 26.11.1Reference at version 26.11.1 · Porovnat s 26.10.9Compare with 26.10.9

Pizza z půlek a čtvrtek, vlastní pizza a víc porcí přílohyPizza from halves and quarters, custom pizza and more portions of an add-on

Aplikace hostů objednají pizzu ze dvou půlek nebo čtyř čtvrtek různých druhů – každý díl se svými přílohami, jeden obal za pizzu – a produkty, které si zákazník skládá ze skupin voleb: vlastní pizzu, povinný výběr těsta nebo přílohy, ingredience s mezemi a s porcemi v ceně a prémiové volby, které zvednou cenu základu. Příloha může mít víc porcí (dvojitý sýr). Kalkulace vrací úplný rozpis dílů a voleb a kuchyň vidí díly pizzy s přísadami u svého dílu.

Guest applications can order a pizza from two halves or four quarters of different kinds – each part with its own add-ons, one packaging fee per pizza – and products the customer composes from groups of options: a custom pizza, a required choice of dough or side, toppings with limits and with portions included in the price, and premium options that raise the base price. An add-on can have more portions (double cheese). The quote returns a full breakdown of parts and options, and the kitchen sees the parts of a pizza with the toppings at their part.

PřidánoAdded

• QuoteItemInput.type split s parts (2 půlky nebo 4 čtvrtky, SplitPartInput s přílohami dílu) a Product.split (ProductSplit – ceny půlky a čtvrtky). Díly ze stejné kategorie a velikosti, obal nejvyšší z dílů.QuoteItemInput.type split with parts (2 halves or 4 quarters, SplitPartInput with the add-ons of the part) and Product.split (ProductSplit – prices of a half and a quarter). Parts from the same category and of the same size, the highest packaging of the parts.
• Product.option_groups (ProductOptionGroup, ProductOption) a QuoteItemInput.options (OptionInput) – meze porcí skupiny, porce jedné volby, N nejlevnějších porcí v ceně a prémiová cena základu (ProductOption.base_price). Jen kanál web; produkt se skupinami nemá add_ons.Product.option_groups (ProductOptionGroup, ProductOption) and QuoteItemInput.options (OptionInput) – limits of portions of a group, portions of one option, the N cheapest portions included in the price and a premium base price (ProductOption.base_price). Only the web channel; a product with groups has no add_ons.
• AddOnInput.quantity – víc porcí jedné přílohy; v řádku OrderLine.add_ons[].quantity a OrderLinePart.add_ons[].quantity.AddOnInput.quantity – more portions of one add-on; in the line OrderLine.add_ons[].quantity and OrderLinePart.add_ons[].quantity.
• OrderLine.base_unit_price, options (OrderLineOption s porcemi v ceně a důvodem reason) a parts (OrderLinePart); OrderLine.type split.OrderLine.base_unit_price, options (OrderLineOption with included portions and a reason) and parts (OrderLinePart); OrderLine.type split.
• KitchenItem.part a KitchenModifier.part – ke kterému dílu dělené pizzy řádek patří.KitchenItem.part and KitchenModifier.part – which part of a split pizza the line belongs to.
• Kódy polí option_not_in_group, option_group_min, option_group_max, split_category_mismatch a split_size_mismatch (u 422 validation_failed).Field codes option_not_in_group, option_group_min, option_group_max, split_category_mismatch and split_size_mismatch (with 422 validation_failed).

ZměněnoChanged

• QuoteItemInput.product_id je nepovinné – u split nepatří, u product zůstává povinné (chybějící vrátí 422 validation_failed s kódem required).QuoteItemInput.product_id is optional – it does not belong to split and stays required for product (a missing one answers 422 validation_failed with the code required).

Reference ve verzi 26.10.9Reference at version 26.10.9 · Porovnat s 26.10.8Compare with 26.10.8

Akce 2.0 – slevy na položky, věrnostní karta, dárky, sady a jednorázové kódyPromotions 2.0 – item discounts, loyalty cards, gifts, sets and single-use codes

Akce provozoven umí víc: slevu na vybrané kategorie a produkty, každý N-tý kus se slevou (2+1 zdarma) i věrnostní kartu napříč objednávkami (každá 7. pizza zdarma), dárek k objednávce a pevnou cenu za sadu. Platí i podle dne v týdnu a denní doby (happy hour), jen pro registrované zákazníky nebo na první objednávku a s limitem na zákazníka. Slevové kódy mohou být i jednorázové. Sleva na položky přichází jako sleva řádku v jeho sazbě DPH, dárek jako řádek s plnou cenou a slevou na ni.

Promotions of restaurants can do more: a discount on chosen categories and products, every N-th piece at a discount (2+1 free) and a loyalty card across orders (every 7th pizza free), a gift with the order and a fixed price for a set. They can apply by the day of the week and the time of day (happy hour), only for registered customers or the first order, and with a limit per customer. Promo codes can also be single-use. A discount of items comes as a discount of a line in its VAT rate, a gift as a line with its full price and a discount of it.

PřidánoAdded

• PromotionEffect.type nth_item (každý N-tý kus, s loyalty věrnostní karta napříč objednávkami), gift (dárek) a bundle (pevná cena sady) s poli nth_item, gift a bundle.PromotionEffect.type nth_item (every N-th piece, with loyalty a loyalty card across orders), gift and bundle (a fixed price for a set) with the fields nth_item, gift and bundle.
• Podmínky akce PromotionConditions.min_items, scope (kategorie a produkty), days, time_windows (happy hour), customer (any, registered, first_order) a max_per_customer.Promotion conditions PromotionConditions.min_items, scope (categories and products), days, time_windows (happy hour), customer (any, registered, first_order) and max_per_customer.
• Promotion.code_type – sdílený (shared) nebo jednorázový kód (single_use); jednorázové kódy se posílají v QuoteRequest.promo_codes stejně jako sdílené.Promotion.code_type – a shared (shared) or single-use code (single_use); single-use codes go in QuoteRequest.promo_codes like shared ones.
• Discount.applies_to line – sleva na položky jednoho řádku (line_id) v jeho sazbě DPH, z ceny produktu (přílohy a obal se platí).Discount.applies_to line – a discount of the items of one line (line_id) in its VAT rate, from the price of the product (add-ons and packaging are paid).
• OrderLine.gift_of – řádek dárku, který přidala akce; v kalkulaci i objednávce.OrderLine.gift_of – a gift line added by a promotion; in quotes and orders.

ZměněnoChanged

• Čas akce (platnost, dny, denní doba) se posuzuje v okamžiku odeslání objednávky (vytvoření kalkulace), ne podle času doručení nebo odběru; listPromotions s at filtruje jen platnost.The time of a promotion (validity, days, time of day) is judged at the moment the order is sent (the quote is created), not by the time of delivery or pickup; listPromotions with at filters the validity only.
• Podrobnější detail u promo_code_not_applicable (kolik chybí, počet kusů, část sady, den a čas, jen registrovaní nebo první objednávka); promo_code_used_up i pro použitý jednorázový kód a vyčerpaný limit zákazníka; promotion_changed i když jednorázový kód mezitím použila jiná objednávka nebo zákazník dosáhl limitu.A more detailed detail of promo_code_not_applicable (how much is missing, the number of items, a part of a set, the day and time, registered customers or the first order only); promo_code_used_up also for a used single-use code and a reached limit per customer; promotion_changed also when another order used the single-use code meanwhile or the customer reached the limit.
• Poplatky a slevy celé objednávky se dělí do sazeb DPH podle položek po slevách na řádky; Totals.items zahrnuje řádky dárků s plnou cenou.Charges and discounts of the whole order are split over the VAT rates by the items after the discounts of lines; Totals.items includes gift lines at their full price.

Reference ve verzi 26.10.8Reference at version 26.10.8 · Porovnat s 26.10.7Compare with 26.10.7

Docházkový terminál – rozpis směn a žádosti o volnoAttendance terminal – shift schedule and time-off requests

Zaměstnanec přihlášený na docházkovém terminálu uvidí svůj rozpis směn a volna na příštích až 31 dní, může požádat o volno a čekající žádost vzít zpět. Provozovna si v administraci nastaví, jestli a jak žádosti přijímá.

An employee signed in on the attendance terminal sees their shifts and days off for up to 31 days ahead, can request time off and withdraw a pending request. The restaurant decides in the administration whether and how it takes requests.

PřidánoAdded

• Rozpis přihlášeného zaměstnance getMyAttendanceSchedule – směny a volno na příštích až 31 dní.The signed-in employee's schedule getMyAttendanceSchedule – shifts and days off for up to 31 days ahead.
• Žádosti o volno listMyAbsenceRequests, createAbsenceRequest a zpětvzetí čekající žádosti cancelAbsenceRequest.Time-off requests listMyAbsenceRequests, createAbsenceRequest and withdrawing a pending one with cancelAbsenceRequest.
• AttendanceTerminal.absence_requests – pravidla žádostí, která provozovna nastavila (terminál podle nich ukáže formulář).AttendanceTerminal.absence_requests – the request rules the restaurant set (the terminal shows the form by them).
• Kódy chyb absence_requests_disabled, absence_request_not_allowed, absence_request_conflict a absence_request_decided.Error codes absence_requests_disabled, absence_request_not_allowed, absence_request_conflict and absence_request_decided.

ZměněnoChanged

• Čtení stačí s oprávněním attendance:read, žádost a její zpětvzetí s attendance:punch – stejně jako dosud píchnutí.Reading needs attendance:read, requesting and withdrawing attendance:punch – the same as punches so far.

Reference ve verzi 26.10.7Reference at version 26.10.7 · Porovnat s 26.10.6Compare with 26.10.6

Stav a chyby vlastních zařízení, logy na vyžádáníStatus and errors of own devices, logs on request

Vlastní zařízení Profirestu hlásí každou minutu svůj stav a chyby hned, když nastanou. Celý log zůstává na zařízení a server si ho vyžádá, jen když ho podpora potřebuje – nahraje se po částech s jednorázovým tokenem. Týká se jen aplikací Profirestu; partnerských integrací se verze nedotkne.

Profirest's own devices report their status every minute and errors as soon as they happen. The full log stays on the device and the server asks for it only when support needs it – it is uploaded in parts with a one-time token. Only Profirest's own apps are concerned; partner integrations are not affected.

PřidánoAdded

• checkInDevice – stav zařízení každých 60 sekund; odpověď nese příkazy upload_logs, live_logs a ping. Hlavička Profirest-Commands: pending u každé odpovědi zařízení řekne, že příkaz čeká.checkInDevice – the device's status every 60 seconds; the answer carries the commands upload_logs, live_logs and ping. The header Profirest-Commands: pending on any answer to the device says a command is waiting.
• reportDeviceError – chyba hned, i s asi 30 řádky kontextu, vlastním ID proti dvojímu zápisu, nejvýš 60 za hodinu.reportDeviceError – an error at once, with about 30 lines of context and the device's own ID against duplicates, at most 60 an hour.
• Nahrávání logu po částech s tokenem cíle pfl_ (nový způsob přihlášení logUpload) – getLogUpload, putLogUploadPart (gzip po částech do 4 MB), completeLogUpload a abortLogUpload.Uploading a log in parts with an upload token pfl_ (the new security scheme logUpload) – getLogUpload, putLogUploadPart (gzip, parts up to 4 MB), completeLogUpload and abortLogUpload.
• Kódy chyb upload_closed a upload_incomplete.Error codes upload_closed and upload_incomplete.

ZastaraléDeprecated

• createDeviceLogs – řádky logu už nejdou do databáze po jednom. Operace dál funguje pro starší aplikace; nahrazují ji reportDeviceError a soubory na vyžádání.createDeviceLogs – log lines no longer go to the database one by one. The operation still works for older apps; reportDeviceError and logs on request replace it.

DokumentaceDocumentation

• Doplněno 28. 10. 2026 (tvar beze změny): strop 200 MB na jedno nahrávání a 500 MB na jednu žádost (413), plný disk serveru 503, souběžné požadavky na totéž nahrávání 409 conflict, příkaz upload_logs přijde znovu se stejnými tokeny, kontext chyby nejvýš 16 kB a 1 MB za den na zařízení.Added on 28 October 2026 (shape unchanged): at most 200 MB per upload and 500 MB per request (413), a full server disk 503, concurrent requests on the same upload 409 conflict, the upload_logs command comes again with the same tokens, error context at most 16 kB and 1 MB a day per device.

Reference ve verzi 26.10.6Reference at version 26.10.6 · Porovnat s 26.10.5Compare with 26.10.5

Expresní doručeníExpress delivery

Zákazník si rozvoz „co nejdřív“ může za příplatek zrychlit. Cenu určuje rozvozová zóna, expres má přednost v kuchyni i u kurýra, ale bez slíbeného času. Nový přehled ukazuje poplatky za dopravu, doplatek do minima a expres.

The customer can speed up an "as soon as possible" delivery for a fee. The delivery zone sets the price; express has priority in the kitchen and with the courier, but no promised time. A new report shows the delivery fees, minimum-order surcharges and express fees.

PřidánoAdded

• FulfillmentInput.speed a Fulfillment.speed – standard nebo express; expres jen u rozvozu „co nejdřív“.FulfillmentInput.speed and Fulfillment.speed – standard or express; express only for an "as soon as possible" delivery.
• Příplatek zóny DeliveryZone.express_fee, DeliveryInfo.express_fee a AddressSuggestion.zone.express_fee – null znamená, že se v zóně expres nenabízí.The zone's fee DeliveryZone.express_fee, DeliveryInfo.express_fee and AddressSuggestion.zone.express_fee – null means express is not offered in the zone.
• Poplatek Charge.type = express_delivery („Expresní doručení“, DPH jako vedlejší výdaj) a kód chyby express_unavailable.The charge Charge.type = express_delivery ("Express delivery", VAT as an incidental cost) and the error code express_unavailable.
• V kuchyni KitchenTicket.express (štítek EXPRES) a KitchenItem.charge / KitchenModifier.charge – řádek je poplatek, ne jídlo.In the kitchen KitchenTicket.express (the EXPRESS label) and KitchenItem.charge / KitchenModifier.charge – the line is a fee, not food.
• Přehled poplatků getChargesReport (oprávnění reports:read) – doprava, doplatek do minima a expres, kolikrát a za kolik, stejně jako Statistiky v administraci.The charges report getChargesReport (scope reports:read) – delivery, minimum-order surcharge and express, how many times and for how much, the same as Statistics in the administration.

ZměněnoChanged

• Řádky dokladu prodeje za doplatek do minima a za expres mají vlastní SaleLine.type – minimum_order_surcharge a express_delivery (doplatek dřív přicházel jako product).Sales document lines for the minimum-order surcharge and express have their own SaleLine.type – minimum_order_surcharge and express_delivery (the surcharge used to come as product).

Reference ve verzi 26.10.5Reference at version 26.10.5 · Porovnat s 26.10.4Compare with 26.10.4

Akce a slevové kódy, kiosek, přehledy tržeb, objednávání od stoluPromotions and promo codes, kiosk, sales reports, ordering from the table

Největší rozšíření od vydání v2: akce a slevové kódy v kalkulaci a objednávce, samoobslužný kiosek a jídlo na místě, přehledy tržeb, doklady prodeje a účetní export pro partnerské systémy, zápis otevírací doby a porcí, přesuny mezi účty stolů a uzávěrka za víc zařízení a objednávání od stolu přes QR kód.

The largest extension since v2 was released: promotions and promo codes in quotes and orders, a self-service kiosk and eating in, sales reports, sales documents and accounting export for partner systems, writing opening hours and portions, moving lines between tabs and closing several devices at once, and ordering from the table by a QR code.

PřidánoAdded

• Akce a slevové kódy: listPromotions (catalog:read), QuoteRequest.promo_codes, slevy v kalkulaci a objednávce s Discount.promotion, applies_to a line_id, kódy chyb promo_code_invalid, promo_code_expired, promo_code_not_applicable, promo_code_used_up, promo_code_attempts_exceeded a promotion_changed, událost promotions.changed.Promotions and promo codes: listPromotions (catalog:read), QuoteRequest.promo_codes, discounts in quotes and orders with Discount.promotion, applies_to and line_id, error codes promo_code_invalid, promo_code_expired, promo_code_not_applicable, promo_code_used_up, promo_code_attempts_exceeded and promotion_changed, the event promotions.changed.
• Kiosek: kanál Connection.client.order_channel = kiosk, jídlo na místě fulfillment.type = dine_in (bez obalu, DPH „na místě“), objednávka kiosku bez kontaktu na zákazníka a platba kartou na terminálu kiosku.Kiosk: the channel Connection.client.order_channel = kiosk, eating in fulfillment.type = dine_in (no packaging, VAT for eating in), kiosk orders without customer contact and card payment at the kiosk's terminal.
• Přehledy a účetnictví (reports:read): getSalesSummary, getProductSales, getTipsReport, getVatReport, doklady prodeje ze všech zdrojů listSales a getSale, uzávěrky listShiftCloses a getShiftClose, události sale.created, sale.cancelled a shift.closed; účetní export pro Pohodu a Money getAccountingExport (accounting:read).Reports and accounting (reports:read): getSalesSummary, getProductSales, getTipsReport, getVatReport, sales documents from all sources listSales and getSale, shift closes listShiftCloses and getShiftClose, the events sale.created, sale.cancelled and shift.closed; the accounting export for Pohoda and Money getAccountingExport (accounting:read).
• Zápis z partnerských systémů: otevírací doba setOpeningHours (opening_hours:write), zbývající porce a „vyprodáno“ setProductAvailability (availability:write, kód portion_tracking_disabled).Writing from partner systems: opening hours setOpeningHours (opening_hours:write), remaining portions and "sold out" setProductAvailability (availability:write, code portion_tracking_disabled).
• Sortiment: Category.color, Category.icon, Product.kitchen_name, PosProductInfo.ticket (kuchyň nebo bar) a velikosti Product.size – každá velikost je samostatný produkt, klient je seskupí podle group_id.Catalog: Category.color, Category.icon, Product.kitchen_name, PosProductInfo.ticket (kitchen or bar) and sizes Product.size – each size is its own product; the client groups them by group_id.
• Kuchyň: KitchenTicket.platform, KitchenItem.category, KitchenItem.from_daily_menu, bon stolu na čas KitchenTicketCreate.preorder_at a události kitchen.ticket_created a kitchen.ticket_updated i pro objednávky mimo API.Kitchen: KitchenTicket.platform, KitchenItem.category, KitchenItem.from_daily_menu, a table ticket for later KitchenTicketCreate.preorder_at and the events kitchen.ticket_created and kitchen.ticket_updated also for orders outside the API.
• Pokladna: přesun položek mezi účty moveTabLines, důvod u closeTab, uzávěrka za víc zařízení a odvod číšníka (getPosShift s devices, closePosShift s device_ids), vklad, výběr a výdaj createCashMovement a pokladní kniha getCashBook, listStaff s ETag a 304.Register: moving lines between tabs moveTabLines, a reason at closeTab, closing several devices and a waiter's hand-in (getPosShift with devices, closePosShift with device_ids), deposits, withdrawals and expenses createCashMovement and the cash book getCashBook, listStaff with ETag and 304.
• Objednávání od stolu: skupina operací Table ordering pro telefon hosta s vlastním tokenem pfg_ (způsob přihlášení tableGuest) a spojení hlavní kasy s cloudem (table:sync, jen aplikace Profirestu), DeviceSettings.table_ordering, kód stolu pro QR Room.tables[].code, událost table.inbox_received.Ordering from the table: the Table ordering group for the guest's phone with its own pfg_ token (security scheme tableGuest) and the main register's link to the cloud (table:sync, Profirest's apps only), DeviceSettings.table_ordering, the table's QR code Room.tables[].code, the event table.inbox_received.

ZměněnoChanged

• listEvents: parametr types přijímá i skupinu order.* jako proud přes WebSocket (dřív 422).listEvents: the types parameter also takes the group order.*, like the WebSocket stream (422 before).
• OrderCreate.customer a OrderCustomerInput.phone už nejsou ve schématu povinné – vynechat je smí jen kiosek; ostatní dál dostanou 422 required, rozvoz vždy.OrderCreate.customer and OrderCustomerInput.phone are no longer required by the schema – only a kiosk may leave them out; others still get 422 required, delivery always.
• closeTab: řádky už poslané do kuchyně se zapíšou jako storna.closeTab: lines already sent to the kitchen are recorded as cancellations.

Reference ve verzi 26.10.4Reference at version 26.10.4 · Porovnat s 26.10.3Compare with 26.10.3

Rozpis DPH dopravy jako na účtenceVAT split of delivery as on the receipt

Doprava a doplatek do minima se do sazeb DPH dělí poměrem hrubých částek položek – přesně jako kopie účtenky a účetní exporty. Rozpis DPH kalkulace a objednávky tak sedí s účtenkou, Pohodou i Money na haléř.

Delivery and the minimum-order surcharge are split into VAT rates by the ratio of the items' gross amounts – exactly like the receipt copy and the accounting exports. The VAT breakdown of quotes and orders now matches the receipt, Pohoda and Money to the cent.

OpravenoFixed

• Dělení dopravy a doplatku do sazeb DPH poměrem hrubých částek (dřív poměrem základů daně).Delivery and surcharge split into VAT rates by gross amounts (by tax bases before).

DokumentaceDocumentation

• Příklady kalkulace podle serveru: kalkulace platí 15 minut, voucher v ní je pending a Loyalty.redeemable je false.Quote examples as the server answers: a quote is valid for 15 minutes, a voucher in it is pending and Loyalty.redeemable is false.

Tvar API se nezměnil – jen texty, příklady a chování podle smlouvy.The shape of the API did not change – texts, examples and behaviour by the contract only.

Reference ve verzi 26.10.3Reference at version 26.10.3 · Porovnat s 26.10.2Compare with 26.10.2

Přesnější dokumentaceMore precise documentation

Jen texty a příklady, tvar API se nezměnil. Popisy teď přesně odpovídají tomu, co server dělá, a smlouva uvádí i odpovědi, které server vracel už dřív.

Texts and examples only; the shape of the API did not change. The descriptions now match exactly what the server does, and the contract lists answers the server already gave before.

DokumentaceDocumentation

• Zdokumentované odpovědi: 409 ticket_cancelled u startStationWork, stopStationWork a takeBackTicketHandover, 400 invalid_request u oauthRevoke, 429 u oauthAuthorize a oauthDeviceAuthorization (limit na IP adresu); u startPhoneVerification popsaná 503, když SMS nejde odeslat.Documented answers: 409 ticket_cancelled at startStationWork, stopStationWork and takeBackTicketHandover, 400 invalid_request at oauthRevoke, 429 at oauthAuthorize and oauthDeviceAuthorization (a limit per IP address); 503 at startPhoneVerification explained for when an SMS cannot be sent.
• Doplněné popisy hlavních schémat (účtenka, objednávka, kuchyňský bon, účet stolu, produkt, provozovna, zákazník, nastavení zařízení) a jejich polí, význam hodnot výčtů a parametrů.Descriptions of the main schemas (receipt, order, kitchen ticket, tab, product, restaurant, customer, device settings) and their fields, the meaning of enum values and parameters.
• Upřesněné chování: vaše ID (putExternalRef) jen u pěti typů objektů, restaurant.changed i po uložení provozovny v administraci, stálá ID zón a stolů, kódy voucherů v poznámkách jen maskované (ABC-***).Behaviour made precise: your IDs (putExternalRef) for five object types only, restaurant.changed also after the restaurant is saved in the administration, stable IDs of zones and tables, voucher codes in notes masked only (ABC-***).
• Veřejný ukázkový účet profirestdemo (bez SMS, e-mailů a EET, data se každou noc obnoví) a popis přechodu z API v1.The public demo account profirestdemo (no SMS, e-mails or EET, the data is reset every night) and how to move from API v1.

Reference ve verzi 26.10.2Reference at version 26.10.2 · Porovnat s 26.10.1Compare with 26.10.1

První finální verze API v2The first final version of API v2

Zmrazená smlouva API v2: napojení e-shopů a partnerských aplikací (OAuth 2.0 s PKCE, sortiment, kalkulace a objednávky, zákazníci, vouchery, vaše ID objektů, události v proudu i webhookem) a vlastní zařízení Profirestu (párování kódem, zaměstnanci, docházka, kuchyňský displej, rozvoz, pokladna s účtenkami spočítanými serverem a EET 2.0 ze serveru, inventura, zálohy a diagnostika). Od této verze platí slib stability – v rámci v2 se jen přidává.

The frozen API v2 contract: integrations of e-shops and partner applications (OAuth 2.0 with PKCE, the catalog, quotes and orders, customers, vouchers, your IDs of objects, events in the feed and by webhook) and Profirest's own devices (pairing by code, staff, attendance, the kitchen display, deliveries, the register with receipts priced by the server and EET 2.0 sent by the server, stock taking, backups and diagnostics). The stability promise holds from this version – within v2 things are only added.

Výchozí verze: celou smlouvu, jak tehdy vypadala, ukáže reference ve verzi 26.10.1.The starting version: the reference at version 26.10.1 shows the whole contract as it was then.

Reference ve verzi 26.10.1Reference at version 26.10.1