Č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ą:
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
- 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ė
- 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:
Norėdami gauti konkretų užsakymo elementą su jo vidiniu “Skyplanner” ID, galite atlikti tokią užklausą:
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:
Č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ą:
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ą:
Galite ištrinti užsakymo elementus, nurodydami vidinius “Skyplanner” ids masyve “ids ” arba išorinius_ids masyve “external_ids “.