Pokud je v nastavení firmy povolené generování požadavků na výdej, 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 článku Aktualizace požadavků na výdej.
Způsob volání
Služba je dostupná metodami PUT a POST na adrese /c/{firma}/sklad/aktualizace-pozadavku, kde {firma} je databázový identifikátor firmy. Podporovanými výstupními formáty jsou XML a JSON.
Parametry
Služba nemá žádné povinné parametry. Volitelně umožňuje použít parametr dry-run, kterým 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 version="1.0"?>
<winstrom version="1.0">
<success>true</success>
</winstrom>
{
"winstrom": {
"@version": "1.0",
"success": "true"
}
}
Neúspěšné volání
HTTP status odpovědi je 4xx nebo 5xx. Například pokud firma nemá povolené generování požadavků na výdej, získáme tento dokument:
<?xml version="1.0"?>
<winstrom version="1.0">
<success>false</success>
<message>Není povoleno generování požadavků na výdej.</message>
</winstrom>
{
"winstrom": {
"@version": "1.0",
"success": "false",
"message": "Není povoleno generování požadavků na výdej."
}
}
Ukázky volání
PUT https://demo.flexibee.eu/c/demo/sklad/aktualizace-pozadavku.xml
PUT https://demo.flexibee.eu/c/demo/sklad/aktualizace-pozadavku.json
POST https://demo.flexibee.eu/c/demo/sklad/aktualizace-pozadavku.xml
POST https://demo.flexibee.eu/c/demo/sklad/aktualizace-pozadavku.json
Volat lze i bez přípony — PUT https://demo.flexibee.eu/c/demo/sklad/aktualizace-pozadavku — pak se formát určí hlavičkou Accept: application/xml, případně Accept: application/json.