---
title: Crearea unei comenzi
description: "Aici puteți găsi un ghid complet despre cum să creați o comandă în Skyplanner cu toate datele aferente. O parte din aceste aspecte au fost abordate în [tutorialul](https://skyplanner.ai/es/docs/tutorial-de-integracion/) de integrare, dar aici vom trece în revistă structura datelor Skyplanner și…"
url: "https://skyplanner.ai/ro/docs/crearea-unei-comenzi/"
updated: "2025-10-07"
category: Integrări
tags:
  - API
  - Integrare
---

# Crearea unei comenzi

Aici puteți găsi un ghid complet despre cum să creați o comandă în Skyplanner cu toate datele aferente. O parte din aceste aspecte au fost abordate în [tutorialul](https://skyplanner.ai/es/docs/tutorial-de-integracion/) de integrare, dar aici vom trece în revistă structura datelor Skyplanner și procesul de integrare în detaliu.

#### Structura datelor

În primul rând, vom trece în revistă modul în care este structurată o comandă Skyplanner. [API-endpoint-urile](https://integration.skyplanner.app/api/swagger) pentru entitățile de date menționate aici sunt evidențiate astfel: /phaser-orders

La nivelul superior avem **comanda**(/phaser-orders)

Fiecare **comandă** *trebuie să*aibă un **client**(/customers).

Fiecare **comandă** poate avea mai multe **articole de comandă**(/phaser-order-rows)

Fiecare **articol de comandă** *poate* avea atașat un **produs**(/products), dar nu este obligatoriu. Fiecare **produs** are un **stoc**(/saldos). Rețineți că entitatea stoc este creată automat atunci când un produs este creat cu API.

Fiecare **articol de comandă** poate avea mai multe **sarcini** (aka etape de proces)(/phaser-jobs).

Fiecare **sarcină** *trebuie să*aibă o **etapă de lucru**(/workstages).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Fig. 1** Structura comenzii și a datelor aferente

#### Fluxul de lucru al integrării

Iată un exemplu pas cu pas al modului în care ați putea structura integrarea de la sistemul ERP la Skyplanner.

1. Preluarea vânzărilor/ordinelor de lucru din ERP
2. Crearea **clientului**(obțineți id-ul clientului în răspuns)
3. Crearea **unei comenzi** cu id-ul clientului (obținerea id-ului comenzii în răspuns)
4. Preluarea datelor referitoare la articolele din comenzile de vânzări/ordine de lucru din ERP
5. Creați **produsul** (obțineți id-ul produsului în răspuns)
6. Creați **un articol de comandă** cu id-ul comenzii și alte date (obțineți id-ul articolului de comandă în răspuns)
7. Preluarea datelor privind etapele procesului din ERP
8. Crearea **etapei de lucru** (obțineți id-ul etapei de lucru în răspuns)
9. Crearea unui **job** cu id-ul etapei de lucru și alte date

#### Sfaturi suplimentare

##### La ștergere

Ștergerea comenzilor phaser, a articolelor de comandă phaser sau a lucrărilor phaser prin API (și din interfața de utilizator) se face într-o manieră *soft delete*. Aceasta înseamnă că datele nu sunt șterse efectiv din baza de date, ci sunt marcate ca fiind *arhivate*. De fapt, atributul **is_archive** al entității este setat la true atunci când este șters. Entitățile arhivate/șterse pot fi în continuare accesate prin API utilizând parametrul **include_archived**. Atunci când include_archived=true, o solicitare GET va prelua entitatea chiar dacă aceasta este arhivată.

**Rețineți că ștergerea ușoară nu este disponibilă în fiecare punct final API! Prin urmare, trebuie să fiți atenți, deoarece ștergerea, de exemplu, a clienților, persoanelor etc. este permanentă!**

##### Utilizarea etapelor de proces prestabilite pentru elementul dvs. de comandă

Dacă ați creat niște pași de proces impliciți pentru produsul pe care îl produce articolul dvs. de comandă, puteți spune sistemului să aducă valorile implicite la articolul de comandă cu ajutorul API, utilizând atributul **get_default_steps**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Fig 2.** Crearea unui nou articol de comandă cu pași de proces impliciți

##### Adăugarea de materiale la elementul de comandă

Dacă ați atașat materiale la produsul produs, acestea sunt atașate automat la rândul de comandă.

Cu toate acestea, dacă nu doriți să utilizați materialele atașate produsului (de exemplu, dacă articolul este o comandă specială și doriți să utilizați materiale diferite etc.), puteți utiliza atributul **use_custom_materials**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Fig 3.** Crearea unui articol de comandă fără utilizarea materialelor implicite