Skip to main content

JAS integration setup

Map JAS warehouses to locations and sync two-way orders, SKU-matched products, read-only stock, and inbound transfers.

A
Written by Argo Ohvril

What syncs between Katana and JAS

Data flow between JAS and Katana

The table below lists each data type and the direction it moves between JAS and Katana.

Data

Direction

Status

Orders

Two-way

Available

Products

JAS → Katana

Available

Inbound stock transfers

JAS → Katana

Available

Inventory sync

JAS → Katana

Available

Locations and mapping

After JAS approves the connection, the configuration screen opens on the Location tab. Each JAS warehouse maps 1:1 to its own dedicated Katana location.

  • A warehouse that has never been mapped shows Not mapped. Click Add to Katana to create its Katana location automatically.

  • To pause a mapped warehouse, click Unlink. Its status then shows Unlinked.

  • To resume syncing that warehouse, click Relink.

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 JAS configuration screen, listing JAS warehouses with their mapped Katana locations, status labels (Mapped, Unlinked, Not mapped), the Add to Katana, Unlink and Relink buttons, and the Activate sync button in the header

Products sync

Product mapping creates a required link between each JAS product and a Katana item. Products are imported by SKU:

  • If the SKU already exists in Katana, the JAS product is matched to that Katana product.

  • If the SKU is unknown in Katana, a product is created just-in-time.

You choose how SKUs are matched. Use direct 1:1 matching or use SKU aliases.

Kits and bundles from JAS become Katana products. To track their components, add a BOM in Katana. A kit order line stays a single sales order row.

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

SKU aliases

A SKU alias links a JAS SKU to a different Katana SKU. Use aliases when the same item has different SKUs in JAS and Katana, so the two products match instead of creating a duplicate. Upload your SKU alias mapping before importing products.

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

Orders sync

Orders from JAS to Katana

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

  • Each JAS order becomes one Katana sales order, with one row per order line.

  • The order source is set to JAS.

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

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

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

Orders from Katana to JAS

A Katana sales order is pushed to JAS as an outbound order when it reaches the Ready for fulfillment status. From then on, Katana tracks its progress the same way as imported orders.

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

  • Changes made in Katana after the push do not update the JAS order.

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

Inventory sync

JAS is the source of truth for physical stock. Katana shows JAS stock levels as read-only External inventory at each mapped warehouse's Katana location. The number shown is JAS's on-hand quantity.

Reconciliation compares Katana's in-stock quantity with JAS's on-hand quantity. You can run it on a schedule or on demand. Any differences are corrected with stock adjustments in Katana. Katana never sends inventory changes to JAS.

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

Inbound shipments

Each JAS inbound shipment becomes one Katana stock transfer. The transfer number is the PO number when one exists. Otherwise, it is the inbound ID.

  • Destination: the Katana location mapped to the inbound's JAS warehouse.

  • Origin: the location you assign for each destination warehouse. This origin location must be mapped.

  • The stock transfer follows the inbound status, and received quantities update the transfer.

  • Katana stock transfers move straight from in transit to received. During partial receiving, the transfer shows updated expected and received quantities until everything is received.

  • If the inbound is canceled in JAS, its stock transfer is deleted.

the inbound shipments screen showing JAS inbound shipments as Katana stock transfers with PO number or inbound ID, origin and destination locations, status, and expected versus received quantities

What does not sync

  • Products and stock changes are not sent from Katana to JAS.

  • Changes to a Katana sales order after it is pushed are not sent to JAS.

  • Canceling a pushed Katana sales order does not cancel the JAS order.

  • Returns and RMAs do not sync.

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

Disconnecting

To disconnect, open the JAS integration from Katana's Integrations page. Syncing stops for orders, products, inventory, and inbound shipments. Records already brought into Katana stay in Katana, including sales orders, fulfillments, products, and stock transfers.

Did this answer your question?