---
title: Tilaa kohteita
description: "Tässä käsitellään yksityiskohtaisesti tilauserien hakemista, luomista, päivittämistä ja poistamista. Tilauseriä voi käyttää /phaser-order-rows-päätepisteestä. #### Tilauserien hakeminen Tilauserät haetaan lähettämällä GET-pyyntö /phaser-order-rows-päätepisteeseen: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Kuva 1.** Tilauserien hakeminen Voit hakea tilauseriä useiden eri parametrien perusteella: - **phaser_order_id** - Skyplannerin sisäinen **tilaustunnus**, löytyy…"
url: "https://skyplanner.ai/fi/docs/tilaa-kohteita/"
updated: "2025-10-08"
category: Integraatiot
tags:
  - API
  - Integrointi
---

# Tilaa kohteita

Tässä käsitellään yksityiskohtaisesti tilauserien hakemista, luomista, päivittämistä ja poistamista.

Tilauseriä voi käyttää /phaser-order-rows-päätepisteestä.

#### Tilauserien hakeminen

Tilauserät haetaan lähettämällä GET-pyyntö /phaser-order-rows-päätepisteeseen:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Kuva 1.** Tilauserien hakeminen

Voit hakea tilauseriä useiden eri parametrien perusteella:

- **phaser_order_id**
  - Skyplannerin sisäinen **tilaustunnus**, löytyy /phaser-orders-endpointista
- **external_id**
  - Tilauserän ulkoinen tunniste
  - Esimerkiksi ulkoisen järjestelmän (ERP jne.) yksilöllinen tunniste.
- **tuotannon_suunnittelu_tuote_id**
  - Sisäinen Skyplanner-tuotetunnus
  - Löytyy /products-päätepisteestä.
- **parent_id**
  - Jos tilauserällä on alaeriä (esim. alatuotteita), alaerillä on vanhemman tilauserän id kentässä parent_id.
- **row_index**
  - Tilauserän indeksinumero

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Kuva 2.** Tilauskappaleen rivin indeksit

- **työnumero**
  - Tilauserän työnumeron arvo
- **tila**
  - Tilauserän tila
  - Sallitut arvot: **uusi**, **aloitettu** tai **valmistunut**.
- **asema**
  - Tilauserän sijaintiarvo

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Kuva 3. Tilauserän sijaintiarvot

- **toimituspäivä**
  - Tilauserän toimituspäivä
  - Formaatti: **2025-06-05T22:00:00+00:00**
- **toimituspäivä_ehto**
  - Valinnainen toimituspäivähakuehto
  - Vaihtoehdot: >, =, <=, =, =, !=
  - Jos arvoa ei ole annettu, käytetään **>= ehtoa.**
- **is_prospect**
  - Palauta vain tilauserät, jotka ovat tulevaisuudennäkymiä
- **include_archived**
  - Arkistoitujen (pehmeästi poistettujen) tilauserien sisällyttäminen noutoon
  - Merkitään **is_archive-arvolla**
- **muutettu**
  - Palauta tilauserät, joita on muutettu tietyn päivämäärän jälkeen.
  - Formaatti: **2025-06-05T22:00:00+00:00**
- **modifiedCondition**
  - Muutetun arvon haun valinnainen ehto
  - Vaihtoehdot: >, =, <=, =, =, !=
  - Jos arvoa ei ole annettu, käytetään **>= ehtoa.**

Voit myös yhdistellä hakuparametreja seuraavasti:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Kuva 4.**Tilauserien hakeminen **phaser_order_id:**n ja **row_indexin** perusteella.

Voit hakea tietyn tilauserän ja sen sisäisen Skyplanner-tunnuksen seuraavasti:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Kuva 5.** Skyplanner-tunnuksella varustetun tilauserän hakeminen 4

#### Tilauserien luominen

Huomaa, että sinun on luotava **tilaus** ennen tilauserän luomista!

Luodaksesi tilauserän lähetä POST-pyyntö /phaser-order-rows-päätepisteeseen:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Kuva** **6.** Tilauserän luominen

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Kuva 7.** Luotu tilauserä

Tässä on yleiskatsaus kenttiin, joita voit käyttää tilauserää luodessasi:

- **phaser_order_id**
  - **Tilauksen** sisäinen Skyplanner-tunnus, johon tilauserä on liitetty.
  - **Pakollinen kenttä**
- **tuotannon_suunnittelu_tilaus_rivi_id**
  - Kun tilaus on viety Skyplannerin tuotantosuunnittelumoduuliin, luodaan erillinen kokonaisuus nimeltä **tuotantosuunnittelutilausrivi** ja sen id asetetaan tähän kenttään.
  - **Ei suositella käytettäväksi**(jätä nollaksi tai älä lähetä tätä kenttää lainkaan pyynnön kentässä).
- **tuotannon_suunnittelu_tuote_id**
  - Skyplanner-tuotetunniste tuotteelle, jota tilauserä tuottaa.
  - Vaaditaan, jos haluat tuoda oletusarvoiset prosessin vaiheet tuotteesta.
- **external_id**
  - Tilauserän yksilöllinen tunniste
  - Käytä tätä linkittääksesi Skyplanner-tilauserän ulkoisen järjestelmän (ERP jne.) tilauserään.
  - **On oltava ainutlaatuinen**
- **parent_id**
  - Jos tilauserä on toisen tilauserän alaerä, anna tässä vanhemman id-arvo.
- **row_index**
  - Missä kohtaa tilauksen nimikkeiden luetteloa tämä nimike sijaitsee tilauksessa.
- **työnumero**
  - Käytetään ainoastaan tilauserän informatiivisena työnumeroarvona.
  - Ei näy Skyplannerin käyttöliittymässä
- **tila**
  - Tilauserän tila
  - Sallitut arvot: **uusi, aloitettu, valmis, vaiheittainen**
- **is_archive**
  - Onko tilauserä arkistoitu (pehmeästi poistettu)?
- **asema**
  - Tilauserän tunnisteen arvo (ks. kuva 3).
- **määrä**
  - Tuotteen valmistettu kokonaismäärä
- **tilattu_määrä**
  - Tuotteen tilattu määrä
- **hinta**
  - Tuotteen yksikköhinta
- **use_custom_materials**
  - Jos et halua käyttää tuotetiedoissa olevaa oletusmateriaaliasetusta, aseta tämä arvo arvoksi true.
  - Oletus: **false**
- **use_custom_materials_calculated (käytä_asiallisia_materiaaleja_laskettuna)**
  - Mukautetut materiaalimäärät lasketaan valmistettujen tuotteiden määrän perusteella.
  - Jos arvoksi asetetaan false, materiaalimäärät ovat kiinteitä
  - Oletus: **false**
- **get_default_steps**
  - Luo prosessivaiheet tilauserän tilaamiseen tuotteen oletusprosessivaiheiden perusteella.
  - Oletus: **false**
- **use_calculated_job_durations (käytä_laskettuja_työn kestoja)**
  - Prosessivaiheen keston laskeminen aiempien aikapäiväkirjatietojen perusteella.
  - Jos tietoja ei ole saatavilla riittävästi laskentaa varten, käytetään oletusarvoisia kestoja.
  - Oletus: **false**
- **sub_items**
  - Luo myös tuotteen alatuotteet, jos niitä on saatavilla
  - Oletus: **false**
- **toimituspäivä**
  - Formaatti: 2022-01-01 10:30:11
- **alku_kelpoisuus_päivämäärä**
  - Formaatti: 2022-01-01 10:30:11
- **drawing_identifier**
  - Piirustuksen/sinipainatuksen/ohjeiden tunniste
- **kuvaus**
  - Tilauserän kuvaus
- **additional_description**
  - Tilauksen kohteen lisäkuvaus
- **is_prospect**
  - Onko tilauserä prospekti
  - Oletus: **false**

#### Tilauserien päivittäminen

Voit päivittää tilauserien tietoja lähettämällä PUT-pyynnön /phaser-order-rows-loppupisteeseen:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**Kuva 8.**Tilauserän päivittäminen

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Kuva 9.**Päivitetty tilauserä

#### Tilauserien poistaminen

Tilauserien poistaminen tapahtuu "pehmeällä poistomenetelmällä". Tilauserän poistaminen muuttaa sen is_archive-arvon true-arvoksi. Tämä tarkoittaa, että voit palauttaa poistetut tilauserät päivittämällä is_archive-arvon arvoksi false.

Kun tilauserä poistetaan, järjestelmä poistaa myös siihen liittyvät prosessivaiheet.

Poistat tilauseriä lähettämällä DELETE-pyynnön /phaser-order-rows-päätepisteeseen:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Kuva 10.**Tilauserien poistaminen

Voit poistaa tilauskohteita antamalla Skyplannerin sisäiset tunnukset sarjassa **"ids** " tai ulkoiset tunnukset sarjassa **"external_ids** ".