Här går vi in i detalj på hur man hämtar, skapar, uppdaterar och tar bort orderobjekt.
Orderartiklar kan nås från slutpunkten /phaser-order-rows.
Hämtning av orderposter #
Du hämtar orderposter genom att skicka en GET-request till endpointen /phaser-order-rows:
Du kan söka efter orderartiklar med hjälp av en mängd olika parametrar:
- phaser_order_id
- internt Skyplanner-order-ID , kan hittas från /phaser-orders-endpoint
- externt_id
- Extern identifierare för orderobjektet
- Till exempel den unika identifieraren från ditt externa system (ERP, etc.)
- produktion_planering_produkt_id
- Internt Skyplanner-produkt-ID
- Kan hittas från /products-endpoint
- förälder_id
- Om en orderartikel har underartiklar (t.ex. underprodukter) har underartiklarna sin överordnade orderartikels id i fältet parent_id
- rad_index
- Indexnummer för orderobjektet
- arbetsnummer
- Värdet på orderartikelns arbetsnummer
- status
- Orderartikelns status
- Tillåtna värden: ny, påbörjad eller avslutad
- position
- Orderartikelns positionsvärde
- leverans_datum
- Leveransdatum för orderobjektet
- Format: 2025-06-05T22:00:00+00:00
- leverans_datum_villkor
- Valfritt villkor för sökning av leveransdatum
- Alternativ: >, =, <=, =, !=
- Om inget värde anges kommer >= villkoret att användas
- är_prospekt
- Returnera endast orderartiklar som är potentiella
- inkludera_arkiverad
- Inkludera arkiverade (mjukt raderade) orderartiklar i hämtningen
- Anges av värdet is_archive
- modifierad
- Returnera orderartiklar som har ändrats efter angivet datum
- Format: 2025-06-05T22:00:00+00:00
- modifierat villkor
- Valfritt villkor för sökning med modifierat värde
- Alternativ: >, =, <=, =, !=
- Om inget värde anges kommer >= villkoret att användas
Du kan också blanda och matcha sökparametrarna så här:
För att hämta en specifik orderartikel med dess interna Skyplanner-id kan du göra en begäran så här:
Skapa orderposter #
Observera att du måste skapa en order innan du skapar orderobjektet!
För att skapa ett orderobjekt skickar du en POST-begäran till slutpunkten /phaser-order-rows:
Här följer en översikt över de fält som du kan använda när du skapar en orderartikel:
- phaser_order_id
- Internt Skyplanner-id för den order som orderobjektet är kopplat till
- Obligatoriskt fält
- produktions_planering_order_rad_id
- När ordern har exporterats till Skyplanner-modulen för produktionsplanering skapas en separat enhet som kallas orderrad för produktionsplanering och dess id anges i detta fält
- Rekommenderas inte att använda (lämna som null eller skicka inte detta fält alls i fältet för begäran)
- produktion_planering_produkt_id
- Skyplanner-produkt-ID för den produkt som orderobjektet producerar
- Krävs om du vill ta med standardprocessteg från en produkt
- externt_id
- Unik identifierare för orderobjektet
- Använd detta för att länka Skyplanner-orderposten till din orderpost från ett externt system (ERP etc.)
- Måste vara unik
- förälder_id
- Om orderartikeln är en underartikel till en annan orderartikel anger du den överordnade artikelns id-värde här
- rad_index
- Var i listan över orderposter i ordern denna post är placerad
- arbetsnummer
- Används endast som ett informativt arbetsnummervärde för orderartikeln
- Syns inte i Skyplanner UI
- status
- Status för orderartikeln
- Tillåtna värden: ny, påbörjad, klar, fasad
- är_arkiv
- Är orderobjektet arkiverat (soft deleted)
- position
- Orderartikelns identifieringsvärde (se bild 3.)
- belopp
- Total tillverkad kvantitet av produkten
- beställt_belopp
- Beställd kvantitet av produkt
- pris
- Enhetspris för produkten
- användning_av_anpassade_material
- Om du inte vill använda standardmaterialinställningen från produktdata ska du ställa in detta värde på true
- Standard: false
- använd_custom_material_beräknade
- Kvantiteter av specialmaterial beräknas utifrån den tillverkade kvantiteten av produkter
- Om inställningen är false är materialkvantiteterna fasta
- Standard: false
- hämta_standard_steg
- Skapa processteg för orderartikeln baserat på produktens standardprocessteg
- Standard: false
- användning_beräknade_jobbdurationer
- Beräkna processtegens varaktighet baserat på tidigare tidsloggdata
- Om det inte finns tillräckligt med data för att beräkna, används standardvaraktigheter
- Standard: false
- under_artiklar
- Skapa även produktens underartiklar om sådana finns
- Standard: false
- leverans_datum
- Format: 2022-01-01 10:30:11
- start_kvalificering_datum
- Format: 2022-01-01 10:30:11
- ritning_identifierare
- Ritning/blåtryck/instruktioner identifierare
- beskrivning
- Beskrivning av orderartikel
- ytterligare_beskrivning
- Ytterligare beskrivning för orderartikel
- är_prospekt
- Är orderobjektet ett prospekt
- Standard: false
Uppdatering av orderposter #
För att uppdatera orderartikeldata kan du skicka en PUT-begäran till slutpunkten /phaser-order-rows:
Radering av orderposter #
Radering av orderposter görs med en “soft delete”-metod. När du tar bort en orderartikel ändras dess
När en orderartikel raderas kommer systemet även att radera de tillhörande processtegen.
Du tar bort orderposter genom att skicka en DELETE-request till slutpunkten /phaser-order-rows:
Du kan ta bort orderposter genom att ange de interna Skyplanner-id:na i matrisen “ids ” eller de externa id:na i matrisen “external_ids “.