PromoSync can import from any supplier your PSRESTful account has credentials for. You add products one by one from Product Search, or many at once with Bulk Import by IDs, and each import becomes a normal Shopify product with its variants, images, prices, stock and supplier data.
Which suppliers you can use
The supplier lists in PromoSync show every supplier your PSRESTful account can read (with our shared credentials or your own) that is ready for Shopify. The full list is at https://promosync-docs.psrestful.com/suppliers.
- To add a supplier, add its credentials in PSRESTful under Configure Credentials
(
/dashboard/configure-credentials/). Add supplier credentials walks through it, and Our credentials or yours explains the difference. A new supplier can take about five minutes to show up in PromoSync. - SanMar needs your own SanMar login for its prices and stock. See SanMar credentials.
- A supplier that isn't on the list at all can be requested at https://psrestful.com/integrated-suppliers/request/.
Check these settings before a big import
These apply to products as they're created, so set them first. Open PromoSync, click Settings, and look on the Shop Settings tab:
- Price Calc. Method and Default Configuration Type decide the Shopify price. See How PromoSync sets prices.
- Import Product Status is Active or Draft. Draft keeps new products hidden from shoppers until you've checked them.
- Variant Grouping Strategy is One Product (All Variants) or Split by Color, which makes one Shopify product per color.
- Max Number of Variants caps how many variants a product gets. It starts at 2048.
- Add Tags adds the supplier's keywords as product tags.
Add products from Product Search
- Open PromoSync from Apps in your Shopify admin.
- Under Product Management, click Product Search.
- Type a product name, product ID, SKU or GTIN in Search, and pick a Supplier to narrow the list.
- Tick the products you want. A mark in the Synced column means the product is already in your store.
- Add Import Tags if you want to label this batch.
- In the bar above the results, choose Import / Sync under Action.
- Click Go.
Add many products by ID
- Under Product Management, click Bulk Import by IDs.
- Choose the supplier in Select Supplier. Select Brand is optional.
- Choose All images or First image only in Images to import.
- Paste the supplier's product IDs in Product IDs, one per line or separated by commas.
- Click Import Products.
Use the supplier's product IDs, not Shopify IDs, written exactly as the supplier writes them. Some suppliers add a letter to a style number for a different version, and the plain number won't match it. If an ID comes back as not found, look it up in Product Search or in Data Explorer and copy the ID from there.
The form recommends at most 100 products per import. Import all products from this supplier brings in the whole catalog, which can be a very large number of products.
After you click import
Imports run in the background, so you can leave the page. When one finishes, your notification contacts get a Product Import Results email with the imported, skipped and failed products and the reason for each. IDs PSRESTful doesn't have for that supplier come in a separate Products Not Found email.
The same results are in PromoSync under Overview > Recent Activity, where CSV downloads the full list and Retry runs the failed and skipped products again.
A product that's already in your store is skipped, not copied. To import a second copy on purpose, tick Allow duplicate product names; the copy gets a different URL handle.
What PromoSync creates in Shopify
| In Shopify | What PromoSync fills in |
|---|---|
| Product | Title, description, the brand as Vendor, tags, and Active or Draft status |
| Variants | One per supplier part (usually a color and size), with SKU, price, cost per item, weight and barcode when the supplier sends one |
| Images | The supplier's images, with each variant linked to the image for its color |
| Stock | The supplier's quantity, at your Default Inventory Location |
| Metafields | Supplier data your theme can show, such as minimum order quantity, decoration locations and each variant's quantity price breaks |
PromoSync doesn't add products to collections. Its tags work as conditions for Shopify smart collections.
Each imported product is also registered with PSRESTful. That's how later price, stock and image updates find it. Products you made by hand, with another app, or by duplicating a product in Shopify aren't registered. Bring them in with the Onboard to PromoSync action (how it works).
PromoSync writes its metafields in the psrestful namespace. On the product:
supplier_code, product_id (the supplier's ID), extra_id, minimum_quantity, location_decorations
and others. On each variant: part_id and part_price_array. The full reference is at
https://promosync-docs.psrestful.com/metafields/product.
If some colors or sizes are missing
- The product has more parts than Max Number of Variants. Raise the limit in Shop Settings, then select the product in Shopify and run Add New Variants from the PromoSync actions.
- The supplier's data is missing a color for some parts. The import email lists them under "Variants skipped - supplier data issue". Those need a fix from the supplier.