Skip to main content

Managing Supplier Products

A Supplier Product is the record that links one product variant to one supplier. It holds the commercial terms specific to that supplier–variant combination: lead time, MOQ, pack size, unit price, and supplier SKU.

Without at least one supplier product on a supplier, that supplier cannot be used on a purchase order line item.

Where supplier product terms fit in the hierarchy​

Synplex resolves lead time, MOQ, and pack size using a three-level fallback: Supplier Product level ← most specific, used if set Supplier level ← default lead time on the supplier record Shop level ← store-wide defaults from Settings → General Only lead time uses all three levels. MOQ and pack size fall back directly to the shop-level default if not set on the supplier product.

Viewing supplier products​

Open any supplier → Supplier Products tab.

The tab shows all variants linked to this supplier in a table with their current per-variant terms. Each row is editable inline.

Method 1: Add supplier products from the Inventory Report​

This is the recommended method when you want to assign a specific set of variants to a supplier after reviewing stock levels.

  1. Go to Inventory Report in the sidebar
  2. Select the variants you want to assign using the row checkboxes
  3. Open the Actions menu → Assign to supplier
  4. Select the supplier from the dropdown
  5. Confirm — supplier product records are created for each selected variant

If a supplier product already exists for a given variant–supplier pair, it is updated rather than duplicated.

Method 2: CSV upload from the supplier detail page​

Best for initial bulk setup or when migrating supplier catalogues from a spreadsheet.

How to upload​

  1. Open the supplier → Supplier Products tab (or use the Tools → Import Products (CSV) action in the top-right menu)
  2. Download the CSV template
  3. Fill in your data (see columns below)
  4. Upload the completed file

CSV columns​

ColumnRequiredNotes
skuRequired (if no productVariant)Synplex looks up the variant by SKU within your shop. Case-sensitive.
productVariantRequired (if no sku)Gadget variant ID. Use SKU instead unless you have IDs available.
supplierRequiredGadget supplier ID. Pre-filled in the template when downloaded from the supplier page.
supplierSKUOptionalThe supplier's own reference code for this variant.
moqOptionalMinimum order quantity for this variant from this supplier.
packSizeOptionalUnits per pack. Orders rounded up to nearest full pack.
leadTimeDaysOptionalLead time in days for this specific variant from this supplier. Overrides supplier default.
unitPriceOptionalCost price per unit in the supplier's currency.

SKU matching behaviour​

  • Synplex matches rows to variants using the sku column against your Shopify product variant SKUs
  • SKUs not found in your shop are skipped and logged as errors in the upload result
  • Blank or missing SKUs without a productVariant ID are also skipped
  • Duplicate rows (same SKU + same supplier) are upserted — the existing record is updated, not duplicated

After upload​

Review the upload result banner — it shows a count of successfully processed rows and a list of any rows that failed with the reason (e.g. SKU not found: WIDGET-001). Correct failed rows and re-upload if needed.

Method 3: Edit supplier products inline on the supplier detail page​

For making changes to individual variants already linked to a supplier.

  1. Open the supplier → Supplier Products tab
  2. Find the variant in the table
  3. Edit the fields directly in the row
  4. Save using the save bar

Supplier product fields reference​

FieldNotes
Supplier SKUThe code your supplier uses for this variant. Useful for PO line items and supplier communication.
MOQMinimum units per order for this variant. Overrides store-wide default.
Pack sizeUnits per pack. Overrides store-wide default.
Lead time (days)Days from order placement to delivery for this variant. Overrides supplier default lead time.
Unit priceCost price in the supplier's currency. Used in PO cost calculations.
StatusAvailable or Not Available. Not Available hides this supplier from the variant's supplier picker on POs.

Primary supplier​

Each product variant has a primary supplier designation stored on its inventory item. The primary supplier is the one Synplex uses by default when:

  • Generating reorder recommendations
  • Pre-selecting a supplier on new PO line items
  • Calculating days of supply and stockout projections using supplier-specific lead times

How primary supplier is assigned​

  • During Sync from Shopify: the Shopify vendor is set as primary supplier for any variant that doesn't already have one
  • During manual assignment: when you assign a variant to a supplier from the Inventory Report and it has no primary supplier yet, the selected supplier is set as primary automatically
  • You can override the primary supplier at any time from the variant detail page (Inventory Report → click a variant → Supply chain & composition tab)

A variant can have multiple suppliers​

A single variant can have supplier product records for multiple suppliers — for example, a primary supplier in Germany and a backup supplier in the UK. The primary designation controls which one drives forecasting. On individual PO line items you can always select any of the linked suppliers regardless of which is primary.