Inno Taxonomy

Summary of Changes: (The purpose of this table is to keep traceability and Product team to highlight the things that were changed into the scope, based on comments or discussions)

Version	Date	Created / Updated	Notes
1.0	08/12/2022	Hristiyan Georgiev	First publish

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.

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 or Variation Specifics according to their taxonomy which we download and store on the instance.

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://galeriainnobe2-dev.mirakl.net/help/api-doc/seller/mmp.html#H11

{
"hierarchies":[
{
"code": "homeAndLeisure",
"label": "Home And Leisure",
"label_translations":[{"locale": "en", "value": "Home And Leisure" }, {"locale": "fr",…],
"level": 1,
"parent_code": ""
},
{
"code": "homeAndLeisure-bathing",
"label": "Bathing",
"label_translations":[{"locale": "en", "value": "Bathing" }, {"locale": "fr",…],
"level": 2,
"parent_code": "homeAndLeisure"
}]
}

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://galeriainnobe2-dev.mirakl.net/help/api-doc/seller/mmp.html#PM11

attributes.json

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://galeriainnobe2-dev.mirakl.net/help/api-doc/seller/mmp.html#VL11

values_.json

Taxonomy export file

In order to generate the taxonomy file we will need to create a new record in Taxonomy export with: Marketplace = Inno Status = pending Category for Export = all (or we can specify which exact categories) Email = email to which the file will be send

Please find ore details on the file structure how it should look like after exported here - Taxonomy General requirements .

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

Marketplaces / Inno Technical Scope [DRAFT] / Inno Taxonomy

Inno Taxonomy

Taxonomy export file