PromoStandards is split into separate services, one per kind of data. Four describe the supplier's catalog (Product Data, Media Content, PPC and Inventory) and work with our shared credentials for suppliers marked Credentials Available. The other four are about your orders (Purchase Order, Order Status, Order Shipment Notification and Invoice) and need credentials the supplier issues to your company.
At a glance
| Service | Code | What it gives you | Credentials |
|---|---|---|---|
| Product Data | Product | What the supplier sells, with colors, sizes and parts | Shared or yours |
| Media Content | MED | Product images, videos and documents | Shared or yours |
| Product Pricing and Configuration | PPC | Prices, decoration options and charges | Shared for net and list prices, yours for your customer pricing |
| Inventory | INV | Stock levels | Shared or yours |
| Purchase Order | PO | Sending orders to the supplier | Yours |
| Order Status | ODRSTAT | Where your order is | Yours |
| Order Shipment Notification | OSN | What shipped, with tracking numbers | Yours |
| Invoice | INVC | The supplier's invoices for your orders | Yours |
"Shared" means our agent credentials, for suppliers that have given us some. A few suppliers need your own credentials even for catalog data: SanMar, for example, only returns pricing and stock with your own SanMar login (SanMar credentials). The Integrated Suppliers page shows each supplier's services and credentials.
Catalog services
Product Data (Product)
What the supplier sells: product names, descriptions, categories, colors, sizes and imprint areas, plus the parts (each color and size combination has its own part ID). Depending on the supplier you also get details such as country of origin, lead times and closeout or hazmat flags. You can ask for all sellable products, products changed since a date, or closeouts. Images come from Media Content, not from here.
Where PSRESTful uses it:
- The Product button in the Data Explorer, on every plan.
- Product Search (Premium) and PromoSync, which work from supplier catalogs we import with Product Data, Media Content and PPC.
- The product files in the CSV Exporter (Premium).
Media Content (MED)
Product images, videos and documents such as art templates. Each file can carry a class type (product image, lifestyle image, virtual sample, blank product and others), the colors and parts it belongs to, and its size. Quality varies by supplier: some don't tag images by color or class type, and many leave out image dimensions.
Where PSRESTful uses it:
- The MED button in the Data Explorer, on every plan. Download All for a product's files needs Standard or higher.
- Broken Links (Premium), which checks supplier media URLs.
- PromoSync product images (images missing in PromoSync).
Product Pricing and Configuration (PPC)
Prices and how a product can be decorated: price breaks by quantity, decoration methods and locations, imprint areas, setup and run charges, less-than-minimum (LTM) charges, and FOB points (where the product ships from). Prices come in three types: Net (your cost), List (the suggested selling price) and Customer (pricing negotiated with your company). Decorated purchase orders are built from this data too.
Where PSRESTful uses it:
- The PPC button in the Data Explorer, on Standard and higher plans.
- The Pricing Calculator (Premium).
- PromoSync pricing and decorations (PromoSync pricing and decorations).
Inventory (INV)
Stock by product and part. A supplier can report it per warehouse or as one total, and can include future availability (when more stock is expected).
Where PSRESTful uses it:
- The INV button in the Data Explorer, on every plan.
- Stock Check (Standard), for one product across suppliers.
- PromoSync stock updates (PromoSync stock not updating).
- Best Sellers and Sales Surge (Business), which estimate sales from changes in supplier stock.
Order services
All four need your own credentials from the supplier (add a supplier's credentials).
Purchase Order (PO)
Sends an order to the supplier electronically, sometimes called an ePO. It covers blank, sample and configured (decorated) orders, with line items, decoration details, shipping instructions and drop-ship addresses. If a supplier runs a staging environment, you can send test orders there before you go live.
Where PSRESTful uses it: the Procurement page (Business).
Order Status (ODRSTAT)
Where your order is, by purchase order or sales order number: received, on hold (credit, proof, art, backorder and others), in production, partly shipped, complete or canceled, with estimated ship dates.
Where PSRESTful uses it: the Orders page (Order Status, Business).
Order Shipment Notification (OSN)
What shipped and how: carrier, tracking numbers, ship dates and partial shipments. OSN is the shipment service; Order Status is a separate service with its own code.
Where PSRESTful uses it: the Shipments page (Shipment Tracking, Business).
Invoice (INVC)
The supplier's invoices for your orders, with line items, charges, taxes and payment terms.
Where PSRESTful uses it: the Invoices page (Business). Only suppliers that support the Invoice service are listed there.
Not available through PSRESTful
PromoStandards also defines Product Compliance (PDC), which returns compliance data for a product or part (in version 1.0.0, California Proposition 65). PSRESTful doesn't have endpoints for it today.
Not sure which services to connect first? Our rollout strategy for distributors suggests an order, for distributors with and without a website.
PSRESTful serves Product Data 1.0.0 and 2.0.0, Media Content 1.0.0 and 1.1.0, PPC 1.0.0, Inventory 1.2.1 and 2.0.0, Purchase Order 1.0.0, Order Status 1.0.0 and 2.0.0, OSN 1.0.0 and 2.0.0, and Invoice 1.0.0. Endpoints and parameters are at api.psrestful.com/docs, how-to guides for each service at docs.psrestful.com/guides, and field-by-field specifications at docs.psrestful.com/standards.