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