Supplier–variant mapping

A supplier–variant link is a row that says “I buy variant X from supplier Y at price Z, with these terms (MOQ, pack size, lead time, supplier-side SKU).” A variant can have many links (many suppliers can sell the same SKU). One link per variant is marked primary — its values drive reorder math.

What a link is

One row per (supplier, variant) pair. The link is where you record everything that’s specific to how this supplier sells this variant to you, including the things that differ from what’s in Shopify. A link carries:

Supplier SKU — the SKU your supplier uses (often different from your Shopify SKU).
Supplier product name — what the supplier calls the product on their invoices and catalogues.
Supplier product URL — a link back to the product on the supplier’s site or portal.
Supplier variant details / notes — free-text notes about this variant from the supplier (colour, finish, packaging quirks, etc.).
Barcode — supplier-side barcode if it differs from the Shopify one.
Cost + currency — your unit cost from this supplier.
MOQ — minimum order quantity for this variant. A separate Product MOQ can apply once per product instead — see Lead times & MOQ.
Max order quantity — optional ceiling.
Pack size — packaging increment.
Lead time — days from order to delivery.
Primary flag — exactly one link per variant is the primary.

A variant can have one Default supplier link plus many real supplier links. Common cases: backup suppliers, multi-region sourcing, comparing quotes.

Adding variants to a supplier

On the supplier detail page’s Variants tab, the Add variants button opens a menu with two sources:

Shopify variants — pick from your store’s product catalogue.
Virtual materials — raw inputs tracked by the Assemblified app (fabric rolls, packaging components, and similar) that aren’t standalone Shopify variants, but can still be linked to a supplier here. The option is always in the menu; if Assemblified isn’t feeding materials into your shop, the picker simply opens empty (“No virtual materials found”).

The menu is available whether the supplier already has variants linked or none yet. With no variants, the empty state shows the same Add variants menu next to an Import variants button; with variants, it sits in the table toolbar above all of the tab’s sub-views.

New links are pre-filled from what you picked — supplier SKU from the variant’s SKU, cost from the variant’s Shopify unit cost, currency from the supplier — and always start as Secondary. The cost is copied as a plain number with no currency conversion, so check it when the supplier bills you in a different currency than your shop. MOQ, pack size, and lead time come from the supplier’s own Ordering Defaults; if the supplier has none set, links added this way start at MOQ 0, pack size 1, and a 40-day lead time until you edit them. To make the new link drive reorder math, promote it afterwards (see Changing primary).

Adding an order’s items to its supplier

This is a different flow from Add variants above: it starts from an order that already has the items on it, and hands them to the order’s supplier without you retyping the terms you negotiated.

A purchase order whose lines aren’t all mapped to its supplier shows task badges above the line-item table — N not from supplier and N unavailable at location. Clicking one opens the Add Items to Supplier dialog. Return orders have the same dialog.

Each item gets its own card, pre-filled from the order line rather than reset to blanks:

Supplier SKU — the line’s supplier SKU, or its Shopify SKU when there isn’t one.
Unit Cost — the line’s cost.
MOQ and Pack Size — from the line (purchase orders only), falling back to the supplier’s Ordering Defaults.

Above the cards, one Lead Time (days) field applies to every item at once; leave it empty and each link takes the supplier’s default lead time.

Each card also has a Show more toggle that reveals three optional fields:

Supplier Barcode — the supplier’s own barcode for this variant, when it differs from the Shopify one.
Supplier Product URL — a link to the item on the supplier’s site or portal.
Supplier Variant Details — free-text notes the supplier uses to identify this variant.

Add to Supplier creates the supplier–variant links and writes the values you confirmed back onto the order’s lines, so the order and the new links agree. Clearing the barcode field clears the line’s barcode override too.

Primary supplier

One link per variant is the primary supplier. Reorder math uses the primary’s numbers. Only one primary at a time.

Changing primary

Three ways, all on the supplier detail page’s Variants tab:

Row edit panel — each row shows Primary or Secondary in the Status column (a label, not a button). To change it, open the row’s edit side panel and turn on the Use as primary supplier toggle.
Bulk edit — select several rows and set Primary supplier status in the bulk edit panel.
Import — the supplier–variant import accepts an Is Primary Supplier column, so a file can promote (or demote) many links in one go. The confirm screen warns you when the file will reassign primaries.

On the Default supplier’s own page the toggle can’t be switched off — Logistified refuses to demote a Default link from there, so you can’t leave a variant without a primary by accident. It can still lose the flag indirectly: promoting a real supplier for that variant clears the Default link’s primary flag, exactly like any other hand-off.

When you set a new primary, the previous primary’s flag is unset automatically. No double primaries.

Cascading variant edits to draft POs

When you bulk-edit variants in supplier mode (e.g., via the supplier detail page’s Variants tab), the changes update Draft POs only. POs in Sent / Confirmed / further statuses are frozen — to apply the new values there, you’d edit the PO manually.

Removing a link

Removing a supplier–variant link severs the connection. The variant isn’t removed — just disconnected from that supplier.

If the link was primary, Logistified tries to promote the Default supplier link as the new primary (provided the Default has a link for that variant).