--- title: Articole de comandă description: "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…" url: "https://skyplanner.ai/ro/docs/articole-de-comanda/" updated: "2025-10-08" category: Integrări tags: - API - Integrare --- # Articole de comandă 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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Fig 1.** Obținerea elementelor de comandă 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ă ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png) **Fig 2.** Ordonați indicii de rând ai articolului - **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ă ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png) Fig. 3. Valorile poziției articolului 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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png) **Fig 4.**Preluarea elementelor de comandă **după phaser_order_id**și **row_index** Pentru a prelua un anumit articol de comandă cu id-ul său intern Skyplanner, puteți efectua o cerere de genul acesta: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png) **Fig 5.** Obținerea unui articol de comandă cu ID-ul Skyplanner 4 #### 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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png) **Fig** **. 6.** Crearea unui articol de comandă ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png) **Fig 7.** Articolul de comandă creat 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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png) **Fig 8.**Actualizarea unui articol de comandă ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png) **Fig 9.**Articolul de comandă actualizat #### Ș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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png) **Fig 10.**Ștergerea elementelor de comandă Puteți șterge elemente de comandă indicând id-urile interne Skyplanner din matricea **"ids"** sau external_ids din matricea **"external_ids"**.