Čia rasite išsamų vadovą, kaip sukurti užsakymą “Skyplanner” su visais susijusiais duomenimis. Kai kurie iš šių dalykų buvo aptarti integracijos vadovėlyje, tačiau čia išsamiau apžvelgsime “Skyplanner” duomenų struktūrą ir integracijos procesą.
Duomenų struktūra #
Pirmiausia apžvelgsime, kaip sudarytas “Skyplanner” užsakymas. Čia paminėtų duomenų esybių API taškai pažymėti taip: /phaser-order
Viršutiniame lygyje turime užsakymą(/phaser-orders)
Kiekvienas užsakymas turi turėti klientą(/customers).
Kiekvienas užsakymas gali turėti kelis užsakymo elementus(/phaser-order-rows)
Prie kiekvieno užsakymo elemento gali būti prijungtas produktas(/products), tačiau tai nėra privaloma. Kiekvienas produktas turi vieną atsargą(/saldos). Atkreipkite dėmesį, kad atsargų esybė sukuriama automatiškai, kai produktas sukuriamas naudojant API.
Kiekvienas užsakymo elementas gali turėti keletą užduočių (dar vadinamų proceso etapais)(/phaser-jobs).
Kiekvienas darbas turi turėti darbo etapą(/workstages).
Integracijos darbo eiga #
Čia pateikiamas žingsnis po žingsnio pavyzdys, kaip galėtumėte struktūrizuoti savo ERP sistemos integraciją su “Skyplanner”.
- Pardavimų ir (arba) darbo užsakymų gavimas iš ERP
- Sukurti klientą (atsakyme gaukite kliento ID)
- Sukurti užsakymą su kliento ID (atsakyme gaukite užsakymo ID)
- Pardavimo ir (arba) darbo užsakymo užsakymo elementų duomenų gavimas iš ERP
- Sukurti gaminį (atsakyme gaukite gaminio ID)
- Sukurti užsakymo elementą su užsakymo ID ir kitais duomenimis (atsakyme gauti užsakymo elemento ID)
- Proceso etapo duomenų gavimas iš ERP
- Sukurti darbo etapą (atsakyme gaukite darbo etapo ID)
- Sukurti užduotį su darbo etapo id ir kitais duomenimis
Papildomi patarimai #
Dėl ištrynimo #
Fazerio užsakymų, fazerio užsakymų elementų arba fazerio darbų šalinimas per API (ir iš vartotojo sąsajos) atliekamas švelniuoju šalinimo būdu. Tai reiškia, kad duomenys iš duomenų bazės iš tikrųjų nėra ištrinami, bet pažymimi kaip archyvuoti. Iš tikrųjų, kai esybė ištrinama, jos atributas is_archive nustatomas į true. Suarchyvuotas / ištrintas esybes vis tiek galima pasiekti per API naudojant parametrą include_archived. Kai include_archived=true, GET užklausa bus gauta esybė, net jei ji yra archyvuota.
Atkreipkite dėmesį, kad švelnus šalinimas galimas ne kiekviename API galiniame taške! Todėl turite būti atsargūs, nes, pavyzdžiui, klientų, žmonių ir pan. ištrynimas yra nuolatinis!
Numatytųjų proceso žingsnių naudojimas jūsų užsakymo elementui #
Jei esate sukūrę tam tikrus numatytuosius užsakymo elemento gaminio proceso žingsnius, galite nurodyti sistemai, kad ji perkeltų numatytuosius žingsnius į užsakymo elementą, naudodama API atributą get_default_steps.
Medžiagų pridėjimas prie užsakymo elemento #
Jei prie pagaminto gaminio pridėjote medžiagų, jos automatiškai pridedamos prie užsakymo eilutės.
Tačiau jei nenorite naudoti prie gaminio pridėtų medžiagų (pavyzdžiui, jei gaminys yra specialus užsakymas ir norite naudoti kitokias medžiagas ir t. t.), galite naudoti atributą use_custom_materials.
