Integrazioni / ERP / Katana
Guida all’integrazione di Katana per la schedulazione della produzione con SkyPlanner APS
Questa guida all’integrazione di Katana mostra a consulenti e team IT come collegare Katana Cloud Inventory (Katana MRP) a SkyPlanner APS. SkyPlanner si integra con Katana in entrambe le direzioni tramite la Katana API pubblica:
- SkyPlanner riceve ordini di produzione, righe delle operazioni, ricette di prodotto, operazioni di produzione, risorse produttive, giacenze e ordini di acquisto.
- La sequenza schedulata viene inviata alla scheda Schedule di Katana, con una scadenza di produzione per ogni ordine.
- Lo stato delle operazioni e il tempo effettivo vengono riportati nelle righe delle operazioni.
- I webhook di Katana segnalano le modifiche in ingresso, mentre quelli di SkyPlanner inviano le modifiche alla schedulazione non appena avvengono.
Durante l’avviamento, il team SkyPlanner configura l’integrazione in base alla configurazione di Katana e fornisce assistenza anche dopo la messa in esercizio. Questa guida si rivolge a consulenti e sviluppatori che vogliono partecipare al progetto o sviluppare autonomamente usando la REST API documentata di SkyPlanner (documentazione API).
La Katana API
Katana è un unico prodotto cloud multi-tenant: tutti i clienti utilizzano quindi la stessa API. Si tratta di una REST API, versione v1, disponibile su https://api.katanamrp.com/v1, con una specifica OpenAPI 3.0 su https://api.katanamrp.com/v1/openapi.json. La documentazione è disponibile nel Katana Developer Hub.
Gli endpoint necessari a uno schedulatore:
- Anagrafiche:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Ordini:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Sequenza:
/manufacturing_order_rerank. - Approvvigionamento e domanda:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Non esiste un endpoint /resources. Le risorse produttive sono riportate nei campi resource_id e resource_name delle righe delle operazioni di prodotto e delle righe delle operazioni degli ordini di produzione.
Autenticazione e limiti
L’autenticazione usa una chiave API come token bearer: Authorization: Bearer <api key>. Creare la chiave in Settings > API > Add new API key. (fonte)
La sincronizzazione va progettata tenendo conto di questi limiti:
- Per impostazione predefinita, la Katana API consente 60 richieste ogni 60 secondi (fonte)
- Superato il limite, l’API restituisce 429 con
Retry-After.X-Ratelimit-Remainingindica quante richieste restano disponibili. - Gli endpoint che restituiscono elenchi paginano i risultati e accettano filtri per data di aggiornamento, così i dati da sincronizzare a ogni aggiornamento restano pochi.
Sul lato SkyPlanner, la REST API si autentica con un token API (SkyPlanner Settings > API) ed è documentata in Swagger/OpenAPI. Il tutorial sull’integrazione illustra le prime chiamate.
Webhook
Registrare un webhook con POST /webhooks, specificando un URL HTTPS e gli eventi necessari. (fonte) Gli eventi utili per la schedulazione:
manufacturing_order.created,.updated,.deleted,.in_progress,.blocked,.donemanufacturing_order_operation_row.created,.updated,.in_progress,.paused,.completedcurrent_inventory.material_updated,.material_out_of_stockpurchase_order.*epurchase_order_row.*, inclusi gli eventi di ricezioneproduct.*,product_recipe_row.*esales_order.*
I payload sono essenziali: contengono il tipo di risorsa, l’azione e un href. Il ricevente recupera l’oggetto completo dall’href. Ogni invio include un header x-sha2-signature (HMAC SHA-256) per la verifica. L’endpoint deve rispondere con 20X entro 10 secondi. Katana ritenta l’invio tre volte: dopo 30 secondi, 2 minuti e 15 minuti.
Mappatura dei dati
| Oggetto Katana (endpoint) | Oggetto SkyPlanner | Direzione | Frequenza |
|---|---|---|---|
Prodotti, materiali, varianti (/products, /materials, /variants) | Prodotti e materiali | Katana → SkyPlanner | Caricamento iniziale, poi tramite webhook |
Ricetta di prodotto / BOM (/recipe_rows, /bom_rows) | Struttura del prodotto, prodotti di livello inferiore | Katana → SkyPlanner | Caricamento iniziale, poi tramite webhook |
Operazioni di produzione (/product_operation_rows): tipo, risorsa produttiva, tempo | Fasi del processo con durate e tempi di attrezzaggio | Katana → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
Risorse produttive (resource_id, resource_name nelle righe delle operazioni) | Centri di lavoro, gruppi di centri di lavoro | Katana → SkyPlanner | Caricamento iniziale e alla creazione di una nuova risorsa produttiva |
Ordine di produzione con righe delle operazioni (/manufacturing_orders, /manufacturing_order_operation_rows) | Ordini e operazioni | Katana → SkyPlanner | In tempo reale tramite webhook |
Componenti dell’ordine di produzione (/manufacturing_order_recipe_rows) | Materiali per operazione | Katana → SkyPlanner | In tempo reale tramite webhook |
Giacenze, ordini di acquisto con date di arrivo (/inventory, /purchase_order_rows) | Scorte e materiali in arrivo | Katana → SkyPlanner | In tempo reale tramite webhook |
delivery_date dell’ordine di vendita (/sales_orders) | Scadenza dell’ordine, priorità del cliente | Katana → SkyPlanner | In tempo reale tramite webhook |
Sequenza degli ordini di produzione (POST /manufacturing_order_rerank) | Sequenza schedulata degli ordini di produzione aperti | SkyPlanner → Katana | A ogni modifica della schedulazione |
production_deadline_date dell’ordine di produzione (PATCH /manufacturing_orders/{id}) | Fine pianificata | SkyPlanner → Katana | A ogni modifica della schedulazione |
status, total_actual_time della riga dell’operazione (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, registrazioni dei tempi | SkyPlanner → Katana | A ogni registrazione del lavoro |
| Non presente in Katana | Turni, assenze, matrice dei tempi di attrezzaggio, utensili, numero di operatori, centri di lavoro alternativi | Gestiti in SkyPlanner | Configurati durante l’avviamento |
Modalità di integrazione
1. Caricamento iniziale delle anagrafiche. Recuperare pagina per pagina prodotti, materiali, varianti, righe delle ricette e righe delle operazioni di prodotto, mantenendo la frequenza delle richieste sotto il limite. Creare i centri di lavoro in SkyPlanner a partire dalle risorse produttive distinte presenti nelle righe delle operazioni e mantenere una corrispondenza 1:1 tra le chiavi. Impostare turni, ferie e straordinari per ogni centro di lavoro in SkyPlanner, perché Katana non dispone di un calendario delle risorse produttive.
2. Sincronizzazione degli ordini. Sottoscrivere gli eventi relativi a ordini di produzione, righe delle operazioni, giacenze e ordini di acquisto. A ogni evento, recuperare l’oggetto dal suo href e aggiornare l’operazione. SkyPlanner considera il materiale ordinato disponibile alla data di consegna dell’ordine di acquisto e aggiorna le scorte quando l’ordine viene ricevuto. Una riconciliazione notturna con filtri per data di aggiornamento recupera eventuali eventi persi.
3. Scrittura della schedulazione in Katana. Due chiamate trasferiscono il piano in Katana:
- POST
/manufacturing_order_rerank“moves one or more manufacturing orders to an exact place in the production schedule” (sposta uno o più ordini di produzione in una posizione precisa del programma di produzione). Accetta fino a 250 ordini di produzione aperti per richiesta, collocandoli all’inizio, alla fine, prima o dopo un determinato ordine di produzione. (fonte) - PATCH
/manufacturing_orders/{id}impostaproduction_deadline_date. Katana accetta il valore solo se il calcolo automatico della scadenza è disattivato per quello stabilimento. (fonte)
Il riordino non cambia soltanto la posizione nell’elenco. In Katana, “higher-priority MOs reserve required materials and subassemblies first” (gli ordini di produzione con priorità più alta prenotano per primi i materiali e i sottoassiemi necessari). La sequenza di SkyPlanner determina quindi anche a quale ordine di produzione vengono assegnate le scorte in Katana.
4. Consuntivazione dal reparto produttivo. Gli operatori registrano il lavoro con SkyPlanner Mobile Confirmations, Production Timer o Quick Log Mode. SkyPlanner scrive lo stato e il tempo effettivo nella riga dell’operazione dell’ordine di produzione. Se invece uno stabilimento continua a utilizzare Katana Shop Floor App, SkyPlanner legge gli eventi delle righe delle operazioni. Scegliere un solo canale di consuntivazione per stabilimento.
5. Responsabilità sui dati e regole per i conflitti. Documentarle prima della messa in esercizio:
| Dati | Sistema responsabile |
|---|---|
| Prodotti, ricette, operazioni di produzione, giacenze, acquisti, ordini di vendita | Katana |
| Sequenza delle operazioni, orari di inizio e fine, centro di lavoro per ogni operazione | SkyPlanner |
| Posizione dell’ordine di produzione nella scheda Schedule e scadenza di produzione | SkyPlanner, con scrittura in Katana |
| Turni, assenze, matrice dei tempi di attrezzaggio, utensili, risorse produttive alternative | SkyPlanner |
| Stato delle operazioni e tempi registrati | Un solo canale, scelto durante la definizione del perimetro |
Le fasi tipiche del progetto
L’implementazione si conclude normalmente entro poche settimane dall’inizio dell’onboarding. Prima di questa fase, la prova gratuita di 30 giorni permette di usare i propri dati esportati da Katana in formato CSV, ad esempio l’elenco Tasks della schermata Make.
Il progetto prevede queste fasi:
- Piano e chiave API. Verificare che il piano Katana includa l’API e Manufacturing Management, quindi creare la chiave API.
- Modalità di gestione delle scadenze. Concordare la disattivazione delle scadenze automatiche per lo stabilimento, in modo che sia SkyPlanner a gestire le scadenze di produzione.
- Mappatura. Definire la tabella di mappatura, le chiavi delle risorse produttive, le regole su quale sistema gestisce ciascun dato e il canale di consuntivazione.
- Caricamento iniziale. Prodotti, varianti, ricette, operazioni di produzione e risorse produttive.
- Sincronizzazione degli eventi. Webhook per ordini, operazioni, giacenze e ordini di acquisto, con riconciliazione notturna.
- Configurazione dei vincoli in SkyPlanner. Turni, matrice dei tempi di attrezzaggio, utensili, numero di operatori e centri di lavoro alternativi.
- Scrittura dei dati in Katana. Riordinamento e scadenze, poi stato delle operazioni e tempi.
- Test in parallelo e avvio in produzione. Confrontare le date di SkyPlanner con quelle attuali della scheda Schedule, correggere le anagrafiche e poi attivare la scrittura dei dati in Katana.
Cosa prevedere per l’integrazione con Katana
- La modalità automatica sovrascrive le date. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Una volta attivata la modalità automatica, tutte le scadenze manuali vengono sovrascritte e non possono essere ripristinate.) Scegliere la modalità una volta sola, all’avvio del progetto.
- Nessun calendario delle risorse produttive. Non ricavare i turni dal solo valore Weekly throughput. Configurarli in SkyPlanner per ogni centro di lavoro.
- Risorse produttive solo sulle righe delle operazioni. Mantenere invariati i nomi delle risorse produttive in Katana, perché sono la chiave di collegamento ai centri di lavoro di SkyPlanner.
- Unità di tempo.
planned_time_parameterè espresso in secondi: per singola unità nelle operazioni per-unit e come totale per i tipi process, setup e fixed. Mappare correttamente il tipo, altrimenti le durate risulteranno errate di un fattore pari alla quantità. - Gruppi per la produzione su commessa. Durante il riordinamento, gli ordini di produzione (MO) collegati allo stesso ordine di vendita restano uniti: vanno quindi messi in sequenza come gruppo.
- È cambiato il comportamento del riordinamento. Dal 7 ottobre 2026, gli endpoint di riordinamento collocano gli ordini esattamente nella posizione richiesta. Le integrazioni sviluppate per il comportamento precedente devono essere testate di nuovo. (fonte)
Integrazione con Katana: chi la configura e fornisce assistenza
Il lavoro riguarda le risorse produttive, le operazioni di produzione, il flusso degli ordini e la modalità di gestione delle scadenze. Aggiunge ciò che Katana non contiene: turni, matrice dei tempi di attrezzaggio, utensili, numero di operatori e risorse produttive alternative.
- Il team SkyPlanner configura l’integrazione durante l’onboarding e fornisce assistenza dopo l’avvio in produzione. Ogni stabilimento configura risorse produttive e operazioni in Katana in modo diverso: la conoscenza di queste specificità viene messa a frutto nella configurazione dell’integrazione.
- Il tuo consulente Katana o partner di integrazione può realizzarla. SkyPlanner mette a disposizione la REST API, la documentazione Swagger/OpenAPI e i webhook.
- I tuoi sviluppatori possono estenderla con un token API. Per iniziare basta un token API e il team SkyPlanner offre assistenza quando serve. La documentazione del prodotto, che comprende gli ordini di acquisto e l’API per prodotti e materiali, è disponibile nella documentazione SkyPlanner.
SkyPlanner parte da 199 € al mese con 5 centri di lavoro inclusi e fatturazione mensile. Il preventivo dell’integrazione viene preparato in anticipo in base al tuo processo e alle tue esigenze, insieme al piano, così conosci il costo completo prima di iniziare. Consulta prezzi e funzionalità e confronta la schedulazione di Katana nella pagina dedicata alla schedulazione della produzione a capacità finita con Katana. Trovi una panoramica nella pagina Katana e gli altri ERP nella sezione sulle integrazioni ERP.
Le recensioni delle aziende manifatturiere su SkyPlanner
2 hrisparmiate ogni settimana
“SkyPlanner ci ha fatto passare dai fogli Excel per la pianificazione della produzione all’ottimizzazione della produzione in tempo reale.”
Kalle Kalliomäki, specialista della catena di approvvigionamento
UTU · Quadri elettrici e apparecchiature di manovra
La pianificazione della produzione fa risparmiare 2 ore di lavoro ogni settimana e una nuova coda di lavoro arriva alla linea in pochi secondi.
+90%di efficienza produttiva
“L’efficienza in produzione è aumentata del 90%.”
Abdul Rucyinga, responsabile IT
Laboratory & Allied · Produzione farmaceutica
L’efficienza produttiva è aumentata del 90% e per creare un piano ottimizzato di tre mesi per tutti i centri di lavoro servono meno di 30 minuti.
Menofermi per carenza di materiali
“Il valore che SkyPlanner ci offre è uno strumento che funziona nell’uso quotidiano, soprattutto per definire le date di consegna.”
Tommi Männistö, responsabile della pianificazione della produzione
Eskomatic · Lavorazioni meccaniche conto terzi
La schedulazione automatica dei carichi permette di definire date di consegna più precise e i fermi di produzione dovuti alla carenza di materiali si sono ridotti nettamente.
1.000 e piùordini di lavoro schedulati automaticamente
“Ora controlliamo la produzione in modo diverso e conosciamo la nostra capacità produttiva a un livello completamente nuovo.”
Hannu Ryynänen, amministratore delegato
Mamec · Miscelatori industriali, pompe e produzione conto terzi ad alta tecnologia
Migliaia di ordini di lavoro vengono schedulati automaticamente, con una visione della produzione in tempo reale per tutta l’organizzazione.
Domande frequenti
Katana dispone di un’API e quale piano serve?
Sì. Katana offre una REST API pubblica, v1, con specifica OpenAPI 3.0. La pagina dei prezzi indica che l’accesso all’API è incluso nei piani Free e Advantage. L’autenticazione avviene tramite una chiave API bearer generata da Settings > API.
SkyPlanner può scrivere il programma di produzione in Katana?
Sì. SkyPlanner dispone gli ordini di produzione aperti nella propria sequenza sulla scheda Schedule di Katana tramite /manufacturing_order_rerank e scrive il campo production_deadline_date di ciascun MO. Lo stato delle operazioni e i tempi effettivi vengono riportati sulle righe delle operazioni dei MO. Il programma con gli orari per ogni centro di lavoro resta in SkyPlanner, dove gli operatori lavorano seguendo la propria coda.
Katana invia le modifiche in tempo reale?
Sì. I webhook di Katana coprono ordini di produzione, righe delle operazioni, giacenze, ordini di acquisto e ordini di vendita. SkyPlanner recupera ogni oggetto modificato ed esegue una riconciliazione notturna, così un evento perso non lascia mai un’operazione non aggiornata.
Come diventano centri di lavoro SkyPlanner le risorse produttive di Katana?
Ogni risorsa produttiva distinta presente sulle righe delle operazioni di Katana diventa un centro di lavoro SkyPlanner tramite una chiave con corrispondenza 1:1. Turni, assenze e centri di lavoro alternativi vengono poi configurati in SkyPlanner.
Possiamo provare SkyPlanner prima di realizzare l’integrazione?
Sì. La prova gratuita di 30 giorni supporta fino a 20 centri di lavoro con importazione CSV da Katana, senza carta di credito. Inizia la prova oppure contatta il team commerciale per definire il perimetro dell’integrazione.
