Akeneo

Akeneo by pixelInfinito

Actions3

Product Actions

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 its 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 your e-commerce platform's category tree with Akeneo.
Creating new categories in bulk based on external data sources.
Fetching all categories for reporting or migration purposes.

Properties

Name	Type	Meaning
Operação	options	Selects the operation to perform: Find All, FindOne, or Create.
Name	string	The unique code of the category (used as identifier for find and create operations).
Parent	string	The code of the parent category (used when creating a subcategory).
Label de_DE	string	The German label for the category (used when creating a category).
Label en_US	string	The English label for the category (used when creating a category).
Label fr_FR	string	The French label for the category (used when creating a category).

Output

The node outputs a json object with the following structure depending on the operation:

Find All:

{
  "response": [ /* Array of category objects as returned by Akeneo API */ ]
}

Find:

{
  "response": { /* Single category object as returned by Akeneo API */ }
}

If an error occurs (e.g., category not found), an additional field may appear:

{
  "response": { ... },
  "message": "Error message from Akeneo"
}

Create:

{
  "response": { /* Newly created category object as returned by Akeneo API */ }
}

If creation fails, a message field with the error details may be included.

Dependencies

External Service: Requires access to an Akeneo PIM instance with API enabled.
Credentials: Needs an n8n credential named akeneoApi containing:
- clientid
- secret
- username
- password
- domain (Akeneo base URL)
Environment: No special environment variables required beyond n8n credentials.

Troubleshooting

Common Issues:

Invalid Credentials: If the provided Akeneo credentials are incorrect, authentication will fail.
Missing Required Fields: For "Create" operation, missing the "Name" or labels will result in errors.
Category Not Found: Using "Find" with a non-existent category code returns an error message in the output.
Parent Category Does Not Exist: When creating a category with a specified parent, if the parent does not exist, Akeneo will return an error.

Error Messages:

"message": "Error message from Akeneo" — Indicates a problem with the request (e.g., invalid input, not found).
- Resolution: Check that all required fields are filled and valid; verify category codes.