Jak načíst 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.

Import objednávek vyžaduje aplikaci 1.122 nebo novější a licenci KLASIK nebo PLUS.

Nastavení

  1. V Nastavení – Expert nastavení – Importní URL pro objednávky zadejte URL adresu k Vašemu rozhraní na serveru
  2. Daná URL adresa musí vrátit platný dokument JSON ve formátu popsaném níže
  3. Adresa je například: https://www.mujserver.cz/hledat.php
  4. 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í

  1. V aplikaci, v rozhraní KLASIK
  2. Vlevo nahoře klepněte na šipku menu
  3. Zvolte „Vyhledat položky z objednávky“
  4. Zadejte číslo objednávky, které se použije k vyhledání dané objednáky na serveru
  5. 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, pokud je objednávka nalezen

{
„invoice_number“: 20130001,
„note“: „strestt“,
„items“: [
{
„plu“: „203“,
„name“: „Item number 203“,
„price_without_vat“: 112,
„quantity“: 1.0,
„vat_rate“: 1.21
}
]
}

Formát JSON prázdné odpovědi pokud server nic nenalezl

{}

Zpět nahoru