What syncs between Katana and Darwynn Fulfillment
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.
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.
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.
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.
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.
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.
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.
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.








