Skip to main content

Unis integration setup

Map warehouses to locations and configure two-way orders, SKU product matching, inventory, and inbound stock transfers.

A
Written by Argo Ohvril

What syncs between Katana and Unis

Data flow between Unis and Katana

The table below summarizes how each type of data moves between Katana and Unis.

Data

Direction

Status

Orders

Two-way

Available

Products

Unis → Katana

Available

Inbound stock transfers

Unis → Katana

Available

Inventory sync

Unis → Katana

Available

Locations and mapping

After Unis approves the connection, the configuration screen opens on the Location tab. Each Unis warehouse maps 1:1 to its own dedicated Katana location. Click Add to Katana next to a warehouse to create that location automatically.

  • Not mapped: the warehouse has never been mapped. Use Add to Katana to create its location.

  • Unlinked: you paused a mapped warehouse with Unlink. Click Relink to resume syncing.

Only mapped warehouses sync. Nothing syncs until you click Activate sync in the header.

the warehouse location mapping panel on the Location tab of the Unis configuration screen, listing Unis warehouses with their mapped Katana locations, an Add to Katana button for a warehouse with Not mapped status, an Unlink action for a mapped warehouse, a Relink action for a warehouse with Unlinked status, and the Activate sync button in the header

Products sync

Product mapping creates a required link between each Unis product and a Katana item. Choose how to match SKUs:

  • Direct 1:1: the Unis SKU matches the Katana SKU exactly.

  • Via SKU aliases: a Unis SKU is linked to a different Katana SKU.

Products are imported by SKU. A Unis product whose SKU matches an existing Katana product links to that product. Katana creates a new product when it first encounters an unknown SKU.

Kits and bundles from Unis become Katana products. Add a BOM of components to the kit in Katana. On orders, a kit line stays a single sales order row.

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

SKU aliasing

A SKU alias tells Katana that a Unis SKU and a Katana SKU are the same item even though the codes differ. Use aliases when Unis stores an item under a different SKU than Katana does, so the item links to your existing product and Katana doesn't create a duplicate. Upload your SKU alias mapping before you import products.

the products mapping screen with SKU alias mapping, showing an uploaded list pairing Unis SKUs with different Katana SKUs

Orders sync

From Unis 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 Unis order becomes one Katana sales order, each order line becomes one row, and the order source is Unis.

Each shipped package becomes a Katana fulfillment with carrier and tracking details. Multi-package shipments create one fulfillment per package, so an order can show several fulfillments. Together, these fulfillments never exceed the ordered quantities.

If an order is canceled in Unis, Katana deletes the sales order only if it's still open.

the order sync settings screen for the Unis integration with the import-from status option set to Open and the order status options

From Katana to Unis

When a Katana sales order reaches the Ready for fulfillment status, Katana pushes it to Unis as an outbound order. Its progress then syncs back to Katana through the import flow above.

Canceling the Katana sales order doesn't cancel the order in Unis. Changes you make in Katana after the push don't update the Unis order.

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

Inventory sync

Unis is the source of truth for physical stock. Its stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. Katana shows the Unis on-hand quantity. You can't edit these numbers in Katana, and Katana never sends stock changes to Unis.

Reconciliation compares Katana's in-stock quantity against the Unis on-hand quantity only. It runs on a schedule or on demand, and Katana creates stock adjustments for any differences. This keeps the stock levels you plan from aligned with what Unis reports.

the inventory sync settings screen for the Unis integration, showing read-only External inventory on-hand quantities per mapped location and the scheduled and on-demand reconciliation options

Inbound shipments

Each Unis inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when one is present. Otherwise, it's 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 status, and received quantities update the transfer. Katana stock transfers have two states: in transit and received. While Unis receives a shipment in parts, the transfer shows updated expected and received quantities until everything is received. If an inbound is canceled in Unis, Katana deletes its stock transfer.

the inbound shipments screen showing Unis inbound shipments as Katana stock transfers with PO or inbound ID numbers, origin and destination locations, in transit or received status, and expected versus received quantities

What does not sync

  • Products and stock changes are never pushed from Katana to Unis.

  • Changes to a Katana sales order after it's pushed don't update the Unis order.

  • Canceling a Katana sales order doesn't cancel the Unis order.

  • Returns and RMAs aren't supported.

  • Serial numbers aren't tracked. Lot and batch data appears read-only where Unis provides it.

Disconnecting

To disconnect, open the Unis integration from Katana's Integrations page. All syncing stops immediately: order import and push, fulfillment and tracking updates, inventory and reconciliation, and inbound shipment updates.

Records already brought into Katana stay in Katana. This includes sales orders, fulfillments, products, and stock transfers.

Did this answer your question?