What syncs between Katana and Crafty
The table below lists each data type and the direction it moves between Crafty and Katana.
Data | Direction | Status |
Orders | Crafty → Katana | Available |
Products | Crafty → Katana | Available |
Inbound stock transfers | Crafty → Katana | Available |
Inventory sync | Crafty → Katana | Available |
Locations and mapping
After you connect Crafty from Katana's Integrations page, the configuration screen opens on the Location tab. Nothing syncs until you click Activate sync in the header.
One location per warehouse: Each Crafty warehouse maps to its own dedicated Katana location. Click Add to Katana to create that location automatically.
Pausing a warehouse: Click Unlink to pause a mapped warehouse. Its status shows Unlinked. Click Relink to resume it.
Warehouses you haven't mapped: A warehouse that was never mapped shows Not mapped until you click Add to Katana.
Only mapped warehouses sync.
Products sync
Product mapping links each Crafty product to a Katana item. Every synced product needs this link. First, choose how SKUs are matched: direct 1:1, or through SKU aliases.
Existing products: Products are imported by SKU. A Crafty SKU that already exists in Katana is matched to that Katana product.
New SKUs: A SKU that Katana doesn't recognize creates a new Katana product just-in-time.
Kits and bundles: These become Katana products. Add a BOM of their components in Katana. A kit on an order stays a single sales order row.
SKU aliases
A SKU alias links a Crafty SKU to a different Katana SKU. Use aliases when the same item has a different SKU in Crafty than in Katana. This lets the item match the existing Katana product instead of creating a duplicate.
Upload your SKU alias mapping before you import products.
Orders sync
Orders flow one way, from Crafty into Katana.
Which orders import: A Crafty order imports once it reaches the import-from status you configure. The default is the "Open" state.
How orders appear: Each Crafty order becomes one Katana sales order, with one row per order line. The order source shows as Crafty.
Status updates: After import, the sales order keeps updating automatically through every later status change in Crafty.
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: If an order is canceled in Crafty, Katana deletes the sales order only if it is still open. Canceling a sales order in Katana does not cancel the order in Crafty.
Inventory sync
Crafty 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. The number shown is the on-hand quantity.
Reconciliation: Katana compares its in-stock quantity against Crafty's on-hand quantity. This runs on a schedule or on demand, and Katana creates stock adjustments for any differences. Katana never sends stock changes to Crafty.
Inbound shipments
Each Crafty inbound shipment becomes one Katana stock transfer.
Transfer number: The PO number, if the inbound has one. Otherwise, the inbound ID.
Destination: The Katana location mapped to the inbound's warehouse. This location receives the stock.
Origin: The location assigned to each destination warehouse. It must be mapped.
Status and quantities: The stock transfer follows the inbound's status, and received quantities update the transfer.
Partial receiving: Katana stock transfers have only two states: in transit and received. Partial receiving shows as updated expected and received quantities until the shipment is fully received.
Cancellations: If an inbound is canceled, its stock transfer is deleted.
What does not sync
Orders out of Katana: Katana doesn't send orders to Crafty. Orders flow from Crafty into Katana only.
Products and stock changes: Katana doesn't send product or stock changes to Crafty.
Returns and RMAs: These don't sync.
Serial numbers: Serial-number tracking isn't supported. Lot and batch data appears read-only where Crafty provides it.
Disconnecting
To disconnect, open the Crafty integration from Katana's Integrations page and disconnect it. Syncing stops right away: no new orders, fulfillments, inventory updates, products, or inbound shipments come in from Crafty.
Records that already synced stay in Katana, including sales orders, fulfillments, products, stock transfers, and stock adjustments.