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:
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
- 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
- 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:
Ak chcete získať konkrétnu položku objednávky s jej interným ID Skyplanner, môžete vykonať túto požiadavku:
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:
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:
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
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:
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 “.