Skip to main content

GoBolt integration setup

Map GoBolt warehouses to locations and configure order, product SKU, inventory, and inbound stock transfer syncs.

A
Written by Argo Ohvril

What syncs between Katana and GoBolt

Data flow between GoBolt and Katana

The table below summarizes each data type and the direction it moves between Katana and GoBolt.

Data

Direction

Status

Orders

Two-way

Available

Products

GoBolt → Katana

Available

Inbound stock transfers

GoBolt → Katana

Available

Inventory sync

GoBolt → Katana

Available

Locations and mapping

After the connection is approved, the configuration screen opens on the Location tab. Each GoBolt warehouse maps 1:1 to its own dedicated Katana location. Click Add to Katana to create that location automatically.

  • Not mapped: This warehouse has never been mapped. Click Add to Katana to create its location.

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

  • Relink: Resumes syncing for an unlinked warehouse.

Only mapped warehouses sync.

the warehouse location mapping panel on the Location tab of the GoBolt configuration screen, listing GoBolt warehouses with their status (mapped to a Katana location, Unlinked, or Not mapped) and the Add to Katana, Unlink, and Relink buttons

Products sync

Product mapping creates the required link between each GoBolt product and a Katana item. Products are matched by SKU. You choose how SKUs are matched: direct 1:1, or through SKU aliases.

  • When a GoBolt SKU matches an existing Katana product, the two are linked.

  • When a GoBolt SKU is unknown in Katana, a new product is created just-in-time.

Kits and bundles from GoBolt become Katana products. You can add a bill of materials (BOM) of components to them in Katana. A kit order line stays a single sales order row.

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

SKU aliases

A SKU alias links a GoBolt SKU to a different Katana SKU. Use aliases when the same item has different SKUs in GoBolt and Katana, so it matches your existing Katana product instead of creating a new one. Upload your SKU alias mapping before importing products.

the products mapping screen with SKU alias mapping, showing GoBolt SKUs paired with different Katana SKUs and the option to upload an alias mapping file

Orders sync

Orders from GoBolt

GoBolt orders import into Katana once they reach the configured import-from status, which is the Open state by default. After import, they keep updating automatically through every later status change.

  • Order structure: Each GoBolt order becomes one Katana sales order, with one row per order line. The order source is GoBolt.

  • Fulfillments and tracking: Each shipped package becomes a Katana fulfillment with its carrier and tracking number. Multi-package shipments create one fulfillment per package. Together, these fulfillments never exceed the ordered quantities.

  • Cancellations: When a GoBolt order is canceled, the Katana sales order is deleted only if it is still open.

the order sync settings screen for GoBolt with the import-from status option (default Open) and order status options

Orders from Katana to GoBolt

When a Katana sales order reaches the Ready for fulfillment status, it is pushed to GoBolt as an outbound order. From then on, its progress is tracked back into Katana through the import flow described above.

  • Canceling the Katana sales order does not cancel the GoBolt order.

  • Changes you make to the sales order in Katana after the push do not update the GoBolt order.

the order push settings screen for GoBolt, showing that Katana sales orders are sent to GoBolt when they reach the Ready for fulfillment status

Inventory sync

GoBolt stock levels appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is GoBolt's on-hand quantity.

Reconciliation compares Katana's in-stock quantity against GoBolt's on-hand quantity. It runs on a schedule, or on demand. For any difference, it creates a stock adjustment so Katana reflects GoBolt's physical stock. Katana never sends inventory changes to GoBolt.

the inventory sync settings screen for GoBolt, showing read-only External inventory on-hand quantities per mapped location and the reconciliation schedule and run-now options

Inbound shipments

Each GoBolt inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when one is present, or the inbound ID otherwise.

  • Destination: The Katana location mapped to the inbound's GoBolt warehouse. This location receives the stock.

  • Origin: The location you assign for each destination warehouse. It must be mapped.

Stock transfers follow the inbound's status, and received quantities update the transfer. If an inbound is canceled, its stock transfer is deleted.

Katana stock transfers move directly from in transit to received. Partial receiving therefore appears as updated expected and received quantities until the shipment is fully received.

the inbound shipments screen for GoBolt, showing inbound shipments with their stock transfer numbers, origin and destination locations, statuses, and expected versus received quantities

What does not sync

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

  • Changes to a Katana sales order after it has been pushed to GoBolt are not sent.

  • Canceling a Katana sales order does not cancel the GoBolt order.

  • Returns and RMAs do not sync.

  • Serial numbers are not tracked. Lot and batch data appears read-only where GoBolt provides it.

Disconnecting

To disconnect, open the GoBolt integration from the Integrations page in Katana. Once disconnected, orders, fulfillments, inventory, and inbound shipments stop syncing between GoBolt and Katana. Records already brought into Katana remain in your account, including sales orders, products, fulfillments, stock transfers, and stock adjustments.

Did this answer your question?