March 6th, 2025 Release Note: RME | Menu Cycles | Changes to Buffet Menu Recipe Property (for POS) API Response

Summary

Select the release feature from the table below to be taken directly to that section of the release note.

Release date for all features:  March 6th 2025

Property Changed in an API Response

• Enabled by default? - Yes
• Set up by customer admin? - No
• Enable via support ticket? - No
• Affects configuration or data? - Yes
• Roles affected: - if applicable

What's Changing?

An API response for Buffet Menu Recipes will have a changed property name and value type. This is a breaking change for existing integrations. The impacted API request is:  <baseURL>/Locations/{LocationId}/BuffetMenuCycleItems.

Reason for the Change

This change is being made because the data in the response was not aggregated correctly when the same recipe was in multiple menus.  To fix this, a collection of menu names will be sent for each recipe.

Customers Affected

Menu Cycle customers only with an integration that uses the response from this request:  <baseURL>/Locations/{LocationId}/BuffetMenuCycleItems.

Release Note Info/Steps

• Current property name: menuName
  New property name: menuNames
• Current value type: String
  New value type: Collection

This request is typically used by Menu Cycles POS providers to retrieve Buffet Menu Recipes that are available at a specific location.  

Example request:  https://api.fourth.com/api/oauth/menuservice-pos/locations/{locationId}/BuffetMenuCycleItems

Additional Resources

Menu Cycles API | Fourth

New Property Added to an API Response

• Enabled by default? - Yes
• Set up by customer admin? - No
• Enable via support ticket? - No
• Affects configuration or data? - Yes
• Roles affected: - if applicable

What's Changing?

A 'menu external ID' has been added to the response to this request <baseURL>/Locations/{LocationId}/BuffetMenuCycleItems 

Reason for the Change

Increases ease of use.

Customers Affected

Menu Cycle customers using this request:  <baseURL>/Locations/{LocationId}/BuffetMenuCycleItems.

Release Note Info/Steps

There are no steps required to enable this change.

See below for snippet of response with external ID included.

{
"menuNames": [
   {
      "name": "test D91179 27022025",
      "externalId": "d65d044c-55cc-4626-9e08-6223da7c00d6"
   },
   {
      "name": "test D91179 27022025-2",
      "externalId": "e386792d-9a2f-4409-9436-2c670c0230a4"
   }
],

Additional Resources (optional)

https://developer.fourth.com/en-gb