Operating suppliers

With write access, a connected assistant can manage your supplier directory — creating and updating supplier records, maintaining the cost and lead-time data for each supplier–product pairing, designating a primary supplier per variant, and issuing manual supplier credits. This page explains what that covers and what to watch out for.

On this page

• What the assistant can do with suppliers
• What it takes
• Managing suppliers
• Managing supplier–product mappings
• Designating a primary supplier
• Issuing supplier credits
• Things to know

What the assistant can do with suppliers

The assistant can handle your full supplier directory, including:

• Create new suppliers with contact details and a default cost currency.
• Update supplier header fields — name, contact, website, and currency.
• Delete (archive) a supplier when it’s no longer needed.
• Add, update, or remove the supplier’s product mappings — SKU, cost price, MOQ, pack size, lead time, fulfilment mode, and more — for up to 500 variants at a time.
• Designate which supplier is the primary source for a variant.
• Issue manual supplier credits.

Changes to suppliers and their mappings are reflected in Logistified immediately. They are never written to Shopify.

What it takes

Write access is opt-in. The assistant needs either:

• an API key created with write scope — see API keys, or
• a web chat connection that was granted write access when it was linked — see Connect a web chat.

A read-only connection can still read supplier data but cannot make any of the changes described here.

Managing suppliers

The assistant can create a supplier with a name, a contact person, email, phone, website, and your default cost currency for that supplier. Once created, any of those header fields can be updated.

Deleting a supplier archives it — past purchase-order references stay intact, but the supplier disappears from active lists. You cannot delete the default supplier.

Caution

Changing a supplier’s cost currency relabels the currency on every product mapping linked to that supplier. It does not convert the numeric costs — only the label changes. Use this only when you’re correcting an initial currency selection across the board, not to adjust one mapping at a time.

Managing supplier–product mappings

The assistant can create or update cost mappings in bulk — up to 500 rows at a time per supplier. For each variant it can set:

• Supplier SKU, supplier product name, and a product URL
• Cost price and currency code
• Minimum and maximum order quantities
• Pack size and lead time (in days)
• Fulfilment mode (warehouse delivery, supplier-held, or warehouse consignment)
• Whether a longer lead time applies when stock is held at the supplier
• A miscellaneous notes field

When updating existing mappings, you can tell the assistant exactly which fields to touch so it doesn’t blank out ones you haven’t provided. Individual mappings can also be removed — removing the mapping doesn’t affect the variant itself or any purchase orders that referenced it.

Designating a primary supplier

Each variant can have one primary supplier — the one Logistified uses for default costs and lead-time planning. The assistant can re-assign the primary flag from one supplier to another for a given variant. The previous primary supplier keeps its mapping; only the flag moves.

If you delete a supplier that was the primary for some variants, the default supplier is re-promoted to primary for those variants automatically.

Issuing supplier credits

The assistant can issue a manual credit against a supplier. Credits issued this way appear in the supplier’s credit ledger and can be applied to purchase orders. Use this for situations where you’re recording a credit arrangement that happened outside the normal return-order flow — for example, a goodwill credit or an agreed price correction.

Note

Credits minted through the return-order flow (as part of closing a supplier return) are handled separately — see Operating transfers, stock takes & returns.

Things to know

• No Shopify writeback. All supplier changes live in Logistified only — nothing here touches Shopify product data, tags, or metafields.
• Supplier IDs are client-supplied on create. When asking the assistant to create a supplier, it generates a unique ID for the record. If the same request is retried, a duplicate ID will fail — this prevents accidental double-creates.
• Bulk mapping updates are safe to retry. Upserting mappings is idempotent: re-running the same set of rows updates any that already exist and inserts any that are new.

See also

• What the assistant can read — the full read surface, including supplier reads.
• Operating purchase orders — applying supplier credits to purchase orders.
• Operating transfers, stock takes & returns — supplier return (RMA) write surface.

Last updated: 20 June 2026