Her går vi i detalj om hvordan du henter, oppretter, oppdaterer og sletter ordreelementer.
Bestillingselementer kan nås fra endepunktet /phaser-order-rows.
Henting av bestillingsvarer #
Du henter bestillingselementer ved å sende en GET-forespørsel til endepunktet /phaser-order-rows:
Du kan søke etter bestillingsvarer etter en rekke ulike parametere:
- phaser_order_id
- intern Skyplanner-ordre-ID , kan finnes fra /phaser-orders-sluttpunktet
- ekstern_id
- Ekstern identifikator for bestillingselementet
- For eksempel den unike identifikatoren fra det eksterne systemet ditt (ERP osv.)
- produksjon_planlegging_produkt_id
- Intern Skyplanner-produkt-ID
- Kan finnes fra /products-sluttpunktet
- overordnet_id
- Hvis en ordrevare har underartikler (f.eks. underprodukter), har underartikkelen sin overordnede ordrevares id i feltet parent_id
- rad_indeks
- Indeksnummeret til ordreposten
- arbeidsnummer
- Verdien av arbeidsnummeret til ordreposten
- status
- Status for bestillingsvare
- Tillatte verdier: ny, påbegynt eller fullført
- stilling
- Posisjonsverdien til ordreelementet
- delivery_date
- Leveringsdatoen for bestillingsvaren
- Format: 2025-06-05T22:00:00+00:00
- leverings_dato_betingelse
- Valgfri betingelse for søk etter leveringsdato
- Alternativer: >, =, <=, =, !=
- Hvis ingen verdi er oppgitt, brukes >= betingelsen
- is_prospect
- Returner kun bestillingsvarer som er potensielle kunder
- include_archived
- Inkluder arkiverte (mykt slettede) ordreelementer i hentingen
- Angis med verdien is_archive
- modifisert
- Returner ordrevarer som har blitt endret etter en gitt dato
- Format: 2025-06-05T22:00:00+00:00
- modifiedCondition
- Valgfri betingelse for søk etter endret verdi
- Alternativer: >, =, <=, =, !=
- Hvis ingen verdi er oppgitt, brukes >= betingelsen
Du kan også blande og matche søkeparametrene på denne måten:
Hvis du vil hente en spesifikk bestillingsvare med dens interne Skyplanner-id, kan du gjøre en forespørsel på denne måten:
Opprette ordrevarer #
Vær oppmerksom på at du må opprette en ordre før du oppretter ordreelementet!
For å opprette en bestillingsvare sender du en POST-forespørsel til endepunktet /phaser-order-rows:
Her er en oversikt over feltene du kan bruke når du oppretter en ordrepost:
- phaser_order_id
- Intern Skyplanner-id for ordren som ordreelementet er knyttet til
- Obligatorisk felt
- produksjonsplanlegging_ordre_rad_id
- Etter at bestillingen er eksportert til produksjonsplanleggingsmodulen i Skyplanner, opprettes det en egen enhet som kalles en produksjonsplanleggingsordrerad, og id-en settes i dette feltet
- Ikke anbefalt å bruke (la feltet stå som null eller ikke send dette feltet i det hele tatt i forespørselsfeltet)
- produksjon_planlegging_produkt_id
- Skyplanner-produkt-ID for produktet som bestillingselementet produserer
- Påkrevd hvis du ønsker å ta med standard prosesstrinn fra et produkt
- ekstern_id
- Unik identifikator for bestillingselementet
- Bruk denne for å koble Skyplanner-ordreelementet til ordreelementet ditt fra et eksternt system (ERP osv.)
- Må være unik
- overordnet_id
- Hvis ordreposten er en underpost til en annen ordrepost, angir du den overordnede ordrepostens id-verdi her
- rad_indeks
- Hvor i listen over ordreposter i bestillingen denne posten befinner seg
- arbeidsnummer
- Brukes kun som en informativ arbeidsnummerverdi for ordreposten
- Ikke synlig i Skyplanner UI
- status
- Status for bestillingselementet
- Tillatte verdier: ny, startet, klar, faset
- is_archive
- Er ordreposten arkivert (mykt slettet)
- stilling
- Identifikasjonsverdi for bestillingsvare (se fig. 3.)
- beløp
- Total produsert mengde av produktet
- bestilt_beløp
- Bestilt mengde produkt
- pris
- Enhetspris på produktet
- bruk_tilpassede_materialer
- Hvis du ikke ønsker å bruke standard materialoppsett fra produktdataene, setter du denne verdien til true
- Standard: false
- bruk_tilpassede_materialer_beregnet
- Kundetilpassede materialmengder beregnes basert på det produserte antallet produkter
- Hvis den er satt til false, er materialmengdene faste
- Standard: false
- get_default_steps
- Opprett prosesstrinn for å bestille varer basert på produktets standard prosesstrinn
- Standard: false
- bruk_beregnet_jobbvarighet
- Beregn varigheten av prosesstrinn basert på tidligere tidsloggdata
- Hvis det ikke er nok data tilgjengelig til å beregne, brukes standard varighet
- Standard: false
- sub_items
- Opprett også produktets underartikler hvis tilgjengelig
- Standard: false
- delivery_date
- Format: 2022-01-01 10:30:11
- start_kvalifisering_dato
- Format: 2022-01-01 10:30:11
- tegning_identifikator
- Identifikator for tegning/blåtrykk/instruksjoner
- beskrivelse
- Beskrivelse av bestillingsvare
- additional_description
- Tilleggsbeskrivelse for bestillingselementet
- is_prospect
- Er bestillingsobjektet et prospekt
- Standard: false
Oppdatering av bestillingsvarer #
For å oppdatere data om bestillingselementer kan du sende en PUT-forespørsel til endepunktet /phaser-order-rows:
Slette ordreelementer #
Sletting av ordreelementer gjøres ved hjelp av en “soft delete”-metode. Når du sletter en ordrepost, endres verdien is_archive til true. Dette betyr at du kan gjenopprette slettede ordreelementer ved å oppdatere is_archive-verdien til false.
Når du sletter en ordrevare, vil systemet også slette de tilknyttede prosesstrinnene.
Du sletter ordreelementer ved å sende en DELETE-forespørsel til endepunktet /phaser-order-rows:
Du kan slette bestillingselementer ved å oppgi de interne Skyplanner-id-ene i matrisen “ids ” eller de eksterne id-ene i matrisen “external_ids “.