Integrationer / ERP / Katana
Guide till Katana-integration för produktionsplanering med SkyPlanner APS
Den här guiden visar konsulter och IT-team hur de ansluter Katana Cloud Inventory (Katana MRP) till SkyPlanner APS. SkyPlanner utbyter data med Katana i båda riktningarna via Katanas publika API:
- Tillverkningsorder, operationsrader, produktrecept, produktionsoperationer, resurser, lagersaldon och inköpsorder läses in.
- Den planerade ordningsföljden skickas tillbaka till fliken Schedule i Katana, med ett slutdatum för produktionen på varje tillverkningsorder.
- Operationsstatus och faktisk tidsåtgång skickas tillbaka till operationsraderna.
- Webhooks från Katana meddelar inkommande ändringar, och webhooks från SkyPlanner skickar ut planändringar när de sker.
SkyPlanner-teamet konfigurerar integrationen efter er Katana-miljö vid införandet och ger support efter driftsättningen. Den här guiden är för konsulter och utvecklare som vill delta eller själva bygga vidare på SkyPlanners dokumenterade REST API (API-referens).
Katana API
Katana är en molnprodukt med gemensam miljö för flera kunder, så alla kunder använder samma API. Det är ett REST API, version v1, på https://api.katanamrp.com/v1, med en OpenAPI 3.0-specifikation på https://api.katanamrp.com/v1/openapi.json. Dokumentationen finns i Katana Developer Hub.
De endpoints som behövs för planeringen:
- Grunddata:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Order:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Ordningsföljd:
/manufacturing_order_rerank. - Tillgång och efterfrågan:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Det finns ingen endpoint för /resources. Resurser anges som resource_id och resource_name på produkternas operationsrader och på tillverkningsorderns operationsrader.
Autentisering och begränsningar
Autentiseringen använder en API-nyckel som bearer-token: Authorization: Bearer <api key>. Skapa nyckeln under Settings > API > Add new API key. (källa)
Begränsningarna styr hur synkroniseringen utformas:
- Som standard tillåter Katana API 60 anrop per 60 sekunder (källa)
- Om gränsen överskrids returnerar API:et 429 med
Retry-After.X-Ratelimit-Remainingvisar hur många anrop som återstår. - Endpoints för listor returnerar resultaten sidvis och stöder filtrering på uppdateringsdatum, så mängden ändringsdata hålls liten.
SkyPlanners REST API använder en API-token för autentisering (SkyPlanner Settings > API) och är dokumenterat i Swagger/OpenAPI. Integrationshandledningen går igenom de första anropen.
Webhooks
Registrera en webhook med POST /webhooks, en HTTPS-URL och de händelser ni behöver. (källa) Följande händelser är användbara för planeringen:
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.*ochpurchase_order_row.*, inklusive receivedproduct.*,product_recipe_row.*ochsales_order.*
Meddelandena innehåller bara resurstyp, åtgärd och en href. Mottagaren hämtar hela objektet från adressen i href. Varje leverans har ett x-sha2-signature-huvud (HMAC SHA-256) för verifiering. Er endpoint måste svara med 20X inom 10 sekunder. Katana gör tre nya försök, efter 30 sekunder, 2 minuter och 15 minuter.
Datamappning
| Katana-objekt (endpoint) | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
Produkter, material, varianter (/products, /materials, /variants) | Produkter och material | Katana → SkyPlanner | Första inläsning, därefter via webhook |
Produktrecept / BOM (/recipe_rows, /bom_rows) | Produktstruktur, delprodukter | Katana → SkyPlanner | Första inläsning, därefter via webhook |
Produktionsoperationer (/product_operation_rows): typ, resurs, tid | Processteg med tidsåtgång och ställtider | Katana → SkyPlanner | Första inläsning, därefter vid ändring |
Resurser (resource_id, resource_name på operationsrader) | Produktionsgrupper, grupper av produktionsgrupper | Katana → SkyPlanner | Första inläsning, sedan vid ny resurs |
Tillverkningsorder med operationsrader (/manufacturing_orders, /manufacturing_order_operation_rows) | Order och operationer | Katana → SkyPlanner | I realtid via webhook |
Material i tillverkningsordern (/manufacturing_order_recipe_rows) | Material per operation | Katana → SkyPlanner | I realtid via webhook |
Lagersaldon, inköpsorder med ankomstdatum (/inventory, /purchase_order_rows) | Lager och inkommande material | Katana → SkyPlanner | I realtid via webhook |
Kundorderns delivery_date (/sales_orders) | Orderns leveransdatum, kundprioritet | Katana → SkyPlanner | I realtid via webhook |
Tillverkningsordrarnas ordningsföljd (POST /manufacturing_order_rerank) | Planerad ordningsföljd för öppna tillverkningsorder | SkyPlanner → Katana | Vid planändring |
Tillverkningsorderns production_deadline_date (PATCH /manufacturing_orders/{id}) | Planerad sluttid | SkyPlanner → Katana | Vid planändring |
Operationsradens status, total_actual_time (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, tidsloggar | SkyPlanner → Katana | När arbete registreras |
| Finns inte i Katana | Skift, frånvaro, ställtidsmatris, verktyg, antal operatörer, alternativa produktionsgrupper | Underhålls i SkyPlanner | Konfigureras vid införandet |
Integrationsmönster
1. Första inläsning av grunddata. Hämta produkter, material, varianter, receptrader och produkternas operationsrader sidvis, med en anropstakt under gränsen. Skapa produktionsgrupper i SkyPlanner utifrån de unika resurserna på operationsraderna och behåll en 1:1-koppling mellan nycklarna. Ange skift, ledighet och övertid per produktionsgrupp i SkyPlanner, eftersom Katana saknar resurskalender.
2. Ordersynkronisering. Prenumerera på händelser för tillverkningsorder, operationsrader, lagersaldon och inköpsorder. Hämta objektet från dess href vid varje händelse och uppdatera operationen. SkyPlanner räknar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagret när inköpsordern inlevereras. En nattlig avstämning med filter på uppdateringsdatum fångar upp eventuella missade händelser.
3. Återskrivning av planen. Två anrop för över planen till Katana:
- POST
/manufacturing_order_rerank”moves one or more manufacturing orders to an exact place in the production schedule” (flyttar en eller flera tillverkningsorder till en exakt position i produktionsplanen). Anropet hanterar upp till 250 öppna tillverkningsorder per begäran och placerar dem överst, nederst eller före eller efter en angiven tillverkningsorder. (källa) - PATCH
/manufacturing_orders/{id}angerproduction_deadline_date. Katana accepterar värdet endast när automatisk beräkning av slutdatum är avstängd för den aktuella fabriksplatsen. (källa)
Den ändrade ordningsföljden påverkar mer än listan. I Katana gäller att ”higher-priority MOs reserve required materials and subassemblies first” (tillverkningsorder med högre prioritet reserverar nödvändigt material och delmontage först). Ordningsföljden från SkyPlanner avgör alltså också vilken tillverkningsorder som får tillgång till materialet i lager i Katana.
4. Återrapportering från produktionsgolvet. Operatörerna registrerar arbete med SkyPlanner Mobile Confirmations, Production Timer eller Quick Log Mode. SkyPlanner skriver status och faktisk tidsåtgång till tillverkningsorderns operationsrad. Om en fabrik i stället behåller Katana Shop Floor App läser SkyPlanner händelserna för operationsraderna. Välj en rapporteringskanal per fabrik.
5. Dataägarskap och konfliktregler. Dokumentera dem före driftsättningen:
| Data | Ägare |
|---|---|
| Produkter, recept, produktionsoperationer, lagersaldon, inköp, kundorder | Katana |
| Operationernas ordningsföljd, start- och sluttider, produktionsgrupp per operation | SkyPlanner |
| Tillverkningsorderns placering på fliken Schedule och slutdatum för produktionen | SkyPlanner, skrivs till Katana |
| Skift, frånvaro, ställtidsmatris, verktyg, alternativa resurser | SkyPlanner |
| Operationsstatus och rapporterad tid | En kanal, vald vid kartläggningen |
Typiska projektsteg
Implementeringen blir normalt klar inom några veckor efter att introduktionen har börjat. Innan dess kan du under den kostnadsfria provperioden på 30 dagar använda egna data från en CSV-export ur Katana, till exempel listan Tasks i vyn Make.
Själva projektet omfattar:
- Abonnemang och nyckel. Kontrollera att Katana-abonnemanget omfattar API och Manufacturing Management och skapa API-nyckeln.
- Läge för slutdatum. Kom överens om att stänga av automatiska slutdatum för fabriken, så att SkyPlanner styr produktionens slutdatum.
- Mappning. Fastställ mappningstabellen, resursnycklarna, reglerna för vilket system som styr vilka data och rapporteringskanalen.
- Första inläsning. Produkter, varianter, recept, produktionsoperationer och resurser.
- Händelsestyrd synkronisering. Webhooks för order, operationer, lagersaldon och inköpsorder samt nattlig avstämning.
- Begränsningar i SkyPlanner. Ställ in skift, ställtidsmatris, verktyg, antal operatörer och alternativa produktionsgrupper.
- Återskrivning. Ändrad ordningsföljd och slutdatum, därefter operationsstatus och tid.
- Parallella tester och driftstart. Jämför datumen i SkyPlanner med den befintliga fliken Schedule, rätta grunddata och aktivera sedan återskrivningen.
Att planera för vid en Katana-integration
- Automatiskt läge skriver över slutdatumen. ”Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (När automatiskt läge aktiveras skrivs alla manuella slutdatum över och kan inte återställas.) Bestäm läget en gång, vid projektstarten.
- Ingen resurskalender. Härled inte skift från det enda värdet Weekly throughput. Lägg upp dem per produktionsgrupp i SkyPlanner.
- Resurser finns bara på operationsrader. Behåll resursnamnen oförändrade i Katana, eftersom de fungerar som nycklar till produktionsgrupperna i SkyPlanner.
- Tidsenheter.
planned_time_parameteranges i sekunder: per enhet för operationer av typen per-unit och totalt för typerna process, setup och fixed. Mappa typen rätt, annars blir tidsåtgången fel med en faktor som motsvarar kvantiteten. - Grupper vid tillverkning mot kundorder. När ordningsföljden ändras hålls tillverkningsorder som är kopplade till samma kundorder ihop. Planera därför deras ordningsföljd som en grupp.
- Ändrat beteende för rerank. Sedan 7 oktober 2026 placerar rerank-endpointarna order exakt där det begärs. Integrationer som byggts för det tidigare beteendet behöver testas på nytt. (källa)
Katana-integrationen: vem konfigurerar den och ger support?
Arbetet omfattar era resurser, produktionsoperationer, orderflöden och inställningen för hur slutdatum hanteras. Det kompletterar med sådant som saknas i Katana: skift, ställtidsmatris, verktyg, antal operatörer och alternativa resurser.
- SkyPlanner-teamet konfigurerar integrationen under introduktionen och ger support efter driftstarten. Varje fabrik lägger upp resurser och operationer i Katana på sitt eget sätt. Den kunskapen tas till vara här.
- Er Katana-konsult eller integrationspartner kan bygga den. SkyPlanner tillhandahåller REST API, Swagger/OpenAPI-dokumentation och webhooks.
- Era egna utvecklare kan bygga vidare på den med en API-token. En API-token räcker för att komma igång, och SkyPlanner-teamet hjälper till vid behov. Produktdokumentationen, inklusive inköpsorder och API:et för produkter och material, finns i SkyPlanners dokumentation.
SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Ni får en offert för integrationen utifrån era processer och behov, tillsammans med abonnemanget, så att ni ser hela kostnaden innan ni börjar. Se priser, funktioner och hur Katanas egen planering står sig i jämförelsen om finplanering i Katana. En översikt finns på Katana-sidan och andra ERP-system finns i översikten över ERP-integrationer.
Tillverkares omdömen om SkyPlanner
2 hsparas varje vecka
”SkyPlanner har tagit vår produktionsplanering från Excel-ark till produktionsoptimering i realtid.”
Kalle Kalliomäki, specialist inom försörjningskedjan
UTU · Elcentraler och ställverk
Produktionsplaneringen sparar 2 timmars arbetstid varje vecka, och en ny arbetskö når produktionslinjen på några sekunder.
+90 %produktionseffektivitet
”Effektiviteten i produktionen har ökat med 90 %.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Läkemedelstillverkning
Produktionseffektiviteten har ökat med 90 %, och det tar under 30 minuter att skapa en optimerad plan för tre månader för samtliga produktionsgrupper.
Färrestopp på grund av materialbrist
”Värdet med SkyPlanner för oss är att det är ett verktyg som fungerar i vardagen, särskilt när vi ska fastställa leveransdatum.”
Tommi Männistö, produktionsplaneringschef
Eskomatic · Legobearbetning
Automatisk beläggningsplanering ger mer precisa leveransdatum, och produktionsstoppen som orsakas av materialbrist har minskat kraftigt.
1 000-talstillverkningsorder planeras automatiskt
”Vi har kontroll över produktionen på ett annat sätt, och vår förståelse för kapaciteten ligger på en helt annan nivå.”
Hannu Ryynänen, vd
Mamec · Industriella blandare, pumpar och högteknologisk legotillverkning
Tusentals tillverkningsorder planeras automatiskt, och hela organisationen får en realtidsbild av produktionen.
Vanliga frågor
Har Katana ett API, och vilket abonnemang behöver jag?
Ja. Katana erbjuder ett publikt REST API, v1, med en OpenAPI 3.0-specifikation. Enligt prissidan ingår API-åtkomst i abonnemangen Free och Advantage. Autentiseringen sker med en API-nyckel av typen bearer från Settings > API.
Kan SkyPlanner skriva tillbaka produktionsplanen till Katana?
Ja. SkyPlanner ordnar öppna tillverkningsorder enligt sin egen ordningsföljd på Katanas flik Schedule via /manufacturing_order_rerank och skriver production_deadline_date för varje tillverkningsorder. Operationsstatus och faktisk tid förs över till tillverkningsorderns operationsrader. Den tidsatta planen per produktionsgrupp finns i SkyPlanner, där operatörerna arbetar utifrån sin arbetskö.
Skickar Katana ändringar i realtid?
Ja. Katanas webhooks omfattar tillverkningsorder, operationsrader, lager, inköpsorder och kundorder. SkyPlanner hämtar varje ändrat objekt och gör en nattlig avstämning, så att uppgifterna för en operation aldrig förblir inaktuella om en händelse missas.
Hur blir resurser i Katana produktionsgrupper i SkyPlanner?
Varje unik resurs på Katanas operationsrader blir en produktionsgrupp i SkyPlanner med en 1:1-koppling via nyckel. Skift, frånvaro och alternativa produktionsgrupper ställs sedan in i SkyPlanner.
Kan vi testa SkyPlanner innan vi bygger integrationen?
Ja. Under den kostnadsfria provperioden på 30 dagar kan ni använda upp till 20 produktionsgrupper med CSV-import från Katana. Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för att kartlägga integrationen.
