If you have some additional data you want to send to Magento but you don’t want to create an extra Magento attribute for it, you can use the reserved “akeneo_meta” attribute for this. In this meta attribute you can send multiple product values for different Akeneo attributes.

By default this attribute is empty. You can configure the attributes for which you want to send the values by a commma seperated attribute code list.

Response formats by attribute type

The meta attribute will be created as a textarea field in your Magento project. The content will be provided a json text. Below you find an example of how this data will be send for each attribute type. We always start with the attribute code. For each attribute value (if the attribute supports multiple values) you’ll always find the value index. If the attribute is localizable you’ll find a locale index as well.

Select and multiselect attribute value

This format below will be used for select attributes:

{
   "exterior_narrowing":[
      {
         "value":{
            "code":"NAR001",
            "attribute":"exterior_narrowing",
            "sort_order":0,
            "labels":{
               "en_US":"Narrowing by touch and close fastening",
               "nl_BE":"Vernauwing d.m.v. klittenbandsluiting",
               "fr_BE":"R\u00e9tr\u00e9cissement au moyen d'une fermeture velcro",
               "en_GB":"Narrowing by touch and close fastening",
               "nl_NL":"Vernauwing d.m.v. klittenbandsluiting",
               "fr_FR":"R\u00e9tr\u00e9cissement au moyen d'une fermeture velcro",
               "de_DE":"Verengung mittels Klettbandpatte",
               "es_ES":"Estrechamiento mediante cierre de velcro"
            }
         }
      },...
   ]
}

Exterior_narrowing is the attribute. The selected attribute option code is NAR001 with it’s labels and sort order data.

File attribute value

If one of the configured attribute is a file attribute, the data will be available in the following format:

{
   "commercial_manual":[
      {
         "value":{
            "code":"php5oaCVI",
            "original_filename":"ORACDECOR-TA-AkeneoPimgentoupgrade-140222-0840-746.pdf",
            "mime_type":"application\/pdf",
            "size":422031,
            "extension":"pdf",
            "_links":{
               "download":{
                  "href":"http:\/\/localhost\/api\/rest\/v1\/media-files\/php5oaCVI\/download"
               }
            }
         }
      }
   ],...
}

Boolean attribute value

Boolean values will be formatted to 0 & 1 values.

{
   "description":[
     {
        "locale":"en_US",
        "value":"Test Baleneo EN"
     },
     {
        "locale":"fr_BE",
        "value":"description fr"
     }
   ]
}

Text field attribute value

{
   "killswitch":[
     {
        "value":0
     }
   ]
}

Price field attribute value

{
   "price":[
     {
        "value":[
           {
              "amount":"49.00",
              "currency":"EUR"
           }
        ]
     }
  ]
}

Configured association codes

Association data will be send in the following format:

{
   "associations":[
     "SUBSTITUTION-products":"sku_1,sku_2,sku_3",
     "SUBSTITUTION-product_models":"sku_model_1,sku_model_2,sku_model_3",
     "XSELL-products":"sku_1",
     "XSELL-product_models":"",
    ]
}

SUBSTITUTION and XSELL are the association type codes. If we have an association with amounts the data looks like this:

{
   "associations":[
     "SUBSTITUTION-products":"sku_1:3,sku_2:1,sku_3:8"
    ]
}

After the sku we find the amount value.

EE only - Assets

Comma separated list of asset codes.

{
   "packshots":[
      {
         "value":"578B_A96___SIL, 578B_A96___FR"
      }
   ]
}

EE only - Reference entity values

Reference entity records will be send will all their attributes:

{
   "care_instructions":[
      {
         "value":{
            "code":"241350628244491",
            "values":{
               "label":[
                  {
                     "locale":"pt_PT",
                     "channel":null,
                     "data":"Lavar a ou abaixo de 40\u00b0C (em lavagem sem vincos)"
                  },
                  {
                     "locale":"nl_NL",
                     "channel":null,
                     "data":"Wassen bij of onder 40\u00b0C (mechanische actie)"
                  },
                  {
                     "locale":"nl_BE",
                     "channel":null,
                     "data":"Wassen bij of onder 40\u00b0C (mechanische actie)"
                  },
                  {
                     "locale":"fr_FR",
                     "channel":null,
                     "data":"Lavage \u00e0 40\u00b0C ou moins (pressage permanent)"
                  },
                  {
                     "locale":"fr_BE",
                     "channel":null,
                     "data":"Lavage \u00e0 40\u00b0C ou moins (pressage permanent)"
                  },
                  {
                     "locale":"fi_FI",
                     "channel":null,
                     "data":"Pesu 40\u00b0C tai pienemm\u00e4ss\u00e4 l\u00e4mp\u00f6tilassa (kestopr\u00e4ss\u00e4ys)"
                  },
                  {
                     "locale":"es_ES",
                     "channel":null,
                     "data":"Lavar a menos de 40\u00b0C (resistente a arrugas)"
                  },
                  {
                     "locale":"en_US",
                     "channel":null,
                     "data":"Wash at or below 40\u00b0C (permanent press)"
                  },
                  {
                     "locale":"en_GB",
                     "channel":null,
                     "data":"Wash at or below 40\u00b0C (permanent press)"
                  },
                  {
                     "locale":"de_DE",
                     "channel":null,
                     "data":"Waschen bei oder unter 40\u00b0C (pflegeleichter Stoff)"
                  }
               ],
               "image":[
                  {
                     "locale":null,
                     "channel":null,
                     "data":"phpIYVX34"
                  }
               ],
               "seq":[
                  {
                     "locale":null,
                     "channel":null,
                     "data":"10050"
                  }
               ],
               "sf_legacy_label":[
                  {
                     "locale":null,
                     "channel":null,
                     "data":"wash40c"
                  }
               ],
               "sf_legacy_pictogram":[
                  {
                     "locale":null,
                     "channel":null,
                     "data":"https:\/\/apparel.sioen.com\/products\/Care\/wash_40c.png"
                  }
               ]
            }
         }
      },...
   ]
}