Predmeti za naročilo

V tem poglavju podrobno opisujemo pridobivanje, ustvarjanje, posodabljanje in brisanje elementov naročila.

Do elementov naročila lahko dostopate prek končne točke /phaser-order-rows.

Pridobivanje elementov naročila #

Elemente naročila pridobite tako, da pošljete zahtevo GET na končno točko /phaser-order-rows:

Predmete naročila lahko iščete po različnih parametrih:

• phaser_order_id
  • notranji ID naročila Skyplannerja, ki ga je mogoče najti na končni točki /phaser-orders-endpoint
• external_id
  • Zunanji identifikator elementa naročila
  • Na primer edinstven identifikator iz zunanjega sistema (ERP itd.).
• production_planning_product_id
  • Notranji ID izdelka Skyplanner
  • Najdete ga v končni točki /products-endpoint
• parent_id
  • Če ima postavka naročila podpostavke (npr. podpostavke izdelkov), imajo podpostavke v polju parent_id id svoje nadrejene postavke naročila.
• row_index
  • Indeksna številka elementa naročila

• številka dela
  • Vrednost delovne številke elementa naročila
• status
  • Stanje postavke naročila
  • Dovoljene vrednosti: novo, začeto ali dokončano
• položaj
  • Vrednost položaja elementa naročila

• delivery_date
  • Datum dostave elementa naročila
  • Format: 2025-06-05T22:00:00+00:00
• delivery_date_condition
  • Neobvezni pogoj iskanja datuma dostave
  • Možnosti: >, =, <=, =, =, !=
  • Če vrednost ni navedena, se uporabi pogoj >=.
• is_prospect
  • Vrnite samo predmete naročila, ki so perspektivi
• vključi_arhivirano
  • Vključitev arhiviranih (mehko izbrisanih) elementov naročila v prevzem
  • Označuje ga vrednost is_archive
• spremenjeno
  • Vrnite elemente naročila, ki so bili spremenjeni po danem datumu
  • Format: 2025-06-05T22:00:00+00:00
• modifiedCondition
  • Neobvezni pogoj za iskanje spremenjene vrednosti
  • Možnosti: >, =, <=, =, =, !=
  • Če vrednost ni navedena, se uporabi pogoj >=.

Parametre iskanja lahko tudi mešate in prilagajate, kot sledi:

Če želite pridobiti določen element naročila z njegovim notranjim ID Skyplannerja, lahko zahtevate takole:

Ustvarjanje elementov naročila #

Upoštevajte, da morate ustvariti naročilo, preden ustvarite element naročila!

Če želite ustvariti element naročila, pošljite zahtevo POST na končno točko /phaser-order-rows:

Tukaj je pregled polj, ki jih lahko uporabite pri ustvarjanju elementa naročila:

• phaser_order_id
  • Notranji ID Skyplannerja za naročilo, ki mu je element naročila priložen.
  • Obvezno polje
• production_planning_order_row_id
  • Ko je naročilo izvoženo v modul Skyplanner za načrtovanje proizvodnje, se ustvari ločena entiteta, imenovana vrstica naročila za načrtovanje proizvodnje, njen id pa se nastavi v to polje.
  • Ni priporočljivo uporabljati (pustite kot nič ali tega polja sploh ne pošiljajte v polju zahteve)
• production_planning_product_id
  • Id izdelka Skyplanner za izdelek, ki ga proizvaja element naročila
  • obvezno, če želite iz izdelka prenesti privzete korake postopka.
• external_id
  • Enolični identifikator elementa naročila
  • Uporabite jo za povezavo elementa naročila Skyplanner z vašim elementom naročila iz zunanjega sistema (ERP itd.)
  • Biti mora edinstven.
• parent_id
  • Če je postavka naročila podpostavka za drugo postavko naročila, tukaj navedite vrednost id nadrejene postavke.
• row_index
  • Kje na seznamu elementov naročila v naročilu se nahaja ta element
• številka dela
  • Uporablja se samo kot informativna vrednost delovne številke za element naročila.
  • Ni vidno v uporabniškem vmesniku Skyplannerja
• status
  • Status elementa naročila
  • Dovoljene vrednosti: novo, začeto, pripravljeno, postopno
• is_archive
  • Ali je element naročila arhiviran (mehko izbrisan)
• položaj
  • Vrednost identifikatorja elementa naročila (glejte sliko 3)
• znesek
  • Skupna proizvedena količina izdelka
• ordered_amount
  • Naročena količina izdelka
• cena
  • Cena na enoto izdelka
• use_custom_materials
  • Če ne želite uporabiti privzete nastavitve materiala iz podatkov o izdelku, nastavite to vrednost na true.
  • Privzeto: false
• use_custom_materials_calculculated
  • Količine materiala po meri se izračunajo na podlagi proizvedene količine izdelkov.
  • Če je nastavljena na false, so količine materiala fiksne.
  • Privzeto: false
• get_default_steps
  • Ustvarite korake postopka za element naročila na podlagi privzetih korakov postopka izdelka
  • Privzeto: false
• use_calculculated_job_durations
  • Izračun trajanja korakov procesa na podlagi preteklih podatkov časovnega dnevnika
  • Če ni na voljo dovolj podatkov za izračun, se uporabijo privzeta trajanja.
  • Privzeto: false
• sub_items
  • Ustvarite tudi podpostavke izdelka, če so na voljo
  • Privzeto: false
• delivery_date
  • Format: 2022-01-01 10:30:11
• start_eligibility_date
  • Format: 2022-01-01 10:30:11
• identifikator risbe
  • Identifikator risbe/sijotiska/navodil
• opis
  • Opis elementa naročila
• additional_description
  • Dodaten opis za element naročila
• is_prospect
  • Ali je element naročila perspektivni
  • Privzeto: false

Posodabljanje elementov naročila #

Če želite posodobiti podatke o postavki naročila, lahko pošljete zahtevo PUT na končno točko /phaser-order-rows:

Brisanje elementov naročila #

Brisanje elementov naročila se izvede na način “mehkega brisanja”. Pri brisanju elementa naročila se njegova vrednost is_archive spremeni v true. To pomeni, da lahko izbrisane elemente naročila obnovite tako, da posodobite vrednost is_archive na false.

Pri brisanju elementa naročila sistem izbriše tudi povezane korake postopka.

Elemente naročila izbrišete tako, da pošljete zahtevek DELETE končni točki /phaser-order-rows:

Elemente naročila lahko izbrišete tako, da v polju “ids” navedete notranje ID programa Skyplanner ali zunanje_id v polju “external_ids “.