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:

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

• 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

• 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:

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

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:

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:

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:

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 „.