Siin käsitleme üksikasjalikult tellimusartiklite hankimist, loomist, uuendamist ja kustutamist.
Tellimuse elementidele pääseb juurde /phaser-order-rows lõpp-punktist.
Tellimuse esemete otsimine #
Tellimuse elemendid saadetakse GET-päringuga /phaser-order-rows lõpp-punktile:
Saate otsida tellimuse objekte erinevate parameetrite järgi:
- phaser_order_id
- Skyplanneri sisemise tellimuse id, saab leida /phaser-orders-endpoint‘ist.
- external_id
- Tellimuse kirje väline identifikaator
- Näiteks unikaalne identifikaator teie välissüsteemist (ERP jne).
- production_planning_product_id
- Skyplanneri sisemine tootetunnus
- Saab leida /products-endpoint‘ist
- parent_id
- Kui tellimuse objektil on alamobjektid (nt alltooted), siis on alamobjektidel nende vanemtellimuse objekti id väljal parent_id.
- row_index
- Tellimuse kirje indeksinumber
- töönumber
- Tellimuse kirje tööarvu väärtus
- staatus
- Tellimusartikli staatus
- Lubatud väärtused: uus, alustatud või lõpetatud
- positsioon
- Tellimuse kirje positsiooniväärtus
- delivery_date
- Tellimuse eseme tarnekuupäev
- Formaat: 2025-06-05T22:00:00+00:00
- delivery_date_condition
- Vabatahtlik tarnekuupäeva otsingu tingimus
- Valikud: >, =, <=, =, !=
- Kui väärtust ei ole antud, kasutatakse >= tingimust.
- is_prospect
- Tagastage ainult tellimuse esemed, mis on väljavaated
- include_archived
- Arhiveeritud (pehme kustutatud) tellimuse objektide kaasamine otsingusse
- Tähistatakse väärtusega is_archive
- muudetud
- Tagastab tellimuse elemendid, mida on muudetud pärast antud kuupäeva.
- Formaat: 2025-06-05T22:00:00+00:00
- modifiedCondition
- Muudetud väärtuse otsingu vabatahtlik tingimus
- Valikud: >, =, <=, =, !=
- Kui väärtust ei ole antud, kasutatakse >= tingimust.
Võite ka otsinguparameetreid segada ja sobitada, näiteks nii:
Konkreetse tellimusartikli ja selle Skyplanneri sisemise id-i saamiseks saate teha sellise päringu:
Tellimuste loomine #
Pange tähele, et enne tellimusartikli loomist peate looma tellimuse!
Tellimuse kirje loomiseks saatke POST päring /phaser-order-rows lõpp-punkti:
Siin on ülevaade väljadest, mida saate kasutada tellimusartikli loomisel:
- phaser_order_id
- Tellimuse sisemine Skyplanner id, millega tellimusartikkel on seotud.
- Kohustuslik väli
- production_planning_order_row_id
- Pärast tellimuse eksportimist Skyplanneri tootmise planeerimise moodulisse luuakse eraldi üksus nimega tootmise planeerimise tellimuse rida ja selle id määratakse sellesse väljale
- Ei soovitata kasutada (jäta nulliks või ära saadeta seda välja üldse taotluse väljal).
- production_planning_product_id
- Skyplanner toote id, mida tellimuse objekt toodab.
- Vajalik, kui soovite tuua vaikimisi protsessisammud tootest
- external_id
- Tellimuse kirje unikaalne identifikaator
- Kasutage seda, et siduda Skyplanneri tellimusartiklit oma tellimuse objektiga välissüsteemist (ERP jne).
- Peab olema ainulaadne
- parent_id
- Kui tellimusartikkel on teise tellimusartikli alamartikkel, siis tuleb siin esitada vanema id väärtus.
- row_index
- Kus asub see kirje tellimuse kirjete loetelus.
- töönumber
- Kasutatakse ainult informatiivse töönumbri väärtusena tellimusartikli jaoks.
- Skyplanneri kasutajaliideses ei ole nähtav
- staatus
- Tellimuse kirje staatus
- Lubatud väärtused: uus, alustatud, valmis, järkjärguline
- is_archive
- Kas tellimuse kirje on arhiveeritud (kustutatud).
- positsioon
- Tellimusartikli identifikaatori väärtus (vt joonis 3.)
- summa
- Toodangu toodetud üldkogus
- tellitud_summa
- Tellitud toote kogus
- hind
- Toote ühikuhind
- use_custom_materials
- Kui te ei soovi kasutada vaikimisi materjali seadistust tooteandmetest, siis seadke see väärtus true.
- Vaikimisi: false
- use_custom_materials_calculated
- Tellimusmaterjalide kogused arvutatakse valmistatud toodete koguse alusel.
- Kui see on seatud väärtuseks false, on materjali kogused fikseeritud
- Vaikimisi: false
- get_default_steps
- Looge protsessi sammud, et tellida toode, mis põhineb toote vaikimisi protsessietappidel.
- Vaikimisi: false
- use_calculated_job_durations
- Protsessi etappide kestuse arvutamine varasemate ajaregistri andmete põhjal
- Kui arvutamiseks ei ole piisavalt andmeid, kasutatakse vaikimisi kestust.
- Vaikimisi: false
- sub_items
- Looge ka toote alamartiklid, kui need on saadaval
- Vaikimisi: false
- delivery_date
- Formaat: 2022-01-01 10:30:11
- start_eligibility_date
- Formaat: 2022-01-01 10:30:11
- drawing_identifier
- Joonis/blueprint/juhiste identifikaator
- kirjeldus
- Tellimusartikli kirjeldus
- additional_description
- Täiendav kirjeldus tellimuse kirje jaoks
- is_prospect
- Kas tellimuse kirje on väljavaade
- Vaikimisi: false
Tellimuse kirjete uuendamine #
Tellimuste andmete uuendamiseks saate saata PUT päringu aadressile /phaser-order-rows (/phaser-order-rows ):
Tellimuste kustutamine #
Tellimuste kustutamine toimub “pehme kustutamise” meetodil. Tellimuse elemendi kustutamine muudab selle is_archive väärtuse true’ks. See tähendab, et kustutatud tellimuse elemendid saab taastada, uuendades is_archive väärtust false’ks.
Tellimuse kirje kustutamisel kustutab süsteem ka sellega seotud protsessietapid.
Tellimuse elemendid kustutatakse, saates DELETE päringu /phaser-order-rows lõpp-punktile:
Saate kustutada tellimuse objekte, andes Skyplanneri sisemised id-d massiivi “ids ” või välised_id-d massiivi “external_ids “.