Här hittar du en omfattande guide om hur du skapar en Order i Skyplanner med alla relaterade data. En del av detta har täckts i integrationshandledningen, men här går vi igenom Skyplanner-datastrukturen och integrationsprocessen mer detaljerat.
Datastruktur #
Först går vi igenom hur en Skyplanner-Order är strukturerad. API-endpoints för de dataenheter som nämns här är markerade så här: /phaser-Order
På den översta nivån har vi ordern(/phaser-orders)
Varje Order måste ha en kund(/customers).
Varje Order kan ha flera orderobjekt(/phaser-orderobjekt)
Varje orderartikel kan ha en produkt(/products) kopplad till sig, men det är inte obligatoriskt. Varje produkt har ett lager(/saldos). Observera att lagerenheten skapas automatiskt när en produkt skapas med API:et.
Varje orderartikel kan ha flera jobb (även kallade processteg)(/phaser-jobs).
Varje jobb måste ha ett arbetssteg(/workstages).
Arbetsflöde för integration #
Här är ett steg för steg exempel på hur du kan strukturera din integration från ditt ERP-system till Skyplanner.
- Hämta försäljning/arbetsorder från ERP
- Skapa kund (få kund-ID i svaret)
- Skapa Order med kund-ID (få Order-ID i svaret)
- Hämta artikeldata för försäljnings-/arbetsorder från ERP
- Skapa produkt (få produkt-ID i svaret)
- Skapa orderartikel med Order-ID och andra data (få orderartikel-ID i svaret)
- Hämta processtegsdata från ERP
- Skapa workstage (få workstage-id i svaret)
- Skapa jobb med workstage-id och andra data
Extra tips #
Vid borttagning #
Radering av phaser-Order, phaser-Order-items eller phaser-jobs via API:et (och från användargränssnittet) görs på ett mjukt sätt. Det innebär att data inte raderas från databasen, utan markeras som arkiverade. I själva verket sätts attributet is_archive för entiteten till true när den raderas. De arkiverade/raderade entiteterna kan fortfarande nås via API:et med hjälp av parametern include_archived. När include_archived=true kommer en GET-begäran att hämta entiteten även om den är arkiverad.
Observera att mjuk radering inte är tillgänglig i alla API-slutpunkter! Så du måste vara försiktig eftersom radering av t.ex. kunder, personer etc. är permanent!
Använda standardprocessteg för din orderartikel #
Om du har skapat några standardprocessteg för den produkt som ditt orderobjekt producerar kan du be systemet att ta med standardstegen till orderobjektet med API:et med hjälp av attributet get_default_steps.
Lägga till Material till orderartikel #
Om du har bifogat Material till den producerade produkten bifogas det automatiskt till orderraden.
Om du däremot inte vill använda de Material som är kopplade till produkten (t.ex. om det är en specialbeställning och du vill använda andra Material) kan du använda attributet use_custom_materials.
