Her kan du finde en omfattende vejledning i, hvordan du opretter en ordre i Skyplanner med alle relaterede data. Noget af dette er blevet dækket i integrationsvejledningen, men her gennemgår vi Skyplanner-datastrukturen og integrationsprocessen mere detaljeret.
Datastruktur #
Først gennemgår vi, hvordan en Skyplanner-ordre er struktureret. API-endepunkterne for de dataenheder, der er nævnt her, er fremhævet på denne måde: /phaser-ordrer
På øverste niveau har vi ordren(/phaser-orders)
Hver ordre skal have en kunde(/customers).
Hver ordre kan have flere ordreelementer(/phaser-order-rows)
Hver ordrevare kan have et produkt(/products) knyttet til sig, men det er ikke obligatorisk. Hvert produkt har et lager(/saldos). Bemærk, at lagerenheden oprettes automatisk, når et produkt oprettes med API’en.
Hver ordrevare kan have flere jobs (også kaldet procestrin)(/phaser-jobs).
Hvert job skal have en arbejdsfase(/workstages).
Arbejdsgang for integration #
Her er et trinvist eksempel på, hvordan du kan strukturere din integration fra dit ERP-system til Skyplanner.
- Hent salg/arbejdsordre fra ERP
- Opret kunde (få kunde-id som svar)
- Opret ordre med kunde-id (få ordre-id som svar)
- Hent salgs-/arbejdsordrevaredata fra ERP
- Opret produkt (få produkt-id som svar)
- Opret ordrevare med ordre-id og andre data (få ordrevare-id som svar)
- Hent data om procestrin fra ERP
- Opret workstage (få workstage-id i svaret)
- Opret job med workstage-id og andre data
Ekstra tips #
Ved sletning #
Sletning af phaser-ordrer, phaser-order-items eller phaser-jobs via API’en (og fra brugergrænsefladen) sker på en soft delete -måde. Det betyder, at dataene faktisk ikke slettes fra databasen, men at de markeres som arkiverede. I praksis sættes entitetens is_archive-attribut til true, når den slettes. De arkiverede/slettede enheder kan stadig tilgås med API’en ved hjælp af parameteren include_archived. Når include_archived=true, vil en GET-request hente entiteten, selv om den er arkiveret.
Bemærk, at blød sletning ikke er tilgængelig i alle API-slutpunkter! Så du skal være forsigtig, da sletning af f.eks. kunder, personer osv. er permanent!
Brug af standardprocessens trin for din ordrevare #
Hvis du har oprettet nogle standardprocesskridt for det produkt, din ordrevare producerer, kan du fortælle systemet, at det skal bringe standardskridtene til ordrevaren med API’en ved hjælp af attributten get_default_steps.
Tilføjelse af materialer til bestillingsvare #
Hvis du har knyttet materialer til det producerede produkt, bliver de automatisk knyttet til ordrelinjen.
Men hvis du ikke ønsker at bruge de materialer, der er knyttet til produktet (f.eks. hvis varen er en specialordre, og du ønsker at bruge andre materialer), kan du bruge attributten use_custom_materials.
