Akeneo icon

Akeneo

Akeneo by pixelInfinito
Join our community

Actions4

Overview

This n8n node integrates with the Akeneo PIM (Product Information Management) system, specifically for managing Categories. It allows users to find all categories, retrieve a single category by code, or create new categories in Akeneo. This is useful for automating catalog management, synchronizing product hierarchies, or batch-creating category structures from other systems.

Practical examples:

  • Syncing categories from an ERP or e-commerce platform into Akeneo.
  • Automating the creation of new category trees when launching new product lines.
  • Fetching all categories for reporting or migration purposes.

Properties

Name Meaning
Operação Selects the operation to perform on Category. Options:
- Find All: Retrieve all categories.
- FindOne: Retrieve a single category by code.
- Create: Create a new category.
Name The unique code/identifier for the category. Required for create and find operations.
Parent The code of the parent category. Used when creating a subcategory.
Label de_DE The German label for the category. Used when creating a category.
Label en_US The English label for the category. Used when creating a category.
Label fr_FR The French label for the category. Used when creating a category.

Output

  • For Find All:
    • json.response: An array of all categories, each with their properties as returned by Akeneo's API.
  • For FindOne:
    • json.response: The details of the requested category (code, parent, labels, etc.).
  • For Create:
    • json.response: The response from Akeneo after attempting to create the category (typically includes the created category's data or status).
  • If an error occurs, you may also see:
    • json.message: Error message from Akeneo.

Note: No binary output is produced by this resource/operation.

Dependencies

  • Akeneo API: Requires access to an Akeneo instance with REST API enabled.
  • API Credentials: You must configure Akeneo API credentials in n8n (base URL, authentication).
  • n8n Configuration: The node expects valid credentials set up under the name akeneoApi.

Troubleshooting

  • Common Issues:
    • Invalid credentials: Ensure your Akeneo API credentials are correct and have sufficient permissions.
    • Missing required fields: When creating a category, ensure "Name" (code) and at least one label are provided.
    • Parent not found: If specifying a parent, make sure it exists in Akeneo.
  • Error Messages:
    • json.message may contain errors like "Category not found", "Code already exists", or validation errors from Akeneo. Review the message for specifics.
    • Network or authentication errors will also be reported in json.message.

Links and References

Discussion