PromoSync

A Shopify app to help you import/sync from PromoStandards

This app helps merchants in the promotional products industry connect directly to PromoStandards-compliant suppliers like SanMar, S&S Activewear, HIT, PCNA and most of the suppliers PSRESTful supports. It automates the process of importing supplier product data, keeping inventory and pricing up to date, and generating optimized product images for storefronts. Merchants can streamline product management, reduce manual data entry, and offer more accurate and current product listings to their customers.

Features: đź”—

  • Connect to top PromoStandards suppliers like SanMar, S&S, Koozie, and PCNA
  • Keep product inventory, pricing, and details in sync automatically
  • Import hundreds of supplier products to your store in one step
  • Improve SEO for all the images
  • Improve SEO by adding Google metafields
  • Optimize API calls to Shopify by avoiding tracking manufactured products
Relevant Screenshots: đź”—
PromoSync Shopify App
Main dashboard showing synced products and actions.
PromoSync Settings View
Settings page where you can configure API keys and sync behavior.
Setting Explanations đź”—
  • PSRESTful Private Key: Your PSRESTful API key to connect from PromoSync to your PSRESTful Account.
  • Currency: The currency of your store is used to call the PPC service to get pricing.
  • Title strategy:
    • Use Supplier's Title(productName)
    • Strip Product ID from Title
    • Reorder with Brand and Code
  • Price Calculation Method: Choose which strategy to apply when calculating prices and cost(Blank).
    • MQ(Minimum Quantity): Choose the price from Price Array based on Minimum Quantity
    • HUNDREDS: Calculate the price if we buy and sell 100
    • MAP: Some brands have Minimum Advertised Price (MAP). If you select this one, we will use MAP if available(currently working for SanMar products)

    Custom pricing is coming soon — available for a simple one-time setup fee per store.

  • Add Tags: Sometimes suppliers add many keywords and categories: you might decide not to tag as the supplier.
  • Import Product Status:
    • Active
    • Draft
  • Image Order:
    • Primary: In apparel like for SanMar, primary is usually the image with the model
      However, HIT for hard goods usually classify as primary an image with all the colors
    • Blank: It should an image of a single Part in blank

    You should check our Data Explorer to better understand Media Content classification.

    The image selection process depends on a good classification. Unfortunately, sometimes suppliers don't classify them correctly, making it impossible to pick the right image.

  • Max Number of Variants: 100 By default due to Shopify current restrictions.
    PromoSync will restrict to the number of variants you set here. If you are using Shopify Plus or a demo store with more variants, you will be able to get more by updating this field to your maximum.
  • Update Inventory Logic:
    • On Demand: When the user clicks on the button via Shopify Extension or when on the main screen
    • Once a Day: Automated process once a day(in the morning)
    • Twice a Day: Automated process (mornings and afternoons)
  • Update Prices Logic:
    • On Demand: When the user clicks on the button via Shopify Extension or when on the main screen
    • Once a Day: Automated process once a day(in the morning)
    • Once a Week: Automated process to run once a week

    In the case of prices, they don't change so often. "On Demand" is a good fit.

PromoSync Import Products with filter View
Import products using brand, category, or tag filters.
PromoSync Import Products North Face Brand View
Example of importing products from The North Face brand.
Import Product Explanations: đź”—

The Import Products feature helps you search and filter products before syncing them into your Shopify store. You can narrow down results using filters such as Supplier, Brand, List Price, Lead Time, Minimum Quantity, and more. For additional options like On Demand, Rush Available, or Apparel Style, click the Other Filters button to open the advanced filter panel.

You can also sort the product list by Supplier, Product ID, Name, List Price, Lead Time, or Minimum Quantity to quickly organize and locate the items you want to import.

Once you’ve selected the products by checking the corresponding boxes, choose the Import/Sync action from the dropdown menu and click Go. This process is asynchronous, meaning products will begin to appear in your Shopify Admin shortly after initiating the import.

Products that have already been imported into Shopify will appear highlighted with a green row, making it easy to distinguish synced items from those still pending.

Lastly, keep in mind that some aspects of the import behavior—like pricing rules, or format customization—are managed through the Settings section. Be sure to review your settings to ensure the import process aligns with your store's configuration.

Admin Actions View
Admin Actions on selected products.
Special Metafields: đź”—
Field Owner Example Reason
Minimum Quantity Product 36 Help you enforce minimum quantity
Part Price Array ProductVariant

                                    
    [
        {
            "quantityMin": 36,
            "price": 2859
        },
        {
            "quantityMin": 72,
            "price": 2486
        },
        {
            "quantityMin": 144,
            "price": 2162
        },
        {
            "quantityMin": 288,
            "price": 1880
        },
        {
            "quantityMin": 576,
            "price": 1635
        }
    ]
    
Serve you to implement tier pricing
Location Decorations Product

                                
    [
        {
            "locationId": 67,
            "locationName": "WRAP",
            "decorationsIncluded": 1,
            "defaultLocation": true,
            "minDecoration": 0,
            "maxDecoration": 1,
            "locationRank": 1,
            "decorations": [
                {
                    "decorationId": 6958149,
                    "decorationName": "4 COLOR PROCESS",
                    "maxImprintColors": 4,
                    "default": true,
                    "priceIncludes": true
                }
           ]
        }
    ]
    
Allows users to display/select locations/decorations
Other Metafields: đź”—
Field Owner Example Reason
Price Expires Date Product 36 Help you enforce minimum quantity
Brand Product The North Face Although Vendor will be populated with this when available, the metafield serves as the original value
Is Caution Product True Cautionary status to review for specific warnings about using product data.
Caution Comment Product - Product cautionary comments
Line Name Product Leeds Line Name / Division to which this product belongs
UNSPSC Commodity Code Product - The United Nations Standard Products and Services Code® (UNSPSC®) that best describes this product. Note that the enumerated values are the UNSPSC "Commodity" codes. For more information, refer to https://www.unspsc.org
Imprint Size Product Width - 3.0000 Width 3.0000 and height 4.0000 shape Rectangle and uom INCH The imprint Size
Default Setup Charge Product - The default SETUP charge for this product. Can be a textual description
Default Run Charge Product Extra color charge : 0.30 | The default RUN charge for this product. Can be a textual description
Primary Material ProductVariant Steel Primary material of construction
Is Rush Service ProductVariant Is Rush service available
Lead time ProductVariant 5 Lead time in days
Is Caution ProductVariant True Cautionary status to review for specific warnings about using product data
Caution Comment ProductVariant Cautionary comments
Is On Demand ProductVariant Manufactured on demand / Made to order
Is HazMat ProductVariant Contains hazardous material. A nil value indicates this it is unknown or the data is not available by the supplier.
Shape ProductVariant General shape
unspsc ProductVariant United Nations Standard Products and Services Code (UNSPSC)
nmfc Code ProductVariant National Motor Freight Classification Code
nmfc Description ProductVariant National Motor Freight Classification Description
nmfc Number ProductVariant National Motor Freight Classification Number
Country of Origin ProductVariant CN Country of Origin in ISO 3166-1 Alpha 2 code format (Example: CA=Canada; US=United States)
GTIN ProductVariant 00191265464253 Global Trade Item Number (GTIN)
Dimension ProductVariant

                                    
    {
        "dimensionUom": "IN",
        "depth": "3.07",
        "height": "8.82",
        "width": "3.07",
        "weightUom": "LB",
        "weight": "1.05"
    }
    
dimensionUom: The dimensional unit of measure
depth: The depth/length of the part using the unit of measure specified in dimensionUom
height: The height of the part using the unit of measure specified in dimensionUom
width: The width of the part using the unit of measure specified in dimensionUom
height: The height of the part using the unit of measure specified in dimensionUom
weightUom: The weight unit of measure for the part
weight: The weight of the part using the unit of measure specified in weightUom
Reference
Specification Array ProductVariant

                                    
    [
      {
        "specificationType": "Volume",
        "SpecificationUom": "oz",
        "measurementValue": "24.0000"
      },
      {
        "specificationType": "Volume",
        "SpecificationUom": "ml",
        "measurementValue": "729.0000"
      }
    ]
    
An array of specifications for the product variant. Each specification includes a type, value, and unit of measure. Reference
Shipping Package Array ProductVariant

                                    
    [
      {
        "packageType": "Master Carton",
        "description": null,
        "quantity": 12,
        "dimensionUom": "IN",
        "depth": 16.93,
        "height": 9.96,
        "width": 11.02,
        "weightUom": "LB",
        "weight": 19.84
      }
    ]
    
An array of ShippingPackage objects that provide details about the shipping packaging options available for a product, such as Carton, Box, Pallet, etc. Reference
Product Packaging Array ProductVariant

                                    
    [
      {
        "default": false,
        "packageType": "Gift Box",
        "description": "FSC certified premium gift box",
        "quantity": 12,
        "dimensionUom": "IN",
        "depth": 16.93,
        "height": 9.96,
        "width": 11.02,
        "weightUom": "LB",
        "weight": 19.8
      }
    ]
    
An array of ProductPackaging objects that provide details about the packaging options available for a product, such as Gift Box, Cello Pack, Sleeve, etc. Reference
Apparel Size ProductVariant

                                    
    {
      "apparelStyle": "Womens",
      "labelSize": "XS",
      "customSize": null
    }
    
Used to describe an apparel size. Reference
Color Array ProductVariant

                                    
    [
      {
        "colorName": "Gray (GY)",
        "hex": "7C878E",
        "approximatePms": "PMS430",
        "standardColorName": "Gray"
      }
    ]
    
Information about the part colors. An array of Color objects.
<