Aici vom intra în detalii cu privire la obținerea, crearea, actualizarea și ștergerea elementelor de comandă.
Elementele de comandă pot fi accesate de la punctul final /phaser-order-rows.
Obținerea elementelor de comandă #
Obțineți elementele comenzii trimițând o cerere GET la punctul final /phaser-order-rows:
Puteți căuta elemente de comandă după o varietate de parametri diferiți:
- phaser_order_id
- ID-ul intern al comenzii Skyplanner, poate fi găsit la punctul final /phaser-orders
- ID_extern
- Identificatorul extern al articolului de comandă
- De exemplu, identificatorul unic din sistemul dvs. extern (ERP, etc.)
- ID_produs_planificare_producție
- Id intern al produsului Skyplanner
- Poate fi găsit din punctul final /products
- ID_părinte
- Dacă un articol de comandă are subarticole (de exemplu, subproduse), subarticolele au id-ul articolului de comandă părinte în câmpul parent_id
- row_index
- Numărul de index al articolului de comandă
- număr de lucru
- Valoarea numărului de lucru al articolului de comandă
- statut
- Starea articolului de comandă
- Valori permise: nou, început sau finalizat
- poziție
- Valoarea poziției elementului de comandă
- data_livrării
- Data livrării articolului din comandă
- Format: 2025-06-05T22:00:00+00:00
- Condiția_datei_de_livrare
- Condiție opțională de căutare a datei de livrare
- Opțiuni: >, =, <=, =, !=
- Dacă nu este indicată nicio valoare, se va utiliza condiția >=
- is_prospect
- Returnați numai articolele de comandă care sunt perspective
- include_archived
- Includerea elementelor de comandă arhivate (șterse soft) în căutare
- Identificat prin valoarea is_archive
- modificat
- Returnarea articolelor de comandă care au fost modificate după o anumită dată
- Format: 2025-06-05T22:00:00+00:00
- Condiție modificată
- Condiție opțională de căutare a valorii modificate
- Opțiuni: >, =, <=, =, !=
- Dacă nu este indicată nicio valoare, se va utiliza condiția >=
De asemenea, puteți combina parametrii de căutare astfel:
Pentru a prelua un anumit articol de comandă cu id-ul său intern Skyplanner, puteți efectua o cerere de genul acesta:
Crearea articolelor de comandă #
Rețineți că trebuie să creați o comandă înainte de a crea elementul de comandă!
Pentru a crea un articol de comandă, trimiteți o cerere POST la punctul final /phaser-order-rows:
Iată o prezentare generală a câmpurilor pe care le puteți utiliza la crearea unui articol de comandă:
- phaser_order_id
- Id intern Skyplanner pentru comanda la care este atașat elementul de comandă
- Câmp obligatoriu
- ID_row_ordine_de_planificare_producție
- După ce comanda este exportată în modulul de planificare a producției din Skyplanner, este creată o entitate separată numită rând de comandă de planificare a producției, iar id-ul acesteia este setat în acest câmp
- Nu se recomandă utilizarea (lăsați ca null sau nu trimiteți deloc acest câmp în câmpul de cerere)
- ID_produs_planificare_producție
- Id-ul produsului Skyplanner pentru produsul pe care îl produce elementul de comandă
- Necesar dacă doriți să aduceți pași de proces impliciți de la un produs
- ID_extern
- Identificatorul unic al articolului de comandă
- Utilizați această opțiune pentru a lega elementul de comandă Skyplanner la elementul de comandă dintr-un sistem extern (ERP etc.)
- Trebuie să fie unic
- ID_părinte
- Dacă elementul de comandă este un subelement pentru un alt element de comandă, indicați aici valoarea id a părintelui
- row_index
- Unde se află acest articol în lista de articole din comandă
- număr de lucru
- Utilizat numai ca valoare informativă a numărului de lucru pentru elementul de comandă
- Nu este vizibil în IU Skyplanner
- statut
- Starea elementului de comandă
- Valori permise: nou, început, gata, în etape
- is_archive
- Articolul de comandă este arhivat (soft deleted)
- poziție
- Valoarea identificatorului articolului de comandă (a se vedea figura 3.)
- sumă
- Cantitatea totală de produs fabricat
- suma_comandată
- Cantitatea de produs comandată
- preț
- Prețul unitar al produsului
- utilizare_materiale_personalizate
- Dacă nu doriți să utilizați configurația implicită a materialului din datele produsului, setați această valoare la true
- Implicit: false
- use_custom_materials_calculated
- Cantitățile de materiale personalizate sunt calculate pe baza cantității de produse fabricate
- Dacă este setat la fals, cantitățile de material sunt fixe
- Implicit: false
- get_default_steps
- Creați pași de proces pentru elementul de comandă pe baza pașilor de proces impliciți ai produsului
- Implicit: false
- use_calculated_job_durations
- Calcularea duratei etapelor procesului pe baza datelor din cronologul trecut
- În cazul în care nu există suficiente date disponibile pentru calcul, se utilizează duratele implicite
- Implicit: false
- sub_iteme
- Creați, de asemenea, elemente secundare ale produsului, dacă sunt disponibile
- Implicit: false
- data_livrării
- Format: 2022-01-01 10:30:11
- data de începere a eligibilității
- Format: 2022-01-01 10:30:11
- identificator_desen
- Identificator desen/albastru/instrucțiuni
- descriere
- Descrierea articolului de comandă
- suplimentare_descriere
- Descriere suplimentară pentru elementul de comandă
- is_prospect
- Articolul de comandă este un prospect
- Implicit: false
Actualizarea elementelor de comandă #
Pentru a actualiza datele articolului de comandă, puteți trimite o cerere PUT la punctul final /phaser-order-rows:
Ștergerea elementelor de comandă #
Ștergerea elementelor de comandă se realizează prin metoda “soft delete”. De fapt, ștergerea unui element de comandă îi modifică valoarea is_archive la true. Aceasta înseamnă că puteți restaura elementele de comandă șterse prin actualizarea valorii is_archive la false.
La ștergerea unui articol de comandă, sistemul va șterge și etapele de proces asociate.
Ștergeți elementele de comandă trimițând o cerere DELETE la punctul final /phaser-order-rows:
Puteți șterge elemente de comandă indicând id-urile interne Skyplanner din matricea “ids” sau external_ids din matricea “external_ids”.