Supplier credentials are the username (or ID) and password a supplier gives you for its PromoStandards web services. You save them once on the Supplier Credentials page, and from then on PSRESTful uses them for every call your account makes to that supplier.
Do you need your own?
Each supplier issues its own PromoStandards login. Some reuse your website login, others give you a separate one, so ask the supplier if you're not sure which they mean.
You can start without any. For many suppliers we already hold a shared login (our agent credentials) for product data, images, net and list prices, and stock. You need your own for anything tied to your account with the supplier, like your negotiated pricing, orders and invoices. A few suppliers, SanMar among them, also want yours for pricing and stock. Agent credentials vs your own explains the split.
Don't have a login yet? Pick the supplier in the steps below anyway. If we can email that supplier for you, the window offers a Send credential request button once your contact name, email and an industry identifier are saved under Org Info. Otherwise it links to the supplier's entry in the PromoStandards directory.
Add a supplier's credentials
The Credentials link is in the user menu for account admins. If you don't see it, ask your admin.
- Open Credentials from your user menu, or go to /dashboard/configure-credentials/.
- Click One Credential.
- Pick the supplier in the Supplier list.
- Under Production Environment, enter the Username/ID and Password the supplier gave you.
- Click Submit.
A Staging Environment card only appears for suppliers that run a test server. Leave it empty unless you're testing purchase orders: everything else runs on Production, and PromoSync only reads Production.
The Supplier list only shows suppliers you haven't added yet. To change a saved login, delete the row with the trash icon and add it again.
Adding many suppliers at once? Import CSV takes a file, and the window lists the columns it expects. Download All exports your saved logins in the same layout.
Please don't email passwords to us. The page stores them encrypted, and it's faster than waiting for us to enter them.
Check that they work
- Find the supplier in the table.
- Click the play button (Test credentials) in the Actions column.
- Read the result under the row.
- Hover over any red service to see the supplier's message.
The test calls each service the supplier supports: Product Data, Media Content, Price & Config, Inventory, Order Status, Shipment Notification and Invoice. It runs in Production, and in Staging too when you saved a Staging login for a supplier that has a test server. It never places an order. A green check means the supplier accepted your login for that service. An answer like "no records found" also counts as a pass, because the supplier had to accept the login to give it.
If you see Cannot test credentials, your account has no active private API key. Create one on /dashboard/api-keys/ and run the test again (see API keys).
Credential statuses explains every badge and result. For red results, see Fix 401 and 403 errors.
When one service needs a different login
Some suppliers run different PromoStandards services through different vendors, so one service can need its own login. Click Show Services on the supplier's row, then Add Service Credential, and pick the service and environment. That login replaces the main one for that service only.
You can also read and save credentials through the API (/extra/v2/credentials), which is how sub-accounts are usually managed. See the Credentials API docs.