Menu Sync Errors Explained – Checkmate

If an attempted menu sync from the Checkmate Portal results in an error, the menu will NOT update in the Checkmate Portal and will, therefore, not be able to update on your integrated Ordering Platforms.

You will be notified via email of why the menu sync occurred and how to resolve the error.

The table below explains the Sync Errors and Resolution for each of these errors:

Hours

Error Message	Explanation	Resolution
First Menu element with title #{element[:title]} has no hours, but location is not disabled	This error would pop up when a menu does not have hours. The location is enabled, but all days are marked as closed on the hour's page for a particular menu.	Set the hours for the menu by accessing the Hours tab on the left-hand side of the Menu Management Screen or Onboarding Portal.
Menu titled ‘Menu_name’ does not have any hours set in the Checkmate user portal.	This error occurs when a menu does not have hours. The location is enabled, but all days are marked as closed on the hour's page for a particular menu.	Set the hours for the menu by accessing the Hours tab on the left-hand side of the Menu Management Screen or Onboarding Portal.
Menu named \"#{element[:title]}\" includes invalid hours for #{day_of_week}	This error means that for a particular day in the menu, the midnight hours have crossed 5 am, which causes a push failure in Postmates with an internal server error.	To remove the invalidity, reset the menu's hours by accessing the Hours tab on the left-hand side of the Menu Management Screen or Onboarding Portal. Our system only supports hours extending past 5 am the next day.

Tax Rate

Error Message	Explanation	Resolution
The tax rate for ‘element’ titled ‘element_name’ is greater than 50%	The tax rate for an item cannot be more than 50%	Adjust the tax rate for the item so that it falls between 0 - 50% in your POS and sync.
The tax rate for ‘element’ titled ‘element_name’ is 0%	The tax rate for an item cannot be zero	Adjust the tax rate for the item so that it falls between 0 - 50% in your POS and sync.
Location titled ‘Location_name’ has tax rate equal to 0%	Tax rate for this location has been set as 0.	Set a tax rate for the location between 0% - 50%.
Location titled ‘Location_name’ does not have a defined tax rate	Location level tax rate has not been set.	Set a tax rate for the location titled ‘location_name’.
Location titled ‘Location_name’ has tax rate greater than 50%	Tax rate for this location has been set as greater than 50% which is not allowed.	Set a tax rate for the location between 0% - 50%.

Menu Item/Mod Name

Error Message	Explanation	Resolution
‘Element’ titled ‘Element_name’ has a description with more than 1000 letters	Element description cannot be more than 1000 letters	Change the element description to be under 1000 letters
The modifier group ‘modifier_group_name’ contains modifiers, but the maximum permitted value is set as 0	The maximum number of modifiers set for the modifier group is 0, but the modifier group contains modifiers	Change the maximum permitted number of modifiers from 0 to the actual number of allowable modifiers within the modifier group or delete the modifiers in the modifier group
Element titled ‘element_name’ is not unique	The menu item/ modifier name must be unique. Each item with a different name should be on the same menu.	Check the name of element and change it to something unique. Our system does not support duplicate item and modifier names.
‘Element’ titled ‘Element_name’ contained within parent ‘element’ ‘parent_element_name’ does not have a unique title	There should not be two child elements with the same name within a parent element. For example, on the Breakfast menu, there should not be two categories called Burgers.	Check the element's name and change it to something unique as it matches an existing item of the same name. Our system does not support duplicate item and modifier names.
‘Element’ titled ‘Element_name’ is not unique.	The element title is required to be unique. No two items/ modifiers/ modifier groups of the same name should be in the same menu.	Check the element's name and change it to something unique. Our system does not support duplicate item and modifier names.
The menu item titled ‘menu_item_name’ has too many characters	A menu item title can only contain up to 99 characters.	Rename the menu item to have less than 99 characters.
The modifier group titled ‘modifier_group_name’ has too many characters	A modifier group title can only contain up to 99 characters.	Rename the modifier group to have less than 99 characters within your POS.
The modifier group titled ‘modifier_group_name’ has too many characters	A modifier title can only contain up to 99 characters.	Rename the modifier group to have less than 99 characters.

Pricing

Error Message	Explanation	Resolution
The price of the element titled ‘element_name’ in the element group 'missing_context' is missing.	This error indicates no price for an item/modifier has been set. The price of this item/ modifier is empty, not zero.	Check your POS system to see if the item/modifier has a price assigned to it. If not, please assign the price and sync. If, however, a price has been set, reach out to menubuilding@itsacheckmate.com
The price for ‘Element’ titled ‘Element_name’ exceeds 375 USD, which is not allowed for Uber	Item prices above 375 USD are not allowed in Uber.	Reduce the price for the item to under 375 USD.
Element #{element[:element_type]} with title \"#{element[:title]}\" price is negative for OPs: " + negative_priced_dsps.join(", ")	The specified item/modifier is priced less than $0. The menu needs to be reviewed for any negative prices. If there are any price discrepancies due to POS pricing/item availability, the item needs to be marked as sold out.	Update the price of this item/modifier in POS and perform menu sync

Alcoholic Item

Error Message	Explanation	Resolution
Category titled ‘Category_name’ has both alcoholic and non alcoholic items. This is not allowed on SkipTheDishes ordering platform	SkipTheDishes ordering platform requires separate categories for items containing alcohol. This error comes up when a category has both.	Create a separate category for the alcoholic items in the category and move these items to the new alcoholic item category.
Element titled ‘Element_name’ does not have the required tags in the POS system. Until the tag is set in the POS, ‘Menu_item_name’ will not be pushed to the ordering platforms.	This Direct sync integration error means that Checkmate has indicated/flagged items in your menu as alcoholic items. This error means we have detected that corresponding tags have not been set in your POS for these items. Therefore, these items will not be pushed to OP’s until a tag is set in the POS.	Mark items with the required tags on your POS system to classify them as alcoholic or nonalcoholic.
Menu item titled ‘Menu_item_name’ might be alcoholic but is not marked	The item name matched with the items that are listed as potentially being alcoholic	Check if the menu item contains alcohol. If it does, please mark the item as alcoholic per the item tagging instructions in your POS direct sync settings checklist.
The modifier group/modifier titled ‘Modifier_name’ has been tagged as an alcoholic in the POS. Modifiers and modifier groups cannot contain alcohol tags.	This Direct Sync integration error means that you have tagged modifiers as alcohol in your menu but have not tagged the corresponding items. We require tags on items, not modifiers.	Review the modifiers in your menu and remove their alcohol tag from your POS system. Modifiers and modifier groups cannot contain alcohol tags.

Modifier Min-Max Settings

Error Message	Explanation	Resolution
The modifier group titled ‘modifier_group_name’ has an invalid maximum quantity set.	The maximum quantity has not been specified for this modifier group.	Set the maximum quantity for the modifier group in your POS and sync.
The modifier group titled ‘modifier_group_name’ has a maximum value greater than the number of modifiers.	The maximum value set for the modifier group is greater than the number of modifiers.	Set the maximum quantity for the modifier group to less than or equal to the number of modifiers in your POS and sync.
The modifier group titled ‘modifier_group_name’ has an invalid minimum quantity set.	The minimum quantity has not been specified for this modifier group.	Set the minimum quantity for the modifier group in your POS and sync.
The modifier group titled ‘modifier_group_name’ has the minimum permitted value greater than the maximum value.	The minimum value set for the modifier group is greater than the maximum value set by the user.	Set the minimum quantity for the modifier group to be less than the maximum quantity in your POS and sync.
Modifier group 'Element_name (Element_ID)' is required, but all modifiers are marked as sold out. To resolve, mark the parent item as sold out OR mark at least one modifier as available.	All modifiers within a required modifier group (min permitted = 1) are marked as sold out.	To resolve, mark the parent item as sold out OR mark at least one modifier as available.