Onboarding Existing Products
If you have used the Products API to verify that a product you wish to sell already exists in the Zalando Catalog, you may associate your own product identifiers with the corresponding EAN for each product variant or option.
Associating your Product Identifiers with an EAN
For more information about product identifiers, see the Product Identifiers and Product Mapping section of our Products Onboarding Overview.
Authentication
The zDirect API requires OAuth 2.0 authentication for all API calls. Use the Authentication API to generate access tokens as described in the Authentication section.
Create a JSON Payload
Create a file named skus.json to define your simple ID, config ID, and model ID for a single EAN. Here is an example:
{
"merchant_product_simple_id": "white-shoes-1105AA",
"merchant_product_config_id": "white-shoes-110",
"merchant_product_model_id": "shoes-110"
}
We recommend to associate all three identifiers to create an explicit relationship between ids at all tiers. But you need to supply at least merchant_product_simple_id. Here is an example of a minimum required payload:
{
"merchant_product_simple_id": "white-shoes-1105AA"
}
Request
Use the zDirect Products API to submit your JSON to Zalando:
PUT /merchants/{merchant_id}/products/identifiers/{ean}
A typical httpie command for a product with the EAN 9780679762881 looks like this:
http PUT \
https://api-sandbox.merchants.zalando.com\
/merchants/$YOUR_MERCHANT_ID/products/identifiers/9780679762881" \
"Authorization:Bearer $YOUR_ACCESS_TOKEN" \
< skus.json
Response
If the request is successful, you will receive a status code 204 No Content as a response.
After receiving a positive reply, you may continue submitting stock and price updates for this EAN. Pending updates submitted prior to this association will be automatically released for evaluation. For more information, see Manage Prices and Manage Stock.
Warning
Once you have mapped your product IDs to an existing product, they will not be shown in your Product Status Report until you submit either their stock or their price.
If your JSON is not valid or the EAN does not exist, you will receive a status code 400 Bad Request as response with more details about the failure.
For example, if you omit the mandatory merchant_product_simple_id field in your request payload.
Sandbox Testing
The Products API supports sandbox mode. Data submitted by write operations in the sandbox environment are not persisted or propagated, but the automated validation applied on submission is the same as in the production environment.
For more information, see the Sandbox section of the Products API Overview in our API Reference.
Additional Resources
- Products API Reference: Information on scopes, rate limiting, and sandbox behavior, and an OpenAPI reference for the Products API.