Prices API Overview
Use the Prices API to set prices per sales channel for up to 1,000 unique EANs for a single Merchant ID in the Zalando Catalog. You may optionally set a promotional price to indicate the product is available at a reduced price.
To get the price of a product, use the Product Status Report in zDirect UI. The Prices API is write-only.
Prices API Scopes
Updating prices with the Prices API requires the Products/price/write scope.
Many zDirect APIs require clients to have specific permissions or scopes for read or write access. You may assign scopes to your apps in the "Applications" section of the zDirect Portal.
For more information on configuring app scopes, see the Applications section of our zDirect Portal guide.
Rate Limiting
There is a limit of POST requests you can send per minute AND number of price updates you can submit per minute:
| Environment | Requests / minute | Price updates / minute |
|---|---|---|
| Production | 30 | 8000 |
| Sandbox | 20 | 8000 |
For example, a client can send 30 requests with a batch of 266 price updates each within a minute. Or it can send 8 requests with a batch of 1000 price updates in the beginning of the minute, and then it would have to wait until the next minute starts.
For more information, see Rate Limiting.
Sandbox Behavior
Price updates made in the sandbox environment are validated upon submission against the same restrictions and pre-validation rules used in production, but submitted data is not necessarily propagated to be validated by the Price Validation Service. Price requests submitted in this environment can be seen in the Price Reporting API in sandbox but validation results will not necessarily be propagated nor become available later on.
For sandbox testing, use the response codes to verify that you are constructing your price updates correctly. You will receive the same response codes in the sandbox environment as in production. Once a price update is made in the sandbox environment, the new price information is not visible, and will not be available in your Product Status Report.
For more information, see Sandbox Testing in our Getting Started Guide.
Additional Resources
- For instructions on using the Prices API to update prices, see Manage Prices in our Developer Guide.
- For the Prices API OpenAPI reference, see Merchant Price Service API.