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:
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
- 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
- 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:
Per recuperare un ordine specifico con il suo id interno di Skyplanner puoi fare una richiesta come questa:
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:
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:
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
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:
Puoi eliminare gli articoli dell’ordine dando gli id interni di Skyplanner nell’array “ids” o gli id esterni nell’array “external_ids”.