Supplier Management

StockrHub’s supplier management system gives you a centralized directory of all your vendors, their contact details, pricing agreements, and lead times. This data feeds into purchase orders, demand forecasting, and reorder suggestions.

Adding a Supplier

To create a new supplier:

1. Navigate to Suppliers and click Add Supplier.
2. Fill in the supplier details:
   • Company Name (required)
   • Email - Used for sending purchase orders.
   • Phone
   • Address - Street, city, state or province, postal code, country.
3. Click Save.

Note

The supplier email address is where PO PDFs are sent. Double-check this is the correct procurement or sales contact for the vendor.

Supplier Contacts

Each supplier can have multiple contacts. This is useful when different people handle orders, billing, or returns.

• Primary Contact - The default recipient for PO emails.
• Additional Contacts - Other people at the supplier you may need to reach.

Each contact record stores:

• Name
• Email
• Phone
• Role or title

Linking Shopify Vendors

StockrHub can link your Shopify product vendors to supplier records. This connection enables:

• Automatic supplier selection when creating POs for products from that vendor.
• Accurate reporting on procurement spend by supplier.
• Reorder suggestions grouped by the correct supplier.

To link a vendor:

1. Open a supplier record.
2. In the Vendor Mapping section, select the matching Shopify vendor name.
3. Save the mapping.

Tip

If your Shopify vendor names match your supplier names exactly, StockrHub can auto-suggest mappings. Keep your Shopify vendor names consistent for best results.

Item Pricing Rules

Pricing rules let you set supplier-specific costs for individual products or variants. These costs override the default product cost when creating POs for that supplier.

Setting a Price Override

1. Open the supplier record.
2. Go to the Pricing tab.
3. Click Add Pricing Rule.
4. Search for the product or variant by SKU or name.
5. Enter the unit cost from this supplier.
6. Save.

When you create a PO for this supplier and add that product, StockrHub will automatically use the supplier-specific cost instead of the default.

Cost Formulas

For suppliers where pricing follows a predictable pattern (for example, a percentage markup on a base price), you can define cost formulas instead of setting individual prices.

A cost formula consists of:

• Multiplier - A factor applied to the base cost (for example, 1.15 for a 15% markup).
• Surcharge - A fixed amount added after the multiplier is applied (for example, $2.00 per unit for handling).

Formula: Final Cost = (Base Cost x Multiplier) + Surcharge

Base Cost	Multiplier	Surcharge	Final Cost
$10.00	1.15	$0.00	$11.50
$10.00	1.00	$2.00	$12.00
$10.00	1.15	$2.00	$13.50

Note

Item-level pricing rules take priority over cost formulas. If a product has both a specific price override and a cost formula, the override is used.

Lead Time Tracking

Each supplier has a configurable lead time measured in days. This represents the typical number of days between placing an order and receiving the goods.

Lead time is used by the demand forecasting engine to calculate:

• When to reorder (stockout date minus lead time).
• Whether current stock will last until the next shipment arrives.

Set the lead time in the supplier record under Lead Time (days).

Caution

Inaccurate lead times will produce incorrect reorder dates. Review and update lead times periodically, especially after seasonal changes or shipping disruptions.

Payment Terms

Record the agreed payment terms with each supplier (for example, “Net 30”, “Net 60”, “COD”, or “Prepaid”). These terms are:

• Displayed on the supplier record for reference.
• Printed on purchase order PDFs.

Preferred Supplier

When a product can be sourced from multiple suppliers, you can flag one as the preferred supplier. This supplier will be:

• Selected by default when auto-generating POs from reorder suggestions.
• Highlighted in the supplier selection dropdown when creating POs manually.

To set a preferred supplier:

1. Open the product’s settings or the supplier record.
2. Toggle Preferred Supplier on.
3. Save.

Tip

Marking preferred suppliers ensures that auto-generated POs are routed to the right vendor without manual intervention.

Exporting and Importing Suppliers

Stockr can export suppliers as a JSON backup and import that same JSON into another shop or environment.

Use Suppliers -> Export JSON to download a stockr-suppliers/v1 file containing:

• Supplier fields and attributes
• Payment methods
• Saved supplier payment accounts
• Supplier automation config
• Vendor mappings
• Item-level pricing overrides
• Supplier warehouse or location mappings

Use Suppliers -> Import JSON to restore that data.

Import behavior:

• Suppliers are matched by existing supplier id first.
• If the imported id does not exist, Stockr falls back to a case-insensitive supplier name match.
• If neither exists, a new supplier is created.
• Missing vendors referenced by the import are created automatically by name.
• For each imported supplier, Stockr replaces:
  • vendor mappings
  • supplier item pricing rows
  • supplier location mappings

Caution

Import is intentionally destructive for the imported supplier’s related mapping tables. If a supplier already exists, importing will replace that supplier’s current vendor mappings, item overrides, and warehouse mappings with the JSON file contents.

Saved Payment Accounts

Payment accounts are now managed centrally so you only add them once.

Path:

• Settings -> Setup -> Accounts

From there, you can add:

• payment method
• account title
• last four digits only
• expiration
• bank name
• bank customer service phone
• default account for that payment method

These saved accounts are then available anywhere Stockr tracks supplier payments, including purchase orders.

Important behavior:

• Stockr stores only the last four digits, never the full account or card number.
• Defaults are scoped per payment method, so you can keep one default credit card and a different default bank account.
• Supplier detail pages point back to Settings -> Setup -> Accounts instead of managing account records there.

API Ordering Connectors

Supplier records can also hold API ordering credentials for suppliers that support direct order submission.

Current live connectors:

• Turn14
• Motorstate
• Parts Authority / IMC

On the supplier form:

1. Set Integration Type to API
2. Choose the supplier connector
3. Enter the required credentials for that connector:
   • Turn14
     • client id
     • client secret
     • warehouse id
     • optional fallback phone
   • Motorstate
     • API key
     • shipping method code
     • payment method code
     • optional fallback last four
   • Parts Authority / IMC
     • username
     • password
     • optional account number
     • optional client id
     • optional ship method
     • optional order status

Important behavior:

• credentials are stored through Stockr’s supplier API-config serializer so secrets can be encrypted at rest
• API ordering currently applies to standard inbound purchase orders, not dropship purchase orders
• Turn14 line items use the PO Part # field as the supplier item id during submission
• Motorstate line items use the PO Part # field as the vendor part number during submission
• Parts Authority / IMC line items use the PO Part # field in LINECODE_PARTNUMBER format
• once configured, the PO detail page can queue the order through the API and show confirmation state on the PO itself

Migrating from Stocky

Stockr includes a built-in Stocky Import for merchants moving off Stocky before Stocky becomes unavailable after August 31, 2026.

Open Settings -> Setup -> Stocky Import and enter:

• your Stocky API key
• your Shopify store name

The supplier side of the importer pulls supplier records from Stocky and creates Stockr supplier records with:

• supplier name
• contact email
• phone
• account number
• company name
• supplier address fields
• a note containing the original Stocky supplier ID

The same card can also import open Stocky purchase orders as archival read-only records. Imported POs are labeled as Stocky imports in the PO register, cannot be edited/received/emailed directly, and can be converted into a normal editable Stockr PO with Duplicate as Stockr PO.

Important migration behavior:

• existing Stockr suppliers are skipped if the supplier name already exists
• imported suppliers start with a default 7 day lead time
• the import does not create vendor mappings or item pricing automatically
• the import does not bring in historical purchase orders

After import, run Shopify Vendor Import and then complete your supplier-to-vendor mappings inside Stockr.

For the full migration sequence, see Migrating from Stocky.

Label Barcode Behavior

Stockr supports label barcode settings in Suppliers -> Add Vendors, but the current scope is important:

• Label Barcode and Barcode Type are stored on the shared Shopify vendor or brand record.
• If the same brand is linked to two suppliers, Stockr does not keep separate label barcode rules per supplier today.
• The saved brand-level setting is reused anywhere that brand is printed.

For MFR Part # labels, Stockr resolves the part number in this order:

1. The shop-wide MFR Metafield Key in Settings.
2. If that is not set, the brand’s default supplier mapping.

Caution

If one brand has multiple suppliers with different label expectations, the current behavior may not be intuitive. Stockr will use one shared brand rule plus the default-supplier fallback for part numbers, not a per-supplier label rule.