V prípade, že je v nastavení firmy povolené generovanie požiadaviek na výdaj, tak možno pomocou REST API volať službu Aktualizácia skladových požiadaviek na výdaj.
Neviete, čo je požiadavka na výdaj? Pozrite si našu dokumentáciu.
Spôsob volania
Možno využiť HTTP metódu:
PUT alebo POST
Služba je dostupná na adrese:
/c/{firma}/sklad/aktualizace-pozadavku
kde {firma} je databázový identifikátor firmy.
Sú podporované výstupné formáty:
XML alebo JSON
Parametre
Služba umožňuje použiť parameter dry-run. Pomocou tohto parametra možno zistiť, či bol prepočet dokončený. Ak áno, vráti HTTP status 200. Ak nie, vráti HTTP status 409 s informáciou o tom, kedy a kým bol prepočet spustený.
Výsledok
Na rozpoznanie, či bola služba vykonaná úspešne, možno kontrolovať HTTP status odpovede alebo vlastnosť success v získanom dokumente.
Úspešné volanie
V prípade úspešného vykonania služby je vrátený HTTP status 200 a dokument zodpovedajúci požadovanému formátu:
XML
<?xml version="1.0"?><winstrom version="1.0"> <success>true</success></winstrom>
JSON
{ "winstrom": { "@version": "1.0", "success": "true" }}
Neúspešné volanie
HTTP status odpovede je 4xx alebo 5xx. A napríklad v prípade, že firma nemá povolené generovanie požiadaviek na výdaj, získame výsledný dokument:
XML
<?xml version="1.0"?><winstrom version="1.0"> <success>false</success> <message>Není povoleno generování požadavků na výdej.</message></winstrom>
JSON
{ "winstrom": { "@version": "1.0", "success": "false", "message": "Nen\u00ed povoleno generov\u00e1n\u00ed po\u017eadavk\u016f na v\u00fddej." }}
Ukážky volania
PUT /c/demo/sklad/aktualizace-pozadavku.xmlPUT /c/demo/sklad/aktualizace-pozadavku.jsonPUT /c/demo/sklad/aktualizace-pozadavku(s hlavičkouAccept: application/xmlaleboAccept: application/json)POST /c/demo/sklad/aktualizace-pozadavku.xmlPOST /c/demo/sklad/aktualizace-pozadavku.jsonPOST /c/demo/sklad/aktualizace-pozadavku(s hlavičkouAccept: application/xmlaleboAccept: application/json)
