Introduction
Some extensions of the Akeneo App Store use events to synchronize the Akeneo PIM product data with other applications.
To use these extensions, you need to enable an event subscription that relies on the connections in the Akeneo PIM.
You will find everything you need to create a new connection on the following page: Create a connection.
Overview
Before you enable an event subscription, you may want to know what it is and what it does.
What happens when you enable an event subscription on a connection?
- A user or a third-party triggers an event in Akeneo PIM.
- Akeneo PIM sends a message that contains product data and the event type to the connected third party.
- The connected third party acknowledges the message reception, then processes the message.
- The product data is synchronized with the connected third party.
Who/what can trigger an event?
Events can be triggered:
- By any user in the Akeneo PIM interface,
- Through the REST API by a third-party application*,
- By the Rules Engine,
- By launching data imports.
*Please note that you won't receive events when you create, update, or delete a product using the same connection as the one you use to receive events.
Which events are triggered by Akeneo PIM?
Akeneo PIM triggers an event when:
- a product is updated, created, or deleted,
- a product variant is updated, created, or deleted,
- a product model is updated, created, or deleted.
You will find more information about product types in Akeneo PIM on the following page: Create products.
What is considered a product update?
Akeneo PIM triggers product update message when:
- a product identifier is updated,
- a product main media is updated,
- a product attribute value is updated,
- a product is classified or unclassified,
- a product family is updated,
- product status is updated,
- a product association is created or removed,
- an association quantity is updated,
- an asset link is created or removed,
- a reference entity is created or removed,
- a previous version of a product is restored,
- the bulk action Change the parent product model is launched,
- the bulk action Add to existing product model is launched,
- the action to convert a product variant to a simple product,
- and the action that allows you to edit a variant axis value.