PromoStandards services
Mareco publishes its curated catalog the same way its own supplier does: as PromoStandards SOAP services. Any distributor platform, ERP connector or agent that already speaks the standard can read products, media, pricing with decoration, live inventory, send purchase orders, and follow status and shipments, with no new integration.
Credentials
Every request carries id and password. Use your account email as the id and a Mareco API key as the password: create one under Account → API. Catalog services need the read scope, status and shipments the orders scope, purchase orders write and orders.
Product ids are Mareco catalog ids (for example S700), part ids as published. Prices are Mareco's retail prices in USD whatever priceType is sent. Inventory is fetched from the manufacturer on every call. A purchase order becomes a Mareco order: on net terms it goes straight to the order desk; otherwise it waits for payment at the link in the response. Machine-readable directory: /ps/directory.json.
| Service | Version | Endpoint | Operations |
|---|---|---|---|
| Product Data | 2.0.0 | https://mareco.com/ps/ProductDataWSDL | getProduct, getProductSellable, getProductDateModified, getProductCloseOut |
| Media Content | 1.1.0 | https://mareco.com/ps/MediaContentWSDL | getMediaContent, getMediaDateModified |
| Pricing and Configuration | 1.0.0 | https://mareco.com/ps/PricingAndConfigurationWSDL | getAvailableLocations, getDecorationColors, getFobPoints, getAvailableCharges, getConfigurationAndPricing |
| Inventory | 2.0.0 | https://mareco.com/ps/InventoryWSDL | getInventoryLevels, getFilterValues |
| Purchase Order | 1.0.0 | https://mareco.com/ps/PurchaseOrderWSDL | sendPO, getSupportedOrderTypes |
| Order Status | 2.0.0 | https://mareco.com/ps/OrderStatusWSDL | getOrderStatus, getServiceMethods, getIssue |
| Order Shipment Notification | 1.0.0 | https://mareco.com/ps/OrderShipmentNotificationWSDL | getOrderShipmentNotification |
Example
curl -X POST https://mareco.com/ps/ProductData -H "Content-Type: text/xml" -H 'SOAPAction: "getProduct"' -d '
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.promostandards.org/WSDL/ProductDataService/2.0.0/" xmlns:shar="http://www.promostandards.org/WSDL/ProductDataService/2.0.0/SharedObjects/">
<soapenv:Body><ns:GetProductRequest>
<shar:wsVersion>2.0.0</shar:wsVersion><shar:id>you@company.com</shar:id><shar:password>mk_...</shar:password>
<shar:localizationCountry>US</shar:localizationCountry><shar:localizationLanguage>en</shar:localizationLanguage>
<shar:productId>S700</shar:productId>
</ns:GetProductRequest></soapenv:Body>
</soapenv:Envelope>'
Prefer JSON? The same catalog is on the REST API and MCP server.