Cez REST API možno realizovať objednávku nasledovne:
vydaná faktúra (
faktura-vydana)prijatá faktúra (
faktura-prijata)skladový pohyb (
skladovy-pohyb)predajka (
prodejka)
Možno určiť typ dokladu (typDokl) a sklad (sklad). Ak nie sú uvedené, použije sa predvolený typ dokladu z objednávky. Dátum sa vždy použije aktuálny podľa aktuálneho účtovného obdobia, zatiaľ nie je možné dátum vystavenia inak určiť.
Ďalej je možné nastaviť v prípade realizácie faktúrou typDoklSkl, napríklad code:VYDEJPOOBP. Využitie je v prípade, že typDokl vytváranej faktúry nemá uvedený typ skladového dokladu.
Realizácia objednávky do už existujúcej faktúry je možná len za predpokladu, že faktúra je neodomknutá, položková, nie je stornovaná, nie je uhradená alebo nie je odoslaná do EET.
Môžete tiež určiť, či sa majú pri nedostatku tovaru generovať požiadavky na výdaj (true).
Parameter <zahrnoutSkladoveDoklady>true</zahrnoutSkladoveDoklady> zabezpečí, že sa do faktúry zahrnia aj nevyfakturované navázané skladové doklady. Tovar z týchto sklad. dokladov sa už neuvádza v zozname <polozkyObchDokladu>.
Objednávku možno realizovať viackrát (napr. podľa dostupnosti tovaru). Informácie o stave realizácie je možné získať z položiek objednávky.
Realizácia objednávky bola navrhnutá predovšetkým pre čítačky čiarového kódu. Preto je jedno, či je zadané výrobné číslo alebo tovar (iba EAN). EAN sa uvádza buď priamo, alebo s prefixom ean:. Odporúčame používať tento prefix pri zadaní EANu.
Vytváranému dokladu je možné priradiť externý identifikátor, pomocou ktorého ho možno ešte v priebehu toho istého importu upravovať. V prípade realizácie do faktúry vydanej / prijatej je možné uviesť už existujúci doklad, ku ktorému budú pridané novo realizované položky. Pre ostatné typy realizácií dochádza vždy k vytvoreniu nového dokladu a uvedenie existujúceho dokladu spôsobí chybu importu.
Príklady XML
Základná podoba
<?xml version="1.0"?>
<winstrom version="1.0">
<objednavka-prijata>
<id>code:OBP0004/2012</id>
<realizaceObj type="faktura-vydana">
<polozkyObchDokladu>
<polozka>
<cenikNeboVyrobniCislo>123skl</cenikNeboVyrobniCislo>
<mj>1</mj>
</polozka>
</polozkyObchDokladu>
</realizaceObj>
</objednavka-prijata>
</winstrom>
Realizácia podľa identifikácie riadku v objednávke (stačí iba jeden identifikátor). Pri realizácii objednávky možno použiť aj poradie položky:
<?xml version="1.0"?>
<winstrom version="1.0">
<objednavka-prijata>
<id>code:OBP0004/2012</id>
<realizaceObj type="faktura-vydana">
<polozkyObchDokladu>
<polozka>
<!-- číslo řádky v objednávce -->
<cisRad>1</cisRad>
<!-- další možnost identifikace, lze použít libovolný identifikátor -->
<id>extId...</id>
<mj>1</mj>
</polozka>
</polozkyObchDokladu>
</realizaceObj>
</objednavka-prijata>
</winstrom>
Realizácia objednávky so šaržou a expiráciou
<?xml version="1.0"?>
<winstrom version="1.0">
<objednavka-prijata>
<id>code:OBP0004/2012</id>
<realizaceObj type="faktura-vydana">
<polozkyObchDokladu>
<polozka>
<cisRad>1</cisRad>
<!-- lze uvést pouze jeden z údajů (v závislosti nastavení ceníkové položky), je nutno vybírat ze šarží či expirací, co jsou právě na skladě -->
<sarze>XY12345</sarze>
<expirace>2021-12-31</expirace>
<mj>1</mj>
</polozka>
</polozkyObchDokladu>
</realizaceObj>
</objednavka-prijata>
</winstrom>
Príklad kompletnej štruktúry XML
<?xml version="1.0"?>
<winstrom version="1.0">
<objednavka-prijata>
<id>code:OBP0004/2012</id>
<!-- faktura-vydana/prodejka/faktura-prijata/skladovy-pohyb-->
<realizaceObj type="faktura-vydana">
<!-- lze použít libovolný identifikátor-->
<id>ext:...</id>
<typDokl>...</typDokl>
<sklad>...</sklad>
<varSym>...</varSym>
<!-- nepovinné -->
<generovatPozadavky>true</generovatPozadavky>
<!-- u vydané faktury říká zda se mají odpočítat navázané zálohy -->
<zahrnoutSkladoveDoklady>true</zahrnoutSkladoveDoklady>
<!-- u faktury říká zda se mají zahrnout i nevyfakturované navázané skladové doklady -->
<odpocetZaloh>true</odpocetZaloh>
<!-- u přijaté faktury povinné -->
<cisDosle>...</cisDosle>
<!-- u přijaté faktury povinné -->
<datSplat>2013-01-01</datSplat>
<polozkyObchDokladu>
<polozka>
<!-- následují tři způsoby identifikace položky -->
<!-- <id>extId...</id> -->
<!-- <cisRad>1</cisRad> -->
<!-- EAN ceníku nebo výrobní číslo -->
<cenikNeboVyrobniCislo>123skl</cenikNeboVyrobniCislo>
<!-- pokud se najde podle EAN nebo výrobního čísla z předcházející řádky, je to vždy 1; nemusí se uvádět, pokud je uveden seznam výrobních čísel -->
<mj>1</mj>
<vyrobniCisla>
<!-- použito pokud se nenajde podle výrobního čisla - tj. u přijatých faktur je nutné zadat výrobní čísla vždy pokud jsou vyžadovány -->
<vyrobniCislo>123</vyrobniCislo>
<vyrobniCislo>456</vyrobniCislo>
</vyrobniCisla>
<!-- lze uvést pouze jeden z údajů (v závislosti nastavení ceníkové položky), je nutno vybírat ze šarží či expirací, co jsou právě na skladě -->
<sarze>XY12345</sarze>
<expirace>2021-12-31</expirace>
</polozka>
</polozkyObchDokladu>
</realizaceObj>
</objednavka-prijata>
</winstrom>
Realizácia objednávky s položkami s balením
Príklad nastavenia balenia pri cenníkovej položke (predvolená MJ = kus, balenie = 100 ks)
Príklad podoby položky prijatej objednávky
Príklad XML realizácie objednávky
<?xml version="1.0"?>
<winstrom version="1.0">
<objednavka-prijata>
<id>code:OBP0004/2021</id>
<realizaceObj type="skladovy-pohyb">
<polozkyObchDokladu>
<polozka>
<cisRad>1</cisRad>
<mj>300</mj>
</polozka>
</polozkyObchDokladu>
</realizaceObj>
</objednavka-prijata>
</winstrom>
Ukážka použitia JSON
{ "flexibee": { "objednavka-prijata": { "id": "code:OBP0004\/2012", "realizaceObj@type": "faktura-vydana", "realizaceObj": { "typDokl": "code:FAKTURA",
"varSym": "12345",
"polozkyObchDokladu": [
{
"cisRad": 1,
"mj": "1",
"vyrobniCisla": [
123,
456
]
}
]
}
}
}
}
Tvorba zálohy
Z prijatej objednávky možno vytvoriť aj vydanú zálohu. Podobne ako v aplikácii môžete priamo určiť výšku zálohy, ktorá nemusí zodpovedať plnej cene objednávky.
Výsledný request môže vyzerať napríklad takto:
<?xml version="1.0"?>
<winstrom version="1.0">
<objednavka-prijata>
<id>code:OBP0004/2012</id>
<tvorbaZalohy>
<id>ext:...</id>
<!-- lze použít libovolný identifikátor -->
<typDokl>...</typDokl>
<!-- částka vytvářené zálohy -->
<castka>...</castka>
<!-- alternativní zadání částky zálohy zadáním procent z celkové částky objednávky -->
<procent>...</procent>
</tvorbaZalohy>
</objednavka-prijata>
</winstrom>
Realizácia objednávky v rámci tvorby faktúry
V rámci jedného API požiadavku možno vytvoriť faktúru a zároveň do tejto faktúry realizovať existujúcu objednávku s využitím tmp identifikátora <id>tmp:FAV123</id>
Príklad:
<?xml version="1.0" encoding="utf-8"?>
<winstrom version="1.0">
<faktura-vydana>
<id>tmp:FAV123</id>
<typDokl>code:FAKTURA</typDokl>
<firma>code:ČOKOLÁDA</firma>
<datVyst>2026-01-08</datVyst>
</faktura-vydana>
<objednavka-prijata>
<id>56</id>
<realizaceObj type="faktura-vydana">
<id>tmp:FAV123</id>
<typDokl>code:FAKTURA</typDokl>
<polozkyObchDokladu>
<polozka>
<cisRad>1</cisRad>
<mj>1</mj>
</polozka>
</polozkyObchDokladu>
</realizaceObj>
</objednavka-prijata>
</winstrom>