What syncs between Katana and Zenventory
The table below summarizes each data type and the direction it flows between Zenventory and Katana.
Data | Direction | Status |
Orders | Two-way | Available |
Products | Zenventory → Katana | Available |
Inbound stock transfers | Zenventory → Katana | Available |
Inventory sync | Zenventory → Katana | Available |
Locations and mapping
After Zenventory approves the connection, the configuration screen opens on the Location tab. Each Zenventory warehouse maps 1:1 to its own dedicated Katana location. Click Add to Katana to create that location automatically.
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.
Products sync
Product mapping creates a required link between each Zenventory product and a Katana item. Choose how SKUs are matched:
Direct 1:1: each Zenventory SKU matches the identical Katana SKU.
SKU aliases: each Zenventory SKU matches the Katana SKU you assign to it.
Products are imported by SKU. If a SKU already exists in Katana, the product is matched to it. If a SKU is unknown, Katana creates the product 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
A SKU alias links a Zenventory SKU to a different Katana SKU. Use aliases when the same item has different SKUs in the two systems. Upload your SKU alias mapping before you import products, so mismatched SKUs match existing Katana items instead of creating new products.
Orders sync
Orders from Zenventory to Katana
Orders import once they reach the import-from status you configure. By default, this is the "Open" state. After import, each order keeps updating automatically through every later status change.
Each Zenventory order becomes one Katana sales order, with one row per order line. The order source is shown as Zenventory.
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 Zenventory, Katana deletes it only if the sales order is still open.
Orders from Katana to Zenventory
When a Katana sales order reaches the Ready for fulfillment status, Katana pushes it to Zenventory as an outbound order. From then on, Katana tracks the order's progress through the import flow described above.
Canceling the Katana sales order does not cancel the Zenventory order.
Changes made in Katana after the push do not update the Zenventory order.
Inventory sync
Zenventory's stock numbers appear in Katana as read-only external inventory at each warehouse's mapped location. Katana surfaces the on-hand quantity. You can't edit these numbers in Katana.
Reconciliation compares Katana's in-stock quantity with Zenventory's on-hand quantity. It runs on a schedule or on demand, and creates stock adjustments in Katana for any differences. Where Zenventory exposes lot or batch data, Katana shows it as read-only.
Inbound shipments
Each Zenventory 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 1:1 to the inbound shipment's warehouse.
Origin: the location assigned to each destination warehouse. This location must be mapped.
Stock transfers follow the inbound shipment's status, and received quantities update the transfer. Katana stock transfers have only two states: in transit and received. Partial receipts appear as updated expected and received quantities until the shipment is fully received. If an inbound shipment is canceled, Katana deletes its stock transfer.
What does not sync
Product and stock changes made in Katana are never sent to Zenventory.
Changes to a sales order in Katana after it's pushed don't update the Zenventory order.
Canceling a pushed sales order in Katana doesn't cancel it in Zenventory.
Returns and RMAs don't sync.
Serial numbers don't sync. Lot and batch data is read-only.
Warehouses that aren't mapped don't sync.
Disconnecting
To disconnect, go to Katana's Integrations page (not Settings), open the Zenventory integration, and disconnect it.
Syncing stops immediately. Katana stops importing orders, fulfillments, inbound shipments, and inventory, and stops pushing orders to Zenventory.
Records Katana has already ingested stay in Katana, including sales orders, fulfillments, stock transfers, products, and locations.








