---
title: Predmeti za naročilo
description: "V tem poglavju podrobno opisujemo pridobivanje, ustvarjanje, posodabljanje in brisanje elementov naročila. Do elementov naročila lahko dostopate prek končne točke /phaser-order-rows. #### Pridobivanje elementov naročila Elemente naročila pridobite tako, da pošljete zahtevo GET na končno točko /phaser-order-rows: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Slika 1.**…"
url: "https://skyplanner.ai/sl/docs/predmeti-za-narocilo/"
updated: "2025-10-08"
category: Integracije
tags:
  - API
  - Integracija
---

# Predmeti za naročilo

V tem poglavju podrobno opisujemo pridobivanje, ustvarjanje, posodabljanje in brisanje elementov naročila.

Do elementov naročila lahko dostopate prek končne točke /phaser-order-rows.

#### Pridobivanje elementov naročila

Elemente naročila pridobite tako, da pošljete zahtevo GET na končno točko /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Slika 1.** Pridobivanje elementov naročila

Predmete naročila lahko iščete po različnih parametrih:

- **phaser_order_id**
  - notranji ID **naročila**Skyplannerja, ki ga je mogoče najti na končni točki /phaser-orders-endpoint
- **external_id**
  - Zunanji identifikator elementa naročila
  - Na primer edinstven identifikator iz zunanjega sistema (ERP itd.).
- **production_planning_product_id**
  - Notranji ID izdelka Skyplanner
  - Najdete ga v končni točki /products-endpoint
- **parent_id**
  - Če ima postavka naročila podpostavke (npr. podpostavke izdelkov), imajo podpostavke v polju parent_id id svoje nadrejene postavke naročila.
- **row_index**
  - Indeksna številka elementa naročila

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Slika 2.** Indeksi vrstic elementov naročila

- **številka dela**
  - Vrednost delovne številke elementa naročila
- **status**
  - Stanje postavke naročila
  - Dovoljene vrednosti: **novo**, **začeto** ali **dokončano**
- **položaj**
  - Vrednost položaja elementa naročila

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Slika 3. Vrednosti položaja elementa naročila

- **delivery_date**
  - Datum dostave elementa naročila
  - Format: **2025-06-05T22:00:00+00:00**
- **delivery_date_condition**
  - Neobvezni pogoj iskanja datuma dostave
  - Možnosti: >, =, <=, =, =, !=
  - Če vrednost ni navedena, se uporabi pogoj **>=.**
- **is_prospect**
  - Vrnite samo predmete naročila, ki so perspektivi
- **vključi_arhivirano**
  - Vključitev arhiviranih (mehko izbrisanih) elementov naročila v prevzem
  - Označuje ga vrednost **is_archive**
- **spremenjeno**
  - Vrnite elemente naročila, ki so bili spremenjeni po danem datumu
  - Format: **2025-06-05T22:00:00+00:00**
- **modifiedCondition**
  - Neobvezni pogoj za iskanje spremenjene vrednosti
  - Možnosti: >, =, <=, =, =, !=
  - Če vrednost ni navedena, se uporabi pogoj **>=.**

Parametre iskanja lahko tudi mešate in prilagajate, kot sledi:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Slika 4.**Pridobivanje elementov naročila po **phaser_order_id**in **row_index**

Če želite pridobiti določen element naročila z njegovim notranjim ID Skyplannerja, lahko zahtevate takole:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Slika 5.** Pridobivanje elementa naročila z id Skyplannerja 4

#### Ustvarjanje elementov naročila

Upoštevajte, da morate ustvariti **naročilo**, preden ustvarite element naročila!

Če želite ustvariti element naročila, pošljite zahtevo POST na končno točko /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Slika** **6.** Ustvarjanje elementa naročila

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Slika 7.** Ustvarjen element naročila

Tukaj je pregled polj, ki jih lahko uporabite pri ustvarjanju elementa naročila:

- **phaser_order_id**
  - Notranji ID Skyplannerja za **naročilo, ki** mu je element naročila priložen.
  - **Obvezno polje**
- **production_planning_order_row_id**
  - Ko je naročilo izvoženo v modul Skyplanner za načrtovanje proizvodnje, se ustvari ločena entiteta, imenovana **vrstica naročila za načrtovanje proizvodnje**, njen id pa se nastavi v to polje.
  - **Ni priporočljivo uporabljati**(pustite kot nič ali tega polja sploh ne pošiljajte v polju zahteve)
- **production_planning_product_id**
  - Id izdelka Skyplanner za izdelek, ki ga proizvaja element naročila
  - obvezno, če želite iz izdelka prenesti privzete korake postopka.
- **external_id**
  - Enolični identifikator elementa naročila
  - Uporabite jo za povezavo elementa naročila Skyplanner z vašim elementom naročila iz zunanjega sistema (ERP itd.)
  - **Biti mora edinstven.**
- **parent_id**
  - Če je postavka naročila podpostavka za drugo postavko naročila, tukaj navedite vrednost id nadrejene postavke.
- **row_index**
  - Kje na seznamu elementov naročila v naročilu se nahaja ta element
- **številka dela**
  - Uporablja se samo kot informativna vrednost delovne številke za element naročila.
  - Ni vidno v uporabniškem vmesniku Skyplannerja
- **status**
  - Status elementa naročila
  - Dovoljene vrednosti: **novo, začeto, pripravljeno, postopno**
- **is_archive**
  - Ali je element naročila arhiviran (mehko izbrisan)
- **položaj**
  - Vrednost identifikatorja elementa naročila (glejte sliko 3)
- **znesek**
  - Skupna proizvedena količina izdelka
- **ordered_amount**
  - Naročena količina izdelka
- **cena**
  - Cena na enoto izdelka
- **use_custom_materials**
  - Če ne želite uporabiti privzete nastavitve materiala iz podatkov o izdelku, nastavite to vrednost na true.
  - Privzeto: **false**
- **use_custom_materials_calculculated**
  - Količine materiala po meri se izračunajo na podlagi proizvedene količine izdelkov.
  - Če je nastavljena na false, so količine materiala fiksne.
  - Privzeto: **false**
- **get_default_steps**
  - Ustvarite korake postopka za element naročila na podlagi privzetih korakov postopka izdelka
  - Privzeto: **false**
- **use_calculculated_job_durations**
  - Izračun trajanja korakov procesa na podlagi preteklih podatkov časovnega dnevnika
  - Če ni na voljo dovolj podatkov za izračun, se uporabijo privzeta trajanja.
  - Privzeto: **false**
- **sub_items**
  - Ustvarite tudi podpostavke izdelka, če so na voljo
  - Privzeto: **false**
- **delivery_date**
  - Format: 2022-01-01 10:30:11
- **start_eligibility_date**
  - Format: 2022-01-01 10:30:11
- **identifikator risbe**
  - Identifikator risbe/sijotiska/navodil
- **opis**
  - Opis elementa naročila
- **additional_description**
  - Dodaten opis za element naročila
- **is_prospect**
  - Ali je element naročila perspektivni
  - Privzeto: **false**

#### Posodabljanje elementov naročila

Če želite posodobiti podatke o postavki naročila, lahko pošljete zahtevo PUT na končno točko /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**Slika 8.**Posodabljanje elementa naročila

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Slika 9.**Posodobljena postavka naročila

#### Brisanje elementov naročila

Brisanje elementov naročila se izvede na način "mehkega brisanja". Pri brisanju elementa naročila se njegova vrednost is_archive spremeni v true. To pomeni, da lahko izbrisane elemente naročila obnovite tako, da posodobite vrednost is_archive na false.

Pri brisanju elementa naročila sistem izbriše tudi povezane korake postopka.

Elemente naročila izbrišete tako, da pošljete zahtevek DELETE končni točki /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Slika 10.**Brisanje elementov naročila

Elemente naročila lahko izbrišete tako, da v polju **"ids"** navedete notranje ID programa Skyplanner ali zunanje_id v polju **"external_ids** ".