What syncs between Katana and Flexport (Deliverr)
The table below summarizes each data flow between Katana and Flexport (Deliverr).
Data | Direction | Status |
Orders | Two-way | Available |
Products | Flexport (Deliverr) → Katana | Available |
Inbound stock transfers | Flexport (Deliverr) → Katana | Available |
Inventory sync | Flexport (Deliverr) → Katana | Available |
Locations and mapping
After you connect, the configuration screen opens on the Location tab. Each Flexport (Deliverr) warehouse maps 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 changes to Unlinked.
To resume syncing, 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 Flexport (Deliverr) product and a Katana item. Products are imported by SKU:
If a Katana product already has that SKU, the two are matched.
If the SKU is unknown in Katana, the product is created just in time.
You choose how SKUs are matched: direct 1:1, or through SKU aliases.
Kits and bundles: These are imported as Katana products. Add a bill of materials (BOM) of their components in Katana. A kit on an order line stays a single sales order row.
SKU aliasing
A SKU alias links a Flexport (Deliverr) SKU to a different Katana SKU for the same item. Use an alias when the same product has different SKUs in the two systems. Upload your SKU alias mapping before the product import, so mismatched SKUs match existing products instead of creating new ones.
Orders sync
Orders imported from Flexport (Deliverr)
Orders import once they reach the import-from status you configure (default: Open). After that, they keep updating automatically through every later status change.
Each Flexport (Deliverr) order becomes one Katana sales order, with one row per order line.
The order source is shown as Flexport (Deliverr).
Each shipped package becomes a Katana fulfillment with carrier and tracking details.
A multi-package shipment creates one fulfillment per package. Together, these never exceed the ordered quantities.
If an order is canceled in Flexport (Deliverr), it is deleted in Katana only if the Katana order is still open.
Orders sent from Katana
When a Katana sales order reaches Ready for fulfillment, it is pushed to Flexport (Deliverr) as an outbound order. From then on, its progress is tracked back into Katana in the same way as imported orders.
Canceling the Katana sales order does not cancel the Flexport (Deliverr) order.
Changes you make in Katana after the push do not update the Flexport (Deliverr) order.
Inventory sync
Flexport (Deliverr) stock levels appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is the warehouse's on-hand quantity.
Reconciliation compares Katana's in-stock quantity against Flexport (Deliverr)'s on-hand quantity. It runs on a schedule or on demand. Any differences are recorded as stock adjustments in Katana, so your Katana stock matches the warehouse.
Inbound shipments
Each Flexport (Deliverr) inbound shipment becomes one Katana stock transfer. The transfer number is the PO number if the shipment has one; otherwise it is the inbound ID.
Destination: the Katana location mapped to the inbound's warehouse.
Origin: the location you assign for each destination warehouse. This must be mapped.
The stock transfer follows the inbound's status, and received quantities update the transfer. Katana stock transfers have two states: in transit and received. Partial receipts appear as updated expected and received quantities until the shipment is fully received. If an inbound is canceled, its stock transfer is deleted.
What does not sync
Products and stock changes are not pushed from Katana to Flexport (Deliverr).
Changes to a sales order after it has been pushed are not sent to Flexport (Deliverr).
Canceling a Katana sales order does not cancel the Flexport (Deliverr) order.
Returns and RMAs are not supported.
Serial numbers are not tracked. Lot and batch data appears read-only where Flexport (Deliverr) provides it.
Warehouses that are not mapped, or are Unlinked, do not sync.
Disconnecting
To disconnect, go to Katana's Integrations page and open the Flexport (Deliverr) integration. Once disconnected, syncing stops immediately: no new orders, fulfillments, inventory updates, or inbound shipments are imported, and no sales orders are pushed.
Records already brought into Katana remain in Katana, including sales orders, fulfillments, products, stock transfers, and stock adjustments.