The table below summarizes each sync flow between Katana and Mabang.

After you connect, the configuration screen opens on the Location tab. Each Mabang warehouse maps 1:1 to its own dedicated Katana location. Click Add to Katana to create that location automatically. Until then, the warehouse shows Not mapped.

To pause a mapped warehouse, click Unlink. Its status then shows Unlinked. Click Relink to resume syncing it. Only mapped warehouses sync.

Product mapping creates the link between each Mabang product and a Katana item. This link is required. You can match SKUs in one of two ways:

Products are imported by SKU. Mabang products whose SKUs already exist in Katana match those products. Unknown SKUs create new Katana products as they are needed.

Kits and bundles become Katana products. Add a BOM of components to them in Katana. A kit order line stays a single row on the sales order.

An SKU alias links a Mabang SKU to a Katana SKU that has a different code. Use aliases when the same product has different SKUs in Mabang and Katana. Upload your SKU alias mapping before you import products, so mismatched SKUs match existing items instead of creating new products.

Mabang orders import into Katana once they reach the configured import-from status. The default is the "Open" state. After import, each order keeps updating automatically through every later status change.

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

Each shipped package becomes a Katana fulfillment with its carrier and tracking number. Shipments with several packages create one fulfillment per package. Together, these fulfillments never exceed the ordered quantities.

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

When a Katana sales order reaches the Ready for fulfillment status, Katana pushes it to Mabang as an outbound order. From then on, the import flow above tracks its progress back in Katana.

Canceling the Katana sales order does not cancel the Mabang order. Changes made to the order in Katana after the push do not update the Mabang order.

Mabang's stock numbers appear in Katana as read-only external inventory at each warehouse's mapped location. The number shown is On hand. You can't edit these figures in Katana.

Reconciliation compares Katana's in-stock quantities with Mabang's on-hand quantities. It runs on a schedule or whenever you start it. For any difference, it creates stock adjustments in Katana. This keeps Katana's stock, which your planning relies on, aligned with Mabang.

Each Mabang inbound shipment becomes one Katana stock transfer. The transfer number is the PO number if there is one, or the inbound ID if not.

Stock transfers follow the inbound's status. Received quantities update the transfer. If an inbound is canceled, Katana deletes its stock transfer.

Katana stock transfers have two states: in transit and received. Partial receiving shows as updated expected and received quantities until the shipment is fully received.

To disconnect, open the Mabang tile on Katana's Integrations page. After you disconnect, nothing new syncs in either direction:

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