What syncs between Katana and Star WMS
The table below summarizes each data type and the direction it flows between Katana and Star WMS.
Data | Direction | Status |
Orders | Two-way | Available |
Products | Star WMS → Katana | Available |
Inbound stock transfers | Star WMS → Katana | Available |
Inventory sync | Star WMS → Katana | Available |
Locations and mapping
After the connection is approved, the configuration screen opens on the Location tab. Each Star WMS warehouse maps 1:1 to its own dedicated Katana location.
Not mapped: the warehouse has never been mapped. Click Add to Katana to create its Katana location automatically.
Unlink: pauses a mapped warehouse. Its status shows Unlinked.
Relink: resumes a paused warehouse.
Only mapped warehouses sync. Nothing syncs until you click Activate sync in the header.
Products sync
Product mapping creates a required link between each Star WMS product and a Katana item. Choose how SKUs are matched: direct 1:1, or through SKU aliases. Products are imported by SKU. A Star WMS SKU that matches an existing Katana product links to that product. An unknown SKU creates a new Katana product when it is first needed.
Kits and bundles become Katana products. Add a bill of materials (BOM) of their components in Katana. A kit order line stays a single sales order row.
SKU aliases
A SKU alias links a Star WMS SKU to a different Katana SKU. Use aliases when the same item has mismatched SKUs in the two systems. Upload your SKU alias mapping before importing products, so those SKUs link to the correct Katana items instead of creating new products.
Orders sync
Orders from Star WMS
Orders import once they reach the configured import-from status, which is the "Open" state by default. After import, they keep updating automatically through every later status change.
Each Star WMS order becomes one Katana sales order, and each order line becomes one row.
The order source shows the integration name.
Each shipped package becomes a Katana fulfillment with its carrier and tracking number.
Multi-package shipments create one fulfillment per package, so one order can show several fulfillments. Together, they never exceed the ordered quantities.
A canceled Star WMS order is deleted in Katana only if the order is still open.
Orders from Katana
When a Katana sales order reaches the Ready for fulfillment status, Katana pushes it to Star WMS as an outbound order. From then on, its progress flows back into Katana the same way as for imported orders.
Canceling the Katana sales order does not cancel the Star WMS order.
Changes you make in Katana after the push do not update the Star WMS order.
Inventory sync
Star WMS stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is the Star WMS on-hand quantity. You can't edit it in Katana, and Katana never sends stock changes to Star WMS.
Reconciliation compares Katana's in-stock quantity with the Star WMS on-hand quantity. It runs on a schedule or on demand, and creates stock adjustments for any differences. This keeps Katana's stock in line with the warehouse.
Inbound shipments
Each Star WMS inbound shipment becomes one Katana stock transfer.
Number: the PO number when one is present, otherwise the inbound ID.
Destination: the Katana location mapped to the inbound's warehouse. This location receives the stock.
Origin: the location you assign to each destination warehouse. It must be mapped.
The stock transfer tracks the inbound status, and received quantities update the transfer. Katana stock transfers have two states: in transit and received. Partial receipts show as updated expected and received quantities until the shipment is fully received. A canceled inbound deletes its stock transfer.
What does not sync
Products and stock changes are not pushed from Katana to Star WMS.
Changes to a Katana sales order after it is pushed do not update the Star WMS order.
Canceling a Katana sales order does not cancel the Star WMS order.
Returns and RMAs are not synced.
Serial numbers are not tracked. Lot and batch data appears read-only where Star WMS provides it.
Warehouses that are not mapped, or are Unlinked, do not sync.
Disconnecting
Disconnect Star WMS from the Star WMS tile on Katana's Integrations page. Syncing stops immediately:
No more orders, fulfillments, inbound shipments, or inventory updates come in from Star WMS.
No more sales orders are pushed out from Katana.
Records that already synced stay in Katana, including sales orders, fulfillments, products, and stock transfers.