Her finner du en omfattende veiledning om hvordan du oppretter en ordre i Skyplanner med alle relaterte data. Noe av dette er dekket i integrasjonsveiledningen, men her går vi gjennom Skyplanner-datastrukturen og integrasjonsprosessen i mer detalj.
Datastruktur #
Først går vi gjennom hvordan en Skyplanner-ordre er strukturert. API-endepunktene for dataenhetene som er nevnt her, er uthevet slik: /phaser-ordrer
På øverste nivå har vi bestillingen(/phaser-orders)
Hver bestilling må ha en kunde(/kunder).
Hver bestilling kan ha flere bestillingselementer(/phaser-Order-items)
Hver ordrevare kan ha et produkt(/products) knyttet til seg, men det er ikke obligatorisk. Hvert produkt har ett lager(/saldos). Merk at lagerenheten opprettes automatisk når et produkt opprettes med API-et.
Hver ordrevare kan ha flere jobber (også kalt prosesstrinn)(/phaser-jobs).
Hver jobb må ha et arbeidsstadium(/workstages).
Arbeidsflyt for integrering #
Her er et trinnvis eksempel på hvordan du kan strukturere integrasjonen fra ERP-systemet ditt til Skyplanner.
- Hent salg/arbeidsordre fra ERP
- Opprett kunde (få kunde-ID i svaret)
- Opprett ordre med kunde-ID (få ordre-ID i svaret)
- Hente salgs-/arbeidsordredata fra ERP
- Opprett produkt (få produkt-ID som svar)
- Opprett ordrevare med ordre-ID og andre data (få ordrevare-ID i svaret)
- Hent prosesstrinndata fra ERP
- Opprett workstage (få workstage-id i svaret)
- Opprett jobb med workstage-id og andre data
Ekstra tips #
Ved sletting #
Sletting av phaser-ordrer, phaser-Order-elementer eller phaser-jobber via API-et (og fra brukergrensesnittet) gjøres på en myk slettingsmåte. Det betyr at dataene faktisk ikke slettes fra databasen, men at de markeres som arkivert. I praksis blir is_archive-attributtet til entiteten satt til true når den slettes. De arkiverte/slettede entitetene kan fremdeles nås via API-et ved hjelp av parameteren include_archived. Når include_archived=true, vil en GET-forespørsel hente entiteten selv om den er arkivert.
Merk at myk sletting ikke er tilgjengelig i alle API-endepunkter! Du må derfor være forsiktig, ettersom sletting av for eksempel kunder, personer osv. er permanent!
Bruke standard prosesstrinn for bestillingselementet ditt #
Hvis du har opprettet noen standard prosesstrinn for produktet som bestillingselementet produserer, kan du be systemet om å hente standardinnstillingene til bestillingselementet ved hjelp av API-et ved hjelp av attributtet get_default_steps.
Legge til materialer til bestillingsvare #
Hvis du har knyttet materialer til det produserte produktet, blir de automatisk knyttet til bestillingsraden.
Hvis du imidlertid ikke ønsker å bruke materialene som er knyttet til produktet (for eksempel hvis varen er en spesialbestilling og du ønsker å bruke andre materialer), kan du bruke attributtet use_custom_materials.
