Decathlon - Taxonomy

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.

In order to download the taxonomy we need to:

• GET H11 - List Catalog categories

API Call: /api/hierarchies

Docs: https://decathlonbelgium-preprod.mirakl.net/help/api-doc/seller/mmp.html#H11

Example Response:

{
  "hierarchies": [
    {
      "code": "5911111",
      "label": "Suncare",
      "label_translations": [
        {
          "locale": "en",
          "value": "Suncare"
        },
        {
          "locale": "fr",
          "value": "Protection solaire"
        }
      ],
      "level": 2,
      "parent_code": "59"
    },
    {
      "code": "5911112",
      "label": "Toiletries",
      "label_translations": [
        {
          "locale": "en",
          "value": "Toiletries"
        },
        {
          "locale": "fr",
          "value": "Articles de toilette"
        }
      ],
      "level": 2,
      "parent_code": "59"
    },
    {
      "code": "5911113",
      "label": "Womens Hair Removal",
      "label_translations": [
        {
          "locale": "en",
          "value": "Womens Hair Removal"
        },
        {
          "locale": "fr",
          "value": "Épilation Femmes"
        }
      ],
      "level": 2,
      "parent_code": "59"
    }
  ]
}

Into the response, we have all the available categories.

• GET PM11 - Get the product attribute configuration

API Call: /api/products/attributes

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

Example Response:

{
  "attributes": [
    {
      "channels": [
        {
          "code": "WEBSITE_EN"
        }
      ],
      "code": "washingInstructions3",
      "default_value": null,
      "description": "How do you wash the product",
      "description_translations": [
        {
          "locale": "en",
          "value": "How do you wash the product"
        }
      ],
      "example": null,
      "hierarchy_code": "3012",
      "label": "Washing Instructions",
      "label_translations": [
        {
          "locale": "en",
          "value": "Washing Instructions"
        }
      ],
      "requirement_level": "OPTIONAL",
      "roles": [],
      "transformations": "CAMEL_CASE",
      "type": "TEXT",
      "type_parameter": null,
      "validations": "MIN_LENGTH|10",
      "variant": false
    },
    {
      "channels": [
        {
          "code": "WEBSITE_FR"
        },
        {
          "code": "WEBSITE_EN"
        }
      ],
      "code": "toolsIncluded3",
      "default_value": null,
      "description": "Are tools included for the assembly of this product",
      "description_translations": [
        {
          "locale": "en",
          "value": "Are tools included for the assembly of this product"
        }
      ],
      "example": null,
      "hierarchy_code": "5610102",
      "label": "Tools Included",
      "label_translations": [
        {
          "locale": "en",
          "value": "Tools Included"
        }
      ],
      "requirement_level": "OPTIONAL",
      "roles": [],
      "type": "LIST",
      "type_parameter": "Boolean",
      "variant": false
    }
  ]
}

Into the response, we have all the available attributes for each category.

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

API Call: /api/values_lists

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

Example Response:

{
  "values_lists": [
    {
      "code": "Jewellery",
      "label": "Bijoux",
      "label_translations": [
        {
          "locale": "en",
          "value": "Jewellery"
        },
        {
          "locale": "fr",
          "value": "Bijoux"
        }
      ],
      "values": [
        {
          "code": "Accessories",
          "label": "Accessoires",
          "label_translations": [
            {
              "locale": "en",
              "value": "Accessories"
            },
            {
              "locale": "fr",
              "value": "Accessoires"
            }
          ]
        },
        {
          "code": "Bracelets",
          "label": "Bracelets",
          "label_translations": [
            {
              "locale": "en",
              "value": "Bracelets"
            },
            {
              "locale": "fr",
              "value": "Bracelets"
            }
          ]
        },
        {
          "code": "Necklaces",
          "label": "Colliers",
          "label_translations": [
            {
              "locale": "en",
              "value": "Necklaces"
            },
            {
              "locale": "fr",
              "value": "Colliers"
            }
          ]
        },
        {
          "code": "Rings",
          "label": "Anneaux",
          "label_translations": [
            {
              "locale": "en",
              "value": "Rings"
            },
            {
              "locale": "fr",
              "value": "Anneaux"
            }
          ]
        }
      ]
    }
  ]
}

With this API call, we get all available values for each attribute.

Note: Once we save the taxonomy, if we would like to update it, we need to delete the old taxonomy and simply to follow the steps above again, in order to get the new one.