Download Taxonomy
The purpose of this page is to give detailed explanations of how we will download the taxonomy for MIRAKL.
The taxonomy must be stored in classes, which should be available for exports from the UI in Export Taxonomy table. The taxonomy is used for internal validation and we will need to map the values and push the codes to MIRAKL.
Note: Every time we send products for creation we have to do internal check if all required attributes are part of the the product as Item Specifics according to their taxonomy which we download and store on the instance. Please note that for the ASOS we will have only 5 categories that we will use! Also, there are no required attributes and values
To download the taxonomy, we should follow the steps:
- GET H11 - List Catalog categories
Using this call, we are able to get all available categories for MIRAKL.
API Call:/api/hierarchies
API Docs: https://asosuk-dev.mirakl.net/help/api-doc/seller/mmp.html#H11
Example response:TBA
- GET PM11 - Get the product attribute configuration
Via this call, we are able to obtain the attributes for the categories.
API Call: /api/products/attributes
API Docs: https://asosuk-dev.mirakl.net/help/api-doc/seller/mmp.html#PM11
Example response:TBA
- GET VL11 - Get information about operator's value lists
With this API call, we get all available values for each attribute.
API Call: /api/values_lists
API Docs: https://asosuk-dev.mirakl.net/help/api-doc/seller/mmp.html#VL11
Example response:TBA
Taxonomy export file
In order to generate the taxonomy file we will need to create a new record in Taxonomy export with: Marketplace = B&Q Status = pending Category for Export = all (or we can specify which exact categories) Email = email to which the file will be send
Please find example file structure how it should look like after exported. We store for each category separate file.
| Column | Column | Column | Column | Column | Column | Column | Column | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| PrimaryCatID | PrimaryCatName | Category Path | Is Leaf | Item Specifics | Required | Enumeration | Values | ||||
| 123 | Shoes | Yes | Color | Yes | No | ||||||
| 123 | Shoes | Yes | Size | Yes | No | ||||||
| 123 | Shoes | Yes | Material | No | Yes | Red | White | Black | |||
| 123 | Shoes | Yes | Type | No | Yes | 40 | 41 | 42 | 43 | 44 | |
| 1234 | Gloves | Yes | Color | Yes | No | ||||||
| 1234 | Gloves | Yes | Size | Yes | No |
Add label