Alkemics

Presentation

This section describes the attributes and code values used at Alkemics (Alkemics data model) to describe any kind of product on our platform. You will find all information you need to import product information from Alkemics or to format your products as you export them into Alkemics.
Submitting your product data to Alkemics in the right format is an important first step to successfully share your products with the retailers you work with.

1. Product categories

Alkemics uses our product classification to help us intelligently understand and structure information about the products on our platform. Our product taxonomy is based on analyzing the specific makeup and nature of your products. We use attributes and code values to dynamically adapt to the different product categories, to ensure that we only propose relevant values. Your product category defines a specific set of relevant attributes and code values.

Alkemics' product classification can be browsed in Attributes documentation.

2. Attribute type

Alkemics supports following attribute types

Simple attributes

  • boolean: true/false/null
  • float: stored on 64 bits. When necessary we differentiate between positive float and negative floats
  • integer: stored on 64 bits (max int: 9223372036854775807). When necessary we differentiate between positive integer and negative integers
  • string: does not accept line breaks. Max number of characters is: 3000. Encoded in UTF-8.
  • text: accept line breaks. Max number of characters is: 20000. Encoded in UTF-8.
  • timestamp : https://en.wikipedia.org/wiki/Unix_time

Complex attributes

  • Array : List of attributes. Nested attributes can be simple or complex attributes.
[
  {
    "text": [
      {
        "expressedIn": {
          "normalizedCode": "af", 
          "code": "afr", 
          "label": "afrikaans"
        }, 
        "data": "Avertissement example"
      }
    ]
  }
]
  • Code list: attributes with a predefined set of possible values.
    The code list attributes are documented in the Attributes documentation. We recommend that you integrate the code in your system and not the label, as labels might evolve and change.
{
  "code": "g", 
  "label": "gram"
}
  • Declinable
    Couple composed of simple attributes (float, integer, string or text) and an expressing unit such as language and unit of measurement.
[
  {
    "expressedIn": {
      "code": "g", 
      "label": "gram"
    }, 
    "data": 100
  }, 
  {
    "expressedIn": {
      "code": "oz", 
      "label": "ounce"
    }, 
    "data": 3.5274
  }
]
  • Dict : Set of attributes. Nested attributes can be simple or complex.
{
  "nutrientCode": {
    "code": "ALPHA_LINOLEIC_ACID", 
    "label": "acide alpha-linolénique"
  }, 
  "quantityMeasurementPrecision": {
    "code": "~", 
    "label": "approximativement"
  }, 
  "percentageOfDailyValueIntake": 70.2, 
  "percentageDVIMeasurementPrecision": {
    "code": "~", 
    "label": "approximativement"
  }, 
  "quantity": [
    {
      "expressedIn": {
        "code": "g", 
        "label": "gramme"
      }, 
      "data": 65.7
    }
  ]
}
  • Targeted product: Refers to a product entity on Alkemics (link between products for promotion, replacement, cross-sell). Targeted product are identified with their GTIN and name.
"targetProduct": {
      "gtin": "03264420101830", 
      "label": "03264420101830 - Targeted Product Name"
    }