---
title: Položky objednávky
description: "Tu sa podrobne venujeme načítaniu, vytváraniu, aktualizácii a odstraňovaniu položiek objednávky. K položkám objednávky je možné pristupovať z koncového bodu /phaser-order-rows. #### Získavanie položiek objednávky Položky objednávky získate odoslaním požiadavky GET na koncový bod /phaser-order-rows: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Obr. 1.** Získavanie položiek…"
url: "https://skyplanner.ai/sk/docs/polozky-objednavky/"
updated: "2025-10-08"
category: Integrácie
tags:
  - API
  - Integrácia
---

# Položky objednávky

Tu sa podrobne venujeme načítaniu, vytváraniu, aktualizácii a odstraňovaniu položiek objednávky.

K položkám objednávky je možné pristupovať z koncového bodu /phaser-order-rows.

#### Získavanie položiek objednávky

Položky objednávky získate odoslaním požiadavky GET na koncový bod /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Obr. 1.** Získavanie položiek objednávky

Položky objednávky môžete vyhľadávať podľa rôznych parametrov:

- **phaser_order_id**
  - interný identifikátor **objednávky**Skyplanner, ktorý možno zistiť z koncového bodu /phaser-orders-endpoint
- **external_id**
  - Externý identifikátor položky objednávky
  - Napríklad jedinečný identifikátor z vášho externého systému (ERP atď.)
- **production_planning_product_id**
  - Interné ID produktu Skyplanner
  - Možno ich nájsť v koncovom bode /products-endpoint
- **parent_id**
  - Ak má položka objednávky vedľajšie položky (napr. vedľajšie produkty), majú vedľajšie položky v poli parent_id id svojej nadradenej položky objednávky.
- **row_index**
  - Indexové číslo položky objednávky

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Obr. 2.** Indexy riadkov položiek objednávky

- **pracovné číslo**
  - Hodnota pracovného čísla položky objednávky
- **stav**
  - Stav položky objednávky
  - Povolené hodnoty: **nový**, **začatý** alebo **dokončený**
- **pozícia**
  - Hodnota pozície položky objednávky

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Obr. 3. Hodnoty polohy položky objednávky

- **delivery_date**
  - Dátum dodania položky objednávky
  - Formát: **2025-06-05T22:00:00+00:00**
- **delivery_date_condition**
  - Voliteľná podmienka vyhľadávania dátumu dodania
  - Možnosti: >, =, <=, =, !=
  - Ak nie je uvedená žiadna hodnota, použije sa podmienka **>=**
- **is_prospect**
  - Vráťte iba položky objednávky, ktoré sú perspektívne
- **include_archived**
  - Zahrnutie archivovaných (mäkko vymazaných) položiek objednávky do načítania
  - Označené hodnotou **is_archive**
- **upravený**
  - Vrátenie položiek objednávky, ktoré boli upravené po danom dátume
  - Formát: **2025-06-05T22:00:00+00:00**
- **modifiedCondition**
  - Nepovinná podmienka vyhľadávania upravených hodnôt
  - Možnosti: >, =, <=, =, !=
  - Ak nie je uvedená žiadna hodnota, použije sa podmienka **>=**

Parametre vyhľadávania môžete kombinovať aj takto:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Obr. 4.**Získavanie položiek objednávky podľa **phaser_order_id**a **row_index**

Ak chcete získať konkrétnu položku objednávky s jej interným ID Skyplanner, môžete vykonať túto požiadavku:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Obr. 5.** Získanie položky objednávky s identifikátorom Skyplanner 4

#### Vytváranie položiek objednávky

Upozorňujeme, že pred vytvorením položky objednávky musíte vytvoriť **objednávku**!

Ak chcete vytvoriť položku objednávky, pošlite požiadavku POST na koncový bod /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Obr.** **6.** Vytvorenie položky objednávky

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Obr. 7.** Vytvorená položka objednávky

Tu je prehľad polí, ktoré môžete použiť pri vytváraní položky objednávky:

- **phaser_order_id**
  - Interný identifikátor Skyplanner pre **objednávku,** ku ktorej je položka objednávky pripojená
  - **Povinné pole**
- **production_planning_order_row_id**
  - Po exporte objednávky do modulu plánovania výroby programu Skyplanner sa vytvorí samostatná entita s názvom **riadok objednávky plánovania výroby** a jej id sa nastaví do tohto poľa
  - **Neodporúča sa používať**(nechajte ako null alebo toto pole vôbec neposielajte v poli žiadosti)
- **production_planning_product_id**
  - Identifikátor produktu Skyplanner pre produkt, ktorý vyrába položka objednávky
  - Vyžaduje sa, ak chcete preniesť predvolené kroky procesu z produktu
- **external_id**
  - Jedinečný identifikátor položky objednávky
  - Pomocou tejto položky prepojíte položku objednávky Skyplanner s položkou objednávky z externého systému (ERP atď.)
  - **Musí byť jedinečný**
- **parent_id**
  - Ak je položka objednávky podpoložkou inej položky objednávky, uveďte tu hodnotu id nadradenej položky
- **row_index**
  - Kde v zozname položiek objednávky sa táto položka nachádza
- **pracovné číslo**
  - Používa sa len ako informatívna hodnota pracovného čísla pre položku objednávky
  - Nie je viditeľné v používateľskom rozhraní Skyplanner
- **stav**
  - Stav položky objednávky
  - Povolené hodnoty: **nový, začatý, pripravený, postupný**
- **is_archive**
  - Je položka objednávky archivovaná (mäkko vymazaná)
- **pozícia**
  - Hodnota identifikátora položky objednávky (pozri obr. 3.)
- **suma**
  - Celkové vyrobené množstvo výrobku
- **ordered_amount**
  - Objednané množstvo výrobku
- **cena**
  - Jednotková cena výrobku
- **use_custom_materials**
  - Ak nechcete použiť predvolené nastavenie materiálu z údajov o výrobku, nastavte túto hodnotu na true
  - Predvolené nastavenie: **false**
- **use_custom_materials_calculculated**
  - Množstvá vlastného materiálu sa vypočítajú na základe vyrobeného množstva výrobkov
  - Ak je nastavená na false, množstvá materiálu sú pevné
  - Predvolené nastavenie: **false**
- **get_default_steps**
  - Vytvorenie krokov procesu na objednanie položky na základe predvolených krokov procesu produktu
  - Predvolené nastavenie: **false**
- **use_calculated_job_durations**
  - Výpočet trvania krokov procesu na základe údajov časového záznamu z minulosti
  - Ak nie je k dispozícii dostatok údajov na výpočet, použijú sa predvolené trvania
  - Predvolené nastavenie: **false**
- **sub_items**
  - Vytvorte aj podpoložky produktu, ak sú k dispozícii
  - Predvolené nastavenie: **false**
- **delivery_date**
  - Formát: 2022-01-01 10:30:11
- **start_eligibility_date**
  - Formát: 2022-01-01 10:30:11
- **drawing_identifier**
  - Identifikátor výkresu/modrotlače/návodu
- **popis**
  - Popis položky objednávky
- **additional_description**
  - Dodatočný popis položky objednávky
- **is_prospect**
  - Je položka objednávky perspektívna
  - Predvolené nastavenie: **false**

#### Aktualizácia položiek objednávky

Ak chcete aktualizovať údaje o položkách objednávky, môžete poslať požiadavku PUT na koncový bod /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**Obr. 8.**Aktualizácia položky objednávky

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Obr. 9.**Aktualizovaná položka objednávky

#### Odstránenie položiek objednávky

Odstraňovanie položiek objednávky sa vykonáva metódou "mäkkého mazania". Vymazaním položky objednávky sa zmení jej hodnota is_archive na true. To znamená, že vymazané položky objednávok môžete obnoviť aktualizáciou hodnoty is_archive na false.

Pri vymazaní položky objednávky systém vymaže aj súvisiace kroky procesu.

Položky objednávky odstránite odoslaním požiadavky DELETE na koncový bod /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Obr. 10.**Odstránenie položiek objednávky

Položky objednávky môžete vymazať zadaním interných ID programu Skyplanner v poli **"ids"** alebo externých ID v poli **"external_ids** ".