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

    {}

    in Pokročilá údržba