What syncs between Katana and Mayple
The table below summarizes each data type and the direction it moves between Mayple and Katana.
Data | Direction | Status |
Orders | Mayple → Katana | Available |
Products | Mayple → Katana | Available |
Inbound stock transfers | Mayple → Katana | Available |
Inventory sync | Mayple → Katana | Available |
Locations and mapping
Connect Mayple from Katana's Integrations page. Click Connect and enter the API key your Mayple representative provides. Once Mayple approves the connection, the configuration screen opens on the Location tab.
Each Mayple warehouse maps 1:1 to its own dedicated Katana location. Click Add to Katana to create that location automatically.
A warehouse that has never been mapped shows Not mapped.
To pause a mapped warehouse, click Unlink. 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 Mayple product and a Katana item. You can match SKUs in two ways: directly 1:1, or through SKU aliases.
Products are imported by SKU:
If a SKU already exists in Katana, the Mayple product is matched to that product.
If a SKU is unknown, Katana creates the product just-in-time.
Kits and bundles also become Katana products. Add a BOM of the components in Katana. On a sales order, a kit line stays a single row.
SKU aliasing
A SKU alias links a Mayple SKU to a different Katana SKU, so products still match when the two systems use different codes for the same item. Use an alias whenever a Mayple SKU doesn't match the SKU you use in Katana.
Upload your SKU alias mapping before importing products.
Orders sync
Orders flow one way, from Mayple into Katana.
Import: An order imports once it reaches the configured import-from status. The default is the "Open" state.
Status changes: After import, the order keeps updating automatically through every later status change in Mayple.
Order structure: Each Mayple order becomes one Katana sales order, and each order line becomes one row. The order source is shown as Mayple.
Fulfillments and tracking
Each shipped package becomes a Katana fulfillment with its carrier and tracking number. A shipment with several packages creates one fulfillment per package, so one order can show several fulfillments. Together, these fulfillments never exceed the ordered quantities.
Cancellations
When an order is canceled in Mayple, Katana deletes the sales order only if it is still open.
Inventory sync
Mayple's stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is Mayple's On hand quantity. You can't edit these numbers in Katana.
Reconciliation compares Katana's in-stock quantity with Mayple's on-hand quantity only. It runs on a schedule or on demand, and creates stock adjustments in Katana for any differences.
Inbound shipments
Each Mayple inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when one exists. Otherwise, it's the inbound ID.
Destination: The Katana location mapped 1:1 to the inbound's warehouse.
Origin: The location assigned to each destination warehouse. This assignment must be mapped.
The stock transfer tracks the inbound status, and received quantities update the transfer. If an inbound is canceled, its stock transfer is deleted.
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.
What does not sync
Orders from Katana to Mayple: Orders flow one way only, from Mayple into Katana.
Products and stock changes from Katana to Mayple: Katana never sends these to Mayple.
Returns and RMAs: Not synced.
Serial numbers: Serial-number tracking isn't supported. Lot and batch data is shown read-only where Mayple provides it.
Disconnecting
To disconnect Mayple, go to Katana's Integrations page. Once you disconnect, orders, fulfillments, inventory, products and inbound shipments stop syncing.
Records already imported into Katana stay in place. This includes sales orders, fulfillments, products, stock transfers and stock adjustments.