Tu nájdete komplexný návod na vytvorenie objednávky do programu Skyplanner so všetkými súvisiacimi údajmi. Niektoré z týchto informácií boli uvedené v návode na integráciu, ale tu si podrobnejšie preberieme štruktúru údajov Skyplanner a proces integrácie.
Štruktúra údajov #
Najprv si prejdeme, ako je štruktúrovaná objednávka Skyplanner. Body API pre uvedené dátové entity sú zvýraznené takto: /phaser-orders
Na najvyššej úrovni máme objednávku(/phaser-orders)
Každá objednávka musí mať zákazníka(/zákazníkov).
Každá objednávka môže mať viacero položiek objednávky(/phaser-Order-items)
Každá položka objednávky môže mať pripojený produkt(/products), ale nie je to povinné. Každý výrobok má jeden sklad(/saldos). Všimnite si, že entita stock (zásoba) sa vytvára automaticky pri vytváraní produktu pomocou API.
Každá položka objednávky môže mať viacero úloh (alias krokov procesu)(/phaser-jobs).
Každá úloha musí mať pracovnú etapu(/workstages).
Pracovný postup integrácie #
Tu je príklad, ako by ste mohli krok za krokom štruktúrovať integráciu vášho systému ERP so Skyplannerom.
- načítanie predaja/objednávky z ERP
- Vytvorenie zákazníka (získanie identifikátora zákazníka v odpovedi)
- Vytvorenie objednávky s identifikátorom zákazníka (získanie identifikátora objednávky v odpovedi)
- načítanie údajov o položkách predajných/pracovných objednávok z ERP
- Vytvoriť produkt (v odpovedi získajte identifikátor produktu)
- Vytvorenie položky objednávky s id objednávky a ďalšími údajmi (získanie id položky objednávky v odpovedi)
- Získavanie údajov o krokoch procesu z ERP
- Vytvorenie pracovnej etapy (získanie ID pracovnej etapy v odpovedi)
- Vytvorenie úlohy s id pracovnej etapy a ďalšími údajmi
Ďalšie tipy #
Pri odstraňovaní #
Odstraňovanie objednávok phaser, položiek objednávok phaser alebo úloh phaser prostredníctvom rozhrania API (a z používateľského rozhrania) sa vykonáva spôsobom soft delete. To znamená, že údaje sa v skutočnosti nevymažú z databázy, ale označia sa ako archivované. V skutočnosti je atribút is_archive entity pri vymazaní nastavený na hodnotu true. K archivovaným/vymazaným entitám je stále možné pristupovať pomocou API pomocou parametra include_archived. Ak je include_archived=true, požiadavka GET načíta entitu, aj keď je archivovaná.
Upozorňujeme, že mäkké mazanie nie je dostupné v každom koncovom bode API! Preto musíte byť opatrní, pretože vymazanie napríklad zákazníkov, ľudí atď. je trvalé!
Použitie predvolených krokov procesu pre vašu položku objednávky #
Ak ste vytvorili niektoré predvolené kroky procesu pre produkt, ktorý vaša položka objednávky vytvára, môžete systému povedať, aby tieto predvolené kroky preniesol do položky objednávky pomocou API pomocou atribútu get_default_steps.
Pridanie materiálov do položky objednávky #
Ak ste k vyrábanému výrobku pripojili materiály, automaticky sa pripoja k riadku objednávky.
Ak však nechcete použiť materiály pripojené k výrobku (napríklad ak ide o špeciálnu objednávku a chcete použiť iné materiály atď.), môžete použiť atribút use_custom_materials.
