Katana-integratiegids voor productieschema’s met SkyPlanner APS

Katana is één multi-tenant cloudproduct, dus alle klanten gebruiken dezelfde API. Het is een REST API, versie v1, op https://api.katanamrp.com/v1, met een OpenAPI 3.0-specificatie op https://api.katanamrp.com/v1/openapi.json. De documentatie staat in de Katana Developer Hub.

De endpoints die nodig zijn voor het opstellen van een productieschema:

• Stamgegevens: /products, /materials, /variants, /recipe_rows, /bom_rows, /product_operation_rows.
• Orders: /manufacturing_orders, /manufacturing_order_operation_rows, /manufacturing_order_recipe_rows, /manufacturing_order_productions.
• Volgorde: /manufacturing_order_rerank.
• Vraag en aanbod: /inventory, /purchase_orders, /purchase_order_rows, /sales_orders, /sales_order_rows.

Er is geen endpoint /resources. Productiemiddelen staan als resource_id en resource_name op de bewerkingsregels van producten en productieorders.

Registreer een webhook via POST /webhooks, met een HTTPS-URL en de gewenste events. (bron) Deze events zijn relevant voor het productieschema:

• manufacturing_order.created, .updated, .deleted, .in_progress, .blocked, .done
• manufacturing_order_operation_row.created, .updated, .in_progress, .paused, .completed
• current_inventory.material_updated, .material_out_of_stock
• purchase_order.* en purchase_order_row.*, inclusief ontvangst
• product.*, product_recipe_row.* en sales_order.*

De payloads zijn beknopt: het resourcetype, de actie en een href. De ontvanger haalt het volledige object op via de href. Elk bericht bevat ter verificatie een x-sha2-signature-header (HMAC SHA-256). Uw endpoint moet binnen 10 seconden antwoorden met 20X. Katana probeert het drie keer opnieuw: na 30 seconden, 2 minuten en 15 minuten.

1. Eerste import van stamgegevens. Haal producten, materialen, varianten, receptuurregels en productbewerkingsregels pagina voor pagina op. Beperk daarbij het aanvraagtempo tot onder de limiet. Maak voor elk afzonderlijk productiemiddel op de bewerkingsregels een werkcentrum in SkyPlanner aan en behoud een 1:1-sleutelkoppeling. Stel in SkyPlanner per werkcentrum ploegendiensten, verlof en overwerk in, want Katana heeft geen kalender voor productiemiddelen.

2. Ordersynchronisatie. Abonneer u op events voor productieorders, bewerkingsregels, voorraad en inkooporders. Haal bij elk event het object op via de href en werk de taak bij. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra die order is ontvangen. Een nachtelijke gegevenscontrole met filters op wijzigingsdatum vangt gemiste events op.

3. Productieschema terugschrijven. Met twee API-aanroepen zet u de planning in Katana:

• POST /manufacturing_order_rerank “moves one or more manufacturing orders to an exact place in the production schedule” (verplaatst een of meer productieorders naar een exacte positie in het productieschema). Per aanvraag kunnen maximaal 250 openstaande productieorders worden geplaatst: bovenaan, onderaan of vóór of na een opgegeven productieorder. (bron)
• PATCH /manufacturing_orders/{id} stelt production_deadline_date in. Katana accepteert dit alleen als de automatische deadlineberekening voor die fabriekslocatie is uitgeschakeld. (bron)

Het herschikken heeft niet alleen gevolgen voor de lijst. In Katana geldt: “higher-priority MOs reserve required materials and subassemblies first” (productieorders met een hogere prioriteit reserveren als eerste de benodigde materialen en subassemblages). De volgorde uit SkyPlanner bepaalt dus ook welke productieorder in Katana voorraad toegewezen krijgt.

4. Terugmeldingen vanaf de productievloer. Operators registreren werk met SkyPlanner Mobile Confirmations, Production Timer of Quick Log Mode. SkyPlanner schrijft de status en de werkelijk bestede tijd naar de bewerkingsregel van de productieorder. Blijft een fabriek in plaats daarvan de Katana Shop Floor App gebruiken, dan leest SkyPlanner de events van de bewerkingsregels in. Kies per fabriek één kanaal voor terugmeldingen.

5. Gegevensbeheer en conflictregels. Leg vóór de ingebruikname vast welk systeem leidend is en welke regels gelden bij conflicten:

• Automatische deadlines overschrijven handmatige datums. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Zodra de automatische modus is ingeschakeld, worden alle handmatige deadlines overschreven en kunnen ze niet worden hersteld.) Kies de modus eenmalig bij de projectstart.
• Geen kalender voor productiemiddelen. Leid ploegendiensten niet af uit alleen de waarde Weekly throughput. Stel ze per werkcentrum in SkyPlanner in.
• Productiemiddelen alleen op bewerkingsregels. Houd de namen van productiemiddelen in Katana ongewijzigd, want ze vormen de sleutel voor de koppeling met werkcentra in SkyPlanner.
• Tijdseenheden. planned_time_parameter wordt uitgedrukt in seconden: per eenheid voor bewerkingen van het type per-unit en als totaal voor de typen process, setup en fixed. Koppel het type correct, anders wijkt de duur af met een factor die gelijk is aan de hoeveelheid.
• Make-to-order-groepen. Bij het wijzigen van de volgorde blijven MO’s die aan dezelfde verkooporder zijn gekoppeld bij elkaar. Plan ze daarom als groep in.
• Werking van rerank gewijzigd. Sinds 7 oktober 2026 plaatsen de rerank-endpoints orders precies op de gevraagde positie. Integraties die voor de oude werking zijn geschreven, moeten opnieuw worden getest. (bron)