Skip to main content

​
Fetching Categories from Akeneo

  • In Alumio, go to “Integrations → Incoming → Akeneo - Fetch - Categories”.
  • To get all categories from the Akeneo system, use an Incoming “Akeneo - Fetch - Categories”.
Image
This incoming creates a task inside Alumio with data structured as Alumio base categories. There are transformers inside this Incoming before processing the category.
  1. Akeneo - Prepare convert category - Labels - To localizations.
  2. Akeneo - Convert - Category - To Alumio Base.
  3. Akeneo - Filter - Category.
Akeneo - Prepare convert category - Labels - To localizations This transformer converts label data from Akeneo. 
{
  "labels": {
    "de_DE": "E-commerce",
    "en_GB": "E-commerce",
    "en_US": "E-commerce",
    "es_ES": "E-commerce",
    "fr_FR": "E-commerce",
    "it_IT": "E-commerce",
    "nl_NL": "E-commerce",
    "pt_PT": "E-commerce"
  }
}
Since the current data structure is incompatible with Centra, the transformer “Akeneo - Convert - Category - To Alumio Base” is used to convert it into a compatible format. 
{
  "localizations": [
    {
      "localeCode": "de_DE",
      "translation": "E-commerce"
    },
    {
      "localeCode": "en_GB",
      "translation": "E-commerce"
    },
    {
      "localeCode": "en_US",
      "translation": "E-commerce"
    },
    ....
  ]
}
Akeneo - Convert - Category - To Alumio Base. This is the transformer that converts the entire category data into Alumio Base data. 
{
  "code": "master",
  "parent": null,
  "localizations": [
    {
      "localeCode": "de_DE",
      "translation": "E-commerce"
    },
    {
      "localeCode": "en_GB",
      "translation": "E-commerce"
    },
    {
      "localeCode": "en_US",
      "translation": "E-commerce"
    },
    {
      "localeCode": "es_ES",
      "translation": "E-commerce"
    },
    ...
  ]
}
Akeneo - Filter - Category
  • Use this transformer to filter previously created tasks into task categories to avoid duplication.
Image
  • To recreate a task, you should remove the entity from the storage “Akeneo - Filter - Categories”.

​
Sending Categories to Centra

The task that was created through Incoming “Akeneo - Fetch - Categories” will then be processed further by the Route “Synchronize Categories - From Akeneo into Centra” and will be sent using this Outgoing. This Outgoing will transform the Alumio Base Categories into Centra one and check to create or to update the category with the data from this outgoing’s previous iteration. The sending in the Outgoing will be processed by the transformer:
  1. Centra - Add global variables.
  2. Centra - Prepare send - Category - Parent ID from Alumio Base Category.
  3. Centra - Prepare send - Category - Before from Alumio Base Category.
  4. Centra - Check and send - Category.
Centra - Add global variables
Adding all the data that you want to add to Centra. Centra - Prepare send - Category - Parent ID from Alumio Base Category
This transformer will check the parent and map it into Centra ID. Centra - Prepare send - Category - from Alumio Base Category
This transformer will finally convert the Category from Alumio Base into Centra. Centra - Check and send - Category This transformer checks the current Centra ID from the previous iteration of this transformer to determine whether we need to create or update the category in the Centra System. An example of a creation payload: 
{
  "query": "mutation createNewCategory($input: CategoryCreateInput!)",
  "variables": {
    "input": {
      "uri": "Microwave_Parts",
      "name": "Microwave Parts",
      "store": {
        "id": 1
      },
      "status": "ACTIVE",
      "parentCategory": {
        "id": 324
      },
      "beforeCategory": {
        "id": 350
      }
    }
  }
}

​
Automatic Categories Synchronization Setup

  • Go to “Integrations → Schedulers → Akeneo - Fetch Categories”.
    Image
  • Set a schedule expression and enable the configuration.
  • Go to “Integrations → Schedulers → Centra - Send - Categories”.
    Image
  • Set a schedule expression and enable the configuration.