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’.
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 si effettua 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:
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:
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:
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.
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.
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.
