---
title: Beställ artiklar
description: "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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Bild 1.**…"
url: "https://skyplanner.ai/sv/docs/bestall-artiklar/"
updated: "2025-10-08"
category: Integrationer
tags:
  - API
  - Integration
---

# Beställ artiklar

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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Bild 1.** Hämtning av orderposter

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

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Bild 2.** Index för orderartikelrader

- **arbetsnummer**
  - Värdet på orderartikelns arbetsnummer
- **status**
  - Orderartikelns status
  - Tillåtna värden: **ny**, **påbörjad** eller **avslutad**
- **position**
  - Orderartikelns positionsvärde

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Bild 3. Orderobjektets positionsvärden

- **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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Bild 4.**Hämtning av orderartiklar med **phaser_order_id**och **row_index**

För att hämta en specifik orderartikel med dess interna Skyplanner-id kan du göra en begäran så här:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Bild 5.** Hämta en orderartikel med Skyplanner-id 4

#### 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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Bild** **6.** Skapa en orderartikel

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Bild 7.** Skapad orderartikel

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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**Bild 8.**Uppdatering av en orderpost

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Bild 9.**Uppdaterad orderartikel

#### Radering av orderposter

Radering av orderposter görs med en "soft delete"-metod. När du tar bort en orderartikel ändras dess is_archive-värde till true. Det innebär att du kan återställa raderade orderobjekt genom att uppdatera is_archive-värdet till false.

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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Fig 10.**Radering av orderposter

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** ".
