PromoStandards services, explained one by one

What each PromoStandards service gives you, from Product Data to Invoice, which ones need your own credentials, and which PSRESTful tools use it.

Product
PSRESTful, PromoSync
Plan
Every plan
Updated
November 2026

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:

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:

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:

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.

Tip

Not sure which services to connect first? Our rollout strategy for distributors suggests an order, for distributors with and without a website.

For developers

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.

Did this answer your question?

Tell us in your own words, or paste the error. It goes to our team with this article attached.