Preskoči na glavno vsebino

Prepočet percent realizovateľnosti cez REST API

Ako prepočítať % realizovateľnosti objednávky prijatej cez API

Avtor: Petr Pech

Rovnako ako v desktopovej alebo webovej aplikácii je možné využiť funkciu Prepočítať percentá realizovateľnosti prijatej objednávky. Táto funkcia slúži na aktualizáciu stĺpca „% realizovateľnosti" v závislosti od ceny objednanej položky a stavu skladu. Tento stĺpec vám hovorí, z kolkých percent ste schopní momentálne objednávku uspokojiť.

Pri položke so 100% zľavou sa % realizovateľnosti nevypočíta. Tento údaj pracuje nie s množstvom, ale s cenou položky.

Pozn.: V súčasnosti je možné toto obísť tak, že objednávku uložíte s cenou za MJ, vypočítate % realizovateľnosti, vrátite sa do objednávky a cenu za MJ zmeníte na 0. Po prepočítaní % realizovateľnosti zostane aj pri objednávke s nulovou cenou správne %.

Táto funkcia je využiteľná iba pre evidenciu prijatých objednávok.

Spôsob volania

Možno využiť HTTP metódu: PUT alebo POST, podporované výstupné formáty sú XML alebo JSON.

Endpoint pre volanie služby obsahuje evidenciu prijatej objednávky a názov služby prepocitat-realizovatelnost:

https://localhost:5434/c/{ID frimy}/objednavka-prijata/prepocitat-realizovatelnost.xml (.json).

URL 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ý.

Príklady použitia

1. volanie v XML

POST https://localhost:5434/c/firma_s_r_o_/objednavka-prijata/prepocitat-realizovatelnost.xml

2. volanie v JSON vrátane testovacieho režimu dry-run:

PUT https://localhost:5434/c/firma_s_r_o_/objednavka-prijata/prepocitat-realizovatelnost.json?dry-run=true

Neúspešné requesty

1. V prípade, že prebieha iný prepočet, spustený napríklad používateľom v aplikácii

"message": "Aktuálně běžící operace 'Přepočítat procenta realizovatelnosti' špuštěná uživatelem dba v 16.10.2022, 18:21:59 nedovoluje současně spustit 'Přepočítat procenta realizovatelnosti'."

FAQ

Ako sa percento vypočíta?

Percento sa stanovuje ako pomer objednaného množstva voči stavu skladu. Inými slovami, koľko percent objednávky je možné uspokojiť podľa dostupnej zásoby.

Je možné vypočítať % realizovateľnosti pre vybranú/vybrané objednávky?

Táto možnosť neexistuje. Služba vždy vypočítava percento realizovateľnosti pri všetkých nedokončených objednávkach.

Ako zistiť aktuálne % realizovateľnosti?

Zmenu % realizovateľnosti možno zistiť pomocou web hooku. Prípadne aktuálnu hodnotu možno vyčítať z vlastnosti procReal na prijatej objednávke.

Potrebujete poradiť?

V prípade otázok k aplikácii nás kontaktujte na podporaflexi@abra.eu, prípadne prostredníctvom okna chatu v pravom dolnom rohu.

Ste s tem dobili odgovor na svoje vprašanje?