What syncs between Katana and Cybership
The table below shows each data type and the direction it flows between Katana and Cybership.
Data | Direction | Status |
Orders | Cybership → Katana | Available |
Products | Cybership → Katana | Available |
Inventory sync | Cybership → Katana | Available |
Locations and mapping
After Cybership approves the connection, the configuration screen opens on the Location tab. Each Cybership warehouse maps to its own dedicated Katana location.
Add to Katana: creates a new Katana location for the warehouse and maps it.
Unlink: pauses a mapped warehouse. Its status shows Unlinked.
Relink: resumes syncing for an unlinked warehouse.
Not mapped: shown for a warehouse that has never been mapped. Use Add to Katana to create its location.
Only mapped warehouses sync.
Products sync
Product mapping creates a required link between each Cybership product and a Katana item. Products are matched by SKU. Choose one of two matching methods:
Direct 1:1: the Cybership SKU matches the Katana SKU exactly.
SKU aliases: a Cybership SKU is linked to a different Katana SKU.
When products are imported, Cybership SKUs that already exist in Katana match the existing products. Unknown SKUs create new Katana products as they are needed.
Kits and bundles become Katana products. Add a bill of materials (BOM) of their components in Katana. A kit order line stays a single row on the sales order.
SKU aliases
A SKU alias links a Cybership SKU to a different Katana SKU. Use aliases when the same product has different SKUs in the two systems, for example because of legacy codes or warehouse-specific naming. Upload your SKU alias mapping before you import products, so mismatched SKUs match existing Katana products instead of creating new ones.
Orders sync
Orders flow one way, from Cybership to Katana.
Which orders import: Cybership orders import once they reach the configured import-from status. The default is the "Open" state.
How orders appear: each Cybership order becomes one Katana sales order, and each order line becomes one row. The order source is shown as Cybership.
Status updates: after import, orders keep updating automatically through every later status change in Cybership.
Fulfillments and tracking: each shipped package becomes a Katana fulfillment with its carrier and tracking number. A shipment with several packages creates one fulfillment per package, so one order can show several fulfillments. Together they never exceed the ordered quantities.
Cancellations: when an order is canceled in Cybership, Katana deletes the sales order only if it is still open.
Inventory sync
Cybership stock levels appear in Katana as read-only External inventory at each warehouse's mapped location. The figure shown is Cybership's on-hand quantity. You can't edit these numbers in Katana.
Reconciliation compares Katana's in-stock quantity against Cybership's on-hand quantity. It runs on a schedule or on demand. When the two numbers differ, Katana creates stock adjustments so its stock levels match the physical stock in the warehouse.
What does not sync
Katana doesn't push orders to Cybership. Orders flow from Cybership to Katana only.
Katana doesn't push products or stock changes to Cybership.
Inbound shipments don't sync, so no stock transfers are created from Cybership receiving.
Returns and RMAs don't sync.
Serial numbers don't sync. Lot and batch data appears read-only where Cybership provides it.
Disconnecting
To disconnect, go to Katana's Integrations page and open the Cybership integration. After you disconnect, syncing stops immediately: no new orders, fulfillments, products, or inventory updates come in from Cybership.
Records already imported, such as sales orders, fulfillments, products, and locations, stay in Katana.