---
title: Ordina gli articoli
description: "In questa sezione analizziamo nel dettaglio la ricerca, la creazione, l'aggiornamento e l'eliminazione degli articoli dell'ordine. Gli articoli dell'ordine sono accessibili dall'endpoint /phaser-order-rows. #### Recuperare gli articoli dell'ordine Puoi recuperare gli articoli dell'ordine inviando una richiesta GET all'endpoint /phaser-order-rows: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)…"
url: "https://skyplanner.ai/it/docs/ordina-gli-articoli/"
updated: "2025-10-08"
category: Integrazioni
tags:
  - API
  - Integrazione
---

# Ordina gli articoli

In questa sezione analizziamo nel dettaglio la ricerca, la creazione, l'aggiornamento e l'eliminazione degli articoli dell'ordine.

Gli articoli dell'ordine sono accessibili dall'endpoint /phaser-order-rows.

#### Recuperare gli articoli dell'ordine

Puoi recuperare gli articoli dell'ordine inviando una richiesta GET all'endpoint /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Figura 1.** Recuperare gli articoli dell'ordine

Puoi cercare gli articoli dell'ordine in base a una serie di parametri diversi:

- **phaser_order_id**
  - l'id interno dell **'ordine**di Skyplanner, può essere trovato dal punto finale /phaser-orders
- **ID esterno**
  - Identificatore esterno dell'ordine
  - Ad esempio l'identificativo univoco del sistema esterno (ERP, ecc.).
- **ID_prodotto_di_pianificazione_di_produzione**
  - ID prodotto Skyplanner interno
  - Può essere trovato dal punto /products-endpoint
- **genitore_id**
  - Se un articolo dell'ordine ha delle sottovoci (ad esempio i sottoprodotti), le sottovoci hanno l'id dell'articolo dell'ordine padre nel campo parent_id.
- **indice_riga**
  - Numero di indice dell'articolo dell'ordine

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Figura 2.** Ordina gli indici delle righe degli articoli

- **numero di lavoro**
  - Il valore del numero di lavoro dell'articolo dell'ordine
- **stato**
  - Stato dell'ordine
  - Valori ammessi: **nuovo**, **iniziato** o **completato**
- **posizione**
  - Il valore della posizione dell'articolo dell'ordine

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Figura 3. Valori di posizione degli articoli dell'ordine

- **data_di_consegna**
  - La data di consegna dell'ordine
  - Formato: **2025-06-05T22:00:00+00:00**
- **data_di_consegna_condizione**
  - Condizione opzionale di ricerca della data di consegna
  - Opzioni: >, =, <=, =, !=
  - Se non viene indicato alcun valore, verrà utilizzata la condizione **>=.**
- **is_prospect**
  - Restituisci solo gli articoli dell'ordine che sono previsti
- **include_archiviato**
  - Includi gli ordini archiviati (cancellati) nel fetch
  - Indicato dal valore **is_archive**
- **modificato**
  - Restituisci gli articoli dell'ordine che sono stati modificati dopo una determinata data
  - Formato: **2025-06-05T22:00:00+00:00**
- **condizione modificata**
  - Condizione opzionale di ricerca del valore modificato
  - Opzioni: >, =, <=, =, !=
  - Se non viene indicato alcun valore, verrà utilizzata la condizione **>=.**

Puoi anche combinare i parametri di ricerca in questo modo:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Figura 4.**Recupero degli articoli dell'ordine in base a **phaser_order_id**e **row_index**

Per recuperare un ordine specifico con il suo id interno di Skyplanner puoi fare una richiesta come questa:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Figura 5.** Recuperare un articolo dell'ordine con l'id Skyplanner 4

#### Creazione di articoli d'ordine

Tieni presente che devi creare un **ordine** prima di creare l'articolo d'ordine!

Per creare un ordine invia una richiesta POST all'endpoint /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Figura** **6.** Creazione di un ordine

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Figura 7.** Articolo d'ordine creato

Ecco una panoramica dei campi che puoi utilizzare quando crei un ordine:

- **phaser_order_id**
  - Id interno di Skyplanner per l'**ordine** a cui l'articolo è collegato
  - **Campo obbligatorio**
- **riga_ordine_di_pianificazione_di_produzione**
  - Dopo che l'ordine è stato esportato nel modulo di pianificazione della produzione di Skyplanner, viene creata un'entità separata, chiamata **riga** dell'**ordine di pianificazione della produzione**, il cui id è impostato in questo campo.
  - **Non è consigliato l'uso**(lasciare null o non inviare affatto questo campo nel campo della richiesta)
- **ID_prodotto_di_pianificazione_di_produzione**
  - ID prodotto Skyplanner per il prodotto che l'ordine sta producendo
  - Richiesto se si desidera portare le fasi di processo predefinite da un prodotto
- **ID esterno**
  - Identificatore univoco dell'ordine
  - Utilizza questa funzione per collegare l'articolo d'ordine di Skyplanner all'articolo d'ordine di un sistema esterno (ERP, ecc.).
  - **Deve essere unico**
- **genitore_id**
  - Se l'articolo dell'ordine è una sottovoce di un altro articolo dell'ordine, indica il valore id del genitore.
- **indice_riga**
  - In quale punto dell'elenco di articoli dell'ordine si trova questo articolo
- **numero di lavoro**
  - Viene utilizzato solo come valore informativo del numero di lavoro per l'articolo dell'ordine.
  - Non visibile nell'interfaccia utente di Skyplanner
- **stato**
  - Stato dell'ordine
  - Valori consentiti: **nuovo, iniziato, pronto, in fase**
- **is_archive**
  - L'articolo dell'ordine è stato archiviato (cancellato)?
- **posizione**
  - Valore dell'identificativo dell'articolo dell'ordine (vedi Fig. 3)
- **importo**
  - Quantità totale di prodotto fabbricato
- **importo ordinato**
  - Quantità di prodotto ordinata
- **prezzo**
  - Prezzo unitario del prodotto
- **usa_materiali_personalizzati**
  - Se non vuoi utilizzare l'impostazione predefinita del materiale dai dati del prodotto, imposta questo valore su true.
  - Predefinito: **false**
- **usa_materiali_personalizzati_calcolati**
  - Le quantità di materiale personalizzato sono calcolate in base alla quantità di prodotti fabbricati.
  - Se impostato su false, le quantità di materiale sono fisse
  - Predefinito: **false**
- **get_default_steps**
  - Crea le fasi del processo per ordinare un articolo in base alle fasi del processo predefinite del prodotto.
  - Predefinito: **false**
- **use_calculated_job_durations**
  - Calcolare le durate delle fasi del processo in base ai dati del timelog passato
  - Se non sono disponibili dati sufficienti per il calcolo, vengono utilizzate le durate predefinite.
  - Predefinito: **false**
- **sottovoci**
  - Crea anche i sotto articoli del prodotto, se disponibili
  - Predefinito: **false**
- **data_di_consegna**
  - Formato: 2022-01-01 10:30:11
- **data_inizio_idoneità**
  - Formato: 2022-01-01 10:30:11
- **identificativo_disegno**
  - Identificatore di disegni/bluprint/istruzioni
- **descrizione**
  - Descrizione dell'ordine
- **descrizione_aggiuntiva**
  - Descrizione aggiuntiva per l'articolo dell'ordine
- **is_prospect**
  - L'oggetto dell'ordine è una prospettiva
  - Predefinito: **false**

#### Aggiornamento degli articoli dell'ordine

Per aggiornare i dati degli ordini puoi inviare una richiesta PUT all'endpoint /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**Figura 8.**Aggiornare un ordine

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Figura 9.**Articolo d'ordine aggiornato

#### Eliminazione degli articoli dell'ordine

L'eliminazione degli articoli dell'ordine avviene con un metodo di "cancellazione morbida". In effetti, l'eliminazione di un ordine cambia il suo valore is_archive in true. Ciò significa che puoi ripristinare gli articoli d'ordine cancellati aggiornando il valore is_archive a false.

Quando si elimina un ordine, il sistema elimina anche le fasi di processo associate.

Per eliminare gli articoli dell'ordine, invia una richiesta DELETE all'endpoint /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Figura 10.**Eliminazione degli articoli dell'ordine

Puoi eliminare gli articoli dell'ordine dando gli id interni di Skyplanner nell'array **"ids"** o gli id esterni nell'array **"external_ids"**.