Skip to main content

THG Ingenuity Fulfil integration setup

Set up warehouse mapping and one-way order, SKU product, inbound stock transfer and read-only inventory syncs.

A
Written by Argo Ohvril

What syncs between Katana and THG Ingenuity Fulfil

Data flow between THG Ingenuity Fulfil and Katana

The table below shows which data the integration covers and the direction it flows.

Data

Direction

Status

Orders

THG Ingenuity Fulfil → Katana

Available

Products

THG Ingenuity Fulfil → Katana

Available

Inbound stock transfers

THG Ingenuity Fulfil → Katana

Available

Inventory sync

THG Ingenuity Fulfil → Katana

Available

Locations and mapping

After the connection is approved, the configuration screen opens on the Location tab. Each THG Ingenuity Fulfil warehouse maps 1:1 to its own dedicated Katana location.

  • Not mapped: The warehouse has never been mapped. Click Add to Katana to create its Katana location and map it.

  • Unlink: Pauses a mapped warehouse. Its status then shows Unlinked.

  • Relink: Resumes syncing for an unlinked warehouse.

Only mapped warehouses sync.

the warehouse location mapping panel on the Location tab, listing THG Ingenuity Fulfil warehouses with their status (mapped, Unlinked, Not mapped), the Katana location each one is mapped to, and the Add to Katana, Unlink and Relink actions

Products sync

Product mapping creates a required link between each THG Ingenuity Fulfil product and a Katana item. Products are imported by SKU:

  • SKUs that match existing Katana products are linked to those products.

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

When you set up mapping, choose how SKUs are matched: direct 1:1, or through SKU aliases.

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 showing the choice between direct 1:1 SKU matching and matching via SKU aliases

SKU aliases

A SKU alias links a THG Ingenuity Fulfil 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 product import, so mismatched SKUs link to your existing Katana products instead of creating new ones.

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

Orders sync

Orders flow one way, from THG Ingenuity Fulfil into Katana.

  • Import: An order imports once it reaches the configured import-from status (default: "Open"). After that, it updates automatically through every later status change.

  • Structure: Each THG Ingenuity Fulfil order becomes one Katana sales order, with one row per order line. The order source is the integration name.

  • Fulfillments and tracking: Each shipped package becomes a Katana fulfillment with its carrier and tracking number. Multi-package shipments create one fulfillment per package, so one order can show several fulfillments. Together, these fulfillments never exceed the ordered quantities.

  • Cancellations: An order canceled in THG Ingenuity Fulfil is deleted in Katana only if the sales order is still open. Canceling a sales order in Katana does not cancel the order in THG Ingenuity Fulfil.

the order sync settings screen with the import and status options, highlighting the import-from status dropdown set to Open

Inventory sync

THG Ingenuity Fulfil stock levels appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is the warehouse's on-hand quantity.

Reconciliation compares Katana's in-stock quantity with THG Ingenuity Fulfil's on-hand quantity. It runs on a schedule or on demand, and creates stock adjustments in Katana for any differences. Katana never sends inventory changes back to THG Ingenuity Fulfil.

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

Inbound shipments

Each THG Ingenuity Fulfil inbound shipment becomes one Katana stock transfer.

  • Number: The PO number when one exists; otherwise, the inbound ID.

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

  • Origin: The location you assign for each destination warehouse. This location must be mapped.

  • Status and quantities: The stock transfer tracks the inbound's status, and received quantities update the transfer. A canceled inbound deletes its stock transfer.

Katana stock transfers have only two states: in transit and received. While an inbound is partially received, the transfer shows updated expected and received quantities until everything is received.

the inbound shipments screen showing THG Ingenuity Fulfil inbounds as Katana stock transfers with number, origin and destination locations, status, and expected versus received quantities

What does not sync

  • Outbound orders: Orders flow only from THG Ingenuity Fulfil into Katana. Katana sales orders are not sent to THG Ingenuity Fulfil.

  • Products and stock changes: These are never pushed from Katana to THG Ingenuity Fulfil.

  • Returns and RMAs: Not supported.

  • Serial numbers: Serial-number tracking is not supported. Lot and batch data is shown read-only where THG Ingenuity Fulfil provides it.

Disconnecting

To disconnect, open Katana's Integrations page, find the THG Ingenuity Fulfil tile, and disconnect the integration. Syncing stops immediately: no new orders, inventory updates, or inbound shipments are imported. Records already imported into Katana remain, including sales orders, fulfillments, products, and stock transfers.

Did this answer your question?