What syncs between Katana and Shipwire
The table below summarizes each sync area between Katana and Shipwire.
Data | Direction | Status |
Orders | Two-way | Available |
Products | Shipwire → Katana | Available |
Inbound stock transfers | Shipwire → Katana | Available |
Inventory sync | Shipwire → Katana | Available |
Locations and mapping
After you connect Shipwire, the configuration screen opens on the Location tab. Each Shipwire warehouse maps 1:1 to its own dedicated Katana location.
Add to Katana creates the Katana location for a warehouse and maps it.
A warehouse that has never been mapped shows Not mapped until you click Add to Katana.
To pause a mapped warehouse, click Unlink. Its status then shows Unlinked.
To resume a paused warehouse, click Relink.
Only mapped warehouses sync. Nothing syncs at all until you click Activate sync in the header.
Products sync
Product mapping creates a required link between each Shipwire product and a Katana item. Before importing, choose how SKUs are matched: direct 1:1, or through SKU aliases.
Products are imported by SKU:
When a Shipwire SKU matches an existing Katana product, the two are linked.
When a SKU is unknown in Katana, a product is created just-in-time.
Kits and bundles from Shipwire become Katana products. You can then add a BOM of components to them in Katana. On a sales order, a kit order line stays a single row.
SKU aliases
A SKU alias links a Shipwire SKU to a different Katana SKU. Use aliases when the same item has mismatched SKUs in the two systems, so that it matches instead of creating a duplicate product. Upload your SKU alias mapping before you import products.
Orders sync
Orders from Shipwire
Shipwire orders import once they reach the configured import-from status. By default, this is the "Open" state. After import, orders keep updating automatically through every later status change.
Each Shipwire order becomes one Katana sales order, with one row per order line. The order source is shown as Shipwire.
Each shipped package becomes a Katana fulfillment with its carrier and tracking number. Multi-package shipments create 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 Shipwire, it is deleted in Katana only if the order is still open.
Orders from Katana to Shipwire
When a Katana sales order reaches the Ready for fulfillment status, it is pushed to Shipwire as an outbound order. From then on, its progress is tracked back in Katana the same way as imported orders.
After the push:
Canceling the Katana sales order does not cancel the Shipwire order.
Changes you make to the order in Katana do not update the Shipwire order.
Inventory sync
Shipwire's stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is Shipwire's on hand quantity.
Reconciliation compares Katana's in-stock quantity with Shipwire's on-hand quantity only. It runs on a schedule or on demand, and it creates stock adjustments in Katana for any differences. This keeps Katana's stock aligned with Shipwire, the source of physical truth.
Katana never pushes inventory changes to Shipwire.
Inbound shipments
Each Shipwire inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when one exists; otherwise, it is the inbound ID.
Destination: the Katana location mapped to the inbound's Shipwire warehouse.
Origin: the location you assign for each destination warehouse. This location must be mapped.
The stock transfer tracks the inbound's status, and received quantities update the transfer. Katana stock transfers have two states: in transit and received. Partial receiving therefore shows as updated expected and received quantities until the shipment is fully received.
If the inbound is canceled in Shipwire, its stock transfer is deleted.
What does not sync
Product or stock changes are never pushed from Katana to Shipwire.
Changes made in Katana after an order is pushed do not update the Shipwire order.
Canceling a Katana sales order does not cancel the pushed Shipwire order.
Returns and RMAs are not supported.
Serial-number tracking is not supported.
Lot and batch data is shown read-only where Shipwire provides it.
Disconnecting
To disconnect, open the Shipwire integration from Katana's Integrations page (not under Settings). Once disconnected, syncing with Shipwire stops: no new orders, inventory updates, or inbound shipments are imported, and no sales orders are pushed.
Records already brought into Katana stay in Katana. This includes sales orders, fulfillments, products, stock transfers, and stock adjustments.