---
title: Prodotti e materiali
description: "Qui ti spieghiamo come creare prodotti e materiali e come allegarli agli ordini con la Skyplanner-API. Ti mostreremo anche come creare delle fasi di processo predefinite per i tuoi prodotti e come creare degli articoli d'ordine utilizzando quelle predefinite. ####…"
url: "https://skyplanner.ai/it/docs/prodotti-e-materiali/"
updated: "2025-10-07"
category: Integrazioni
tags:
  - API
  - Integrazione
---

# Prodotti e materiali

Qui ti spieghiamo come creare prodotti e materiali e come allegarli agli ordini con la Skyplanner-API. Ti mostreremo anche come creare delle fasi di processo predefinite per i tuoi prodotti e come creare degli articoli d'ordine utilizzando quelle predefinite.

#### Creare un prodotto/materiale

La creazione e l'aggiornamento di prodotti e materiali avviene attraverso lo stesso API-endpoint: /prodotti. Il tipo di prodotto è definito dall'**attributo type**: 'product' o 'material'.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-14.png)
**Figura 1.** Creare un prodotto

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-11.png)
**Figura 2.** Creare un materiale

Quando crei prodotti e materiali assicurati di impostare il valore **is_active** come true se vuoi che il prodotto/materiale venga mostrato come attivo nell'elenco dei prodotti. Ricorda inoltre che puoi impostare la quantità di scorte disponibili con l'attributo **free_amount**.

#### Creare fasi di processo predefinite per un prodotto

Prima di aggiungere delle fasi di processo predefinite per un prodotto, devi disporre dei workstage appropriati. I workstage possono essere creati sia attraverso l'interfaccia utente di Skyplanner che attraverso l'endpoint /workstages.

L'aggiunta di fasi di processo predefinite avviene dall'endpoint /products/jobs/{productId}.

Quindi, ad esempio, se vuoi aggiungere un passo predefinito al prodotto con id 22220, devi fare una richiesta POST come questa:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-16.png)
**Figura 3.** Aggiunta di una fase di processo predefinita

Alcuni campi degni di nota:

- numero_ordine
  - Si tratta di un numero indice che indica a Skyplanner in quale ordine devono essere completate le fasi del processo.
  - Ad esempio: il primo passo ottiene il valore 1, il secondo passo ottiene il valore 3, il terzo passo ottiene il valore 3 e così via...
- postazioni di lavoro
  - Questo è un elenco di postazioni di lavoro per le quali è possibile programmare questa fase del processo.
  - Indica gli id delle workstation come un elenco separato da virgole, in questo modo: "61,62,63"
- Variazione_di_tempo
  - Valori possibili: time_per_pcs, pcs_per_time, fixed_time
- durata, settingtime, settletime
  - Indica questi valori in *secondi*

#### Aggiornare una fase di processo predefinita

Quando aggiorni una fase del processo predefinita devi usare l'attributo **order_number** per specificare quale fase aggiornare.

Ad esempio, la prima fase del processo**(ordine_numero 1**) in questo prodotto viene eseguita con una richiesta PUT come questa:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-19.png)
**Figura 4.** Aggiornare una fase di processo predefinita

#### Eliminazione delle fasi di processo predefinite

L'eliminazione delle fasi di processo predefinite si effettua anche utilizzando i valori **order_number**.

I numeri d'ordine vengono forniti in un array come questo:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-21.png)
**Figura 5.** Eliminazione delle fasi di processo predefinite

##### Aggiunta di un materiale/sottoprodotto a un prodotto

Per allegare un materiale o un sottoprodotto dobbiamo utilizzare l'endpoint /sub-products.

Il processo è piuttosto semplice: inseriamo l'id del materiale o del sottoprodotto nell'attributo **production_planning_product_id** e l'id del prodotto a cui vogliamo che il materiale/sottoprodotto sia collegato nell'attributo **production_planning_product_parent_id**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-22.png)
**Figura 6.** Attaccare un materiale a un prodotto

##### Aggiunta di un materiale all'ordine

Puoi anche allegare i materiali direttamente a un ordine utilizzando l'endpoint /row-materials. In questo modo puoi allegare materiali extra o utilizzare un elenco di materiali completamente diverso da quello predefinito per i prodotti. Tieni presente che puoi avere solo un'entità riga-materiale per un ordine per ogni materiale. Quindi, in effetti, non puoi creare due entità con lo stesso **production_planning_product_id**allo stesso **phaser_order_row_id**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-24.png)
**Figura 7.** Aggiungere un materiale a un ordine

#### Aggiornare il livello delle scorte

Puoi aggiornare il livello delle scorte del prodotto o del materiale inviando una richiesta PUT con l'attributo **free_amount**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-40.png)
**Figura 8.** Aggiornare il livello delle scorte