Her går vi i detaljer med at hente, oprette, opdatere og slette ordrevarer.
Ordreelementer kan tilgås fra slutpunktet /phaser-order-rows.
Hentning af ordrevarer #
Du henter ordreelementer ved at sende en GET-request til slutpunktet /phaser-order-rows:
Du kan søge efter bestillingsvarer ud fra en række forskellige parametre:
- phaser_order_id
- internt Skyplanner-ordre-id , kan findes fra /phaser-orders-endpoint
- ekstern_id
- Ekstern identifikation af ordreposten
- For eksempel den unikke identifikator fra dit eksterne system (ERP osv.)
- produktionsplanlægning_produkt_id
- Internt Skyplanner-produkt-id
- Kan findes fra /products-endpoint
- forælder_id
- Hvis en ordreartikel har underartikler (f.eks. underprodukter), har underartiklerne deres overordnede ordreartikels id i feltet parent_id.
- række_indeks
- Ordrepostens indeksnummer
- arbejdsnummer
- Værdien af arbejdsnummeret på ordreposten
- status
- Status for bestillingsvarer
- Tilladte værdier: ny, startet eller afsluttet
- stilling
- Ordrepostens positionsværdi
- leveringsdato
- Leveringsdatoen for ordreemnet
- Format: 2025-06-05T22:00:00+00:00
- leverings_dato_betingelse
- Valgfri betingelse for søgning efter leveringsdato
- Valgmuligheder: >, =, <=, =, !=
- Hvis der ikke er angivet nogen værdi, bruges >= betingelse
- is_prospect
- Returner kun bestillingsvarer, der er udsigtsløse
- inkludere_arkiveret
- Inkluder arkiverede (blødt slettede) ordrevarer i hentning
- Betegnes af is_archive-værdien
- modificeret
- Returner ordrevarer, der er blevet ændret efter en given dato
- Format: 2025-06-05T22:00:00+00:00
- modificeretBetingelse
- Valgfri betingelse for søgning efter ændret værdi
- Valgmuligheder: >, =, <=, =, !=
- Hvis der ikke er angivet nogen værdi, bruges >= betingelse
Du kan også blande og matche søgeparametrene på denne måde:
For at hente en specifik ordrevare med dens interne Skyplanner-id kan du lave en anmodning som denne:
Oprettelse af ordrevarer #
Bemærk, at du skal oprette en ordre, før du opretter en ordrepost!
For at oprette en ordrepost skal du sende en POST-anmodning til slutpunktet /phaser-order-rows:
Her er en oversigt over de felter, du kan bruge, når du opretter en ordrepost:
- phaser_order_id
- Internt Skyplanner-id for den ordre, som ordreelementet er knyttet til
- Påkrævet felt
- produktionsplanlægning_ordre_række_id
- Når ordren er eksporteret til produktionsplanlægningsmodulet i Skyplanner, oprettes der en separat enhed kaldet en produktionsplanlægningsordrerække, og dens id indstilles i dette felt
- Anbefales ikke at bruge (efterlad som null, eller send slet ikke dette felt i anmodningsfeltet)
- produktionsplanlægning_produkt_id
- Skyplanner-produkt-id for det produkt, som ordreposten producerer
- Påkrævet, hvis du vil hente standardprocesskridt fra et produkt
- ekstern_id
- Unik identifikation af ordreelementet
- Brug dette til at linke Skyplanner-ordreposten til din ordrepost fra et eksternt system (ERP osv.).
- Skal være unik
- forælder_id
- Hvis ordreposten er en underpost til en anden ordrepost, skal du angive den overordnede id-værdi her
- række_indeks
- Hvor på listen over bestillingsvarer i bestillingen er denne vare placeret
- arbejdsnummer
- Bruges kun som en informativ arbejdsnummerværdi for ordreposten
- Ikke synlig i Skyplanner UI
- status
- Status for ordreposten
- Tilladte værdier: ny, startet, klar, indfaset
- er_arkiv
- Er ordreposten arkiveret (soft deleted)?
- stilling
- Værdi for identifikation af ordrevare (se fig. 3.)
- beløb
- Samlet fremstillet mængde af produktet
- bestilt_beløb
- Bestilt mængde af produkt
- Pris
- Enhedspris for produktet
- brug_tilpassede_materialer
- Hvis du ikke ønsker at bruge standardmaterialeopsætningen fra produktdataene, skal du indstille denne værdi til true
- Standard: false
- brug_custom_materialer_beregnet
- Tilpassede materialemængder beregnes ud fra den fremstillede mængde af produkter
- Hvis den er sat til false, er materialemængderne faste
- Standard: false
- get_default_steps
- Opret procestrin for at bestille varer baseret på produktets standard procestrin
- Standard: false
- brug_beregnet_jobvarighed
- Beregn varighed af procestrin baseret på tidligere timelog-data
- Hvis der ikke er nok data til rådighed til at beregne, bruges standardvarigheder.
- Standard: false
- underpunkter
- Opret også produktets underartikler, hvis de er tilgængelige
- Standard: false
- leveringsdato
- Format: 2022-01-01 10:30:11
- start_støtteberettigelse_dato
- Format: 2022-01-01 10:30:11
- tegning_identifikator
- Identifikator for tegning/blåtryk/instruktioner
- beskrivelse
- Beskrivelse af bestillingsvare
- yderligere_beskrivelse
- Yderligere beskrivelse af bestillingsvare
- is_prospect
- Er ordreposten et prospekt?
- Standard: false
Opdatering af ordrevarer #
For at opdatere ordrevaredata kan du sende en PUT-anmodning til slutpunktet /phaser-order-rows:
Sletning af ordrevarer #
Sletning af ordrevarer sker med en “soft delete”-metode. Når man sletter en ordrepost, ændres dens is_archive-værdi til true. Det betyder, at du kan gendanne slettede ordrevarer ved at opdatere is_archive-værdien til false.
Når man sletter en ordrepost, sletter systemet også de tilknyttede procestrin.
Du sletter ordreelementer ved at sende en DELETE-anmodning til slutpunktet /phaser-order-rows:
Du kan slette ordreelementer ved at angive de interne Skyplanner-id’er i arrayet “ids ” eller de eksterne id’er i arrayet “external_ids “.