# 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.

<p class="callout danger">Funkce bude ukončena na nahrazena Online API pro zasíláni a dotazy na objednávky pomocí API</p>

### 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

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

```JSON
null
```