Integrazione ERP e MES

Questa pagina è per l'ingegnere di integrazione che collega Scalarcut a un ERP, un MES o un controller di banco di taglio.

Il documento Factory MBOM raggiunge i tuoi sistemi in due modi:

• Export dal pianificatore — un utente Enterprise pianifica nel pianificatore e fa clic sul pulsante Factory MBOM per scaricare JSON e CSV.
• API HTTP — il tuo middleware recupera lo stesso documento tramite l'endpoint con chiave.

Entrambi producono lo stesso schema scalarcut.factory_bom.v1.1; il mapping sotto si applica a entrambi.

Scegli JSON o CSV

• JSON è il documento completo: intestazione, pezzi, ricette, consumabili, totali e geometry opzionale. Usalo quando il tuo middleware può consumare JSON strutturato.
• CSV è solo l'elenco dei pezzi — le colonne piatte da inserire direttamente in un banco di taglio o in un'importazione di foglio di calcolo. Imballo, id, tariffe e totali non sono nel CSV.

Entrambi descrivono la stessa lista di taglio; il CSV è una proiezione con perdita dei pezzi JSON.

Mapping dei campi

Campo Factory MBOM	Destinazione ERP / MES tipica
schema	Blocco versione contratto (fissa su scalarcut.factory_bom.v1.1)
scene_id / project_id	Chiave ordine di produzione / ordine di lavoro
surface_id	Zona o linea (wall-a…wall-d, floor)
group_id	Chiave di instradamento stabile per un gruppo di taglio
letter	Legenda leggibile della lista di taglio per il reparto
sku	Anagrafica materiale / codice articolo
w_mm / h_mm	Dimensioni di taglio per il banco di taglio
cut_type	Strategia di taglio / centro di lavoro
qty	Quantità d'ordine per il gruppo
fragile	Blocco qualità / flag di manipolazione manuale
cre_recycled / cre_parent	Tracciabilità del riciclo fino alla piastrella di origine
is_l_cut	Instradamento taglio a L
rates	Costanti di formula dei consumabili
totals.cut_qty	Audit contro l'intestazione della lista di taglio del blueprint
totals.boxes_to_order	Scatole da acquistare

Recuperi idempotenti

L'endpoint è una GET con ETag. Fai polling con If-None-Match così una richiesta invariata restituisce 304 invece di rielaborare il documento. Tratta la combinazione scene_id/project_id + ETag come chiave di idempotenza quando inserisci in una coda.

Recupera, non inviare

Ci sono due vie di consegna. Un utente può esportare il documento dal pulsante nell'intestazione del pianificatore (scarica JSON + CSV). Per l'automazione, il tuo middleware può recuperare il documento tramite l'API HTTP su richiesta — in questa release non c'è push via webhook. Pianifica il polling al tuo ritmo e affidati all'ETag.

Tagli fragili

Un taglio sotto la soglia di fragilità di 50 mm è marcato fragile: true. Instradalo a una manipolazione manuale invece di inviarlo a una macchina che lo romperebbe. Sliver Guard prova già a riancorare i layout per evitarli; il flag è l'ultima rete di sicurezza.

Consumabili

Collante, stucco e primer sono sempre presenti nei rates e totals di Factory MBOM — l'opposto del carrello dell'Online Store Widget, dove i consumabili sono una riga carrello opzionale. Mappa rates una volta sulle costanti delle tue formule; il documento porta i kg/L calcolati, quindi non devi ricalcolarli.

Audit

totals.cut_qty deve essere uguale alla somma delle qty dei pezzi. Quando inserisci un documento, riconcilia totals.cut_qty con l'intestazione della lista di taglio del blueprint della stessa scena. Qualsiasi scarto significa che il layout è cambiato tra export e inserimento — recupera di nuovo prima di rilasciare in produzione.

Recuperare un progetto per id

Il tuo middleware recupera un progetto tramite il suo scene_id (o project_id) insieme alla tua Enterprise Key. La richiesta è limitata alla tua azienda, quindi recuperi solo i tuoi progetti. Il fixture del garage è un campione pubblico per prove degli integratori e il pannello Try MBOM API, non l'unico documento che serve l'endpoint.