Skip to main content

Stockhub integration setup

Map Stockhub warehouses to locations, then configure order, SKU-based product, inbound transfer, and inventory syncs.

A
Written by Argo Ohvril

What syncs between Katana and Stockhub

Data flow between Stockhub and Katana

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.

the warehouse location mapping panel on the Location tab of the Stockhub configuration screen in Katana, listing Stockhub warehouses with their mapped Katana locations, an Add to Katana button on a warehouse with Not mapped status, Unlink and Relink actions on mapped warehouses, one warehouse showing Unlinked status, and the Activate sync button 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.

the products mapping settings screen in the Stockhub integration in Katana, showing the SKU matching choice between direct 1:1 matching and matching via SKU aliases

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.

the products mapping screen with SKU alias mapping in the Stockhub integration in Katana, showing an uploaded list pairing Stockhub SKUs with different Katana SKUs

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.

the order sync settings screen in the Stockhub integration in Katana, showing the import-from status option set to Open and the order import and status options

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.

the inventory sync settings screen in the Stockhub integration in Katana, showing the reconciliation schedule and on-demand reconciliation option, with read-only External inventory on-hand quantities per mapped location

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.

the inbound shipments screen in the Stockhub integration in Katana, showing Stockhub inbound shipments as stock transfers with transfer number, origin and destination locations, status, and expected versus received quantities

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.

Did this answer your question?