API propojení a integrace
- Načtení objednávky z externího API souboru
- Propojení na informačním systémem (web integrace)
- Webhook Integrace API
- REST API
- Propojení Foodora **
- Propojení WhatsApp
- Propojení Wolt + Wolt Retail
- Propojení Better Hotel
- Propojení Aktion.eu - stravovací systém
Načtení objednávky z externího API souboru
Aplikace KASA FIK nabízí možnost importu již přednastavených objednávek/faktur ze stávajícího informačního systému pomocí stáhnutí JSON dokumentu. Prodejce tak může načíst předpřipravenou objednávku s položkami, číslem účtenky i poznámkami. Používá se v mobilním a sanitárním prodeji, prodeji z eshopu a jiných situacích, kdy dochází jen k dokončení tržby na zařízení a objednávka byla připravena předem.
Funkce je dostupná pouze v edici PREMIUM
Nastavení
- V Nastavení – Expert nastavení – Importní URL pro objednávky zadejte URL adresu k Vašemu rozhraní na serveru
- Daná URL adresa musí vrátit platný dokument JSON ve formátu popsaném níže
- Adresa je například: https://www.mujserver.cz/hledat.php
- Aplikace připojí parametr „search“ s volbou, kterou zadá uživatel. to znamená že bude voláno např. https://www.mujserver.cz/hledat.php?search=220001
Používání
- V aplikaci, v rozhraní KLASIK
- Vlevo nahoře klepněte na šipku menu
- Zvolte „Vyhledat položky z objednávky“
- Zadejte číslo objednávky, které se použije k vyhledání dané objednáky na serveru
- Pokud se objednávka nelezne, dojde k vyplnění položek
Popis formátu
- Pokud je invoice_number null, aplikace čísluje dle svého číselného plánu. Jinak se použije invoice_number
- Ceny, množství, DPH jsou desetinná čísla double
- PLU slouží k párování položek, to znamená, že pokud položka neexistuje v pokladně, pod daným PLU, bude automaticky vytvořena
Formát JSON platné odpovědi
{
"invoice_number": 20130001, // optional, will be generated if not provided
"note": "strestt", // optional
"items": [
{
"plu": "203", // optional
"note": "Item optional note" // optional
"name": "Item number 203",
"price_without_vat": 112.0,
"quantity": 1.0,
"vat_rate": 1.21
}
]
}
Formát JSON prázdné odpovědi pokud server nic nenalezl
Pokud uživatel zadá neplatný kód faktury, měl by server vrátit chybu 404 - Not found v hlavičce a odpověd v těle by měla obsahovat null
null
Propojení na informačním systémem (web integrace)
Aplikace KASA FIK umožňuje dynamicky integrovat webové aplikace zákazníka pomocí integrovaného tlačítka nebo funkční klávesy. Propojení je ideální pro přenos objednávek z eshopu nebo účetních systémů přímo do aplikace.
Funkce je dostupná pouze s licencí PREMIUM
Princip funkce - workflow
- Uživateli se zobrazí nové nastavitelné tlačítko na hlavní obrazovce
- Po klepnutí na tlačítko se načte webová aplikace, která je plně pod kontrolou zákazníka
- Ve webové aplikace může být umístěno tlačítko, které po kliknutí přenese uživatele zpět do aplikace a vyplní automaticky účtenku
- KASA FIK provede zaúčtování EET případně platbu kartou
- Integraci lze nastavit i na funkční klávesu při prodeji
- Informace o vystavení účtenek lze získat přes Webhook API
Ukázková stránka
Vytvořili jsme ukázkovou stránku, ve které můžete vidět funkce, které lze využít při práci v aplikaci a návrtatu hodnot.
Příklad poskytnutých parametrů v URL:
partner_code=XXXXX&utm_source=app-com.eetterminal.pos&utm_medium=app&utm_campaign=fik-integration&app_flavor=fik&app_version=1.181-beta12-debug&app_version_code=181&app_lang=cs&shop_id=848428671200000&cash_register_id=2044577243700000&shift_id=5132358187320000
Query String poskytnutý při volání URL
- partner_code - Partnerský kód, pokud je nastaven
- utm_source - Google UTM měřící kód. Hodnota "app-com.eetterminal.pos"
- utm_medium - Google UTM měřící kód. Hodnota "app"
- utm_campaign- Google UTM měřící kód. Hodnota "fik-integration"
- app_flavor - Typ aplikace- Hodnota "fik"
- app_version - Textový popis verze aplikace. Např. 1.180-beta1
- app_version_code - Kód verze aplikace např. 180
- app_lang - Jazyk, ve kterém je nastavena aplikace (cs pro češtinu)
- global_customer_id - Globální ID zákazníka
- shop_id - ID pobočky
- cash_register_id - ID pokladny
- shift_id - ID současné směny - Hodnota 0 pro uzavřenou směnu
- employee_id - ID aktuálně přihlášeného zaměstnance. Hodnota 0 pokud není nikdo přihlášen
- user_email - Email pod kterým je evidována pokladna
Specifikace integrace
Aplikace načte uživatetem přednastavené URL, které obohatí o Query String s dalšími parametry. Rozšíří Javascript funkce o interface window.FikApiInterface
který obsahuje metody použitelné k propojení nativní Android aplikace s webovou.
if (window.FikApiInterface){
window.FikApiInterface.logError('heyho'); // log error message to android console
window.FikApiInterface.logInfo('heyho'); // log info message to android console
window.FikApiInterface.setTitle(document.title); // sets title of the window
window.FikApiInterface.showToast('heyho'); // shows small toast notification
// window.FikApiInterface.finish(); // Will close the window without any result
// window.FikApiInterface.finishWithReceipt(JSON.stringify(obj)); // return back to the app with receipt data
} else {
// Not loaded within Fik Webapp container
}
Návrat účtenky do aplikace
Zavolejte metodu window.FikApiInterface.finishWithReceipt(JSON.stringify(obj))
s následujícim JSON objektem:
{
"invoice_number": 20130001, // optional, will be generated if not provided
"note": "strestt", // optional
"items": [
{
"plu": "203", // optional
"note": "Item optional note" // optional
"name": "Item number 203",
"price_without_vat": 112.0,
"quantity": 1.0,
"vat_rate": 1.21
}
]
}
Poznámky k poskytovanému objektu:
- Hodnota musí být
JSON.stringify()
, protože Web integrace neumožňuje přenášet objekty. - Pokud je vše v pořádku, aplikace uzavře integraci a přenese uživatele do režimu vystavení účtenky
- Pokud nebude vyplněná hodnota
invoice_number
aplikace vygeneruje standarně podle číselné řady (doporučené) - DPH je v desetinném formátu, tedy 1.21, 1.10, 1.00 - nevyplňujte, pokud se jedná o neplátce
Nastavení expirace a vliv na cache (expire)
Webová integrace respektuje správné nastavení cache hlavičky pro ukládání do paměti prohlížeče. Nastavíte-li správné Expire v HTTP hlavičce, bude se respektovat.
Aplikace má také podporu pro ukládání databází a Webstorage.
Webhook Integrace API
Webhooky umožňují zasílání dat z pokladny/backoffice pomocí HTTP volání informovat o každé události (např. vystavení účtenky, založení zákazníka). Zpracováním webhooků si můžete měnit chování stránky nebo aplikace a rozšiřovat je o nové funkce.
Webhooky lze nastavit v Backoffice v Nastavení - Systém - Webhooky. Zadejte https:// adresu kam systém má zasílat data. Nastavení uložte tlačítkem Uložit. Pak následně může trvat nějaký čas, než systém začne automaticky data zasílat. Nové nastavení může trvat až 1-2 hodiny, než se projeví nastavení skrz systémy.
Formát zasílaných dat
- Data jsou zasílána ve formátu JSON objektu a metodou POST.
- Server musí odpovědět na požadavek návratovým HTTP kódem 200
- Přijímací server musí odpovědět návratovým kódem 200
- Jednotlivé záznamy (objekty) jsou zasílány zvlášť a není garantované pořadi doručení
- Každý záznam má následující povinné pole
- _t - Jedná se o název tabulky/typu záznamu, jako je "orders, order_details, products, ..."
- _v - Verze v Unix timestamp kdy byl záznam změněn
- id - unikatní ID záznamu
- Pokud záznam obsahuje monetární data (ceny, hodnoty prodeje atd) tak jsou vyjádřeny jako celé číslo (int) vynásobené 1000. Např. cena 3 331,000 Kč je vyjádřena jako 3331000
Příklad zaslaného objektu `orders`
{
"_t": "orders",
"_v": 1541274974010,
"conversion_rate": 1,
"currency": "CZK",
"dine_in": false,
"id": 3317888960569993,
"id_c": 100000,
"id_cash_register": 3173505578999348,
"id_employee": 1,
"id_employee_served": 1,
"id_park_location": 3227505427363220,
"id_shift": 3317259000928416,
"id_shop": 3173505578310000,
"order_serial_number": 103,
"total_credits": 0,
"total_discounts_tax_excl": 0,
"total_discounts_tax_incl": 0,
"total_paid_real": 3331000,
"total_paid_tax_excl": 3331000,
"total_paid_tax_incl": 3331000,
"total_points": 0,
"total_products": 32,
"total_profit_tax_excl": 0,
"total_profit_tax_incl": 0,
"total_shipping_tax_excl": 0,
"total_shipping_tax_incl": 0,
"total_tax_eco": 0,
"total_tax_gst": 0,
"total_tax_luxury": 0,
"total_tax_pst": 0,
"total_tax_service": 0,
"total_tip": 0,
"total_wrapping_tax_excl": 0,
"total_wrapping_tax_incl": 0
}
REST API
Data z pokladen jsou pravidelně synchronizována do cloudu a zpřístupněna přes REST API.
API je v současné době poskytováno v omezeném režimu. Do budoucna plánujeme expiraci autorizačního tokenu. Pokud chcete získávat kontinuáně data a synchronizovat systémy doporučujeme používat Webhooky. Jedná se o efektivnější způsob.
Autorizace požadavku
Autorizace probíhá pomocí API Tokenu, který naleznete v Backoffice - Nastavení - Systém.
Autorizační klíč je v HTTP hlavičce Authorization: A|xxxxx
curl -XGET 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/products/list' \
-H 'Authorization: A|kLgT.........' \
-H 'Content-Type: application/json'
POST přííklad:
curl -XPOST 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reports/generic/order_history' \
-H 'Authorization: A|kLgT.........' \
-H 'Content-Type: application/json' \
--data-raw '{"date_start":1639436400000,"date_end":1642028399999,"timezone":"Europe/Prague","id_cash_register":953221254382092,"id_shop":492696696397774}' \
Konvence
- Časy jsou reprezentovány v unix timestamp v millisekundách. Např. 1639436400000
- Monetární hodnoty (tržba, cena, atd) jsou vždy celé číslo, vynásobené 1000. Např. cena 23.50 je v JSON dokumentu jako 23500.
- Autorizační token nemá expiraci, ale do budoucna plánujeme že token bude muset být vyměněn za nový
- Do User Agent prosím vložte svoji identifikaci případně kontakt, abychom měli kontakt na vývojáře
- Pokud navrácený objekt obsahuje položku, která začíná na
__
tak se jedná o tzv. hydrataci - objekt je automaticky obohacen o child objekty, aby vývojář nemusel provádět další dotazy na API. - Převod id na čas lze provést pomocí funkce:
new Date((id / 32768) + 1440000000000);
Společné pole
id_c
- globální ID zákazníka_v
- verze objektu_d
- indikuje jestli byl záznam označen jako smazaný_t
- název tabulkypgx
- složený interní primární klíč - ignorujte- pole s prefixem
date_
jsou Unix UTC čas v millisekundách - pole s prefixem
id_
jsou relace a odkaz na záznam v jiné tabulce. Napřid_shop
odkazuje na id obchodu v tabulce shops.
Funkce pro práci s id
Id je číslo složené z času, id tabulky a náhodného suffixu. Příklad výpočtu:
const EPOCH = 1440000000000;
// Vrati objekt s datem a id tabulky
function getDateFromId(id) {
return {
dt: new Date((id / 32768) + EPOCH),
tableId: (id / 512) & 0x3f
}
}
// Generuje id pro konkretni tabulku - pouzijte 0 pro referenci
function getRandomRowId(tableId) {
let ts = new Date().getTime() - EPOCH;
let randid = Math.floor(Math.random() * 512);
ts = (ts * 64);
ts = ts + tableId;
return (ts * 512) + (randid % 512);
}
GET products
Vrací JSON Array se seznamem produktů. Položky které jsou smazané, mají nastaveno _visible = false
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/products/list
CURL příklad
curl 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/products/list' \
-H 'Authorization: A|......'
Odpověď
[
{
"unit": 0,
"date_updated": 1641499263724,
"attributes_bitmask": 8208,
"__price_matrix_model": {
"date_starts": 1640070857424,
"unit_price_base_tax_incl": 550,
"unit_price_regular_tax_excl": 454546,
"unit_price_c_tax_excl": 0,
"credits_deduct": 0,
"hour_bitmask": 0,
"points_deduct": 0,
"reduction_amount_a_tax_excl": 0,
"id_exec_rule": 0,
"id_product": 6555921856010421,
"unit_price_b_tax_excl": 0,
"dow_bitmask": 0,
"price_bitmask": 0,
"unit_price_base_tax_excl": 454.5455,
"id_shop": 0,
"currency": "CZK",
"unit_price_a_tax_excl": 454546,
"id": 6555922259744395,
"id_warehouse": 953221254427235,
"_t": "product_price_matrix",
"_v": 1641499263728
},
"condition_type": 0,
"name": "Cesta",
"id_category": 5723345161520367,
"node_sort": -6680027574804497000,
"inventory_management": false,
"id": 6555921856010421,
"id_shop": 0,
"color": 0,
"visible": true,
"tax_pst_rate": 1.21,
"item_type": 0,
"icon_code": 0,
"quantity_minimal": 1,
"quantity_multiple": 1,
"id_c": 111111,
"_t": "products",
"_v": 1641499263746
}
]
GET product/{id}
Vrací jednotlivý produkt podle ID objektu. Pro ceny volejte get-price-by-product-id/
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/products/{id}
Odpověď
{
"unit": 0,
"pgx": "111:products",
"description_short": "Vydařená kombinace rumu a griotky",
"date_updated": 1647012279153,
"attributes_bitmask": 8240,
"sale_group_type": 0,
"condition_type": 1,
"name": "Čert",
"id_tax_rules_group": 0,
"id_category": 6783340285035904,
"node_sort": 3752073357922477000,
"accounting_group": 600000,
"warranty_length": 0,
"inventory_management": true,
"inventory_type": 0,
"id": 6783372795320333,
"id_shop": 0,
"tax_eco": 1,
"color": 0,
"visible": true,
"_d": 0,
"tax_luxury": 1,
"tax_pst_rate": 1.21,
"item_type": 0,
"additional_shipping_cost": 0,
"icon_code": 0,
"warranty_type": 0,
"_t": "products",
"quantity_minimal": 1,
"_v": 1681918519463,
"quantity_multiple": 1,
"id_c": 111111,
"id_exec_rule": 0
}
GET get-price-by-product-id/{id_product}
Vrací ceny pro konkrétní produkt v ceníku podle id produktu.
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/products/get-price-by-product-id/{id_product}
GET product_price_matrix
Ceny k produktům. Je nutné napárovat pomocí id_product
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/product_price_matrix/list
Odpověď
[
{
"currency": "CZK",
"unit_price_base_tax_excl": 30,
"id_warehouse": 4438373662962620,
"_d": 1,
"dow_bitmask": 0,
"credits_deduct": 0,
"hour_bitmask": 0,
"unit_price_base_tax_incl": 30,
"id_product": 4438453021022482,
"unit_price_regular_tax_excl": 30000,
"points_deduct": 0,
"date_starts": 1575450836824,
"price_bitmask": 0,
"_t": "product_price_matrix",
"unit_price_a_tax_excl": 30000,
"_v": 1633950008092,
"id": 4438454091814580,
"reduction_amount_a_tax_excl": 0,
"id_shop": 0,
"id_c": 1141932
}
]
GET categories
Seznam kategorií v hiearchické struktuře
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/categories/list
Odpověď
[
{
"visible": true,
"_d": 0,
"name": "Cakes >",
"category_bitmask": 0,
"icon_code": 5,
"node_sort": 5000000,
"id_category_sort_after": 0,
"_t": "categories",
"_v": 1672597351272,
"id_category_parent": 0,
"id": 1,
"id_shop": 0,
"color": 17,
"id_c": 111111,
"children": [
{
"visible": false,
"name": "test",
"category_bitmask": 0,
"margin_minimal_rate": null,
"icon_code": 4,
"node_sort": 5000000,
"id_category_sort_after": 0,
"_t": "categories",
"_v": 1640029337604,
"id_category_parent": 1,
"id": 1067887041152062,
"id_shop": 0,
"margin": null,
"color": 5,
"tags": null,
"id_c": 111111,
"children": []
}
]
}
]
GET shops
Seznam poboček (shops)
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/shops/list
Odpověď
[
{
"visible": true,
"currency": "CZK",
"_d": 0,
"name": "Shop 83",
"location_name": "City 44",
"_t": "shops",
"_v": 1677240349376,
"id": 492696696391111,
"bitmask": 0,
"id_c": 111111
}
]
GET cash_registers
Seznam poboček. Více o struktuře a závislosti na obchodech v manuálu zde.
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/cash_registers/list
Odpověď
[
{
"visible": true,
"name": "Point of Sale 233",
"location_name": "Brno",
"_t": "cash_registers",
"_v": 1640802641284,
"cash_register_type": 11,
"id": 49269669639111,
"id_shop": 492696696397774,
"bitmask": 0,
"id_c": 11111
}
]
GET customers
Seznam zákazníků
curl 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/customers/list' \
-H 'Authorization: A|ADq
Odpověď
[
{
"customer_type": 0,
"credit_account": null,
"internal_extra": null,
"price_group": "A",
"zip_code": "40801",
"date_updated": null,
"email": null,
"city": "RUMBURK",
"bank_account": null,
"date_birthday": null,
"company": "Test s.r.o.",
"geohash": null,
"firstname": null,
"company_ico": "3332650",
"id": 3665795354036044,
"color": 0,
"bitmask": 0,
"tags": "csv-import-91",
"barcode": null,
"visible": true,
"id_discount_group": null,
"lastname": null,
"company_dic": "CZ33333",
"internal_json": null,
"_t": "customers",
"_v": 1551875000154,
"date_expires": null,
"phone_number": null,
"note_internal": null,
"country_code": "CZ",
"note_external": null,
"id_c": "11111",
"street": "17.8"
}
]
GET customer/{id}
Jednotlivý záznam pro zákazníka podle ID.
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/customers/{id}
curl 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/customers/12344566' \
-H 'Authorization: A|ADqsEX...
GET orders
Vrací seznam účtenek (JSON Array), seřazené od nejnovějších po nejstarší.
Poznámky:
- Pokud je doklad zrušený nebo stornovaný, pole
date_canceled
obsahuje čas zrušení (not-null) reduction_percent
indikuje slevu v procentech poskytnutou zakaznikovi vynasobene 1000, uvedené jako celé číslo (integer). Tzn. hodnota 500 znamená, že byla poskytnuta sleva 0.5%
Parametry
- id_start - id záznamu od kterého se má stránkovat. výchozí hodnota 0 stránkuje od nejnovejší účtenky
- version_start - unix epoch timestamp (ms) filtr. Hodnota 0 znamená že se hodnoty nebudou filtrovat.
- limit - omezit počet záznamů, výchozí 250, maximum 2000. Velková velikost navráceného JSON nemůže přesáhnout 6MB
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/orders/list?version_start=0&id_start={id_order}
GET orders/latest/{id_cash_register}
Posledních 40 orders z konkrétní pokladny podle id_cash_register. Metoda nepodporuje stránkování. Doporučujeme na získávání aktuálních objednávek v pravidelných intervalech pro systémy, které chtějí získávat online přehled o uskutečnených pohybech.
Query string parametry:
- id_payment (optional) - ID forma platby. Např 221: hotovost, 222: kreditní parta, 238: sumup
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/orders/latest/{id_cash_register}?id_payment={id_payment}
Odpověď
[
{
"total_discounts_tax_excl": 0,
"currency": "CZK",
"pgx": "1141932:orders:4438373662917304",
"total_points": 0,
"id_employee": 0,
"date_closed": 1642005467495,
"total_credits": 0,
"id_payment": 222,
"total_paid_tax_excl": 50000,
"total_shipping_tax_excl": 0,
"total_tax_service": 0,
"total_paid_real": 50000,
"conversion_rate": 1,
"_u_dyn": 1642005490213,
"total_discounts_tax_incl": 0,
"geohash": "u2ugrgc",
"date_collected": 1642005467495,
"total_tip": 0,
"id_cash_register": 4438373662917304,
"id": 6619285123010267,
"dine_in": true,
"id_shop": 4438373662924485,
"total_products": 1,
"total_tax_gst": 0,
"total_profit_tax_excl": 0,
"order_serial_number": 130,
"summary": "1x Pure bar",
"id_park_location": 0,
"total_wrapping_tax_incl": 0,
"_d": 0,
"total_tax_eco": 0,
"total_tax_pst": 0,
"total_shipping_tax_incl": 0,
"id_employee_served": 0,
"date_paid": 1642005467185,
"id_shift": 6618245790277082,
"total_profit_tax_incl": 0,
"date_tax_reported": 1642005467495,
"_t": "orders",
"total_paid_tax_incl": 50000,
"_v": 1642005467521,
"total_wrapping_tax_excl": 0,
"total_tax_luxury": 0,
"invoice_number": 202012274,
"id_c": 1141932
}
]
GET order/{id_cash_register}/{id_order}
Umožní získat účtenku/doklad včetně položek v poli __order_details
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/orders_details/{id_cash_register}/{id_order}
{
"total_discounts_tax_excl": 0,
"currency": "CZK",
"pgx": "1173665:orders:7694791899251239",
"total_points": 0,
"id_employee": 1,
"date_closed": 1684414596504,
"total_credits": 0,
"id_payment": 222,
"total_paid_tax_excl": 56522,
"total_shipping_tax_excl": 0,
"total_tax_service": 0,
"date_fiscalized": 0,
"total_paid_real": 65000,
"conversion_rate": 1,
"total_discounts_tax_incl": 0,
"date_collected": 1684414596504,
"total_tip": 0,
"id_cash_register": 7694791899251000,
"id": 8008974168592088,
"dine_in": true,
"id_shop": 7694791899258554,
"total_products": 2,
"total_tax_gst": 0,
"total_profit_tax_excl": 0,
"order_serial_number": 320,
"id_park_location": 0,
"total_wrapping_tax_incl": 0,
"_d": 0,
"total_tax_eco": 0,
"total_tax_pst": 8478,
"total_shipping_tax_incl": 0,
"id_employee_served": 1,
"date_paid": 1684414596504,
"id_shift": 7962837799869694,
"total_profit_tax_incl": 0,
"date_tax_reported": 1684414596504,
"_t": "orders",
"total_paid_tax_incl": 65000,
"_v": 1684414596517,
"total_wrapping_tax_excl": 0,
"total_tax_luxury": 0,
"invoice_number": 202305288,
"id_c": 11111,
"date_canceled": null,
"__order_details": [
{
"product_item_type": 0,
"currency": "CZK",
"pgx": "1173665:order_details:7694791899251239",
"total_points": 0,
"id_warehouse": 0,
"id_employee": 1,
"date_updated": 1684414596517,
"total_credits": 0,
"id_payment": 222,
"id_product": 7833117185743150,
"_u_dyn": 1684414622686,
"reduction_amount_tax_incl": 0,
"id_category": 7694792007615808,
"id_order": 8008974168592088,
"product_name_alternative": ":;en:Cappuccino",
"product_price_billed_tax_incl": 35000,
"id_order_details_parent": 1,
"id_cash_register": 7694791899251000,
"id": 8008976796814560,
"id_shop": 7694791899258554,
"product_quantity": 1,
"product_bitmask": 0,
"product_name": "Cappuccino",
"_d": 0,
"total_tax_eco": 0,
"total_tax_pst": 4565,
"reduction_amount_tax_excl": 0,
"product_price_billed_tax_excl": 30435,
"product_unit": 0,
"product_price_original_tax_excl": 30435,
"tax_pst_rate": 1.15,
"date_paid": 1684414596517,
"id_shift": 7962837799869694,
"_t": "order_details",
"_v": 1684414596517,
"order_number": 320,
"total_tax_luxury": 0,
"reduction_percent": 0,
"id_c": 11111,
"date_voided": null,
"date_canceled": null
}
]
}
GET order_details
Vrací položky účtenek. Jedná se o child kolekci objektu orders.
https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/order_details/list?version_start=0&id_start={id_order_details}
POST warehouse_status
Aktuální stav skladu. Je nutné zaslat JSON request s id_warehouse který určuje ID skladu, pro který chcete report.
curl 'https://m6vadtaz1h.execute-api.eu-west-1.amazonaws.com/prod/data/reports/generic/warehouse_status' \
-H 'Accept: application/json' \
-H 'Authorization: A|....' \
-H 'Content-Type: application/json' \
--data-raw '{"id_warehouse":953221250000000}'
Odpověď
{
"data": [
{
"id_c": 111111,
"id_warehouse": 953221254427235,
"wname": "WAREHOUSE MAIN 21",
"id_product": 5128991459121170,
"pname": "Aperol",
"cname": null,
"id_category": 4933809643652539,
"barcode": null,
"ean13": null,
"unit": 0,
"qty_cnt": 1,
"qty_sum": 3,
"qty_avg": 3,
"date_updated": 1641489385000,
"pp_avg": 10000,
"pp_unit": 10000
},
{
"id_c": 111111,
"id_warehouse": 953221254427235,
"wname": "WAREHOUSE MAIN 21",
"id_product": 4305305643161675,
"pname": "01.Vstup 8225",
"cname": "ACesty",
"id_category": 5723345161520367,
"barcode": null,
"ean13": null,
"unit": 0,
"qty_cnt": 1,
"qty_sum": 6,
"qty_avg": 6,
"date_updated": 1642004221000,
"pp_avg": 100000,
"pp_unit": 100000
}
],
"source": "query"
}
Zasílání objednávek do pokladny
Připravujeme propojení pro zasílání externích objednávek do pokladního systému přes API. Kontaktujre prosím podpora@kasafik.cz pro více informací.
Propojení Foodora **
Propojení WhatsApp
Vyvolávání připravených objednávek pro vytížené provozy
Naše samoobslužné kiosky a pokladny jsou vybaveny funkcí, která zákazníkům umožňuje zaregistrovat své mobilní číslo pro příjem oznámení o stavu objednávky prostřednictvím aplikace WhatsApp. Tato funkce poskytuje rychlé a efektivní upozornění, jakmile je objednávka připravena k vyzvednutí, a zároveň otevírá další komunikační kanál pro marketingové aktivity.
V dnešním rychlém a neustále se měnícím světě je důležité, aby se podniky v oblasti pohostinství a maloobchodu přizpůsobily očekáváním moderních zákazníků, kteří hledají pohodlí, rychlost a efektivitu. Vyvolávání připravených objednávek prostřednictvím automatizovaných systémů je v tomto ohledu revolučním krokem, který posouvá zákaznický servis na novou úroveň.
Pro vytížené provozy, jako jsou restaurace s rychlým občerstvením, kavárny a maloobchody, je klíčové zvládnout špičky návštěvnosti bez zbytečných prodlev a s maximální efektivitou. Vyvolávání objednávek přes moderní komunikační kanály jako WhatsApp umožňuje zákazníkům přijímat real-time aktualizace o stavu jejich objednávky přímo na jejich telefon, což znamená, že mohou svůj čas plánovat efektivněji a bez zbytečného čekání.
Tato služba nejenže zvyšuje spokojenost zákazníků, ale také snižuje fronty a zatížení personálu během rušných období, což vede k hladšímu chodu provozu a umožňuje zaměstnancům soustředit se na další klíčové úkoly. Automatizace tohoto procesu prostřednictvím pokladního systému je intuitivní, snadno integrovatelná a představuje značnou úsporu času a zdrojů.
Předtím, než začnete, ujistěte se, že máte
Účet WhatsApp Business (WABA) potřebuje platné, věnované telefonní číslo podniku.
Požadavky
- Aby bylo telefonní číslo podniku způsobilé pro registraci, musí být: vlastněno vámi
- Mít zeměpisné a oblastní kódy (zkrácené kódy nejsou podporovány)
- Schopné přijímat hlasové hovory nebo SMS (zasíláme vám zprávu k ověření vlastnictví)
- Portfolio podniku, které vlastní účet WhatsApp Business spojený s podnikovým telefonním číslem, dokončilo ověření podniku.
- Stav jména podnikového telefonního čísla je SCHVÁLEN.
- Pokladní systém KASA FIK PREMIUM s podporou integrace pro odesílání zpráv
Registrovaná čísla je možné stále používat pro běžné účely, jako jsou telefonáty a textové zprávy.
Registrace telefonních čísel
Postup také naleznete v origiálním manuálu WhatsApp na stránkách Facebook/Meta.
Pokud jste při dokončování kroků v dokumentu Začínáme nezaregistrovali číslo, vraťte se na nástěnku aplikace, přejděte na panel WhatsApp > API Setup. Posuňte se dolů k Kroku 5: Přidání telefonního čísla, klikněte na tlačítko Add phone number a dokončete proces.
Jako součást procesu registrace vám Meta pošlem hlasovou nebo SMS zprávu obsahující ověřovací kód na vaše telefonní číslo, abychom ověřili, že jste jeho majitelem.
Všimněte si, že můžete také zaregistrovat číslo pomocí správce WhatsApp. Podívejte se na článek v centru nápovědy Jak připojit vaše telefonní číslo k vašemu účtu WhatsApp Business, kde se dozvíte, jak na to.
Integrace WhatsApp API s pokladním systémem
- Použijte poskytnuté API klíče a koncové body od WhatsAppu a zadejte je do odpovídajících polí ve vašem pokladním systému pro nastavení integrace.
Nastavení pravidel pro odesílání zpráv
- V pokladním systému nastavte pravidla pro automatické odesílání zpráv. To může zahrnovat:
- Vyvolání objednávky, když je připravena k vyzvednutí.
- Upozornění na speciální nabídky nebo slevy.
- Připomenutí rezervací nebo objednávek.
- Nastavte šablony zpráv, které budou odesílány zákazníkům. WhatsApp vyžaduje schválení šablon zpráv pro masové rozesílání.
Testování
- Proveďte testovací transakci a ujistěte se, že zpráva je správně odeslána na testovací číslo WhatsApp.
- Zkontrolujte, zda je zpráva dostatečně informativní a zda obsahuje všechny potřebné informace.
Odkazy
Propojení Wolt + Wolt Retail
Úprava nabídky po aktivaci synchronizace s Wolt
Synchronizace s Vzdálenou Správou
Po zapnutí funkce synchronizace ve Vzdálené správě dojde k následujícím změnám:
- Omezení úprav nabídky: Možnost úpravy nabídky v administrativním rozhraní Woltu bude zablokována. Jakékoli menu, které bylo vytvořeno v Woltu před aktivací synchronizace, zůstane dostupné pro zákazníky, ale nebude již možné ho upravovat.
- Vytváření nabídky: Pro další úpravy a správu nabídky je nutné používat Vzdálenou správu systému KASA FIK.
Po Aktivaci Synchronizace
Pokyny pro Odblokování iPadu
- Požádání o odblokování: V případě potřeby můžete kontaktovat Wolt s žádostí o odblokování vašeho iPadu, který byl dříve používán pro správu objednávek.
- Další využití tabletů: Po odblokování můžete tablet využívat pro jiné účely, které nejsou svázány s přijímáním objednávek na Woltu.
Toto jsou kroky a důležité informace týkající se změn ve správě vaší nabídky po aktivaci synchronizace s Backoffice KASA FIK. Pro hladký přechod a efektivní správu vaší nabídky doporučujeme důkladně se seznámit s novým postupem a zajistit, že všechny relevantní osoby ve vašem týmu jsou řádně informovány a vyškoleny.
Propojení Better Hotel
Tento dokument poskytuje podrobný přehled o integraci pokladního systému KASA FIK a samoobslužných kiosků s rezervačním systémem Better Hotel. Tato integrace umožňuje hotelům zefektivnit procesy odbavení hostů, správy rezervací a účtování výdajů, čímž se zvyšuje efektivita provozu a zlepšuje zákaznická zkušenost.
Přehled Integrace
Integrace mezi KASA FIK a Better Hotel přináší následující klíčové funkce:
-
Vyhledání rezervace:
- Hosté mohou snadno vyhledat své rezervace pomocí samoobslužných kiosků nebo pokladny zadáním čísla rezervace nebo jiného identifikátoru (např. jméno hosta, email).
-
Správa karty hostů:
- Personál a hosté mohou přistupovat k informacím o hostech, jako je číslo pokoje, jméno hosta, email nebo telefon, což umožňuje rychlé a přesné poskytování služeb.
-
Účtování konzumace:
- Útraty z restaurace nebo baru mohou být přímo připsány na hotelový účet hosta prostřednictvím pokladního systému KASA FIK, což zjednodušuje proces placení a závěrečné vyúčtování.
-
Self-Checkout:
- Hosté mají možnost provést self-checkout prostřednictvím kiosků, kde mohou zkontrolovat svůj účet, provést platbu a dokončit proces odhlášení bez nutnosti čekání na recepci.
Výhody Integrace
- Zvýšená efektivita: Automatizace procesů sníží zátěž na personál a zrychlí odbavení hostů.
- Zlepšená zákaznická zkušenost: Hosté mají více možností, jak spravovat svůj pobyt, což zvyšuje jejich pohodlí a spokojenost.
- Přesnost a přehlednost: Konzumace a další výdaje jsou automaticky zaznamenány a propojeny s rezervačním systémem, což minimalizuje chyby a zajišťuje přesné účtování.
- Flexibilita: Hosté mohou kdykoliv přistupovat k informacím o svém pobytu a provádět potřebné změny bez nutnosti asistence personálu.
Implementace
- Nakonfigurujte API klíče a přístupové body pro komunikaci mezi KASA FIK a Better Hotel v aplikaci KASA FIK Pokladna - Nastavení - Expertní nastavení - Better Hotel
- Ujistěte se, že jsou správně nastaveny všechny parametry pro vyhledávání rezervací, správy účtů a účtování výdajů
Propojení Aktion.eu - stravovací systém
Tento dokument poskytuje podrobné informace o integraci pokladního systému KASA FIK se stravovacím systémem Aktion. Tato integrace přináší efektivní řešení pro řízení stravování ve firmách, šetří náklady na provoz jídelen a zrychluje proces odbavení strávníků.
Přehled stravovacího systému Aktion
Systém Aktion nabízí komplexní řešení pro objednávání a vyúčtování stravy ve firemních jídelnách. Mezi hlavní funkce patří:
- Rychlé objednání jídel z mobilu, kiosku nebo webové aplikace.
- Platby pomocí RFID karty, mobilu nebo biometrie.
- Export jídelníčku přímo dodavatelům.
- Automatické strhávání částek za odebranou stravu ze mzdy.
- Možnost objednat a převzít jídlo v různých jídelnách v rámci podniku.
- Propojení s nápojovými a jídelními automaty.
Výhody Integrace KASA FIK s Aktion
- Efektivita Provozu: Integrace automatizuje procesy objednávání a vyúčtování, což snižuje administrativní zátěž a zvyšuje efektivitu.
- Zrychlení Odbavení: Díky automatizovanému odbavení a platbám se zrychluje proces výdeje jídel.
- Flexibilita: Uživatelé mohou snadno spravovat objednávky z různých zařízení a místa odběru.
- Přesnost a Transparentnost: Přesné sledování odebrané stravy a její účtování zajišťuje transparentní procesy.
Implementační Kroky
-
Analýza Potřeb:
- Vyhodnocení stávajících procesů a určení požadovaných funkcí integrace.
-
Příprava a Testování:
- Instalace a konfigurace potřebného softwaru a hardwaru.
- Provádění testů propojení a ověření správnosti datové výměny.
-
Konfigurace API:
- Nastavení API klíčů a přístupových bodů pro bezpečnou komunikaci mezi KASA FIK a Aktion.
- Zajištění správného nastavení parametrů pro objednávání a vyúčtování.
-
Školení Personálu:
- Poskytnutí školení pro personál o používání integrovaného systému, včetně nových funkcí a postupů.
-
Zahájení Provozu:
- Po úspěšném testování a školení uvedení systému do ostrého provozu.
- Monitorování činnosti a řešení případných problémů.
Objednávání a Platby
- Objednávání Jídel: Strávníci mohou objednávat jídla z mobilní aplikace, kiosku nebo webové aplikace.
- Platby: Platby jsou možné pomocí RFID karty, mobilu nebo biometrie, což zajišťuje rychlé a bezpečné transakce.
Export a Vyúčtování
- Export Dodavatelům: Objednávky se automaticky exportují dodavatelům, což zjednodušuje logistiku.
- Strhávání ze Mzdy: Odebraná jídla jsou automaticky účtována do mzdového systému, což zajišťuje efektivní vyúčtování.
Propojení s Automaty
- Identifikace a Výdej: Strávníci mohou použít svou přístupovou kartu pro identifikaci a výdej z automatů.
- Úhrada: Úhrady za odebrané položky jsou automaticky odečteny ze mzdy.