Skip to main content

TLogistics integration setup

Map warehouses, then sync orders two-way, products by SKU, read-only inventory and inbound shipments as transfers.

A
Written by Argo Ohvril

What syncs between Katana and TLogistics

Data flow between TLogistics and Katana

The table below summarizes how data moves between Katana and TLogistics.

Data

Direction

Status

Orders

Two-way

Available

Products

TLogistics → Katana

Available

Inbound stock transfers

TLogistics → Katana

Available

Inventory sync

TLogistics → Katana

Available

Locations and mapping

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

  • Add to Katana automatically creates the Katana location for a warehouse.

  • A warehouse that has never been mapped shows Not mapped until you click Add to Katana.

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

  • To resume syncing, click Relink.

Only mapped warehouses sync.

the warehouse location mapping panel on the Location tab of the TLogistics configuration screen, listing TLogistics warehouses with their mapped Katana locations, one warehouse showing Not mapped with an Add to Katana button, one showing Unlinked with a Relink button, and a mapped one with an Unlink button

Products sync

Product mapping creates a required link between each TLogistics product and a Katana item. You choose how SKUs are matched: directly 1:1, or through SKU aliases.

  • Products are imported by SKU.

  • A TLogistics SKU that already exists in Katana is matched to that product.

  • An unknown SKU creates a new Katana product just-in-time.

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

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

SKU aliases

A SKU alias links a TLogistics SKU to a different Katana SKU. Use aliases when the same product has a different SKU in TLogistics than in Katana, so it matches the existing Katana product instead of creating a new one.

Upload your SKU alias mapping before you import products.

the products mapping screen with SKU alias mapping, showing a list of TLogistics SKUs each paired with a different Katana SKU, and an option to upload the alias mapping

Orders sync

Orders imported from TLogistics

Orders import once they reach the configured import-from status. The default is the "Open" state. After import, orders keep updating automatically through every later status change.

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

  • 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.

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

the order sync settings screen for TLogistics with the import-from status option set to Open and the order import options

Orders sent from Katana to TLogistics

When a Katana sales order reaches the Ready for fulfillment status, Katana pushes it to TLogistics as an outbound order. Its progress then flows back into Katana through the import flow above.

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

  • Changes you make in Katana after the push do not update the TLogistics order.

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

Inventory sync

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

Reconciliation compares Katana's in-stock quantity with TLogistics' on-hand quantity. It runs on a schedule or on demand. Any differences are recorded as stock adjustments in Katana.

Katana never sends inventory changes to TLogistics.

the inventory sync settings screen for TLogistics showing read-only external on-hand inventory per mapped location and the scheduled and on-demand reconciliation options

Inbound shipments

Each TLogistics inbound shipment becomes one Katana stock transfer.

  • Number: the PO number when one is present, otherwise the inbound ID.

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

  • Origin: the location assigned for each destination warehouse. This location must be mapped.

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

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

the inbound shipments screen showing a TLogistics inbound shipment as a Katana stock transfer with its PO number, origin and destination locations, status, and expected versus received quantities

What does not sync

  • Products and stock changes are never sent from Katana to TLogistics.

  • Changes made in Katana after an order is pushed do not update the TLogistics order.

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

  • Returns and RMAs.

  • Serial number tracking. Lot and batch data is shown read-only where TLogistics provides it.

Disconnecting

To disconnect, open the TLogistics tile on Katana's Integrations page. Syncing between Katana and TLogistics then stops, so no new orders, fulfillments, inventory updates, or inbound shipments come in, and no orders are pushed.

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

Did this answer your question?