V případě, že je v nastavení firmy povolené generování požadavků na výdej, tak lze pomocí REST API volat službu Aktualizace skladových požadavků na výdej.
Nevíte, co je požadavek na výdej? Nahlédněte do naší dokumentace.
Způsob volání
Lze využít HTTP metodu:
PUT nebo POST
Služba je dostupná na adrese:
/c/{firma}/sklad/aktualizace-pozadavku
kde {firma} je databázový idenfitikátor firmy.
Jsou podporovány výstupní formáty:
XML nebo JSON
Parametry
Služba umožňuje použít parametr dry-run. Pomocí tohoto parametru lze zjistit, zda byl přepočet dokončen. Pokud ano, vrátí HTTP status 200. Pokud ne, vrátí HTTP status 409 s informací o tom, kdy a kým byl přepočet spuštěn.
Výsledek
Pro rozpoznání, zda byla služba vykonána úspěšně, lze kontrolovat HTTP status odpovědi nebo vlastnost success v získaném dokumentu.
Úspěšné volání
V případě úspěšného vykonání služby je vracen HTTP status 200 a dokument odpovídající 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úspěšné volání
HTTP status odpovědi je 4xx nebo 5xx. A například v případě, že firma nemá povolené generování požadavků na výdej, získáme 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ázky volání
PUT /c/demo/sklad/aktualizace-pozadavku.xmlPUT /c/demo/sklad/aktualizace-pozadavku.jsonPUT /c/demo/sklad/aktualizace-pozadavku(s hlavičkouAccept: application/xmlneboAccept: application/json)POST /c/demo/sklad/aktualizace-pozadavku.xmlPOST /c/demo/sklad/aktualizace-pozadavku.jsonPOST /c/demo/sklad/aktualizace-pozadavku(s hlavičkouAccept: application/xmlneboAccept: application/json)