--- title: Užsakyti elementus description: "Čia išsamiai aprašysime užsakymo elementų paiešką, kūrimą, atnaujinimą ir šalinimą. Užsakymo elementus galima pasiekti iš /phaser-order-rows galinio taško. #### Užsakymo elementų gavimas Užsakymo elementus galite gauti siųsdami GET užklausą į /phaser-order-rows galinį tašką: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **1 pav.** Užsakymo elementų gavimas Užsakymo…" url: "https://skyplanner.ai/lt/docs/uzsakyti-elementus/" updated: "2025-10-08" category: Integracijos tags: - API - Integracija --- # Užsakyti elementus Čia išsamiai aprašysime užsakymo elementų paiešką, kūrimą, atnaujinimą ir šalinimą. Užsakymo elementus galima pasiekti iš /phaser-order-rows galinio taško. #### Užsakymo elementų gavimas Užsakymo elementus galite gauti siųsdami GET užklausą į /phaser-order-rows galinį tašką: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **1 pav.** Užsakymo elementų gavimas Užsakymo elementų galite ieškoti pagal įvairius parametrus: - **phaser_order_id** - vidinį "Skyplanner" **užsakymo**ID galima rasti iš /phaser-orders-endpoint - **external_id** - Išorinis užsakymo elemento identifikatorius - Pavyzdžiui, unikalus išorinės sistemos (ERP ir kt.) identifikatorius. - **production_planning_product_id** - Vidinis "Skyplanner" produkto ID - Galima rasti iš /products-endpoint - **parent_id** - Jei užsakymo elementas turi subpozicijų (pvz., subproduktų), subpozicijos turi savo patronuojančio užsakymo elemento ID lauke parent_id. - **row_index** - Užsakymo elemento indeksas ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png) **2 pav.** Užsakyti elemento eilučių indeksus - **darbo numeris** - Užsakymo elemento darbo numerio reikšmė - **statusas** - Užsakymo elemento būsena - Leidžiamos reikšmės: **naujas**, **pradėtas** arba **baigtas** - **pozicija** - Užsakymo elemento pozicijos reikšmė ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png) 3 pav. Užsakymo elemento pozicijos reikšmės - **delivery_date** - Užsakymo elemento pristatymo data - Formatas: **2025-06-05T22:00:00+00:00** - **delivery_date_condition** - Neprivaloma pristatymo datos paieškos sąlyga - Parinktys: >, =, <=, =, =, != - Jei reikšmė nenurodyta, bus naudojama **>= sąlyga.** - **is_prospect** - Grąžinkite tik tuos užsakymo elementus, kurie yra perspektyvūs - **include_archived** - Įtraukti archyvuotus (švelniai ištrintus) užsakymo elementus į paiešką - Žymima reikšme **is_archive** - **modifikuotas** - Grąžinti užsakymo elementus, kurie buvo modifikuoti po nurodytos datos - Formatas: **2025-06-05T22:00:00+00:00** - **modifiedCondition** - Neprivaloma pakeistos vertės paieškos sąlyga - Parinktys: >, =, <=, =, =, != - Jei reikšmė nenurodyta, bus naudojama **>= sąlyga.** Paieškos parametrus taip pat galite derinti taip: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png) **4 pav.**Užsakymo elementų gavimas pagal **phaser_order_id**ir **row_index** Norėdami gauti konkretų užsakymo elementą su jo vidiniu "Skyplanner" ID, galite atlikti tokią užklausą: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png) **5 pav.** Užsakymo elemento su "Skyplanner" ID gavimas 4 #### Užsakymo elementų kūrimas Atkreipkite dėmesį, kad prieš kurdami **užsakymo** elementą turite sukurti **užsakymą**! Norėdami sukurti užsakymo elementą, siųskite POST užklausą į galinį tašką /phaser-order-rows: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png) **6** **pav.** Užsakymo elemento sukūrimas ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png) **7 pav.** Sukurtas užsakymo elementas Čia apžvelgiami laukai, kuriuos galite naudoti kurdami užsakymo elementą: - **phaser_order_id** - Vidinis "Skyplanner" **užsakymo,** prie kurio yra prijungtas užsakymo elementas, ID - **Privalomas laukas** - **production_planning_order_row_id** - Eksportavus užsakymą į "Skyplanner" gamybos planavimo modulį, sukuriama atskira esybė, vadinama **gamybos planavimo užsakymo eilute**, o jos ID nustatomas šiame lauke. - **Nerekomenduojama naudoti**(palikite kaip nulinį arba iš viso nesiųskite šio lauko užklausos lauke) - **production_planning_product_id** - Skyplanner produkto, kurį gamina užsakymo elementas, ID - Būtina, jei norite iš produkto perkelti numatytuosius proceso veiksmus. - **external_id** - Unikalus užsakymo elemento identifikatorius - Naudokite šią funkciją, norėdami susieti "Skyplanner" užsakymo elementą su savo užsakymo elementu iš išorinės sistemos (ERP ir kt.) - **Turi būti unikalus** - **parent_id** - Jei užsakymo elementas yra kito užsakymo elemento papunktis, čia nurodykite tėvinio elemento id reikšmę. - **row_index** - Kur užsakymo elementų sąraše yra šis elementas - **darbo numeris** - Naudojama tik kaip informacinė užsakymo elemento darbo numerio reikšmė - "Skyplanner" vartotojo sąsajoje nematomas - **statusas** - Užsakymo elemento būsena - Leidžiamos reikšmės: **naujas, pradėtas, paruoštas, palaipsniui** - **is_archive** - Ar užsakymo elementas yra archyvuotas (švelniai ištrintas) - **pozicija** - Užsakymo elemento identifikatoriaus reikšmė (žr. 3 pav.) - **suma** - Visas pagamintas produkto kiekis - **ordered_amount** - Užsakytas produkto kiekis - **kaina** - Produkto vieneto kaina - **use_custom_materials** - Jei nenorite naudoti numatytosios medžiagos sąrankos iš gaminio duomenų, nustatykite šią reikšmę į true. - Numatytoji reikšmė: **false** - **use_custom_materials_calculated** - užsakomųjų medžiagų kiekiai apskaičiuojami pagal pagamintą produktų kiekį. - Jei nustatyta false, medžiagų kiekiai yra fiksuoti - Numatytoji reikšmė: **false** - **get_default_steps** - Sukurti proceso žingsnius užsakymo elementui pagal gaminio numatytuosius proceso žingsnius - Numatytoji reikšmė: **false** - **use_calculated_job_durations** - Apskaičiuokite proceso etapų trukmę pagal ankstesnius laiko žurnalo duomenis - Jei nėra pakankamai duomenų, kad būtų galima apskaičiuoti, naudojamos numatytoji trukmė. - Numatytoji reikšmė: **false** - **sub_items** - Sukurti ir produkto subpozicijas, jei yra - Numatytoji reikšmė: **false** - **delivery_date** - Formatas: 2022-01-01 10:30:11 - **start_eligibility_date** - Formatas: 2022-01-01 10:30:11 - **piešinio_identifikatorius** - Brėžinio / mėlynojo atspaudo / instrukcijų identifikatorius - **aprašymas** - Užsakymo elemento aprašymas - **additional_description** - Papildomas užsakymo elemento aprašymas - **is_prospect** - Ar užsakymo elementas yra perspektyvus - Numatytoji reikšmė: **false** #### Užsakymo elementų atnaujinimas Norėdami atnaujinti užsakymo elemento duomenis, galite siųsti PUT užklausą į /phaser-order-rows galinį tašką: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png) **8 pav.**Užsakymo elemento atnaujinimas ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png) **9 pav.**Atnaujintas užsakymo elementas #### Užsakymo elementų šalinimas Užsakymo elementai ištrinami "minkštojo ištrynimo" būdu. Trinant užsakymo elementą, jo reikšmė **is_archive** pakeičiama į true. Tai reiškia, kad ištrintus užsakymo elementus galima atkurti atnaujinant is_archive reikšmę į false. Ištrynus užsakymo elementą, sistema taip pat ištrins susijusius proceso veiksmus. Užsakymo elementus ištrinsite siųsdami DELETE užklausą į /phaser-order-rows galinį tašką: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png) **10 pav.**Užsakymo elementų šalinimas Galite ištrinti užsakymo elementus, nurodydami vidinius "Skyplanner" ids masyve **"ids** " arba išorinius_ids masyve **"external_ids** ".