What syncs between Katana and Dotcom Distribution
The table below summarizes the data flows between Katana and Dotcom Distribution.
Data | Direction | Status |
Orders | Two-way | Available |
Products | Dotcom Distribution → Katana | Available |
Inbound stock transfers | Dotcom Distribution → Katana | Available |
Inventory sync | Dotcom Distribution → Katana | Available |
Locations and mapping
After Dotcom Distribution approves the connection, the configuration screen opens on the Location tab. Each Dotcom Distribution warehouse maps 1:1 to its own dedicated Katana location. Click Add to Katana to create that location automatically.
A warehouse that has never been mapped shows Not mapped until you click Add to Katana.
To pause a mapped warehouse, click Unlink. Its status then shows Unlinked.
To resume it, 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 Dotcom Distribution product and a Katana item. You choose how SKUs are matched: either directly 1:1, or through SKU aliases.
Products are imported by SKU.
If a SKU already exists in Katana, the product matches that item.
If a SKU is unknown, Katana creates the product just-in-time.
Kits and bundles are imported as Katana products. You can then add a BOM of components to them in Katana. A kit order line stays a single row on the sales order.
SKU aliasing
A SKU alias links a Dotcom Distribution SKU to a different Katana SKU. Use aliases when the same item uses different SKUs in the two systems. Upload your SKU alias mapping before the product import so mismatched SKUs match existing items instead of creating new products.
Orders sync
Orders from Dotcom Distribution to Katana
Orders import once they reach the configured import-from status. The default is the "Open" state. After import, orders keep updating automatically through every later status change.
Each Dotcom Distribution order becomes one Katana sales order, with each line as one row.
The order source is shown as Dotcom Distribution.
Each shipped package becomes a Katana fulfillment with its carrier and tracking number.
Multi-package shipments create one fulfillment per package. Together, these fulfillments never exceed the ordered quantities.
A canceled Dotcom Distribution order is deleted in Katana only if the order is still open.
Orders from Katana to Dotcom Distribution
A Katana sales order is pushed to Dotcom Distribution as an outbound order when it reaches the Ready for fulfillment status. Its progress then syncs back to Katana in the same way as imported orders.
Canceling the Katana sales order does not cancel the pushed Dotcom Distribution order.
Changes made in Katana after the push do not update the pushed order.
Inventory sync
Dotcom Distribution's stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is On hand.
Reconciliation compares Katana's in-stock quantity with Dotcom Distribution's on-hand quantity only. It runs on a schedule or on demand. Any differences are recorded as stock adjustments, which keeps Katana's stock aligned with your warehouse for planning. Katana never pushes inventory changes to Dotcom Distribution.
Inbound shipments
Each Dotcom Distribution inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when one is present; otherwise it is the inbound ID.
Destination: the Katana location mapped 1:1 to the inbound's warehouse.
Origin: the location assigned to that destination warehouse. This location must be mapped.
Status and quantities: the stock transfer follows the inbound's status, and received quantities update the transfer.
Cancellations: a canceled inbound deletes its stock transfer.
Katana stock transfers have only two states: in transit and received. Partial receiving therefore shows as updated expected and received quantities until the shipment is fully received.
What does not sync
Products and stock changes are not sent from Katana to Dotcom Distribution.
Changes made to a Katana sales order after it has been pushed do not update the Dotcom Distribution order.
Canceling a Katana sales order does not cancel the pushed Dotcom Distribution order.
Returns and RMAs are not synced.
Serial numbers are not tracked.
Lot and batch data is shown read-only, only where Dotcom Distribution provides it.
Disconnecting
To disconnect, open the Dotcom Distribution integration from Katana's Integrations page and disconnect it. Syncing stops immediately: no new orders, fulfillments, inbound shipments, or inventory updates are imported, and no sales orders are pushed.
Records already brought into Katana stay in place, including sales orders, fulfillments, products, stock transfers, and stock adjustments.