What syncs between Katana and Boxzooka
The table below summarizes each data flow between Katana and Boxzooka.
Data | Direction | Status |
Orders | Two-way | Available |
Products | Boxzooka → Katana | Available |
Inbound stock transfers | Boxzooka → Katana | Available |
Inventory sync | Boxzooka → Katana | Available |
Locations and mapping
After Boxzooka approves the connection, the configuration screen opens on the Location tab. Each Boxzooka warehouse maps 1:1 to its own dedicated Katana location:
A warehouse that has never been mapped shows Not mapped. Click Add to Katana to create its Katana location automatically.
To pause a mapped warehouse, click Unlink. Its status then shows Unlinked.
To resume syncing an unlinked warehouse, click Relink.
Only mapped warehouses sync. Nothing syncs until you click Activate sync in the header.
Products sync
Product mapping creates a required link between each Boxzooka product and a Katana item. First, choose how SKUs are matched:
Direct 1:1: the Boxzooka SKU must equal the Katana SKU.
SKU aliases: a Boxzooka SKU links to a different Katana SKU.
Products are imported by SKU:
A Boxzooka SKU that matches an existing Katana product links to that product.
A SKU that Katana doesn't recognize creates a new 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.
SKU aliases
An SKU alias links a Boxzooka SKU to a different Katana SKU. Use aliases when the same product is coded differently in the two systems, for example when Boxzooka uses its own SKU format.
Upload your SKU alias mapping before the product import. Otherwise, mismatched SKUs create new products instead of matching your existing ones.
Orders sync
Orders from Boxzooka
Orders import once they reach the configured import-from status (default: Open). After that, they keep updating automatically through every later status change.
Each Boxzooka order becomes one Katana sales order, with one row per line. The order source is Boxzooka.
Each shipped package becomes a Katana fulfillment with carrier and tracking details. Multi-package shipments create one fulfillment per package. Together, these fulfillments never exceed the ordered quantities.
If an order is canceled in Boxzooka, Katana deletes it only if the sales order is still open.
Orders from Katana
Katana pushes a sales order to Boxzooka as an outbound order when the order reaches the Ready for fulfillment status. From then on, the order's progress in Boxzooka updates back in Katana.
Canceling the Katana sales order does not cancel the Boxzooka order.
Changes you make in Katana after the push do not update the Boxzooka order.
Inventory sync
Boxzooka's stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is Boxzooka's on-hand quantity.
Reconciliation compares Katana's in-stock quantity with Boxzooka's on-hand quantity. It runs on a schedule or whenever you trigger it, and creates stock adjustments for any differences. This keeps Katana's stock at each mapped location in line with Boxzooka.
Katana never sends inventory changes to Boxzooka.
Inbound shipments
Each Boxzooka inbound shipment becomes one Katana stock transfer:
Number: the PO number, if there is one. Otherwise, the inbound ID.
Destination: the Katana location mapped to the inbound's warehouse.
Origin: the location assigned for each destination warehouse. This must be mapped.
The stock transfer tracks the inbound's status, and received quantities update the transfer. Katana stock transfers move straight from in transit to received. Partial receiving therefore shows as updated expected and received quantities until the shipment is fully received.
If an inbound is canceled in Boxzooka, Katana deletes its stock transfer.
What does not sync
Products and stock changes are not pushed from Katana to Boxzooka.
Canceling a Katana sales order does not cancel the pushed Boxzooka order.
Changes made in Katana after an order is pushed are not sent to Boxzooka.
Returns and RMAs.
Serial-number tracking. Lot and batch data appears read-only where Boxzooka provides it.
Disconnecting
To disconnect, go to Katana's Integrations page (not Settings) and open the Boxzooka integration.
Once you disconnect, syncing stops immediately:
No new orders, fulfillments, inbound shipments, or inventory updates come in.
Katana stops pushing sales orders to Boxzooka.
Records already imported into Katana stay in Katana, including sales orders, fulfillments, products, and stock transfers.