Šeit mēs sīkāk aprakstīsim pasūtījumu elementu iegūšanu, izveidi, atjaunināšanu un dzēšanu.
Pasūtījuma vienībām var piekļūt no galapunkta /phaser-order-rows.
Pasūtījuma elementu iegūšana #
Pasūtījuma vienumus varat iegūt, nosūtot GET pieprasījumu uz galapunktu /phaser-order-rows:
Pasūtījuma vienumus var meklēt pēc dažādiem parametriem:
- phaser_order_id
- iekšējo Skyplanner pasūtījuma id, ko var atrast no /phaser-orders-endpoint.
- external_id
- Pasūtījuma vienības ārējais identifikators
- Piemēram, ārējās sistēmas (ERP u. c.) unikālais identifikators.
- production_planning_product_id
- Iekšējais Skyplanner produkta id
- Var atrast no /products-endpoint
- parent_id
- Ja pasūtījuma vienībai ir apakšpozīcijas (piemēram, apakšprodukti), apakšpozīcijām laukā parent_id ir norādīts to vecākās pasūtījuma pozīcijas id.
- row_index
- Pasūtījuma pozīcijas indeksa numurs
- darba numurs
- Pasūtījuma vienības darba numura vērtība
- statuss
- Pasūtījuma pozīcijas statuss
- Atļautās vērtības: jauns, sākts vai pabeigts
- pozīcija
- Pasūtījuma vienības pozīcijas vērtība
- delivery_date
- Pasūtījuma vienības piegādes datums
- Formāts: 2025-06-05T22:00:00+00:00
- delivery_date_condition
- Piegādes datuma meklēšanas izvēles nosacījums
- Iespējas: >, =, <=, =, =, !=
- Ja vērtība nav norādīta, tiks izmantots >= nosacījums.
- is_prospect
- Atgrieziet tikai tos pasūtījuma priekšmetus, kas ir perspektīvi
- include_archived
- Arhivēto (mīksti dzēsto) pasūtījumu elementu iekļaušana atlasē
- Apzīmē ar is_archive vērtību
- modificēts
- Atgriezt pasūtījuma vienumus, kas modificēti pēc norādītā datuma
- Formāts: 2025-06-05T22:00:00+00:00
- modifiedCondition
- Izvēles nosacījums modificētu vērtību meklēšanai
- Iespējas: >, =, <=, =, =, !=
- Ja vērtība nav norādīta, tiks izmantots >= nosacījums.
Varat arī kombinēt un saskaņot meklēšanas parametrus, piemēram, šādi:
Lai iegūtu konkrētu pasūtījuma elementu ar tā iekšējo Skyplanner id, varat veikt šādu pieprasījumu:
Pasūtījuma elementu izveide #
Ņemiet vērā, ka pirms pasūtījuma vienuma izveides ir jāizveido pasūtījums!
Lai izveidotu pasūtījuma elementu, nosūtiet POST pieprasījumu uz galapunktu /phaser-order-rows:
Šeit ir sniegts pārskats par laukiem, kurus varat izmantot, veidojot pasūtījuma vienumu:
- phaser_order_id
- Iekšējais Skyplanner id pasūtījumam, kuram ir pievienots pasūtījuma vienums.
- Obligātais lauks
- production_planning_order_row_id
- Pēc pasūtījuma eksportēšanas uz Skyplanner ražošanas plānošanas moduli tiek izveidota atsevišķa vienība, ko sauc par ražošanas plānošanas pasūtījuma rindu, un tās id tiek iestatīts šajā laukā.
- Nav ieteicams izmantot (atstājiet kā nulli vai vispār nesūtiet šo lauku pieprasījuma laukā).
- production_planning_product_id
- Skyplanner produkta ID produktam, ko ražo pasūtījuma vienība.
- Nepieciešams, ja vēlaties izmantot noklusējuma procesa soļus no produkta.
- external_id
- Pasūtījuma vienības unikālais identifikators
- Izmantojiet šo vienumu, lai savienotu Skyplanner pasūtījuma vienumu ar ārējās sistēmas (ERP u. c.) pasūtījuma vienumu.
- Jābūt unikālam
- parent_id
- Ja pasūtījuma vienība ir citas pasūtījuma vienības apakšpozīcija, šeit norādiet vecākās vienības id vērtību.
- row_index
- Kur pasūtījuma vienību sarakstā atrodas šī vienība.
- darba numurs
- Izmanto tikai kā informatīvu darba numura vērtību pasūtījuma vienībai.
- Nav redzams Skyplanner UI
- statuss
- Pasūtījuma vienības statuss
- Atļautās vērtības: jauns, sākts, gatavs, pakāpeniski
- is_archive
- Vai pasūtījuma vienība ir arhivēta (viegli dzēsta)
- pozīcija
- Pasūtījuma pozīcijas identifikatora vērtība (skatīt 3. attēlu).
- summa
- Kopējais saražotais produkta daudzums
- ordered_amount
- Pasūtītais produkta daudzums
- cena
- Produkta vienības cena
- use_custom_materials
- Ja nevēlaties izmantot noklusējuma materiālu iestatījumu no produkta datiem, iestatiet šo vērtību uz true.
- Noklusējuma iestatījums: false
- use_custom_materials_calculculated
- Custom materiālu daudzumi tiek aprēķināti, pamatojoties uz saražoto produktu daudzumu.
- Ja iestatīts uz false, materiālu daudzumi ir fiksēti
- Noklusējuma iestatījums: false
- get_default_steps
- Procesa soļu izveide, lai pasūtītu preci, pamatojoties uz produkta noklusējuma procesa soļiem.
- Noklusējuma iestatījums: false
- use_calculated_job_durations
- Aprēķināt procesa posmu ilgumu, pamatojoties uz iepriekšējiem laika reģistra datiem.
- Ja nav pieejami pietiekami daudz datu, lai aprēķinātu, tiek izmantoti noklusējuma ilgumi.
- Noklusējuma iestatījums: false
- sub_items
- Izveidot arī produkta apakšpozīcijas, ja tādas ir pieejamas
- Noklusējuma iestatījums: false
- delivery_date
- Formāts: 2022-01-01 10:30:11
- start_eligibility_date
- Formāts: 2022-01-01 10:30:11
- drawing_identifier
- Zīmējums/zīmējums/instrukciju identifikators
- apraksts
- Pasūtījuma pozīcijas apraksts
- additional_description
- Pasūtījuma pozīcijas papildu apraksts
- is_prospect
- Vai pasūtījuma vienība ir perspektīva
- Noklusējuma iestatījums: false
Pasūtījuma elementu atjaunināšana #
Lai atjauninātu pasūtījuma elementu datus, varat nosūtīt PUT pieprasījumu uz /phaser-order-rows galapunktu:
Pasūtījuma vienību dzēšana #
Pasūtījuma elementu dzēšana tiek veikta, izmantojot “maigās dzēšanas” metodi. Faktiski, dzēšot pasūtījuma elementu, tā is_archive vērtība tiek mainīta uz true. Tas nozīmē, ka var atjaunot izdzēstos pasūtījuma vienumus, atjauninot is_archive vērtību uz false.
Dzēšot pasūtījuma vienību, sistēma dzēsīs arī saistītos procesa soļus.
Pasūtījuma vienumus var dzēst, nosūtot DELETE pieprasījumu uz /phaser-order-rows galapunktu:
Jūs varat dzēst pasūtījuma vienumus, norādot iekšējos Skyplanner id masīvā “ids ” vai ārējos_id masīvā “external_ids “.