Akeneo icon

Akeneo

Akeneo by pixelInfinito
Join our community

Actions4

Overview

The Akeneo custom n8n node enables interaction with the Akeneo PIM (Product Information Management) system. Specifically, for the Product resource and the Build Call operation, this node allows users to make custom API requests to the /api/rest/v1/products endpoint by appending a user-defined path or query string. This is useful for advanced use cases where predefined operations are insufficient, such as retrieving filtered product lists, paginated results, or accessing specific sub-resources.

Practical examples:

  • Fetching products with specific attributes or filters not covered by standard node operations.
  • Accessing paginated product data using custom query parameters.
  • Integrating Akeneo product data into other workflows based on dynamic API calls.

Properties

Name Meaning
API Request The custom path or query string to append to /api/rest/v1/products. Example: ?limit=50&search={"enabled":[{"operator":"=","value":true}]}. This allows flexible API calls to fetch or filter products as needed.

Output

  • The output is a JSON array containing the data returned from the Akeneo API for the specified custom call.
  • If the API returns an error, the output will include a message field with the error details.
  • Example output structure:
    [
  {
    "code": "product_123",
    "family": "clothing",
    "categories": ["summer", "sale"],
    ...
  },
  ...
]
  • No binary data is produced by this operation.

Dependencies

  • External Service: Requires access to an Akeneo PIM instance with REST API enabled.
  • Credentials: Needs valid Akeneo API credentials configured in n8n under the name akeneoApi.
  • Environment: The base URL for Akeneo must be set in the credentials.

Troubleshooting

  • Common Issues:

    • Invalid API Request Path: If the API Request property is malformed, the node may return an error message from Akeneo.
    • Authentication Errors: Missing or incorrect credentials will result in authentication failures.
    • Network Issues: Connectivity problems between n8n and Akeneo can cause timeouts or connection errors.

  • Error Messages:

    • "message": "Not Found": The custom path does not match any Akeneo endpoint.
    • "message": "Unauthorized": Check your Akeneo API credentials.
    • "message": "Bad Request": The query string or parameters are invalid; review the Akeneo API documentation for correct syntax.

Links and References

Discussion