Salta al contenuto principale
← CutOptim Engine APIEngine API · già disponibile

API per l’ottimizzazione del taglio di profili e acciaio

Sì, esiste un’API per il taglio di acciaio e profili. Tagliare a misura profili, barre, angolari o travi in acciaio o alluminio è un problema di cutting stock 1D, e lo stesso motore che alimenta l’app CutOptim si richiama via HTTP. Il tuo gestionale, il software di preventivazione o di produzione invia in JSON la distinta di taglio e le lunghezze di materiale disponibili e riceve il piano di taglio ottimizzato, il numero di barre e la resa.

È già disponibile: il motore CutOptim esegue da tempo l’ottimizzazione 1D in produzione per l’app; l’Engine API espone lo stesso solver via HTTP, così un software di carpenteria metallica o un gestionale può calcolare e pianificare una commessa senza browser.

POST /v1/optimize/1d
{
  "parts": [
    { "length": 1450, "qty": 12, "meta": { "profile": "IPE-140" } },
    { "length": 3100, "qty": 6 }
  ],
  "stock": [{ "length": 12000, "qty": 40, "price": 58.0 }],
  "options": { "kerf": 3, "minimizeCost": true }
}
Usa una chiave demo pubblica — limitata, solo lavori piccoli, mai fatturata.
  • Già disponibile su POST /v1/optimize/1d — lo stesso motore dell’app.
  • minimizeCost ordina i piani in base al prezzo totale del materiale, non solo al numero di barre, e restituisce totalPrice.
  • Validazione gratuita: POST /v1/validate/1d controlla un lavoro senza chiave e senza quota.
  • Allega un oggetto meta (designazione del profilo, riga d’ordine) e torna su ogni taglio.

Perché ne hanno bisogno le carpenterie metalliche

L’acciaio strutturale e i profili in alluminio si comprano in barre lunghe e si tagliano in molte lunghezze. Tagliare nell’ordine della lista lascia uno sfrido corto su quasi ogni barra; un ottimizzatore 1D ridistribuisce i tagli sulle barre in modo che la commessa richieda il minor numero di barre possibile. Dentro un flusso di preventivazione o di gestionale, l’API lo fa su ogni commessa in automatico invece che a mano.

Cosa invii e cosa ottieni

Invii in JSON le lunghezze e le quantità dei pezzi e le lunghezze e i prezzi delle barre disponibili. La risposta restituisce il piano di taglio barra per barra, il numero di barre, la resa, la lunghezza totale segata e lo sfrido utilizzabile su ogni barra. Allega un oggetto meta — la designazione del profilo o la riga d’ordine — e torna su ogni taglio posizionato, così il piano si riconcilia con il tuo sistema.

Deterministico: riproducibile per preventivi e verifiche

La stessa richiesta restituisce sempre lo stesso piano di taglio. Un preventivo costruito da una chiamata API è riproducibile per una verifica o un ordine ripetuto, e i risultati si possono mettere in cache e confrontare nei test: la proprietà che un flusso di preventivazione richiede.

Risorsa scaricabile
Scheda sintetica API taglio acciaio e profili

Una sintesi di due pagine (PDF in inglese): il problema, cosa invii e cosa ricevi, una richiesta e una risposta, e come costruire sul motore. Pronta da stampare, con un QR che rimanda a questa pagina.

PDF2 pagineGratis
Scarica il PDF

Domande frequenti

Esiste un’API per ottimizzare il taglio di acciaio o profili?
Sì. Profili, barre, angolari e travi in acciaio e alluminio tagliati a misura sono un problema di cutting stock 1D, e la CutOptim Engine API lo risolve su POST /v1/optimize/1d. Invii in JSON la distinta di taglio e le lunghezze del materiale e ricevi il piano di taglio ottimizzato, il numero di barre, la resa e gli sfridi utilizzabili — lo stesso motore che gira nell’app, via HTTP.
Può ottimizzare sul costo del materiale, non solo sul numero di barre?
Sì. Assegna un prezzo a ogni lunghezza di materiale e imposta options.minimizeCost: il motore ordina i piani in base al prezzo totale più basso anziché al minor numero di barre, e restituisce totalPrice insieme al piano. Conta quando le barre più lunghe hanno un prezzo sproporzionato.
Posso validare gratis una richiesta mentre integro?
Sì. POST /v1/validate/1d controlla una richiesta senza risolverla — gratis, senza chiave API e senza quota — così il tuo team può confermare che il payload venga accettato ancora prima di avere una chiave. L’Engine API vera e propria ha una prova di 14 giorni.
Può pianificare solo con le barre che ho a magazzino, compresi i resti?
Sì. Elenca ogni barra che possiedi — lunghezze intere e resti di altre lunghezze — ciascuna con la sua quantità, e imposta options.respectStock così che quelle quantità diventino limiti rigidi. Il motore pianifica con ciò che è davvero a scaffale, e ogni pezzo che non ci sta viene riportato in unplaced, così sai esattamente cosa manca ancora prima di ordinare.
Posso riavere la distinta di taglio come file?
Sì. Aggiungi include:["csv","dxf"] alla richiesta e la risposta contiene la distinta di taglio come stringa CSV e un disegno DXF, accanto al piano in JSON — nessuno storage e nessuna seconda chiamata. L’oggetto meta che alleghi a un pezzo, come la designazione del profilo o una riga d’ordine, torna su ogni taglio posizionato, così il piano si riconcilia con il tuo gestionale.

Caso d’uso lavorazione dei metalli (app) · Benchmark