Akeneo icon

Akeneo

Akeneo by pixelInfinito

Actions4

Category

AI-generated

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