Skip to main content

Snapfulfil integration setup

Map warehouses to locations, match products by SKU or aliases, and sync orders, fulfillments, and on-hand stock.

A
Written by Argo Ohvril

What syncs between Katana and Snapfulfil

Data flow between Snapfulfil and Katana

The table below lists each type of data and how it moves between Snapfulfil and Katana.

Data

Direction

Status

Orders

Snapfulfil → Katana

Available

Products

Snapfulfil → Katana

Available

Inventory sync

Snapfulfil → Katana

Available

Locations and mapping

After Snapfulfil approves the connection, the configuration screen opens on the Location tab. Each Snapfulfil warehouse maps to its own dedicated Katana location. To create that location, click Add to Katana. Until you do, a warehouse shows Not mapped.

To pause a mapped warehouse, click Unlink. Its status then shows Unlinked. Click Relink to resume syncing it. Only mapped warehouses sync.

the warehouse location mapping panel on the Location tab of the Snapfulfil configuration screen, listing Snapfulfil warehouses with their mapped Katana locations, an Add to Katana button on a warehouse with Not mapped status, an Unlink action on a mapped warehouse, and a Relink action on a warehouse with Unlinked status

Products sync

Product mapping links each Snapfulfil product to a Katana item, and this link is required. Choose how SKUs match:

  • Direct 1:1: the Snapfulfil SKU matches the Katana SKU exactly.

  • Via SKU aliases: a Snapfulfil SKU maps to a different Katana SKU.

Products and variants are imported by SKU:

  • Existing Katana products with a matching SKU are matched.

  • Unknown SKUs create new products in Katana as they are needed.

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

the products mapping settings screen for Snapfulfil showing the SKU matching options: direct 1:1 and via SKU aliases

SKU aliasing

An SKU alias links a Snapfulfil SKU to a different Katana SKU. Use aliases when the same product has different SKUs in the two systems. Upload your SKU alias mapping before importing products, so mismatched SKUs match existing items instead of creating new ones.

the products mapping screen with SKU alias mapping, showing Snapfulfil SKUs paired with different Katana SKUs and the option to upload an SKU alias mapping

Orders sync

Orders flow one way only, from Snapfulfil into Katana.

  • Which orders import: orders import once they reach the configured import-from status (the default is the "Open" state).

  • How they appear: each Snapfulfil order becomes one Katana sales order, and each order line becomes one row. The order source shows as Snapfulfil.

  • Status updates: after import, the sales order keeps updating automatically through every later status change in Snapfulfil.

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

Fulfillments and tracking

Each shipped package becomes a Katana fulfillment with the carrier and tracking number. A multi-package shipment creates one fulfillment per package, so one order can show several fulfillments. Together, these fulfillments never exceed the ordered quantities.

Cancellations

When an order is canceled in Snapfulfil, Katana deletes the matching sales order only if that sales order is still open.

Inventory sync

Snapfulfil stock levels appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is the Snapfulfil on-hand quantity. Snapfulfil is the source of physical stock, and Katana mirrors it.

Reconciliation compares Katana's in-stock quantity with Snapfulfil's on-hand quantity. It runs on a schedule or on demand. When the numbers differ, Katana creates stock adjustments so its stock matches Snapfulfil.

the inventory sync settings screen for Snapfulfil showing read-only External inventory on-hand quantities per mapped location and the scheduled and on-demand reconciliation options

What does not sync

  • Orders are not sent from Katana to Snapfulfil. Orders flow from Snapfulfil to Katana only.

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

  • Inbound shipments do not sync, so no stock transfers are created from Snapfulfil inbounds.

  • Returns and RMAs do not sync.

  • Serial numbers are not tracked. Lot and batch data is shown read-only where Snapfulfil provides it.

Disconnecting

To disconnect, go to Katana's Integrations page and open the Snapfulfil integration. Once it is disconnected, syncing stops: no new orders, fulfillments, products or inventory updates come in from Snapfulfil. Records already brought into Katana stay in Katana, including sales orders, fulfillments, products and stock adjustments.

Did this answer your question?