Šeit atradīsiet visaptverošu ceļvedi par to, kā izveidot pasūtījumu programmā Skyplanner, norādot visus saistītos datus. Daļa no tā jau ir aplūkota integrācijas pamācībā, bet šeit mēs detalizētāk aplūkosim Skyplanner datu struktūru un integrācijas procesu.
Datu struktūra #
Vispirms apskatīsim, kā ir strukturēts Skyplanner pasūtījums. Šeit minēto datu vienību API galapunkti ir izcelti šādi: /phaser-orders
Augšējā līmenī ir pasūtījums(/phaser-orders).
Katram pasūtījumam ir jābūt klientam(/klientiem).
Katram pasūtījumam var būt vairāki pasūtījuma posteņi(/phaser-Order-items).
Katram pasūtījuma postenim var būt pievienots produkts(/produkti), taču tas nav obligāti. Katram produktam ir viens krājums(/saldos). Ņemiet vērā, ka krājuma vienība tiek izveidota automātiski, kad produkts tiek izveidots, izmantojot API.
Katram pasūtījuma postenim var būt vairāki uzdevumi (jeb procesa posmi)(/phaser-jobs).
Katram darbam ir jābūt darba posmam(/workstages).
Integrācijas darbplūsma #
Šeit ir soli pa solim sniegts piemērs tam, kā jūs varētu strukturēt integrāciju no jūsu ERP sistēmas uz Skyplanner.
- Pārdošanas/darba pasūtījuma iegūšana no ERP
- Izveidot klientu (atbildē iegūstiet klienta id)
- Izveidot pasūtījumu ar klienta id (atbildē iegūstiet pasūtījuma id)
- Pārdošanas/darba pasūtījuma posteņu datu iegūšana no ERP
- Izveidot produktu (atbildē iegūstiet produkta id)
- Izveidot pasūtījuma vienumu ar pasūtījuma id un citiem datiem (atbildē iegūstiet pasūtījuma vienības id).
- Procesa soļa datu iegūšana no ERP
- Izveidot darba posmu (atbildē iegūstiet darba posma id)
- Darba uzdevuma izveide, izmantojot darba posma id un citus datus
Papildu padomi #
Par dzēšanu #
Fāzera pasūtījumu, fāzera pasūtījumu elementu vai fāzera darbu dzēšana, izmantojot API (un no lietotāja interfeisa), tiek veikta mīksta dzēšanas veidā. Tas nozīmē, ka dati faktiski netiek dzēsti no datubāzes, bet tiek atzīmēti kā arhivēti. Faktiski, kad tiek dzēsta vienība, tās atribūtam is_archive tiek iestatīta vērtība true. Arhivētajām/izdzēstajām vienībām joprojām var piekļūt ar API, izmantojot parametru include_archived. Ja include_archived=true, GET pieprasījums iegūs vienību pat tad, ja tā ir arhivēta.
Ņemiet vērā, ka mīksta dzēšana nav pieejama visos API galapunktos! Tāpēc jums jābūt uzmanīgiem, jo, piemēram, klientu, cilvēku utt. dzēšana ir neatgriezeniska!
Izmantojot noklusējuma procesa soļus jūsu pasūtījuma vienumam #
Ja esat izveidojis dažus noklusējuma procesa soļus produktam, kuru ražo jūsu pasūtījuma vienība, varat pateikt sistēmai, lai tā šos noklusējuma soļus pārnes uz pasūtījuma vienību, izmantojot API, izmantojot get_default_steps atribūtu.
Materiālu pievienošana pasūtījuma vienumam #
Ja izgatavotajam produktam ir pievienoti materiāli, tie automātiski tiek pievienoti pasūtījuma rindai.
Tomēr, ja nevēlaties izmantot izstrādājumam pievienotos materiālus (piemēram, ja izstrādājums ir īpašs pasūtījums un vēlaties izmantot citus materiālus u. c.), varat izmantot atribūtu use_custom_materials.
