Skip to main content

Warehance integration setup

Map warehouses to locations, then configure two-way order sync, SKU product import, inventory reconciliation, and inbounds.

A
Written by Argo Ohvril

What syncs between Katana and Warehance

Data flow between Warehance and Katana

The table below summarizes the data exchanged between Katana and Warehance.

Data

Direction

Status

Orders

Two-way

Available

Products

Warehance → Katana

Available

Inbound stock transfers

Warehance → Katana

Available

Inventory sync

Warehance → Katana

Available

Locations and mapping

Connect Warehance from Katana's Integrations page. Click Connect and enter your Warehance API key. When the connection is approved, the configuration screen opens on the Location tab.

Each Warehance warehouse maps to its own dedicated Katana location. Click Add to Katana to create that location automatically. Until then, a warehouse that was never mapped shows 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, listing Warehance warehouses with their statuses (mapped to a Katana location, Unlinked, Not mapped), the Add to Katana, Unlink and Relink actions, and the Activate sync button in the header

Products sync

Product mapping creates a required link between each Warehance product and a Katana item. Products are imported by SKU:

  • When a SKU matches an existing Katana product, the two are linked.

  • When a SKU is unknown, Katana creates the product just-in-time.

You choose how SKUs are matched: direct 1:1, or through SKU aliases.

Kits and bundles from Warehance become Katana products. Add a bill of materials (BOM) with their components in Katana. On orders, a kit line stays a single sales-order row.

the products mapping settings screen showing the SKU matching choice between direct 1:1 matching and matching via SKU aliases

SKU aliasing

A SKU alias links a Warehance SKU to a different Katana SKU. Use aliases when the same product has mismatched SKUs in the two systems. Upload your SKU alias mapping before importing products, so those products link to the correct Katana items.

the products mapping screen with SKU alias mapping, showing Warehance SKUs paired with different Katana SKUs and the option to upload an alias mapping

Orders sync

From Warehance to Katana

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 Warehance order becomes one Katana sales order, with one row per order line. The order source is set to Warehance.

Each shipped package becomes a Katana fulfillment with its carrier and tracking number. Multi-package shipments create one fulfillment per package. Together, these fulfillments never exceed the ordered quantities.

If an order is canceled in Warehance, it is deleted in Katana only if the sales order is still open.

the order sync settings screen with the import and status options, showing the import-from status selector set to Open

From Katana to Warehance

When a Katana sales order reaches the Ready for fulfillment status, it is pushed to Warehance as an outbound order. Its progress then syncs back to Katana like any imported order.

Canceling the Katana sales order does not cancel the pushed Warehance order. Changes you make in Katana after the push do not update the Warehance order.

the order push settings screen showing that Katana sales orders are sent to Warehance when they reach the Ready for fulfillment status

Inventory sync

Warehance stock levels appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is Warehance's On hand quantity. You can't edit these numbers in Katana.

Reconciliation compares Katana's in-stock quantity against Warehance's on-hand quantity. It runs on a schedule or on demand. For any difference, it creates a stock adjustment in Katana.

the inventory sync settings screen showing read-only External inventory with On hand quantities per mapped location, and reconciliation options for scheduled or on-demand runs

Inbound shipments

Each Warehance inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when one exists; otherwise it's the inbound ID.

  • Destination: the Katana location mapped to the inbound's warehouse.

  • Origin: the location assigned for each destination warehouse. This location must be mapped.

Stock transfers follow the inbound's status, and received quantities update the transfer. Katana stock transfers have two states: in transit and received. Partial receipts appear as updated expected and received quantities until the shipment is fully received.

If an inbound is canceled, its stock transfer is deleted.

the inbound shipments screen showing Warehance inbounds as Katana stock transfers with PO or inbound numbers, origin and destination locations, status, and expected versus received quantities

What does not sync

  • Product or stock changes are not sent from Katana to Warehance.

  • Changes to a Katana sales order after it's pushed do not update the Warehance order.

  • Canceling a Katana sales order does not cancel the Warehance order.

  • Returns and RMAs are not synced.

  • Serial numbers are not tracked. Lot and batch data appears read-only where Warehance provides it.

Disconnecting

To disconnect, open Katana's Integrations page, select the Warehance integration, and disconnect it.

Syncing stops immediately: no new orders, fulfillments, inventory updates, or inbound shipments come in, and no sales orders are pushed to Warehance.

Records already imported into Katana stay in place, including sales orders, fulfillments, products, and stock transfers.

Did this answer your question?