Skip to main content

Darwynn Fulfillment integration setup

Map Darwynn warehouses, then set up two-way orders, SKU-matched products, inventory sync, and inbound transfers.

A
Written by Argo Ohvril

What syncs between Katana and Darwynn Fulfillment

Data flow between Darwynn Fulfillment and Katana

The table below summarizes how each type of data moves between Katana and Darwynn Fulfillment.

Data

Direction

Status

Orders

Two-way

Available

Products

Darwynn Fulfillment → Katana

Available

Inbound stock transfers

Darwynn Fulfillment → Katana

Available

Inventory sync

Darwynn Fulfillment → Katana

Available

Locations and mapping

To connect, ask your Darwynn account manager to set up API access. They will give you an app key and access token. In Katana, open the Integrations page, find the Darwynn Fulfillment tile, click Connect, and enter these credentials. After Darwynn approves the connection, the configuration screen opens on the Location tab.

  • Each Darwynn warehouse maps to its own dedicated Katana location. Click Add to Katana to create that location.

  • A warehouse that was never mapped shows Not mapped.

  • Click Unlink to pause a mapped warehouse. Its status then shows Unlinked. Click Relink to resume it.

Only mapped warehouses sync. Nothing syncs until you click Activate sync in the header.

the warehouse location mapping panel on the Location tab, listing Darwynn Fulfillment warehouses with their statuses (Mapped to a Katana location, Unlinked, Not mapped), the Add to Katana, Unlink and Relink actions, and the Activate sync button in the header next to a Connected / Sync inactive status

Products sync

Product mapping creates a required link between each Darwynn Fulfillment product and a Katana item. First, choose how SKUs are matched:

  • Direct 1:1: each Darwynn SKU matches the identical Katana SKU.

  • Via SKU aliases: each Darwynn SKU matches a Katana SKU through an alias.

Products are imported by SKU. A SKU that already exists in Katana links to that product. An unknown SKU creates a new Katana product when it is 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 showing the SKU matching choice between direct 1:1 matching and matching via SKU aliases

SKU aliases

A SKU alias links a Darwynn Fulfillment SKU to a different Katana SKU. Use one when the same item has different SKUs in the two systems, so they still match instead of creating a duplicate product. Upload your SKU alias mapping before you import products.

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

Orders sync

Orders from Darwynn Fulfillment

Orders import once they reach the import-from status you configure. The default is the Open state. After import, orders keep updating automatically through every later status change.

Each Darwynn order becomes one Katana sales order, with one row per order line. The order source is shown as Darwynn Fulfillment.

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

If an order is canceled in Darwynn, Katana deletes its sales order only if that 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 sent from Katana

Katana pushes a sales order to Darwynn Fulfillment as an outbound order when it reaches the Ready for fulfillment status. After that, its progress is tracked back in Katana through the import flow described above.

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

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

Inventory sync

Darwynn Fulfillment's stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is the on hand quantity. Katana never sends inventory changes to Darwynn.

Reconciliation compares Katana's in-stock quantity with Darwynn's on hand quantity, and nothing else. It runs on a schedule or on demand. For each difference, it creates a stock adjustment so Katana's stock matches what is physically in the warehouse.

the inventory sync settings screen showing read-only External inventory on hand per mapped location and the reconciliation schedule with an on-demand reconcile option

Inbound shipments

Each Darwynn Fulfillment inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when there is one. 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 assignment must be mapped.

Stock transfers follow the inbound's status, and received quantities update the transfer. Katana stock transfers have only two states: in transit and received. Partial receiving therefore shows as updated expected and received quantities until the shipment is fully received. A canceled inbound deletes its stock transfer.

the inbound shipments screen showing Darwynn Fulfillment inbounds as Katana stock transfers with transfer number, origin and destination locations, status, and expected versus received quantities

What does not sync

  • Product changes from Katana to Darwynn Fulfillment.

  • Stock changes from Katana to Darwynn Fulfillment.

  • Katana-side changes to an order after it has been pushed.

  • Cancellations of Katana sales orders. These do not cancel the Darwynn order.

  • Returns and RMAs.

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

Disconnecting

To disconnect, open Darwynn Fulfillment from Katana's Integrations page. Once you disconnect, Katana stops all of the following immediately:

  • Importing orders, fulfillments, inventory and inbound shipments.

  • Pushing sales orders to Darwynn.

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

Did this answer your question?