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 some 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 BigCommerce, 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 transformer 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 BigCommerce

The task that was created through Incoming “Akeneo - Fetch - Categories” will then be processed further by the Route “Synchronize Categories - From Akeneo into BigCommerce” and will be sent using this Outgoing. This Outgoing will transform the Alumio Base Categories into BigCommerce ones and check to create or to update the category with the data from this Outgoing’s previous iteration. Sending the Outgoing will be processed by the following transformers:
  1. BigCommerce - Prepare convert - Category - Parent id from Alumio Base Category.
  2. BigCommerce - Convert - Category - from Alumio Base Category.
  3. BigCommerce - Check and send - Category.
BigCommerce - Prepare convert - Category - Parent id from Alumio Base Category This transformer checks the parent and maps it into the BigCommerce ID. BigCommerce - Convert - Category - from Alumio Base Category This transformer converts the Category from Alumio Base into BigCommerce. BigCommerce - Check and send - Category This transformer checks the current BigCommerce id from the previous iteration of this transformer to determine whether we need to create or update the category in the BigCommerce System. 
[
  {
    "parent_id": 856,
    "name": "AntiVirus",
    "description": "AntiVirus",
    "is_visible": true,
    "default_product_sort": "use_store_setting"
  }
]

​
Automatic Categories Synchronization Setup

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