NordStrom 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)

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

{
    "hierarchies": [
        {
            "code": "accessories",
            "label": "Accessories",
            "label_translations": [
                {
                    "locale": "en",
                    "value": "Accessories"
                },
                {
                    "locale": "en_GB",
                    "value": "Accessories"
                }
            ],
            "level": 1,
            "parent_code": ""
        },
        {
            "code": "accesbags",
            "label": "Bags",
            "label_translations": [
                {
                    "locale": "en",
                    "value": "Bags"
                },
                {
                    "locale": "en_GB",
                    "value": "Bags"
                }
            ],
            "level": 2,
            "parent_code": "accessories"
        },
        {
            "code": "bagsbackpacks",
            "label": "Backpacks",
            "label_translations": [
                {
                    "locale": "en",
                    "value": "Backpacks"
                },
                {
                    "locale": "en_GB",
                    "value": "Backpacks"
                }
            ],
            "level": 3,
            "parent_code": "accesbags"
        }
    ]
}

Response file :

H11.json

• GET PM11 - Get the product attribute configuration

Via this call, we are able to obtain the attributes for the categories. The link between categories and attributes is the code = hierarchy_code

API Call: /api/products/attributes

API Docs: https://help.mirakl.net/help/api-doc/seller/mmp.html#PM11

{
  "attributes" : [ {
    "code" : "category",
    "default_value" : null,
    "description" : "Category",
    "description_translations" : [ {
      "locale" : "en",
      "value" : "Category"
    } ],
    "example" : null,
    "hierarchy_code" : "",
    "label" : "Category",
    "label_translations" : [ {
      "locale" : "en",
      "value" : "Category"
    } ],
    "required" : true,
    "requirement_level" : "REQUIRED",
    "roles" : [ {
      "parameters" : [ ],
      "type" : "CATEGORY"
    } ],
    "type" : "TEXT",
    "type_parameter" : null,
    "type_parameters" : null,
    "values" : null,
    "values_list" : null,
    "variant" : false
  }, {
    "code" : "shop_sku",
    "default_value" : null,
    "description" : "Shop SKU",
    "description_translations" : [ {
      "locale" : "en",
      "value" : "Shop SKU"
    } ],
    "example" : null,
    "hierarchy_code" : "",
    "label" : "Shop SKU",
    "label_translations" : [ {
      "locale" : "en",
      "value" : "Shop SKU"
    } ],
    "required" : true,
    "requirement_level" : "REQUIRED",
    "roles" : [ {
      "parameters" : [ ],
      "type" : "SHOP_SKU"
    } ],
    "type" : "TEXT",
    "type_parameter" : null,
    "type_parameters" : null,
    "values" : null,
    "values_list" : null,
    "variant" : false
   } ]
  }

Response file :

PM11.json

• GET VL11 - Get information about operator's value lists

With this API call, we get all available values for each attribute. The link between attributes and values is type_parameter = code

API Call: /api/values_lists

API Docs: https://help.mirakl.net/help/api-doc/seller/mmp.html#VL11

{
"values_lists" : [ {
  "code" : "Activity",
  "label" : "Activity",
  "label_translations" : [ {
    "locale" : "en",
    "value" : "Activity"
  }, {
    "locale" : "en_GB",
    "value" : "Activity"
  } ],
  "values" : [ {
    "code" : "gym_training",
    "label" : "Gym & Training",
    "label_translations" : [ {
      "locale" : "en",
      "value" : "Gym & Training"
    }, {
      "locale" : "en_GB",
      "value" : "Gym & Training"
    } ]
  }, {
    "code" : "lifestyle",
    "label" : "Lifestyle",
    "label_translations" : [ {
      "locale" : "en",
      "value" : "Lifestyle"
    }, {
      "locale" : "en_GB",
      "value" : "Lifestyle"
    } ]
  }, {
    "code" : "yoga",
    "label" : "Yoga",
    "label_translations" : [ {
      "locale" : "en",
      "value" : "Yoga"
    }, {
      "locale" : "en_GB",
      "value" : "Yoga"
    } ]
  } ]
} ]
}

Response file :

VL11.json

Taxonomy export file

In order to generate the taxonomy file we will need to create a new record in Taxonomy export with: Marketplace = BestBuy 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 .