Skip to main content

TradePeg integration setup

Set up warehouse-to-location mapping, product import by SKU or alias, and inventory sync with stock reconciliation.

A
Written by Argo Ohvril

What syncs between Katana and TradePeg

Data flow between TradePeg and Katana

The table below shows each data type and the direction it moves between TradePeg and Katana.

Data

Direction

Status

Products

TradePeg → Katana

Available

Inventory sync

TradePeg → Katana

Available

Locations and mapping

Connect TradePeg from Katana's Integrations page by clicking Connect on the TradePeg tile and entering your API key. Your TradePeg contact provides this key. Once the connection is approved, the configuration screen opens on the Location tab.

  • Each TradePeg warehouse maps to its own dedicated Katana location. Click Add to Katana to create that location automatically.

  • A warehouse that was never mapped shows Not mapped.

  • To pause a mapped warehouse, click Unlink. Its status shows Unlinked. Click Relink to resume it.

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 TradePeg configuration screen, listing TradePeg warehouses with statuses Mapped, Unlinked and 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 TradePeg product and a Katana item. You choose how SKUs are matched: either direct 1:1 or through SKU aliases.

  • Products are imported by SKU.

  • If a TradePeg SKU matches an existing Katana product, the two are linked.

  • If Katana doesn't recognize a SKU, it creates the product just in time.

  • Kits and bundles become Katana products. Add a BOM of their components in Katana.

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

SKU aliasing

A SKU alias links a TradePeg SKU to a different Katana SKU. Use aliases when the same product has a different SKU in each system, so the two records match instead of creating a duplicate product.

Upload your SKU alias mapping before importing products.

the products mapping screen with SKU alias mapping, showing an uploaded alias list pairing TradePeg SKUs with different Katana SKUs

Inventory sync

TradePeg is the source of truth for physical stock. Its stock numbers appear in Katana as read-only External inventory at each warehouse's mapped location. The figure shown is TradePeg's on-hand quantity.

Reconciliation compares Katana's in-stock quantity with TradePeg's on-hand quantity. It runs on a schedule or on demand. Where the two differ, Katana creates stock adjustments so its in-stock figures match TradePeg. Katana then uses these figures for planning.

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

What does not sync

  • Sales orders, in either direction.

  • Fulfillments, carrier details and tracking numbers.

  • Inbound shipments and stock transfers.

  • Product or stock changes made in Katana. These are never pushed to TradePeg.

  • Returns and RMAs.

  • Serial-number tracking. Lot and batch data appears read-only where TradePeg exposes it.

Disconnecting

To disconnect, go to Katana's Integrations page, open the TradePeg integration, and disconnect it. Syncing between TradePeg and Katana stops.

Records already brought into Katana, such as imported products and the locations created for your warehouses, stay in Katana.

Did this answer your question?