Skip to main content

NPFulfilment integration setup

Map warehouses, then set up two-way orders, SKU-matched products, on-hand inventory and inbound stock transfers.

A
Written by Argo Ohvril

What syncs between Katana and NPFulfilment

Data flow between NPFulfilment and Katana

The table below shows each data type and the direction it moves between Katana and NPFulfilment.

Data

Direction

Status

Orders

Two-way

Available

Products

NPFulfilment → Katana

Available

Inbound stock transfers

NPFulfilment → Katana

Available

Inventory sync

NPFulfilment → Katana

Available

Locations and mapping

After NPFulfilment approves the connection, the configuration screen opens on the Location tab. The integration shows Connected with Sync inactive. Nothing syncs until you click Activate sync in the header.

Each NPFulfilment warehouse maps to its own dedicated Katana location:

  • Add to Katana creates the Katana location for a warehouse. Until then, a warehouse that has never been mapped shows Not mapped.

  • 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, listing each NPFulfilment warehouse beside its dedicated Katana location, with an Add to Katana button on a warehouse showing Not mapped, an Unlink action on a mapped warehouse, and a Relink action on a warehouse showing Unlinked

Products sync

Product mapping creates a required link between each NPFulfilment product and a Katana item. You choose how SKUs are matched: direct 1:1 or via SKU aliases.

Products are imported by SKU:

  • If the SKU already exists in Katana, the product is matched to the existing Katana product.

  • If the SKU is unknown, Katana creates the product when it is needed.

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

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

SKU aliases

A SKU alias links an NPFulfilment SKU to a different Katana SKU. Use aliases when the same item has different SKUs in the two systems.

Upload your SKU alias mapping before you import products. This ensures the mismatched SKUs match your existing Katana products and don't create new ones.

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

Orders sync

Orders from NPFulfilment to Katana

An NPFulfilment order imports once it reaches the import-from status you configure. The default is the Open state. After import, the order keeps updating automatically through every later status change.

Each NPFulfilment order becomes one Katana sales order, with one row per order line. The order source is NPFulfilment.

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

If an order is canceled in NPFulfilment, Katana deletes it only if the sales order is still open.

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

Orders from Katana to NPFulfilment

Katana pushes a sales order to NPFulfilment as an outbound order when the order reaches the Ready for fulfillment status. Its progress in NPFulfilment then syncs back to Katana through the import flow above.

Canceling the Katana sales order does not cancel the NPFulfilment order. Changes you make to the sales order in Katana after the push do not update the NPFulfilment order.

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

Inventory sync

NPFulfilment's stock numbers 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 NPFulfilment's on-hand quantity only. It runs on a schedule or whenever you start it. For any differences, it creates stock adjustments in Katana to keep your Katana stock aligned with what NPFulfilment holds.

the inventory sync settings screen showing read-only External inventory On hand quantities per mapped location and the reconciliation options for running on a schedule or on demand

Inbound shipments

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

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

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

The stock transfer follows the inbound's status, and received quantities update the transfer. If the inbound is canceled, Katana deletes its stock transfer.

Katana stock transfers have only two statuses: in transit and received. Partial receiving therefore appears as updated expected and received quantities until the shipment is fully received.

the inbound shipments screen showing an NPFulfilment inbound as a Katana stock transfer with its PO number, origin and destination locations, status, and expected versus received quantities

What does not sync

  • Product and stock changes made in Katana are not sent to NPFulfilment.

  • Changes to a sales order in Katana after it has been pushed do not update the NPFulfilment order.

  • Canceling a Katana sales order does not cancel the pushed NPFulfilment order.

  • Returns and RMAs.

  • Serial-number tracking. Lot and batch data appears read-only where NPFulfilment provides it.

Disconnecting

To disconnect, go to Katana's Integrations page, open the NPFulfilment tile, and disconnect. Syncing stops immediately: Katana no longer imports orders, fulfillments, inbound shipments, or inventory, and no longer pushes sales orders to NPFulfilment.

Records already brought into Katana stay in Katana, including sales orders, fulfillments, stock transfers, products, and stock adjustments.

Did this answer your question?