Ghid de integrare Katana pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare Katana le arată consultanților și echipelor IT cum să conecteze Katana Cloud Inventory (Katana MRP) la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu Katana prin interfața publică Katana API:
- În SkyPlanner sunt importate comenzile de producție, liniile de operații, rețetele produselor, operațiile de producție, resursele, stocurile și comenzile de achiziție.
- Ordinea programată este transmisă înapoi în fila Schedule din Katana, împreună cu un termen de finalizare pentru fiecare comandă de producție.
- Starea operațiilor și timpul efectiv sunt transmise înapoi în liniile de operații.
- Webhookurile Katana notifică SkyPlanner despre modificări, iar webhookurile SkyPlanner transmit modificările programului pe măsură ce apar.
Echipa SkyPlanner configurează integrarea în funcție de configurația Katana în etapa de implementare și asigură asistență după punerea în funcțiune. Acest ghid se adresează consultanților și dezvoltatorilor care vor să participe la integrare sau să dezvolte singuri soluții folosind interfața REST API documentată a SkyPlanner (documentația API).
Interfața Katana API
Katana este un produs cloud unic, cu arhitectură multi-tenant, astfel încât toți clienții folosesc aceeași interfață API. Este o interfață REST API, versiunea v1, disponibilă la https://api.katanamrp.com/v1, cu specificația OpenAPI 3.0 la https://api.katanamrp.com/v1/openapi.json. Documentația este disponibilă în Katana Developer Hub.
Endpointurile necesare pentru programarea producției:
- Nomenclatoare:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Comenzi:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Ordine de execuție:
/manufacturing_order_rerank. - Aprovizionare și cerere:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Nu există un endpoint /resources. Resursele apar în câmpurile resource_id și resource_name din liniile de operații ale produselor și ale comenzilor de producție.
Autentificare și limite
Autentificarea folosește o cheie API ca token bearer: Authorization: Bearer <api key>. Creați cheia din Settings > API > Add new API key. (sursă)
La proiectarea sincronizării trebuie să țineți cont de următoarele limite:
- În mod implicit, Katana API permite 60 de cereri la fiecare 60 de secunde (sursă)
- La depășirea limitei, interfața API returnează codul 429 împreună cu
Retry-After.X-Ratelimit-Remainingindică numărul de cereri rămase disponibile. - Endpointurile de listare returnează rezultate paginate și acceptă filtre după data actualizării, astfel încât volumul de date transferat la sincronizările incrementale rămâne mic.
În SkyPlanner, interfața REST API folosește un token API pentru autentificare (SkyPlanner Settings > API) și este documentată în Swagger/OpenAPI. Tutorialul de integrare explică pas cu pas primele apeluri.
Webhookuri
Înregistrați un webhook prin POST /webhooks, specificând un URL HTTPS și evenimentele de care aveți nevoie. (sursă) Evenimente utile pentru programarea producției:
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.*șipurchase_order_row.*, inclusiv receivedproduct.*,product_recipe_row.*șisales_order.*
Mesajele conțin puține date: tipul resursei, acțiunea și un href. Sistemul receptor preia obiectul complet de la adresa href. Fiecare mesaj include un antet x-sha2-signature (HMAC SHA-256) pentru verificare. Endpointul dumneavoastră trebuie să răspundă cu 20X în cel mult 10 secunde, iar Katana reîncearcă de trei ori: la 30 de secunde, 2 minute și 15 minute.
Maparea datelor
| Obiect Katana (endpoint) | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
Produse, materiale, variante (/products, /materials, /variants) | Produse și materiale | Katana → SkyPlanner | Încărcare inițială, apoi la primirea unui webhook |
Rețeta produsului / BOM (/recipe_rows, /bom_rows) | Structura produsului, subproduse | Katana → SkyPlanner | Încărcare inițială, apoi la primirea unui webhook |
Operații de producție (/product_operation_rows): tip, resursă, durată | Etape de proces cu durate și timpi de pregătire | Katana → SkyPlanner | Încărcare inițială, apoi la fiecare modificare |
Resurse (resource_id, resource_name în liniile de operații) | Centre de lucru, grupuri de centre de lucru | Katana → SkyPlanner | Încărcare inițială, apoi la adăugarea unei resurse |
Comandă de producție cu linii de operații (/manufacturing_orders, /manufacturing_order_operation_rows) | Comenzi și operații | Katana → SkyPlanner | În timp real, prin webhook |
Ingrediente ale comenzii de producție (/manufacturing_order_recipe_rows) | Materiale pentru fiecare operație | Katana → SkyPlanner | În timp real, prin webhook |
Stocuri, comenzi de achiziție cu date de sosire (/inventory, /purchase_order_rows) | Stocuri și materiale în curs de aprovizionare | Katana → SkyPlanner | În timp real, prin webhook |
Câmpul delivery_date al comenzii de vânzare (/sales_orders) | Termenul comenzii, prioritatea clientului | Katana → SkyPlanner | În timp real, prin webhook |
Ordinea comenzilor de producție (POST /manufacturing_order_rerank) | Ordinea programată a comenzilor de producție deschise | SkyPlanner → Katana | La modificarea programului |
Câmpul production_deadline_date al comenzii de producție (PATCH /manufacturing_orders/{id}) | Finalizare programată | SkyPlanner → Katana | La modificarea programului |
Câmpurile status, total_actual_time ale liniei de operație (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, înregistrări de timp | SkyPlanner → Katana | Pe măsură ce se înregistrează activitatea |
| Nu există în Katana | Schimburi, absențe, matricea timpilor de pregătire, scule, număr de operatori, centre de lucru alternative | Gestionate în SkyPlanner | Configurate în etapa de implementare |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Preluați paginat produsele, materialele, variantele, liniile de rețetă și liniile de operații ale produselor, menținând frecvența cererilor sub limita admisă. Creați centrele de lucru în SkyPlanner pe baza resurselor distincte din liniile de operații și păstrați o corespondență 1:1 între chei. Configurați în SkyPlanner schimburile, concediile și orele suplimentare pentru fiecare centru de lucru, deoarece Katana nu are un calendar al resurselor.
2. Sincronizarea comenzilor. Abonați-vă la evenimentele pentru comenzi de producție, linii de operații, stocuri și comenzi de achiziție. La fiecare eveniment, preluați obiectul de la adresa href și actualizați operația. SkyPlanner consideră materialul comandat disponibil la data de livrare a comenzii de achiziție și actualizează stocul la recepția acesteia. O reconciliere în fiecare noapte, cu filtre după data actualizării, identifică orice eveniment omis.
3. Transmiterea programului înapoi în Katana. Două apeluri transferă programul în Katana:
- POST
/manufacturing_order_rerank“moves one or more manufacturing orders to an exact place in the production schedule” (mută una sau mai multe comenzi de producție într-o poziție exactă din programul de producție). Acceptă până la 250 de comenzi de producție deschise per cerere, plasate la început, la sfârșit sau înainte ori după o anumită comandă de producție. (sursă) - PATCH
/manufacturing_orders/{id}seteazăproduction_deadline_date. Katana acceptă această valoare numai dacă este dezactivat calculul automat al termenului de finalizare pentru locația de producție respectivă. (sursă)
Reordonarea nu afectează doar lista. În Katana, “higher-priority MOs reserve required materials and subassemblies first” (comenzile de producție cu prioritate mai mare rezervă primele materialele și subansamblurile necesare), astfel încât ordinea stabilită de SkyPlanner decide și cărei comenzi de producție i se alocă stocul în Katana.
4. Confirmări din secția de producție. Operatorii înregistrează activitatea prin SkyPlanner Mobile Confirmations, Production Timer sau Quick Log Mode. SkyPlanner scrie starea și timpul efectiv în linia de operație a comenzii de producție. Dacă o fabrică păstrează în schimb Katana Shop Floor App, SkyPlanner citește evenimentele liniilor de operații. Alegeți un singur canal de raportare pentru fiecare fabrică.
5. Responsabilitatea asupra datelor și regulile de soluționare a conflictelor. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Produse, rețete, operații de producție, stocuri, achiziții, comenzi de vânzare | Katana |
| Ordinea operațiilor, momentele de început și de sfârșit, centrul de lucru pentru fiecare operație | SkyPlanner |
| Poziția comenzii de producție în fila Schedule și termenul de finalizare a producției | SkyPlanner, cu transmitere în Katana |
| Schimburi, absențe, matricea timpilor de pregătire, scule, resurse alternative | SkyPlanner |
| Starea operației și timpul înregistrat | Un singur canal, ales la definirea domeniului |
Etapele obișnuite ale proiectului
Implementarea se încheie, de regulă, în câteva săptămâni de la începerea procesului de configurare inițială. Înainte de această etapă, puteți folosi perioada de probă gratuită de 30 de zile cu propriile date dintr-un export CSV din Katana, de exemplu lista Tasks din ecranul Make.
Proiectul propriu-zis cuprinde:
- Abonament și cheie. Verificați dacă abonamentul Katana include API și Manufacturing Management și creați cheia API.
- Modul de stabilire a termenelor. Conveniți dezactivarea termenelor automate pentru locația fabricii, astfel încât SkyPlanner să gestioneze termenele de producție.
- Mapare. Stabiliți tabelul de corespondențe, cheile resurselor, regulile privind sistemul care gestionează fiecare tip de date și canalul de raportare.
- Încărcare inițială. Produse, variante, rețete, operații de producție, resurse.
- Sincronizare pe bază de evenimente. Webhook-uri pentru comenzi, operații, stocuri și comenzi de achiziție, plus reconciliere în fiecare noapte.
- Configurarea constrângerilor în SkyPlanner. Schimburi, matricea timpilor de pregătire, scule, număr de operatori și centre de lucru alternative.
- Scrierea datelor înapoi în Katana. Reordonare și termene, apoi starea operațiilor și timpii.
- Testare în paralel și punere în funcțiune. Comparați datele calendaristice din SkyPlanner cu cele din fila Schedule, corectați nomenclatoarele, apoi activați scrierea datelor înapoi în Katana.
Ce trebuie să aveți în vedere la integrarea cu Katana
- Modul de stabilire a termenelor șterge datele existente. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Odată activat modul automat, toate termenele introduse manual vor fi suprascrise și nu vor mai putea fi recuperate.) Alegeți modul o singură dată, la începutul proiectului.
- Nu există un calendar al resurselor. Nu deduceți schimburile din valoarea unică Weekly throughput. Configurați-le pentru fiecare centru de lucru în SkyPlanner.
- Resursele apar doar pe rândurile operațiilor. Păstrați neschimbate denumirile resurselor în Katana, deoarece acestea servesc drept cheie de corespondență cu centrele de lucru din SkyPlanner.
- Unități de timp.
planned_time_parametereste exprimat în secunde: pe unitate pentru operațiile de tip per-unit și ca total pentru tipurile process, setup și fixed. Mapați corect tipul; altfel, duratele vor fi eronate cu un factor egal cu cantitatea. - Grupuri pentru producția la comandă. La reordonare, comenzile de fabricație (MO) asociate aceleiași comenzi de vânzare rămân împreună, așa că stabiliți-le poziția în secvență ca grup.
- Comportamentul la reordonare s-a schimbat. Din 7 octombrie 2026, endpoint-urile de reordonare plasează comenzile exact în poziția solicitată. Integrările dezvoltate pentru comportamentul anterior trebuie testate din nou. (sursă)
Integrarea cu Katana: cine o configurează și asigură suportul
Configurarea acoperă resursele, operațiile de producție, fluxul comenzilor și modul de stabilire a termenelor. Sunt adăugate informațiile care lipsesc din Katana: schimburi, matricea timpilor de pregătire, scule, număr de operatori și resurse alternative.
- Echipa SkyPlanner configurează integrarea în etapa inițială și asigură suportul după punerea în funcțiune. Fiecare fabrică își configurează diferit resursele și operațiile în Katana, iar această experiență practică este pusă în valoare aici.
- Consultantul Katana sau partenerul dumneavoastră de integrare o poate dezvolta. SkyPlanner pune la dispoziție REST API, documentația Swagger/OpenAPI și webhook-uri.
- Propriii dezvoltatori pot construi pe această bază folosind un token API. Un token API este suficient pentru a începe, iar echipa SkyPlanner oferă asistență când este nevoie. Documentația produsului, inclusiv informațiile despre comenzile de achiziție și API-ul pentru produse și materiale, este disponibilă în documentația SkyPlanner.
SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Primiți de la început o ofertă pentru integrare, adaptată procesului și nevoilor dumneavoastră, împreună cu oferta pentru abonament, astfel încât să cunoașteți costul total înainte de a începe. Consultați prețurile, funcționalitățile și comparația cu programarea disponibilă în Katana în pagina Programare cu capacitate finită pentru Katana. Găsiți prezentarea generală pe pagina Katana, iar celelalte sisteme ERP în secțiunea de integrări ERP.
Ce spun producătorii despre SkyPlanner
2 heconomisite în fiecare săptămână
„Cu SkyPlanner, am trecut de la planificarea producției în foi de calcul Excel la optimizarea producției în timp real.”
Kalle Kalliomäki, specialist în lanțul de aprovizionare
UTU · Tablouri electrice și aparataj de comutație
Planificarea producției economisește 2 ore de lucru în fiecare săptămână, iar o nouă listă de operații ajunge la linia de producție în câteva secunde.
+90%eficiență în producție
„Eficiența în producție a crescut cu 90%.”
Abdul Rucyinga, director IT
Laboratory & Allied · Producție farmaceutică
Eficiența în producție a crescut cu 90%, iar realizarea unui plan optimizat pe trei luni, pentru toate centrele de lucru, durează sub 30 de minute.
Mai puțineopriri cauzate de lipsa materialelor
„Valoarea pe care ne-o aduce SkyPlanner este că funcționează în activitatea de zi cu zi, mai ales când stabilim termenele de livrare.”
Tommi Männistö, manager de planificare a producției
Eskomatic · Prelucrări mecanice în subcontractare
Programarea automată a încărcării permite stabilirea unor termene de livrare mai precise, iar opririle de producție cauzate de lipsa materialelor s-au redus considerabil.
1.000+de comenzi de fabricație programate automat
„Avem un alt control asupra producției, iar acum înțelegem capacitatea la un cu totul alt nivel.”
Hannu Ryynänen, director general
Mamec · Mixere industriale, pompe și producție de înaltă tehnologie în subcontractare
Mii de comenzi de fabricație sunt programate automat, iar întreaga organizație are o imagine în timp real a producției.
Întrebări frecvente
Katana are un API și de ce abonament am nevoie?
Da. Katana oferă un REST API public, v1, cu o specificație OpenAPI 3.0. Pagina de prețuri menționează accesul la API pentru abonamentele Free și Advantage. Autentificarea se face cu o cheie API de tip bearer, obținută din Settings > API.
Poate SkyPlanner să transmită programul de producție înapoi în Katana?
Da. SkyPlanner reordonează comenzile de fabricație deschise din fila Schedule a Katana conform propriei secvențe, prin /manufacturing_order_rerank, și scrie valoarea production_deadline_date pentru fiecare MO. Starea operațiilor și timpul efectiv sunt înscrise pe rândurile operațiilor din MO. Programul cu intervale orare pentru fiecare centru de lucru rămâne în SkyPlanner, unde operatorii lucrează pe baza propriei liste de operații.
Katana transmite modificările în timp real?
Da. Webhook-urile Katana acoperă comenzile de fabricație, rândurile operațiilor, stocurile, comenzile de achiziție și comenzile de vânzare. SkyPlanner preia fiecare obiect modificat și reconciliază datele în fiecare noapte, astfel încât niciun eveniment ratat nu lasă o operație neactualizată.
Cum devin resursele din Katana centre de lucru în SkyPlanner?
Fiecare resursă distinctă de pe rândurile operațiilor din Katana devine un centru de lucru în SkyPlanner, cu o cheie de corespondență 1:1. Schimburile, absențele și centrele de lucru alternative sunt apoi configurate în SkyPlanner.
Putem testa SkyPlanner înainte de a dezvolta integrarea?
Da. Perioada de probă gratuită de 30 de zile permite folosirea a până la 20 de centre de lucru, cu import CSV din Katana, fără card de credit. Începeți proba gratuită sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
