What syncs between Katana and Moda Express
The table below summarizes the data flows between Katana and Moda Express.
Data | Direction | Status |
Orders | Two-way | Available |
Products | Moda Express → Katana | Available |
Inbound stock transfers | Moda Express → Katana | Available |
Inventory sync | Moda Express → Katana | Available |
Locations and mapping
After Moda Express approves the connection, the configuration screen opens on the Location tab. Each Moda Express warehouse maps 1:1 to its own dedicated Katana location.
Not mapped: the warehouse has never been mapped. Click Add to Katana to create its Katana location automatically.
Unlink: pauses a mapped warehouse. Its status 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 is a required link between each Moda Express product and a Katana item. First, choose how SKUs are matched: direct 1:1, or through SKU aliases.
Products are imported by SKU:
When a SKU matches an existing Katana product, the two are linked.
When a SKU is unknown, Katana creates the product just-in-time.
Kits and bundles become Katana products. Add a bill of materials (BOM) of their components in Katana. A kit order line stays a single sales order row.
SKU aliases
A SKU alias links a Moda Express SKU to a different Katana SKU. Use aliases when the same item is identified differently in the two systems, for example when Moda Express catalogs styles, colors and sizes under codes that differ from your Katana SKUs.
Upload your SKU alias mapping before you import products, so items link correctly instead of being created as duplicates.
Orders sync
Orders from Moda Express
Orders import once they reach your configured import-from status (by default, the Open state). After import, they keep updating automatically through every later status change.
Each Moda Express order becomes one Katana sales order:
Each order line becomes one row.
The order source is Moda Express.
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.
If an order is canceled in Moda Express, Katana deletes it only if the sales order is still open.
Orders from Katana to Moda Express
When a Katana sales order reaches the Ready for fulfillment status, Katana pushes it to Moda Express as an outbound order. From then on, its progress is tracked back in Katana through the import flow above.
Changes you make in Katana after the push do not update the Moda Express order.
Canceling the Katana sales order does not cancel the Moda Express order.
Inventory sync
Moda Express 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 against the Moda Express on-hand quantity only. It runs on a schedule, or on demand. Where the two numbers differ, Katana creates stock adjustments for the difference.
Inbound shipments
Each Moda Express 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 to the inbound's warehouse.
Origin: the location assigned for that destination warehouse. This location must be mapped.
The stock transfer tracks the inbound status. Received quantities update the transfer, and a canceled inbound deletes its stock transfer.
Katana stock transfers have two states: in transit and received. While a shipment is partially received, the transfer shows updated expected and received quantities until it is fully received.
What does not sync
Products and stock changes are never pushed from Katana to Moda Express.
Changes to a Katana sales order after it has been pushed are not sent to Moda Express.
Canceling a Katana sales order does not cancel the Moda Express order.
Returns and RMAs are not synced.
Serial numbers are not tracked. Lot and batch data appears read-only where Moda Express provides it.
Disconnecting
To disconnect, go to Katana's Integrations page, open the Moda Express integration, and disconnect it. Syncing stops immediately: orders, fulfillments, inventory and inbound shipments no longer update, and Katana stops pushing sales orders to Moda Express.
Records already brought into Katana stay in place. This includes sales orders, fulfillments, products, stock transfers and stock adjustments.