What syncs between Katana and ShipHero
The table below summarizes each data flow between Katana and ShipHero.
Data | Direction | Status |
Orders | Two-way | Available |
Products | ShipHero → Katana | Available |
Inbound stock transfers | ShipHero → Katana | Available |
Inventory sync | ShipHero → Katana | Available |
Locations and mapping
After ShipHero approves the connection, the configuration screen opens on the Location tab. Each ShipHero warehouse maps 1:1 to its own dedicated Katana location. A warehouse that has never been mapped shows Not mapped. Click Add to Katana to create its location automatically.
To pause a mapped warehouse, click Unlink. Its status then shows Unlinked. Click Relink to resume it. Only mapped warehouses sync.
Products sync
Product mapping creates a required link between each ShipHero product and a Katana item. You choose how SKUs are matched: direct 1:1, or through SKU aliases.
Products are imported by SKU:
A ShipHero SKU that matches an existing Katana product links to it.
An unknown SKU creates a new product in Katana just-in-time.
Kits and bundles become Katana products. Add a bill of materials (BOM) of components to them in Katana. A kit order line stays a single sales order row.
SKU aliases
An SKU alias links a ShipHero SKU to a different Katana SKU. Use one when the same item has different SKUs in ShipHero and Katana. Upload your SKU alias mapping before you import products, so the mismatched SKUs link correctly.
Orders sync
From ShipHero to Katana
Orders import once they reach the configured import-from status. The default is the "Open" state. After import, each order keeps updating automatically through every later status change.
Each ShipHero order becomes one Katana sales order, with one row per order line. The order source is ShipHero.
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.
If an order is canceled in ShipHero, Katana deletes it only if the sales order is still open.
From Katana to ShipHero
When a Katana sales order reaches the Ready for fulfillment status, Katana pushes it to ShipHero as an outbound order. From then on, its progress is tracked back in Katana through the import flow above.
Canceling the Katana sales order does not cancel the ShipHero order.
Changes made in Katana after the push do not update the ShipHero order.
Inventory sync
ShipHero's stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is On hand.
Reconciliation compares Katana's in-stock quantity with ShipHero's on-hand quantity only. It runs on a schedule or on demand. For any differences, it creates stock adjustments in Katana. This keeps Katana's stock in line with the warehouse when you plan. Katana never pushes inventory changes to ShipHero.
Inbound shipments
Each ShipHero inbound shipment becomes one Katana stock transfer:
Number: the PO number when one exists, otherwise the inbound ID.
Destination: the Katana location mapped to the inbound's warehouse.
Origin: the location assigned to each destination warehouse. This location must be mapped.
Stock transfers follow the inbound's status, and received quantities update the transfer. If an inbound is canceled, its stock transfer is deleted.
Katana stock transfers have two states: in transit and received. Partial receiving appears as updated expected and received quantities until the shipment is fully received.
What does not sync
Products and stock changes are never pushed from Katana to ShipHero.
Changes to a Katana sales order after it has been pushed are not sent to ShipHero.
Canceling a Katana sales order does not cancel the ShipHero order.
Returns and RMAs are not synced.
Serial numbers are not tracked. Lot and batch data appears read-only where ShipHero provides it.
Disconnecting
To disconnect, open the ShipHero integration from Katana's Integrations page. Syncing stops immediately:
No new orders, fulfillments, inbound shipments or inventory updates come in from ShipHero.
No sales orders are pushed to ShipHero.
Everything already imported stays in Katana. This includes sales orders, fulfillments, products and stock transfers.