Skip to main content

Mochila Fulfillment integration setup

Map warehouses to locations, match products by SKU or alias, and set order import status and inventory reconciliation.

A
Written by Argo Ohvril

What syncs between Katana and Mochila Fulfillment

Data flow between Mochila Fulfillment and Katana

The table below lists each data type and how it is handled for this integration.

Data

Direction

Status

Orders

Mochila Fulfillment → Katana

Available

Products

Mochila Fulfillment → Katana

Available

Inventory sync

Mochila Fulfillment → Katana

Available

Locations and mapping

After the connection is approved, the configuration screen opens on the Location tab. Each Mochila Fulfillment 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 automatically.

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

  • Relink: Resumes syncing for an unlinked warehouse.

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

the warehouse location mapping panel on the Location tab of the Mochila Fulfillment configuration screen, listing Mochila Fulfillment warehouses with their statuses (mapped, Unlinked, Not mapped) and the Add to Katana, Unlink and Relink actions, with the Activate sync button in the header

Products sync

Product mapping creates a required link between each Mochila Fulfillment product and a Katana item. Choose how SKUs are matched:

  • Direct 1:1: The SKU is identical in both systems.

  • SKU aliases: A Mochila Fulfillment SKU is linked to a different Katana SKU.

Products are imported by SKU. If a SKU already exists in Katana, it is matched to that product. If the SKU is unknown, Katana creates the product when it is first needed.

Kits and bundles are imported as Katana products. You can add a bill of materials (BOM) of components to them in Katana. A kit order line stays a single row on the sales order.

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

SKU aliases

A SKU alias links a Mochila Fulfillment 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, so that items match correctly instead of being created as duplicates.

the products mapping screen with SKU alias mapping, showing Mochila Fulfillment SKUs paired with their corresponding Katana SKUs and the option to upload an alias mapping

Orders sync

Orders flow one way only, from Mochila Fulfillment to Katana.

  • When orders import: An order imports once it reaches the configured import-from status. The default is the Open state.

  • Later status changes: After import, the order keeps updating automatically through every later status change in Mochila Fulfillment.

  • How orders appear: Each Mochila Fulfillment order becomes one Katana sales order, with one row per order line. The order source is shown as the integration name.

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

  • Cancellations: If an order is canceled in Mochila Fulfillment, it is deleted in Katana only if the Katana order is still open.

the order sync settings screen for Mochila Fulfillment showing the import-from status option (default Open) and the order status settings

Inventory sync

Mochila Fulfillment's stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. The figure shown is the on-hand quantity.

Reconciliation compares Katana's in-stock quantity against Mochila Fulfillment's on-hand quantity only. It runs on a schedule or on demand, and it creates stock adjustments in Katana for any differences.

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

What does not sync

  • Orders are not sent from Katana to Mochila Fulfillment. Orders flow one way only, from Mochila Fulfillment to Katana.

  • Products and stock changes are not pushed from Katana to Mochila Fulfillment.

  • Inbound shipments are not imported as Katana stock transfers.

  • Returns and RMAs are not synced.

  • Serial-number tracking is not supported. Lot and batch data appears read-only where Mochila Fulfillment provides it.

Disconnecting

To disconnect, open the Mochila Fulfillment integration from Katana's Integrations page. Once disconnected, orders, fulfillments, products and inventory stop syncing from Mochila Fulfillment. Records already brought into Katana, such as sales orders, fulfillments and products, stay in Katana.

Did this answer your question?