Published Offers API and Versioned Offers v2

Offers v2 have been improved to include Offer versions. The Offer version allows to control more granularly when certain edits made to an Offer is available for sales.

Offer version is controlled via the Page's publishing cycle. The latest version of an Offer will match the last published Page it is attached to.

This feature needs to be activated by the Limio team, so you need to contact support in order to get it working in your environment.

Impact

This feature impacts the following features:

• Limio for Salesforce Offer Selector
• Limio Commerce Catalog API
• Limio Commerce Purchase Links

How to adopt the feature

Offers v2 now have a published version, which is updated when its attached Page is Published. When you are upgraded to a release which contains this feature change (from Release 77 onwards), the Offers won't have the version set and Offers won't be visible anywhere. You must republish Pages in order to set a version on the Offers v2.

⚠️ To recap: It is important to understand that once this feature is active, the Offer v2 will not be available to customers and agents until it is attached to a Page and the Page is built and published. 

While Offers for Limio for Salesforce, API or Purchase Links might not require a visual shop experience, you must still attach the Offer to a Page in order for the Offers to have a version and be available to agents or customers.

What have we changed?

Previously, if an Offer v1 was updated to prepare for a future Page, the updated price would have been immediately available in the Catalog API and in Limio for Salesforce. This led to issues where new prices were available to Agents or Customers before they were ready to be sold.

With the updated Offers v2 API and versioned Offers, updates to offer pricing will only appear when a Page containing the Offer v2 that gets published.

Here is the impact of the change based on the lifecycle of the Offer and the Page it is attached to:

	Page is not published	Page is published
New Offer	The Offer v2 won't appear to customers or agents	The Offer v2 will appear to customers or agents
Edited an existing offer	The latest Offer v2 version won't appear to customers or agents until the Page is republished	The latest Offer v2 version appears to customers or agents

Note: If an Offer v2 is attached to two Pages and one Page is published and the other isn't, Limio for Salesforce/Catalog API/Purchase Links will show the version for the latest published one.