Katana

Katana

Katana is MRP software for inventory, production, and order fulfillment. Integrates with Shopify, WooCommerce, and similar channels. Access is token-authenticated to the tenant API.

Data Model

• Products → Variants — products are catalog entries; variants are SKU-level items. Inventory tracked at variant level.
• Inventory — stock per variant per location. quantity_in_stock, quantity_committed, quantity_expected, average_cost, reorder_point.
• Recipes — bills of materials (BOMs) for manufacturing.
• Materials — raw materials/components consumed in recipes. Create, read, update, and delete supported.
• Manufacturing Orders — production orders. Create, read, update, and delete with status: NOT_STARTED, IN_PROGRESS, DONE.
• Sales Orders → Fulfillments — customer orders with tracking. Create and update supported.
• Purchase Orders → Suppliers — POs to suppliers. Suppliers support create, read, update, and delete.
• Customers → Customer Addresses — customer records. Create, read, update, and delete supported.
• Locations — warehouses (read-only).
• Costs / Price Lists / Tax Rates / Shipping Fees — pricing configuration (read-only).
• Stock Adjustments / Stocktakes — inventory corrections (read-only in this integration).

Operations

Browse: Every entity type above supports paged enumeration (page, limit).

Customers: Create with name, email, phone, company. Update any field. Delete (fails if linked to orders).

Products: Create with name and optional default variant (SKU, prices). Update name, category, flags. Delete (cascades to variants).

Manufacturing orders: Create with order_no, variant_id, planned_quantity, location_id. Update status, quantities, deadline. Delete.

Suppliers: Create with name, contact info. Update any field. Delete.

Materials: Create with name and optional variant. Update name, category, supplier. Delete.

Sales orders: Create with order_no, customer_id, and line items (variant_id + quantity). Update status, delivery date, tracking info.

Common Workflows

• New customer order: Create customer → create sales order with line items referencing variant IDs → update status as it progresses.
• Production planning: Create manufacturing order for a variant → enumerate recipes for material requirements → update MO status as production proceeds.
• New product launch: Create product with variant → set pricing → create materials for components.
• Supplier onboarding: Create supplier → link to materials via default_supplier_id update.

Gotchas

• Response nesting — collection responses wrap data in {"data": [...]}.
• High-precision decimals — quantities are 20-decimal strings. Parse as Decimal.
• variant_id required for MOs — manufacturing orders target a specific variant, not a product. Resolve variants for the product first.
• customer_id required for SOs — sales orders need an existing customer. Create the customer first.
• sales_order_rows format — line items are a JSON array of objects with variant_id and quantity.
• Some fields locked when DONE — manufacturing orders cannot have certain fields changed after completion.
• Pagination — defaults to 50 items/page. Use limit and page.