What syncs between Katana and Cirro
The table below summarizes each data type and how it moves between Cirro and Katana.
Data | Direction | Status |
Orders | Cirro → Katana | Available |
Products | Cirro → Katana | Available |
Locations and mapping
After you connect Cirro, the configuration screen opens on the Location tab. Each Cirro warehouse maps to its own dedicated Katana location.
Not mapped: A warehouse that has never been mapped shows this status. Click Add to Katana to create its Katana location automatically.
Unlink: Pauses a mapped warehouse. Its status then shows Unlinked.
Relink: Resumes syncing for an unlinked warehouse.
Only mapped warehouses sync. Nothing syncs until you click Activate sync in the header.
Products sync
Product mapping creates a required link between each Cirro product and a Katana item. Products are matched by SKU, and you choose how SKUs are matched: direct 1:1 or through SKU aliases.
Existing SKUs: Products whose SKU already exists in Katana are matched to that item.
Unknown SKUs: Products with SKUs Katana doesn't recognize are created in Katana as needed.
Kits and bundles: Cirro kits and bundles become Katana products. Add a bill of materials (BOM) with the components in Katana. A kit on an order still appears as a single sales order row.
SKU aliases
A SKU alias links a Cirro SKU to a different Katana SKU. Use aliases when the same product has different SKUs in Cirro and Katana, so it maps to your existing Katana item instead of creating a new product.
Upload your SKU alias mapping before products are imported.
Orders sync
Orders flow one way only, from Cirro into Katana.
Which orders import: Orders import once they reach the configured import-from status. The default is the Open state.
How orders appear: Each Cirro order becomes one Katana sales order, with one row per order line. The order source shows as Cirro.
Status updates: After import, the sales order keeps updating automatically as the order's status changes in Cirro.
Fulfillments and tracking: Each shipped package becomes a Katana fulfillment with its carrier and tracking number. A multi-package shipment creates one fulfillment per package, so one order can show several fulfillments. Together, they never exceed the ordered quantities.
Cancellations: A Cirro order canceled while it's still open in Katana is deleted from Katana. Otherwise, it stays.
What does not sync
Inventory levels. Cirro stock quantities and inventory reconciliation are not part of this integration.
Inbound shipments. Cirro inbound shipments don't create stock transfers in Katana.
Sales orders sent from Katana to Cirro. Orders sync from Cirro to Katana only.
Product or stock changes made in Katana. These are never sent to Cirro.
Returns and RMAs.
Serial-number tracking.
Disconnecting
To disconnect, go to the Integrations page in Katana, open the Cirro integration, and disconnect it.
Syncing stops immediately. No new orders, order updates, fulfillments, or products are imported from Cirro.
Records already imported stay in Katana, including sales orders, fulfillments, products, and locations.