What syncs between Katana and Bleckmann
The table below summarizes how data moves between Katana and Bleckmann.
Data | Direction | Status |
Orders | Two-way | Available |
Products | Bleckmann → Katana | Available |
Inbound stock transfers | Bleckmann → Katana | Available |
Inventory sync | Bleckmann → Katana | Available |
Locations and mapping
After Bleckmann approves the connection, the configuration screen opens on the Location tab. Each Bleckmann warehouse maps 1:1 to its own dedicated Katana location.
Add to Katana creates the Katana location for a warehouse and maps it.
Unlink pauses a mapped warehouse. Its status then shows Unlinked.
Relink resumes a paused warehouse.
A warehouse that has never been mapped shows Not mapped until you use Add to Katana.
Only mapped warehouses sync.
Products sync
Product mapping creates a required link between each Bleckmann product and a Katana item. Products are matched by SKU, and you choose the matching method:
Direct 1:1: the Bleckmann SKU matches the Katana SKU exactly.
SKU aliases: a Bleckmann SKU maps to a different Katana SKU.
When products import, SKUs that already exist in Katana are matched to those products. Unknown SKUs create new Katana products as they are needed.
Kits and bundles import as Katana products. Add a BOM of components to them in Katana. A kit order line stays a single row on the sales order.
SKU aliasing
An SKU alias links a Bleckmann SKU to a different Katana SKU. Use aliases when the same item is coded differently in the two systems. Upload your SKU alias mapping before you import products, so mismatched SKUs match existing items instead of creating new ones.
Orders sync
Orders from Bleckmann
Orders import once they reach the configured import-from status (default: Open). After that, they keep updating automatically through every later status change.
Each Bleckmann order becomes one Katana sales order, with one row per order line.
The order source shows as Bleckmann.
Each shipped package becomes a Katana fulfillment with carrier and tracking details.
Multi-package shipments create one fulfillment per package. Together, these fulfillments never exceed the ordered quantities.
A canceled Bleckmann order is deleted in Katana only if the sales order is still open.
Orders from Katana
A Katana sales order is pushed to Bleckmann as an outbound order when it reaches the Ready for fulfillment status. From then on, its progress is tracked back in Katana through the import flow above.
Canceling the Katana sales order does not cancel the pushed Bleckmann order.
Changes made in Katana after the push do not update the Bleckmann order.
Inventory sync
Bleckmann's stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is Bleckmann's on-hand quantity.
Reconciliation compares Katana's in-stock quantity with Bleckmann's on-hand quantity. It runs on a schedule or on demand, and creates stock adjustments in Katana for any differences. Katana never sends inventory changes to Bleckmann.
Inbound shipments
Each Bleckmann inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when one is present; 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 must be mapped.
Stock transfers follow the inbound's status, and received quantities update the transfer. Katana stock transfers move from in transit to received in a single step. Partial receipts appear as updated expected and received quantities until the shipment is fully received. A canceled inbound deletes its stock transfer.
What does not sync
Products and stock changes are never pushed from Katana to Bleckmann.
Katana-side changes to an order after it has been pushed to Bleckmann.
Canceling a pushed order from Katana.
Returns and RMA.
Serial-number tracking. Lot and batch data is shown read-only where Bleckmann provides it.
Disconnecting
To disconnect, go to Katana's Integrations page and open the Bleckmann integration. Once you disconnect, orders, inventory, and inbound shipments stop syncing, and no more orders are pushed to Bleckmann. Records already brought into Katana stay in place, including sales orders, fulfillments, products, stock transfers, and stock adjustments.