Skip to main content

Zenventory integration setup

Map warehouses to locations, then set up two-way orders, SKU-matched products, read-only stock, and inbound transfers.

A
Written by Argo Ohvril

What syncs between Katana and Zenventory

Data flow between Zenventory and Katana

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.

the warehouse location mapping panel on the Location tab of the Zenventory configuration screen in Katana, listing Zenventory warehouses with their statuses (a mapped warehouse linked to its Katana location, one showing Not mapped with an Add to Katana button, and one showing Unlinked with a Relink button)

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.

the products mapping settings screen in the Zenventory 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 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.

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

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.

the order sync settings screen in the Zenventory integration in Katana, showing the import-from status option (default Open) and related order import options

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.

the order push settings screen in the Zenventory integration in Katana, showing that sales orders are sent to Zenventory as outbound orders when they reach the Ready for fulfillment status

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.

the inventory sync settings screen in the Zenventory integration in Katana, showing read-only external on-hand inventory per mapped location and the reconciliation schedule and on-demand reconcile options

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.

the inbound shipments screen in the Zenventory integration in Katana, showing an inbound shipment as a stock transfer with its origin and destination locations, status, and expected versus received quantities

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.

Did this answer your question?