What syncs between Katana and Flat Fee Shipping
The table below summarizes how data moves between Flat Fee Shipping and Katana.
Data | Direction | Status |
Orders | Flat Fee Shipping → Katana | Available |
Products | Flat Fee Shipping → Katana | Available |
Inbound stock transfers | Flat Fee Shipping → Katana | Available |
Inventory sync | Flat Fee Shipping → Katana | Available |
Locations and mapping
After the connection is approved, the configuration screen opens on the Location tab. Each Flat Fee Shipping warehouse maps 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 that 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 Flat Fee Shipping product and a Katana item. You choose how SKUs are matched: direct 1:1, or through SKU aliases.
Products are imported by SKU:
If a Katana product already has the SKU, the two are matched.
If the SKU is unknown in Katana, a product is created the first time it's needed.
Kits and bundles become Katana products. Add a bill of materials (BOM) with their components in Katana. On orders, a kit line stays a single sales order row.
SKU aliases
A SKU alias links a Flat Fee Shipping SKU to a different Katana SKU. Use aliases when the same item has different SKUs in the two systems, so the item still matches instead of creating a duplicate product.
Upload your SKU alias mapping before you import products.
Orders sync
Orders flow one way, from Flat Fee Shipping into Katana.
When orders import: an order imports once it reaches the import-from status set in the configuration. The default is the Open state.
Status updates: after import, the order keeps updating automatically through every later status change in Flat Fee Shipping.
How orders appear: each Flat Fee Shipping order becomes one Katana sales order, and each order line becomes one row. The order source shows as Flat Fee Shipping.
Fulfillments and tracking
Each shipped package becomes a Katana fulfillment with its carrier and tracking number.
A shipment with several packages creates one fulfillment per package, so one order can show several fulfillments.
Together, an order's fulfillments never exceed the ordered quantities.
Cancellations
When an order is canceled in Flat Fee Shipping, it's deleted in Katana only if the Katana sales order is still open.
Inventory sync
Flat Fee Shipping stock levels 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 Flat Fee Shipping's on-hand quantity. It runs on a schedule, or you can run it on demand. When the two numbers differ, Katana creates stock adjustments for the difference, so your stock levels match the warehouse.
Inbound shipments
Each Flat Fee Shipping inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when there is one. Otherwise, it's the inbound ID.
Destination: the Katana location mapped to the inbound's warehouse.
Origin: the location assigned for each destination warehouse. This location must be mapped.
Status: the stock transfer follows the inbound's status.
Quantities: received quantities update the transfer.
Cancellations: canceling an inbound deletes its stock transfer.
Katana stock transfers have two states: in transit and received. A partially received shipment shows as updated expected and received quantities until it's fully received.
What does not sync
Katana doesn't send orders to Flat Fee Shipping. Orders sync only from Flat Fee Shipping into Katana.
Katana doesn't push products or stock changes to Flat Fee Shipping.
Returns and RMAs aren't synced.
Serial numbers aren't tracked. Lot and batch data is shown read-only where Flat Fee Shipping provides it.
Disconnecting
To disconnect, go to Katana's Integrations page and open the Flat Fee Shipping integration.
Once you disconnect, syncing stops immediately. Records already imported into Katana stay in Katana, including sales orders, fulfillments, products, and stock transfers.