Tukaj najdete izčrpen vodnik o tem, kako ustvariti naročilo v Skyplannerju z vsemi povezanimi podatki. Nekaj tega je bilo obravnavano v vodniku za integracijo, vendar tukaj podrobneje obravnavamo strukturo podatkov Skyplannerja in postopek integracije.
Struktura podatkov #
Najprej bomo pregledali, kako je strukturirano naročilo Skyplannerja. Točke API za podatkovne entitete, ki so omenjene tukaj, so označene takole: /phaser-orders
Na najvišji ravni imamo naročilo(/phaser-orders)
Vsako naročilo mora imeti stranko(/customers).
Vsako naročilo ima lahko več elementov naročila(/phaser-Order-items)
Vsakemu elementu naročila je lahko priložen izdelek(/products), vendar to ni obvezno. Vsak izdelek ima eno zalogo(/saldos). Upoštevajte, da se entiteta zaloge ustvari samodejno, ko je izdelek ustvarjen z vmesnikom API.
Vsako element naročila ima lahko več opravil (tudi korakov postopka)(/phaser-jobs).
Vsako opravilo mora imeti delovno stopnjo(/workstages).
Delovni tok integracije #
Tukaj je primer, kako lahko po korakih strukturirate integracijo iz sistema ERP v Skyplanner.
- Pridobivanje prodaje/delovnega naloga iz sistema ERP
- Ustvari stranko (v odzivu pridobi id stranke)
- Ustvarite naročilo z id stranke (v odzivu dobite id naročila)
- Pridobivanje podatkov o prodajnih postavkah/delovnih nalogih iz sistema ERP
- Ustvari izdelek (v odzivu pridobi id izdelka)
- Ustvarite element naročila z id naročila in drugimi podatki (v odzivu dobite id elementa naročila)
- Pridobivanje podatkov o korakih procesa iz sistema ERP
- Ustvari delovno stopnjo (v odzivu pridobi id delovne stopnje)
- Ustvarjanje delovnega mesta z id delovnega mesta in drugimi podatki
Dodatni nasveti #
Ob brisanju #
Brisanje phaser-naročil, phaser-naročil-postavk ali phaser-delov prek vmesnika API (in iz uporabniškega vmesnika) poteka na način mehkega brisanja. To pomeni, da se podatki dejansko ne izbrišejo iz podatkovne zbirke, temveč so označeni kot arhivirani. Atribut is_archive entitete je ob izbrisu nastavljen na true. Do arhiviranih/izbrisanih entitet je še vedno mogoče dostopati z vmesnikom API z uporabo parametra include_archived. Če je include_archived=true, bo zahteva GET priklicala entiteto, tudi če je arhivirana.
Upoštevajte, da mehko brisanje ni na voljo v vseh končnih točkah API! Zato morate biti previdni, saj je brisanje na primer strank, oseb itd. trajno!
Uporaba privzetih korakov postopka za element naročila #
Če ste ustvarili nekaj privzetih korakov postopka za izdelek, ki ga izdeluje element naročila, lahko sistemu poveste, naj privzete korake prenese v element naročila z vmesnikom API z uporabo atributa get_default_steps.
Dodajanje materialov v element naročila #
Če ste izdelanemu izdelku priložili materiale, so ti samodejno priloženi vrstici naročila.
Če ne želite uporabiti materialov, ki so priloženi izdelku (na primer, če gre za posebno naročilo in želite uporabiti drugačne materiale itd.), lahko uporabite atribut use_custom_materials.
