Siit leiate põhjaliku juhendi, kuidas luua tellimus Skyplannerisse koos kõigi sellega seotud andmetega. Osa sellest on juba käsitletud integratsiooniõpetuses, kuid siin käsitleme Skyplanneri andmestruktuuri ja integratsiooniprotsessi üksikasjalikumalt.
Andmete struktuur #
Kõigepealt vaatame läbi, kuidas Skyplanneri tellimus on üles ehitatud. Siin mainitud andmeüksuste API-punktid on esile toodud järgmiselt: /phaser-orders
Ülemisel tasandil on meil tellimus(/phaser-orders)
Igal tellimusel peab olema klient(/kliendid).
Igal tellimusel võib olla mitu tellimusartiklit(/phaser-order-rows).
Iga tellimuse kirje võib olla seotud tootega(/products), kuid see ei ole kohustuslik. Igal tootel on üks varu(/saldos). Pange tähele, et varuüksus luuakse automaatselt, kui toode luuakse API abil.
Igal tellimusartiklil võib olla mitu tööd (ehk protsessietappi)(/phaser-jobs).
Igal tööülesandel peab olema tööetapp(/tööetapid).
Integratsiooni tööprotsess #
Siin on samm-sammult näide, kuidas te võiksite oma ERP-süsteemi ja Skyplanneri integreerimist struktureerida.
- Müügi/töötellimuse toomine ERP-st
- Loo klient (saada kliendi id vastuseks)
- Loo tellimus kliendi id-ga (saada vastuseks tellimuse id)
- Müügi/töötellimuse kirje andmete hankimine ERP-st
- Loo toode (saada vastuseks toote id)
- Tellimuse kirje loomine tellimuse id ja muude andmetega (saada vastuseks tellimuse kirje id)
- Protsessi etappide andmete hankimine ERP-st
- Loo tööetapp (saada tööetapi id vastuseks)
- Töö loomine koos tööetapi id ja muude andmetega
Lisanipid #
Kustutamisel #
Phaser-tellimuste, phaser-order-items või phaser-jobs kustutamine API kaudu (ja kasutajaliidesest) toimub pehme kustutamise teel. See tähendab, et andmeid tegelikult andmebaasist ei kustutata, kuid need märgitakse arhiveerituks. Tegelikkuses seatakse kustutamisel olio atribuut is_archive väärtuseks true. Arhiveeritud/kustutatud üksustele saab API abil endiselt juurde pääseda, kasutades parameetrit include_archived. Kui include_archived=true, saab GET päringuga üksuse kätte isegi siis, kui see on arhiveeritud.
Pange tähele, et pehme kustutamine ei ole igas API lõpp-punktis saadaval! Seega tuleb olla ettevaatlik, sest näiteks klientide, inimeste jne. kustutamine on püsiv!
Kasutades vaikimisi protsessietappe teie tellimuse kirje jaoks #
Kui olete loonud mõned vaikimisi protsessietapid toote jaoks, mida teie tellimusartikkel toodab, saate süsteemile öelda, et ta tooks vaikimisi parameetri API abil tellimusartiklile, kasutades atribuuti get_default_steps (vaikimisi_etapid ).
Materjalide lisamine tellimusartiklile #
Kui olete tootele lisanud materjale, lisatakse need automaatselt tellimuse reale.
Kui te aga ei soovi kasutada tootele lisatud materjale (näiteks kui toode on eritellimus ja te soovite kasutada teistsuguseid materjale jne), võite kasutada atribuuti use_custom_materials.
