---
title: Tellige esemeid
description: "Siin käsitleme üksikasjalikult tellimusartiklite hankimist, loomist, uuendamist ja kustutamist. Tellimuse elementidele pääseb juurde /phaser-order-rows lõpp-punktist. #### Tellimuse esemete otsimine Tellimuse elemendid saadetakse GET-päringuga /phaser-order-rows lõpp-punktile: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Joonis 1.** Tellimuse esemete otsimine Saate otsida tellimuse objekte erinevate parameetrite järgi: - **phaser_order_id**…"
url: "https://skyplanner.ai/et/docs/tellige-esemeid/"
updated: "2025-10-08"
category: Integratsioonid
tags:
  - API
  - Integratsioon
---

# Tellige esemeid

Siin käsitleme üksikasjalikult tellimusartiklite hankimist, loomist, uuendamist ja kustutamist.

Tellimuse elementidele pääseb juurde /phaser-order-rows lõpp-punktist.

#### Tellimuse esemete otsimine

Tellimuse elemendid saadetakse GET-päringuga /phaser-order-rows lõpp-punktile:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Joonis 1.** Tellimuse esemete otsimine

Saate otsida tellimuse objekte erinevate parameetrite järgi:

- **phaser_order_id**
  - Skyplanneri sisemise **tellimuse**id, saab leida /phaser-orders-endpoint'ist.
- **external_id**
  - Tellimuse kirje väline identifikaator
  - Näiteks unikaalne identifikaator teie välissüsteemist (ERP jne).
- **production_planning_product_id**
  - Skyplanneri sisemine tootetunnus
  - Saab leida /products-endpoint'ist
- **parent_id**
  - Kui tellimuse objektil on alamobjektid (nt alltooted), siis on alamobjektidel nende vanemtellimuse objekti id väljal parent_id.
- **row_index**
  - Tellimuse kirje indeksinumber

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Joonis 2.** Tellimuselemendi rea indeksid

- **töönumber**
  - Tellimuse kirje tööarvu väärtus
- **staatus**
  - Tellimusartikli staatus
  - Lubatud väärtused: **uus**, **alustatud** või **lõpetatud**
- **positsioon**
  - Tellimuse kirje positsiooniväärtus

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Joonis 3. Tellimusartikli positsiooni väärtused

- **delivery_date**
  - Tellimuse eseme tarnekuupäev
  - Formaat: **2025-06-05T22:00:00+00:00**
- **delivery_date_condition**
  - Vabatahtlik tarnekuupäeva otsingu tingimus
  - Valikud: >, =, <=, =, !=
  - Kui väärtust ei ole antud, kasutatakse **>= tingimust.**
- **is_prospect**
  - Tagastage ainult tellimuse esemed, mis on väljavaated
- **include_archived**
  - Arhiveeritud (pehme kustutatud) tellimuse objektide kaasamine otsingusse
  - Tähistatakse väärtusega **is_archive**
- **muudetud**
  - Tagastab tellimuse elemendid, mida on muudetud pärast antud kuupäeva.
  - Formaat: **2025-06-05T22:00:00+00:00**
- **modifiedCondition**
  - Muudetud väärtuse otsingu vabatahtlik tingimus
  - Valikud: >, =, <=, =, !=
  - Kui väärtust ei ole antud, kasutatakse **>= tingimust.**

Võite ka otsinguparameetreid segada ja sobitada, näiteks nii:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Joonis 4.**Tellimuse kirjete otsimine **phaser_order_id**ja **row_index** järgi

Konkreetse tellimusartikli ja selle Skyplanneri sisemise id-i saamiseks saate teha sellise päringu:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Joonis 5.** Skyplanneri id-ga tellimuse eseme otsimine 4

#### Tellimuste loomine

Pange tähele, et enne tellimusartikli loomist peate looma **tellimuse**!

Tellimuse kirje loomiseks saatke POST päring /phaser-order-rows lõpp-punkti:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Joonis** **6.** Tellimuse kirje loomine

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Joonis 7.** Loodud tellimuse kirje

Siin on ülevaade väljadest, mida saate kasutada tellimusartikli loomisel:

- **phaser_order_id**
  - **Tellimuse** sisemine Skyplanner id, millega tellimusartikkel on seotud.
  - **Kohustuslik väli**
- **production_planning_order_row_id**
  - Pärast tellimuse eksportimist Skyplanneri tootmise planeerimise moodulisse luuakse eraldi üksus nimega **tootmise planeerimise tellimuse rida** ja selle id määratakse sellesse väljale
  - **Ei soovitata kasutada**(jäta nulliks või ära saadeta seda välja üldse taotluse väljal).
- **production_planning_product_id**
  - Skyplanner toote id, mida tellimuse objekt toodab.
  - Vajalik, kui soovite tuua vaikimisi protsessisammud tootest
- **external_id**
  - Tellimuse kirje unikaalne identifikaator
  - Kasutage seda, et siduda Skyplanneri tellimusartiklit oma tellimuse objektiga välissüsteemist (ERP jne).
  - **Peab olema ainulaadne**
- **parent_id**
  - Kui tellimusartikkel on teise tellimusartikli alamartikkel, siis tuleb siin esitada vanema id väärtus.
- **row_index**
  - Kus asub see kirje tellimuse kirjete loetelus.
- **töönumber**
  - Kasutatakse ainult informatiivse töönumbri väärtusena tellimusartikli jaoks.
  - Skyplanneri kasutajaliideses ei ole nähtav
- **staatus**
  - Tellimuse kirje staatus
  - Lubatud väärtused: **uus, alustatud, valmis, järkjärguline**
- **is_archive**
  - Kas tellimuse kirje on arhiveeritud (kustutatud).
- **positsioon**
  - Tellimusartikli identifikaatori väärtus (vt joonis 3.)
- **summa**
  - Toodangu toodetud üldkogus
- **tellitud_summa**
  - Tellitud toote kogus
- **hind**
  - Toote ühikuhind
- **use_custom_materials**
  - Kui te ei soovi kasutada vaikimisi materjali seadistust tooteandmetest, siis seadke see väärtus true.
  - Vaikimisi: **false**
- **use_custom_materials_calculated**
  - Tellimusmaterjalide kogused arvutatakse valmistatud toodete koguse alusel.
  - Kui see on seatud väärtuseks false, on materjali kogused fikseeritud
  - Vaikimisi: **false**
- **get_default_steps**
  - Looge protsessi sammud, et tellida toode, mis põhineb toote vaikimisi protsessietappidel.
  - Vaikimisi: **false**
- **use_calculated_job_durations**
  - Protsessi etappide kestuse arvutamine varasemate ajaregistri andmete põhjal
  - Kui arvutamiseks ei ole piisavalt andmeid, kasutatakse vaikimisi kestust.
  - Vaikimisi: **false**
- **sub_items**
  - Looge ka toote alamartiklid, kui need on saadaval
  - Vaikimisi: **false**
- **delivery_date**
  - Formaat: 2022-01-01 10:30:11
- **start_eligibility_date**
  - Formaat: 2022-01-01 10:30:11
- **drawing_identifier**
  - Joonis/blueprint/juhiste identifikaator
- **kirjeldus**
  - Tellimusartikli kirjeldus
- **additional_description**
  - Täiendav kirjeldus tellimuse kirje jaoks
- **is_prospect**
  - Kas tellimuse kirje on väljavaade
  - Vaikimisi: **false**

#### Tellimuse kirjete uuendamine

Tellimuste andmete uuendamiseks saate saata PUT päringu aadressile /phaser-order-rows (/phaser-order-rows ):

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**Joonis 8.**Tellimuse kirje uuendamine

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Joonis 9.**Uuendatud tellimuse kirje

#### Tellimuste kustutamine

Tellimuste kustutamine toimub "pehme kustutamise" meetodil. Tellimuse elemendi kustutamine muudab selle **is_archive** väärtuse true'ks. See tähendab, et kustutatud tellimuse elemendid saab taastada, uuendades is_archive väärtust false'ks.

Tellimuse kirje kustutamisel kustutab süsteem ka sellega seotud protsessietapid.

Tellimuse elemendid kustutatakse, saates DELETE päringu /phaser-order-rows lõpp-punktile:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Joonis 10.**Tellimuste kustutamine

Saate kustutada tellimuse objekte, andes Skyplanneri sisemised id-d massiivi **"ids** " või välised_id-d massiivi **"external_ids** ".