Guide til Katana-integrasjon for produksjonsplanlegging med SkyPlanner APS

Katana er ett skyprodukt med felles infrastruktur for flere kunder, så alle kunder bruker samme API. Det er et REST API, versjon v1, på https://api.katanamrp.com/v1, med en OpenAPI 3.0-spesifikasjon på https://api.katanamrp.com/v1/openapi.json. Dokumentasjonen finnes i Katana Developer Hub.

Endepunktene som trengs til produksjonsplanlegging:

• Grunndata: /products, /materials, /variants, /recipe_rows, /bom_rows, /product_operation_rows.
• Ordrer: /manufacturing_orders, /manufacturing_order_operation_rows, /manufacturing_order_recipe_rows, /manufacturing_order_productions.
• Rekkefølge: /manufacturing_order_rerank.
• Tilgang og behov: /inventory, /purchase_orders, /purchase_order_rows, /sales_orders, /sales_order_rows.

Det finnes ikke noe /resources-endepunkt. Ressursene er oppgitt som resource_id og resource_name på operasjonslinjene for produkter og produksjonsordrer.

Registrer en webhook med POST /webhooks, en HTTPS-URL og hendelsene du trenger. (kilde) Disse hendelsene er nyttige for produksjonsplanlegging:

• 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.* og purchase_order_row.*, inkludert received
• product.*, product_recipe_row.* og sales_order.*

Meldingene inneholder lite data: ressurstype, handling og en href. Mottakeren henter hele objektet fra href-adressen. Hver levering har en x-sha2-signature-header (HMAC SHA-256) for verifisering. Endepunktet ditt må svare med 20X innen 10 sekunder. Katana prøver på nytt tre ganger, etter 30 sekunder, 2 minutter og 15 minutter.

1. Førstegangsinnlasting av grunndata. Hent produkter, materialer, varianter, oppskriftslinjer og produktoperasjonslinjer side for side, med en kallfrekvens under grensen. Opprett arbeidsstasjoner i SkyPlanner fra de unike ressursene på operasjonslinjene, og behold en 1:1-nøkkelkobling. Angi skift, fravær og overtid per arbeidsstasjon i SkyPlanner, siden Katana ikke har noen ressurskalender.

2. Ordresynkronisering. Abonner på hendelser for produksjonsordrer, operasjonslinjer, lagerbeholdning og innkjøpsordrer. Hent objektet fra href-adressen ved hver hendelse, og oppdater jobben. SkyPlanner regner bestilte materialer som tilgjengelige på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren mottas. En nattlig avstemming med filtre på oppdateringsdato fanger opp eventuelle hendelser som ikke ble behandlet.

3. Tilbakeskriving av planen. To kall overfører planen til Katana:

• POST /manufacturing_order_rerank «moves one or more manufacturing orders to an exact place in the production schedule» (flytter én eller flere produksjonsordrer til en bestemt plass i produksjonsplanen). Kallet tar opptil 250 åpne produksjonsordrer per forespørsel og plasserer dem øverst, nederst eller før eller etter en angitt produksjonsordre. (kilde)
• PATCH /manufacturing_orders/{id} angir production_deadline_date. Katana godtar dette bare når automatisk fristberegning er slått av for den aktuelle fabrikklokasjonen. (kilde)

Endret rekkefølge påvirker mer enn listen. I Katana gjelder følgende: «higher-priority MOs reserve required materials and subassemblies first» (produksjonsordrer med høyere prioritet reserverer nødvendige materialer og delmontasjer først). Dermed avgjør rekkefølgen fra SkyPlanner også hvilken produksjonsordre som får tildelt lagerbeholdning i Katana.

4. Tilbakemeldinger fra produksjonsgulvet. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations, Production Timer eller Quick Log Mode. SkyPlanner skriver status og faktisk tidsbruk til operasjonslinjen på produksjonsordren. Hvis en fabrikk i stedet beholder Katana Shop Floor App, leser SkyPlanner hendelsene for operasjonslinjene. Velg én rapporteringskanal per fabrikk.

5. Dataeierskap og konfliktregler. Dokumenter dem før løsningen settes i drift:

• Fristmodusen overskriver datoer. «Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.» (Når automatisk modus aktiveres, overskrives alle manuelle frister og kan ikke gjenopprettes.) Velg modus én gang, ved prosjektstart.
• Ingen ressurskalender. Ikke utled skift fra den ene verdien i Weekly throughput. Sett opp skiftene per arbeidsstasjon i SkyPlanner.
• Ressurser finnes bare på operasjonsradene. Hold ressursnavnene i Katana uendret, ettersom de brukes som nøkkel til arbeidsstasjonene i SkyPlanner.
• Tidsenheter. planned_time_parameter angis i sekunder: per enhet for operasjoner av typen per-unit og som totaltid for typene process, setup og fixed. Koble typen riktig, ellers blir varigheten feil med en faktor som tilsvarer antallet.
• Grupper ved produksjon mot ordre. Når rekkefølgen endres, holdes produksjonsordrer (MO) som er knyttet til samme salgsordre, samlet. Planlegg dem derfor som en gruppe.
• Virkemåten for rerank er endret. Siden 7. oktober 2026 plasserer rerank-endepunktene ordrer på nøyaktig ønsket plass. Integrasjoner som er laget for den tidligere virkemåten, må testes på nytt. (kilde)