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í

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

{
  "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