Akeneo icon

Akeneo

Akeneo by pixelInfinito

Actions3

Overview

This n8n custom node integrates with the Akeneo PIM (Product Information Management) system. Specifically, for the Product resource and the FindOne operation, it allows users to search for a single product in Akeneo by its name. This is useful in scenarios where you need to retrieve detailed information about a specific product based on a user-provided query, such as synchronizing product data, validating existence, or enriching workflows with product details.

Practical Example:
Suppose you have an e-commerce workflow that needs to fetch product details from Akeneo when a customer searches for a product by name. This node can be used to look up the product and return its full information for further processing.

Properties

Name Type Meaning
Nome String The name of the product to search for in Akeneo. Used as the query parameter for lookup.

Output

  • The node outputs a json object with at least the following fields:
    • response: Contains the result of the Akeneo API call for the product found by the provided name. The structure depends on Akeneo's product API response.
    • If an error occurs during the API request, an additional field may appear:
      • message: Contains the error message returned by the Akeneo API.

Example output:

{
  "response": {
    // Product data as returned by Akeneo API
  }
}

or, in case of an error:

{
  "response": { "error": { /* ... */ } },
  "message": "Error message from Akeneo"
}

Dependencies

  • External Service: Requires access to an Akeneo PIM instance.
  • API Credentials: Needs valid Akeneo API credentials (clientid, secret, username, password, and domain) configured in n8n under the credential type akeneoApi.
  • n8n Configuration: No special environment variables beyond standard credential setup.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the Akeneo API credentials are incorrect or missing, authentication will fail.
  • Product Not Found: If the product name does not match any existing product, the response may be empty or contain an error message.
  • API Rate Limits/Network Errors: Network issues or exceeding Akeneo API rate limits can cause errors.

Error Messages:

  • "message": "Error message from Akeneo": Indicates an error response from the Akeneo API. Check the message for details (e.g., "Product not found", "Unauthorized").
    • Resolution: Verify the product name, ensure credentials are correct, and check network connectivity.

Links and References

Discussion