Tässä käsitellään yksityiskohtaisesti tilauserien hakemista, luomista, päivittämistä ja poistamista.
Tilauseriä voi käyttää /phaser-order-rows-päätepisteestä.
Tilauserien hakeminen #
Tilauserät haetaan lähettämällä GET-pyyntö /phaser-order-rows-päätepisteeseen:
Voit hakea tilauseriä useiden eri parametrien perusteella:
- phaser_order_id
- Skyplannerin sisäinen tilaustunnus , löytyy /phaser-orders-endpointista
- external_id
- Tilauserän ulkoinen tunniste
- Esimerkiksi ulkoisen järjestelmän (ERP jne.) yksilöllinen tunniste.
- tuotannon_suunnittelu_tuote_id
- Sisäinen Skyplanner-tuotetunnus
- Löytyy /products-päätepisteestä.
- parent_id
- Jos tilauserällä on alaeriä (esim. alatuotteita), alaerillä on vanhemman tilauserän id kentässä parent_id.
- row_index
- Tilauserän indeksinumero
- työnumero
- Tilauserän työnumeron arvo
- tila
- Tilauserän tila
- Sallitut arvot: uusi, aloitettu tai valmistunut.
- asema
- Tilauserän sijaintiarvo
- toimituspäivä
- Tilauserän toimituspäivä
- Formaatti: 2025-06-05T22:00:00+00:00
- toimituspäivä_ehto
- Valinnainen toimituspäivähakuehto
- Vaihtoehdot: >, =, <=, =, =, !=
- Jos arvoa ei ole annettu, käytetään >= ehtoa.
- is_prospect
- Palauta vain tilauserät, jotka ovat tulevaisuudennäkymiä
- include_archived
- Arkistoitujen (pehmeästi poistettujen) tilauserien sisällyttäminen noutoon
- Merkitään is_archive-arvolla
- muutettu
- Palauta tilauserät, joita on muutettu tietyn päivämäärän jälkeen.
- Formaatti: 2025-06-05T22:00:00+00:00
- modifiedCondition
- Muutetun arvon haun valinnainen ehto
- Vaihtoehdot: >, =, <=, =, =, !=
- Jos arvoa ei ole annettu, käytetään >= ehtoa.
Voit myös yhdistellä hakuparametreja seuraavasti:
Voit hakea tietyn tilauserän ja sen sisäisen Skyplanner-tunnuksen seuraavasti:
Tilauserien luominen #
Huomaa, että sinun on luotava tilaus ennen tilauserän luomista!
Luodaksesi tilauserän lähetä POST-pyyntö /phaser-order-rows-päätepisteeseen:
Tässä on yleiskatsaus kenttiin, joita voit käyttää tilauserää luodessasi:
- phaser_order_id
- Tilauksen sisäinen Skyplanner-tunnus, johon tilauserä on liitetty.
- Pakollinen kenttä
- tuotannon_suunnittelu_tilaus_rivi_id
- Kun tilaus on viety Skyplannerin tuotantosuunnittelumoduuliin, luodaan erillinen kokonaisuus nimeltä tuotantosuunnittelutilausrivi ja sen id asetetaan tähän kenttään.
- Ei suositella käytettäväksi (jätä nollaksi tai älä lähetä tätä kenttää lainkaan pyynnön kentässä).
- tuotannon_suunnittelu_tuote_id
- Skyplanner-tuotetunniste tuotteelle, jota tilauserä tuottaa.
- Vaaditaan, jos haluat tuoda oletusarvoiset prosessin vaiheet tuotteesta.
- external_id
- Tilauserän yksilöllinen tunniste
- Käytä tätä linkittääksesi Skyplanner-tilauserän ulkoisen järjestelmän (ERP jne.) tilauserään.
- On oltava ainutlaatuinen
- parent_id
- Jos tilauserä on toisen tilauserän alaerä, anna tässä vanhemman id-arvo.
- row_index
- Missä kohtaa tilauksen nimikkeiden luetteloa tämä nimike sijaitsee tilauksessa.
- työnumero
- Käytetään ainoastaan tilauserän informatiivisena työnumeroarvona.
- Ei näy Skyplannerin käyttöliittymässä
- tila
- Tilauserän tila
- Sallitut arvot: uusi, aloitettu, valmis, vaiheittainen
- is_archive
- Onko tilauserä arkistoitu (pehmeästi poistettu)?
- asema
- Tilauserän tunnisteen arvo (ks. kuva 3).
- määrä
- Tuotteen valmistettu kokonaismäärä
- tilattu_määrä
- Tuotteen tilattu määrä
- hinta
- Tuotteen yksikköhinta
- use_custom_materials
- Jos et halua käyttää tuotetiedoissa olevaa oletusmateriaaliasetusta, aseta tämä arvo arvoksi true.
- Oletus: false
- use_custom_materials_calculated (käytä_asiallisia_materiaaleja_laskettuna)
- Mukautetut materiaalimäärät lasketaan valmistettujen tuotteiden määrän perusteella.
- Jos arvoksi asetetaan false, materiaalimäärät ovat kiinteitä
- Oletus: false
- get_default_steps
- Luo prosessivaiheet tilauserän tilaamiseen tuotteen oletusprosessivaiheiden perusteella.
- Oletus: false
- use_calculated_job_durations (käytä_laskettuja_työn kestoja)
- Prosessivaiheen keston laskeminen aiempien aikapäiväkirjatietojen perusteella.
- Jos tietoja ei ole saatavilla riittävästi laskentaa varten, käytetään oletusarvoisia kestoja.
- Oletus: false
- sub_items
- Luo myös tuotteen alatuotteet, jos niitä on saatavilla
- Oletus: false
- toimituspäivä
- Formaatti: 2022-01-01 10:30:11
- alku_kelpoisuus_päivämäärä
- Formaatti: 2022-01-01 10:30:11
- drawing_identifier
- Piirustuksen/sinipainatuksen/ohjeiden tunniste
- kuvaus
- Tilauserän kuvaus
- additional_description
- Tilauksen kohteen lisäkuvaus
- is_prospect
- Onko tilauserä prospekti
- Oletus: false
Tilauserien päivittäminen #
Voit päivittää tilauserien tietoja lähettämällä PUT-pyynnön /phaser-order-rows-loppupisteeseen:
Tilauserien poistaminen #
Tilauserien poistaminen tapahtuu “pehmeällä poistomenetelmällä”. Tilauserän poistaminen muuttaa sen
Kun tilauserä poistetaan, järjestelmä poistaa myös siihen liittyvät prosessivaiheet.
Poistat tilauseriä lähettämällä DELETE-pyynnön /phaser-order-rows-päätepisteeseen:
Voit poistaa tilauskohteita antamalla Skyplannerin sisäiset tunnukset sarjassa “ids ” tai ulkoiset tunnukset sarjassa “external_ids “.