What syncs between Katana and Stockhub
The table below summarizes each data type and the direction it flows between Stockhub and Katana.
Data | Direction | Status |
Orders | Stockhub → Katana | Available |
Products | Stockhub → Katana | Available |
Inbound stock transfers | Stockhub → Katana | Available |
Inventory sync | Stockhub → Katana | Available |
Locations and mapping
After you connect Stockhub, the configuration screen opens on the Location tab. Each Stockhub warehouse maps 1:1 to its own dedicated Katana location. Click Add to Katana to create that location automatically. Until then, the warehouse shows as Not mapped.
To pause a mapped warehouse, click Unlink. Its status then shows Unlinked. Click Relink to resume it. Only mapped warehouses sync.
Nothing syncs until you click Activate sync in the header.
Products sync
Product mapping creates a required link between each Stockhub product and a Katana item. Products are imported by SKU:
Stockhub SKUs that match existing Katana products link to those products.
Unknown SKUs create new Katana products automatically as they come in.
You choose how SKUs are matched: direct 1:1, or via SKU aliases.
Kits and bundles from Stockhub become Katana products. Add a BOM of components to them in Katana. A kit order line stays a single row on the sales order.
SKU aliases
A SKU alias links a Stockhub SKU to a different Katana SKU. Use aliases when the same product has different SKUs in Stockhub and Katana. This prevents a duplicate product from being created.
Upload your SKU alias mapping before you import products.
Orders sync
Orders flow one way, from Stockhub into Katana. An order imports once it reaches the configured import-from status, which is the Open state by default. After that, it keeps updating automatically through every later status change in Stockhub.
How orders appear in Katana:
Each Stockhub order becomes one Katana sales order.
Each order line becomes one row on the sales order.
The order source is shown as Stockhub.
Fulfillments and tracking
Each shipped package becomes a Katana fulfillment with its carrier and tracking number. A multi-package shipment creates one fulfillment per package, so a single order can show several fulfillments. Together, these fulfillments never exceed the ordered quantities.
Cancellations
When an order is canceled in Stockhub, Katana deletes the matching sales order only if that sales order is still open.
Inventory sync
Stockhub stock levels appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is Stockhub's on-hand quantity. You can't edit it in Katana.
Reconciliation compares Katana's in-stock quantity with Stockhub's on-hand quantity. It runs on a schedule, or on demand. For any difference, Katana creates a stock adjustment, so Katana's stock matches the warehouse's physical count.
Inbound shipments
Each Stockhub inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when one is present. Otherwise, it's the inbound ID.
Destination: the Katana location mapped to the inbound's Stockhub warehouse.
Origin: the location assigned to that destination warehouse. This location must be mapped.
The stock transfer follows the inbound's status, and received quantities update the transfer. Katana stock transfers move straight from in transit to received. While an inbound is partially received, the transfer shows updated expected and received quantities until everything has arrived.
If an inbound is canceled in Stockhub, Katana deletes its stock transfer.
What does not sync
Orders are not sent from Katana to Stockhub. Orders flow from Stockhub into Katana only.
Product changes are not pushed from Katana to Stockhub.
Stock changes are not pushed from Katana to Stockhub.
Returns and RMAs don't sync.
Serial numbers aren't tracked.
Lot and batch data appears read-only, where Stockhub provides it.
Disconnecting
Go to Katana's Integrations page, open the Stockhub integration, and disconnect it. Syncing stops immediately: no new orders, fulfillments, inbound shipments, or stock updates come in from Stockhub.
Records already brought into Katana stay in Katana. This includes sales orders, fulfillments, stock transfers, products, and stock adjustments.







