Skip to main content

FedEx Fulfillment integration setup

Map warehouses to locations and set up two-way order sync, product import by SKU or alias, and read-only stock sync.

A
Written by Argo Ohvril

What syncs between Katana and FedEx Fulfillment

Data flow between FedEx Fulfillment and Katana

The table below summarizes the data flows for this integration.

Data

Direction

Status

Orders

Two-way

Available

Products

FedEx Fulfillment → Katana

Available

Inventory sync

FedEx Fulfillment → Katana

Available

Locations and mapping

After the connection is approved, the configuration screen opens on the Location tab. Each FedEx Fulfillment 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 use Add to Katana.

  • To pause a mapped warehouse, click Unlink. Its status then shows Unlinked.

  • To resume syncing, click Relink.

Only mapped warehouses sync.

the warehouse location mapping panel on the Location tab of the FedEx Fulfillment configuration screen, listing FedEx Fulfillment warehouses with their mapped Katana locations, an Add to Katana button on a warehouse showing Not mapped, and Unlink/Relink actions with one warehouse showing Unlinked status

Products sync

Product mapping creates a required link between each FedEx Fulfillment product and a Katana item. First choose how SKUs are matched: direct 1:1, or through SKU aliases.

  • Products are imported by SKU.

  • A SKU that already exists in Katana is matched to that product.

  • An unknown SKU creates a new Katana product when it is first needed.

Kits and bundles become Katana products. Add a BOM of components to them in Katana. A kit order line stays a single row on the sales order.

the products mapping settings screen for FedEx Fulfillment showing the SKU matching choice between direct 1:1 matching and matching via SKU aliases

SKU aliasing

A SKU alias links a FedEx Fulfillment SKU to a different Katana SKU. Use aliases when the same item has mismatched SKUs in the two systems. Upload your SKU alias mapping before importing products, so items match correctly and duplicate products aren't created.

the products mapping screen with SKU alias mapping, showing FedEx Fulfillment SKUs paired with different Katana SKUs and an option to upload the alias mapping before product import

Orders sync

Orders from FedEx Fulfillment

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 order becomes one Katana sales order, with one row per order line.

  • The order source is shown as FedEx Fulfillment.

  • Each shipped package becomes a Katana fulfillment with carrier and tracking details. A multi-package shipment creates one fulfillment per package. Together, these fulfillments never exceed the ordered quantities.

  • A canceled FedEx Fulfillment order is deleted in Katana only if the sales order is still open.

the order sync settings screen for FedEx Fulfillment with the import-from status option set to Open and the order status options

Orders from Katana

A Katana sales order is pushed to FedEx Fulfillment as an outbound order when it reaches the Ready for fulfillment status. Its progress then syncs back to Katana through the import flow above.

  • Canceling the Katana sales order does not cancel the FedEx Fulfillment order.

  • Changes made in Katana after the push do not update the FedEx Fulfillment order.

the order push settings screen for FedEx Fulfillment showing that Katana sales orders are sent when they reach Ready for fulfillment status

Inventory sync

FedEx Fulfillment 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 against FedEx Fulfillment's on-hand quantity. It runs on a schedule or on demand. Where the numbers differ, Katana creates stock adjustments, so your stock figures reflect the physical stock held by FedEx Fulfillment.

the inventory sync settings screen for FedEx Fulfillment showing read-only external on-hand inventory per mapped location and reconciliation options to run on a schedule or on demand

What does not sync

  • Product or stock changes from Katana are never pushed to FedEx Fulfillment.

  • Changes to a sales order after it has been pushed are not sent to FedEx Fulfillment.

  • Inbound shipments are not imported, so no stock transfers are created from them.

  • Returns and RMAs.

  • Serial-number tracking. Lot and batch data is shown read-only where FedEx Fulfillment provides it.

Disconnecting

You can disconnect FedEx Fulfillment from Katana's Integrations page. Once you disconnect, syncing stops: no new orders, fulfillments, or inventory updates are exchanged. Records already brought into Katana stay in Katana, including sales orders, fulfillments, products, and locations.

Did this answer your question?