What syncs between Katana and FFE
The table below lists each type of data and how it moves between FFE and Katana.
Data | Direction | Status |
Orders | Two-way | Available |
Products | FFE → Katana | Available |
Inbound stock transfers | FFE → Katana | Available |
Inventory sync | FFE → Katana | Available |
Locations and mapping
Connect FFE from Katana's Integrations page with the username and password from your FFE representative. Once the connection is approved, the configuration screen opens on the Location tab. The status shows Connected with Sync inactive. Nothing syncs until you click Activate sync in the header.
Each FFE warehouse maps 1:1 to its own Katana location. Click Add to Katana to create that location.
A warehouse that has never been mapped shows Not mapped.
To pause a mapped warehouse, click Unlink. Its status then shows Unlinked. Click Relink to resume it.
Only mapped warehouses sync.
Products sync
Every FFE product needs a link to a Katana item. Choose how SKUs are matched: direct 1:1 or through SKU aliases.
Products are imported by SKU.
An FFE SKU that already exists in Katana matches the existing product.
An unknown SKU creates a new Katana product just in time.
Kits and bundles become Katana products. Add a BOM of their components in Katana.
A kit order line stays a single sales-order row.
SKU aliases
A SKU alias links an FFE SKU to a different Katana SKU. Use aliases when the same item has different SKUs in FFE and Katana, so it matches your existing product instead of creating a duplicate. Upload the SKU alias mapping before importing products.
Orders sync
Orders imported from FFE
Orders import once they reach the configured import-from status (default: Open). After that, they keep updating automatically through every later status change.
Each FFE order becomes one Katana sales order, with one row per line.
The order source is FFE.
Each shipped package becomes a Katana fulfillment with its carrier and tracking number.
A multi-package shipment creates one fulfillment per package. Together, these fulfillments never exceed the ordered quantities.
A canceled FFE order is deleted in Katana only if the order is still open.
Orders pushed to FFE
A Katana sales order is sent to FFE as an outbound order when it reaches the Ready for fulfillment status. Katana then tracks its progress the same way as imported orders.
Canceling the Katana sales order does not cancel the FFE order.
Changes you make in Katana after the push do not update the FFE order.
Inventory sync
FFE's stock levels appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is FFE's on-hand quantity.
Reconciliation compares Katana's in-stock quantity against FFE's on-hand quantity. It runs on a schedule or on demand. Any difference creates a stock adjustment in Katana.
Inbound shipments
Each FFE inbound shipment becomes one Katana stock transfer.
Number: the PO number when one is present, otherwise the inbound ID.
Destination: the Katana location mapped to the inbound's FFE warehouse. This location receives the stock.
Origin: the location you assign to each destination warehouse. It must be mapped.
The transfer follows the inbound's status, and received quantities update it. If the inbound is canceled, its stock transfer is deleted.
Katana stock transfers have only two states: in transit and received. Partial receipts show as updated expected and received quantities until the transfer is fully received.
What does not sync
Products and stock changes are not sent from Katana to FFE.
Changes to a Katana sales order after it has been pushed are not sent to FFE.
Canceling a Katana sales order does not cancel the FFE order.
Returns and RMAs do not sync.
Serial numbers are not tracked. Lot and batch data appears read-only where FFE provides it.
Disconnecting
Disconnect FFE from Katana's Integrations page. Syncing stops immediately: no new orders, fulfillments, inventory updates or inbound shipments are imported, and no sales orders are pushed to FFE. Everything already imported stays in Katana, including sales orders, fulfillments, products, stock transfers and stock adjustments.