PromoStandards is the promotional products industry's shared set of web services. A supplier that implements it lets distributors pull its product details, images, prices, stock levels and order information electronically, in the same basic format every other implementing supplier follows.
What it covers
PromoStandards is split into services, one for each kind of data:
- Product Data describes what the supplier sells, with colors, sizes and imprint areas.
- Media Content has the product images and other files.
- Product Pricing and Configuration (PPC) has prices and decoration options.
- Inventory has stock levels.
- Purchase Order sends an order to the supplier.
- Order Status tells you where an order is.
- Order Shipment Notification (OSN) tells you what shipped, with tracking numbers.
- Invoice has the supplier's invoices for your orders.
PromoStandards services, explained one by one goes through each of them.
Why suppliers implement it
A supplier publishes each service once, and every distributor it gives access to can use it. Suppliers that implement it well are easier to do business with and easier for distributors to automate against, which matters most to distributors who order in volume.
Why it's hard to use directly
PromoStandards settles what the questions and answers look like. Using them directly still takes a lot of work:
- It's SOAP and XML. Every request is an XML envelope built from the service's WSDL (its machine-readable description), and every answer is XML to parse. Most web and mobile tools today expect JSON.
- Each supplier implements it a little differently. A field one supplier always fills is empty at another, some suppliers skip methods the standard defines, and the documentation leaves room to read it more than one way.
- Every supplier has its own endpoints and versions. Each service lives at a different address for each supplier, and suppliers run different versions of the same service, sometimes more than one.
- IDs don't always line up. The same product variant can have different part IDs in a supplier's media, stock and pricing services.
- You need access from each supplier. Your own pricing and anything about your orders needs credentials that the supplier issues to your company, requested one supplier at a time.
Connecting directly means writing a separate integration for each supplier and keeping all of them working over time.
How PSRESTful fits
PSRESTful builds on PromoStandards rather than replacing it. The data still comes from each supplier's own PromoStandards services; PSRESTful calls them for you and returns the answers as JSON, in one format across suppliers.
For suppliers marked Credentials Available on the Integrated Suppliers page, our shared credentials cover public catalog data, so you can see products, images, net and list prices and stock without a login of your own. Your own pricing, orders, shipments and invoices still need your own credentials (agent credentials vs your own).
More on the product itself: What PSRESTful is. If you sell on Shopify, PromoSync brings the same supplier data into your store (Install PromoSync). For industry terms like FOB point, part ID or LTM, see the glossary.
Readable versions of the official specifications, for each service and version, are at docs.psrestful.com/standards. The service codes PromoStandards uses (Product, MED, PPC, INV, PO, ODRSTAT, OSN, INVC) are listed at docs.psrestful.com/standards/service-codes.