Skip to main content

Shipedge integration setup

Map warehouses to locations, then set up two-way orders, product import by SKU, inventory, and inbound stock transfers.

A
Written by Argo Ohvril

What syncs between Katana and Shipedge

Data flow between Shipedge and Katana

The table below summarizes each data flow between Katana and Shipedge.

Data

Direction

Status

Orders

Two-way

Available

Products

Shipedge → Katana

Available

Inbound stock transfers

Shipedge → Katana

Available

Inventory sync

Shipedge → Katana

Available

Locations and mapping

After you connect, the configuration screen opens on the Location tab. Each Shipedge warehouse maps 1:1 to its own dedicated Katana location. Click Add to Katana to create that location automatically.

  • Not mapped: The warehouse has never been mapped. It stays this way until you click Add to Katana.

  • Unlink: Pauses a mapped warehouse, and its status shows Unlinked.

  • Relink: Resumes syncing for an unlinked warehouse.

Only mapped warehouses sync.

the warehouse location mapping panel on the Location tab of the Shipedge configuration screen in Katana, listing Shipedge warehouses with their statuses (one mapped to a Katana location, one showing Unlinked with a Relink button, one showing Not mapped with an Add to Katana button)

Products sync

Product mapping creates a required link between each Shipedge product and a Katana item. Choose how SKUs are matched: direct 1:1 or through SKU aliases.

Products are imported by SKU:

  • If a Katana product already has the same SKU, it's matched to the Shipedge product.

  • If the SKU is unknown in Katana, Katana creates the product when it's first needed.

Kits and bundles from Shipedge become Katana products. Add a bill of materials (BOM) with the components in Katana. A kit order line stays a single row on the sales order.

the products mapping settings screen in the Shipedge integration in Katana, showing the SKU matching choice between direct 1:1 matching and matching via SKU aliases

SKU aliases

An SKU alias links a Shipedge SKU to a different Katana SKU. Use aliases when the same product has a different SKU in each system. Upload your SKU alias mapping before you import products so that mismatched SKUs match existing Katana products.

the products mapping screen in the Shipedge integration in Katana with SKU alias mapping selected, showing an uploaded list pairing Shipedge SKUs with their different Katana SKUs

Orders sync

Orders from Shipedge to Katana

A Shipedge order imports once it reaches the configured import-from status (default: Open). After import, it keeps updating automatically through every later status change.

  • Each Shipedge order becomes one Katana sales order, and each line becomes one row.

  • The order source is set to Shipedge.

  • Each shipped package becomes a Katana fulfillment with the 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 Shipedge, it's deleted in Katana only while the sales order is still open.

the order sync settings screen in the Shipedge integration in Katana, showing the import-from status dropdown set to Open and the order import options

Orders from Katana to Shipedge

When a Katana sales order reaches the Ready for fulfillment status, Katana pushes it to Shipedge as an outbound order. Katana then tracks its progress through the import flow above. Canceling the Katana sales order doesn't cancel the Shipedge order. Changes you make in Katana after the push don't update the Shipedge order.

the order push settings screen in the Shipedge integration in Katana, showing that sales orders are sent to Shipedge when they reach the Ready for fulfillment status

Inventory sync

Shipedge stock levels appear in Katana as read-only external inventory at each warehouse's mapped location. The number shown is Shipedge's on-hand quantity. Katana never sends inventory changes to Shipedge.

Reconciliation compares Katana's in-stock quantity with Shipedge's on-hand quantity. It runs on a schedule or on demand. When the numbers differ, Katana creates stock adjustments for the difference. This keeps the stock that Katana uses for planning aligned with your warehouse.

the inventory sync settings screen in the Shipedge integration in Katana, showing reconciliation of Katana in-stock against Shipedge on-hand with the schedule setting and a run-now option

Inbound shipments

Each Shipedge inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when one exists. Otherwise, it's the inbound ID.

  • Destination: The Katana location mapped to the inbound's Shipedge warehouse.

  • Origin: The location assigned to each destination warehouse. This location must be mapped.

The stock transfer follows the inbound status, and received quantities update the transfer. If the inbound is canceled, Katana deletes its stock transfer. Katana stock transfers have only two states: in transit and received. Partial receipts show as updated expected and received quantities until the shipment is fully received.

the inbound shipments screen in the Shipedge integration in Katana, showing inbound shipments listed as stock transfers with PO or inbound ID numbers, destination and origin locations, status, and expected versus received quantities

What does not sync

  • Products and stock changes from Katana to Shipedge

  • Changes made to a Katana sales order after it's pushed to Shipedge

  • Canceling a pushed order: canceling the Katana sales order doesn't cancel the Shipedge order

  • Returns and RMAs

  • Serial number tracking (lot and batch data appears as read-only where Shipedge provides it)

Disconnecting

To disconnect, go to Katana's Integrations page and open the Shipedge integration. Syncing stops right away. Katana no longer imports orders, fulfillments, inbound shipments, or inventory updates, and no longer pushes sales orders to Shipedge. Records already imported into Katana stay there, including sales orders, fulfillments, stock transfers, products, and locations.

Did this answer your question?