Skip to main content

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