---
title: Creare un ordine
description: "Qui trovi una guida completa su come creare un ordine in Skyplanner con tutti i dati correlati. Alcuni di questi aspetti sono già stati trattati nel [tutorial](https://skyplanner.ai/lt/docs/integravimo-pamoka/) sull'integrazione, ma qui analizziamo la struttura dei dati di Skyplanner e il processo…"
url: "https://skyplanner.ai/it/docs/creare-un-ordine/"
updated: "2025-10-07"
category: Integrazioni
tags:
  - API
  - Integrazione
---

# Creare un ordine

Qui trovi una guida completa su come creare un ordine in Skyplanner con tutti i dati correlati. Alcuni di questi aspetti sono già stati trattati nel [tutorial](https://skyplanner.ai/lt/docs/integravimo-pamoka/) sull'integrazione, ma qui analizziamo la struttura dei dati di Skyplanner e il processo di integrazione in modo più dettagliato.

#### Struttura dei dati

Per prima cosa vedremo come è strutturato un ordine di Skyplanner. I [punti API](https://integration.skyplanner.app/api/swagger) per le entità di dati citate sono evidenziati come segue: /phaser-ordini

Al livello superiore abbiamo l'**ordine**(/phaser-orders)

Ogni **ordine** *deve*avere un **cliente**(/clienti).

Ogni **ordine** può avere più **voci d'ordine**(/phaser-order-rows)

Ogni **articolo-ordine** *può avere* un **prodotto**(/products) collegato, ma non è obbligatorio. Ogni prodotto ha uno stock(/saldos). Si noti che l'entità stock viene creata automaticamente quando si crea un prodotto con l'API.

Ogni **articolo-ordine** può avere più **lavori** (alias fasi del processo)(/phaser-jobs).

Ogni **lavoro** *deve*avere una **fase di lavoro**(/workstages).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Fig. 1** Struttura dell'ordine e dei dati correlati

#### Flusso di lavoro dell'integrazione

Ecco un esempio passo dopo passo di come potresti strutturare l'integrazione tra il tuo sistema ERP e Skyplanner.

1. Recupera le vendite/ordini di lavoro dall'ERP
2. Crea un **cliente**(ottieni l'id del cliente nella risposta)
3. Crea **un ordine** con l'id del cliente (ottieni l'id dell'ordine nella risposta)
4. Recupera i dati degli ordini di vendita/lavoro dall'ERP
5. Crea un **prodotto** (ottieni l'id del prodotto nella risposta)
6. Crea **l'articolo dell'ordine** con l'id dell'ordine e altri dati (ottieni l'id dell'articolo dell'ordine nella risposta)
7. Recupera i dati delle fasi del processo dall'ERP
8. Crea un **workstage** (ottieni l'id del workstage nella risposta)
9. Crea un **lavoro** con l'id del workstage e altri dati

#### Consigli extra

##### Per l'eliminazione

L'eliminazione di phaser-ordini, phaser-ordini-item o phaser-lavori attraverso l'API (e dall'interfaccia utente) avviene in maniera *soft delete*. Ciò significa che i dati non vengono effettivamente cancellati dal database, ma vengono contrassegnati come *archiviati*. In effetti, l'attributo **is_archive** dell'entità viene impostato su true quando viene eliminata. Le entità archiviate/cancellate sono comunque accessibili con l'API utilizzando il parametro include_archived. Quando include_archived=true, una richiesta GET recupera l'entità anche se è archiviata.

**Tieni presente che la cancellazione morbida non è disponibile in tutti gli endpoint API! Quindi devi fare attenzione perché l'eliminazione, ad esempio, di clienti, persone ecc. è permanente!**

##### Utilizza le fasi di processo predefinite per il tuo ordine

Se hai creato delle fasi di processo predefinite per il prodotto che l'articolo d'ordine sta producendo, puoi dire al sistema di inserire i valori predefiniti nell'articolo d'ordine tramite l'API utilizzando l'attributo **get_default_steps**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Figura 2.** Creazione di un nuovo ordine con fasi di processo predefinite

##### Aggiunta di materiali all'ordine

Se hai allegato dei materiali al prodotto realizzato, questi vengono automaticamente allegati alla riga dell'ordine.

Tuttavia, se non vuoi utilizzare i materiali allegati al prodotto (ad esempio, se l'articolo è un ordine speciale e vuoi utilizzare materiali diversi) puoi utilizzare l'attributo **use_custom_materials**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Figura 3.** Creazione di un articolo d'ordine senza utilizzare i materiali predefiniti