---
title: Položky objednávky
description: "Zde se podrobně seznámíme s načítáním, vytvářením, aktualizací a mazáním položek objednávky. K položkám objednávky lze přistupovat z koncového bodu /phaser-order-rows. #### Získání položek objednávky Položky objednávky získáte odesláním požadavku GET na koncový bod /phaser-order-rows: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Obr. 1.** Získání položek…"
url: "https://skyplanner.ai/cs/docs/polozky-objednavky/"
updated: "2025-10-08"
category: Integrace
tags:
  - API
  - Integrace
---

# Položky objednávky

Zde se podrobně seznámíme s načítáním, vytvářením, aktualizací a mazáním položek objednávky.

K položkám objednávky lze přistupovat z koncového bodu /phaser-order-rows.

#### Získání položek objednávky

Položky objednávky získáte odesláním požadavku GET na koncový bod /phaser-order-rows:

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

Položky objednávky můžete vyhledávat podle různých parametrů:

- **phaser_order_id**
  - interní ID **objednávky**Skyplanner, lze zjistit z koncového bodu /phaser-orders-endpoint.
- **external_id**
  - Externí identifikátor položky objednávky
  - Například jedinečný identifikátor z vašeho externího systému (ERP atd.).
- **production_planning_product_id**
  - Interní ID produktu Skyplanner
  - Lze nalézt v koncovém bodě /products-endpoint
- **parent_id**
  - Pokud má položka objednávky dílčí položky (např. dílčí produkty), mají dílčí položky v poli parent_id id své nadřazené 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 řádků položek objednávky

- **pracovní číslo**
  - Hodnota pracovního čísla položky objednávky
- **stav**
  - Stav položky objednávky
  - Přípustné hodnoty: **nový**, **zahájený** nebo **dokončený**
- **pozice**
  - Hodnota pozice 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**
  - Datum dodání položky objednávky
  - Formát: **2025-06-05T22:00:00+00:00**
- **delivery_date_condition**
  - Volitelná podmínka vyhledávání data dodání
  - Možnosti: >, =, <=, =, !=
  - Pokud není uvedena žádná hodnota, použije se podmínka **>=.**
- **is_prospect**
  - Vracejte pouze položky objednávky, které jsou perspektivní
- **include_archived**
  - Zahrnutí archivovaných (měkce smazaných) položek objednávek do načítání
  - Označuje se hodnotou **is_archive**
- **upravený**
  - Vrátit položky objednávky, které byly upraveny po daném datu.
  - Formát: **2025-06-05T22:00:00+00:00**
- **modifiedCondition**
  - Nepovinná podmínka vyhledávání změněných hodnot
  - Možnosti: >, =, <=, =, !=
  - Pokud není uvedena žádná hodnota, použije se podmínka **>=.**

Parametry vyhledávání můžete také kombinovat:

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

Chcete-li získat konkrétní položku objednávky s jejím interním ID Skyplanneru, můžete provést tento požadavek:

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

#### Vytváření položek objednávky

Všimněte si, že před vytvořením položky **objednávky** musíte vytvořit **objednávku**!

Chcete-li vytvořit položku objednávky, odešlete požadavek POST na koncový bod /phaser-order-rows:

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

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

Zde je přehled polí, která můžete použít při vytváření položky objednávky:

- **phaser_order_id**
  - Interní ID Skyplanneru pro **objednávku,** ke které je položka objednávky připojena.
  - **Povinné pole**
- **production_planning_order_row_id**
  - Po exportu zakázky do modulu plánování výroby Skyplanneru se vytvoří samostatná entita nazvaná **řádek zakázky plánování výroby** a její id se nastaví do tohoto pole.
  - **Nedoporučuje se používat**(ponechte jako null nebo toto pole v poli požadavku vůbec neposílejte).
- **production_planning_product_id**
  - ID produktu Skyplanner pro produkt, který položka objednávky vyrábí.
  - Vyžadováno, pokud chcete přenést výchozí kroky procesu z produktu.
- **external_id**
  - Jedinečný identifikátor položky objednávky
  - Slouží k propojení položky objednávky Skyplanner s položkou objednávky z externího systému (ERP atd.).
  - **Musí být jedinečné**
- **parent_id**
  - Pokud je položka objednávky podpoložkou jiné položky objednávky, uveďte zde hodnotu id nadřazené položky.
- **row_index**
  - Kde v seznamu položek objednávky se tato položka nachází.
- **pracovní číslo**
  - Používá se pouze jako informativní hodnota pracovního čísla pro položku objednávky.
  - Není vidět v uživatelském rozhraní Skyplanneru
- **stav**
  - Stav položky objednávky
  - Přípustné hodnoty: **nový, zahájen, připraven, postupný**
- **is_archive**
  - Je položka objednávky archivována (měkce smazána).
- **pozice**
  - Hodnota identifikátoru položky objednávky (viz obr. 3.)
- **částka**
  - Celkové vyrobené množství výrobku
- **ordered_amount**
  - Objednané množství produktu
- **cena**
  - Jednotková cena výrobku
- **use_custom_materials**
  - Pokud nechcete použít výchozí nastavení materiálu z údajů o výrobku, nastavte tuto hodnotu na true.
  - Výchozí hodnota: **false**
- **use_custom_materials_calculculated**
  - Množství zakázkového materiálu se vypočítá na základě vyrobeného množství produktů.
  - Pokud je nastaveno na false, množství materiálu je pevné
  - Výchozí hodnota: **false**
- **get_default_steps**
  - Vytvoření kroků procesu pro objednání položky na základě výchozích kroků procesu produktu
  - Výchozí hodnota: **false**
- **use_calculculated_job_durations**
  - Výpočet doby trvání kroků procesu na základě minulých dat z časového záznamu
  - Pokud není k dispozici dostatek údajů pro výpočet, použijí se výchozí doby trvání.
  - Výchozí hodnota: **false**
- **sub_items**
  - Vytvořit také dílčí položky produktu, pokud jsou k dispozici
  - Výchozí hodnota: **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/modrotisku/instrukcí
- **popis**
  - Popis položky objednávky
- **additional_description**
  - Další popis položky objednávky
- **is_prospect**
  - Je položka objednávky perspektivní
  - Výchozí hodnota: **false**

#### Aktualizace položek objednávky

Chcete-li aktualizovat data položky objednávky, můžete odeslat požadavek PUT na koncový bod /phaser-order-rows:

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

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

#### Odstranění položek objednávky

Odstranění položek objednávky se provádí metodou "soft delete". Smazáním položky objednávky se její hodnota is_archive změní na true. To znamená, že smazané položky objednávek lze obnovit aktualizací hodnoty is_archive na false.

Při mazání položky objednávky systém odstraní také související kroky procesu.

Položky objednávky odstraníte odesláním požadavku DELETE na koncový bod /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Obr. 10.**Odstranění položek objednávky

Položky objednávky můžete odstranit zadáním interních id Skyplanneru v poli **"ids"** nebo externích_id v poli **"external_ids** ".