Menus API

preparing for menu integration with ezcater ezcater is excited to connect your content systems with ezcater’s menu catalog these pages will help you prepare your menu content in order to make the project move quickly please review the following guidelines to prepare your menu to be integrated with ezcater menu structure ezcater has a specific structure for modeling menus information is primarily organized into categories, items, options, and choices here is a bit more information about each element of the ezcater menu structure categories sections that group items, options and choices together the category includes elements such as the name, description, and the order categories will be presented in see appendix a category names & order https //api ezcater io/menus api#lsast for additional information items these are typically the items you sell item images are supported options a group of choices or item modifier selections choices the individual selections available for a given option please note nested items or options are not supported at this time therefore, you may need to prepare an ezcater specific menu or make modifications to your existing menu to remove nesting ezcater specific field configurations "serves (# of people)" a numeric field identified as being specific to catering the field allows a customer to identify the number of people participating in an event catering partners use this numeric value to describe how many people a large tray or bowl serves dietary tags (foodlabelingtags) describe qualities of an item or choice related to labeling if an item qualifies under a specific tag (ex “vegetarian”) only if certain option choices are selected, then the option choices that qualify should also be tagged accordingly values include award , gluten free , halal , healthy , kosher , popular , spicy , star , vegan , vegetarian packaging tags (individualwrapstatus) identifies whether the item is individually wrapped values include t, f drinks & dessert tags (itemtypetags, choicetypetags) these values are specifically used for upsell opportunities please ensure all beverage and dessert items are tagged accordingly values include dessert, drinks utensil tags (itemtypetags, choicetypetags) for items and option choice representing utensils, please tag the entity as “utensils” see appendix b https //api ezcater io/menus api#8akre for additional information tax categories values stored by menu items describing the avalara tax classifications the classification is used by ezcater to look up tax rates and charge taxes per order tags used to classify how a given item is taxed values include bakery items , cakes and pies , candy , chips and snacks , coffee tea milk , dressings and condiments , exempt , ice cream , miscellaneous , non soda drinks , prepared food , sandwiches , soda , water uom a set of values used to describe the quantity required of a given item quantityunit a uom for ordering items default to item if needed values include bar , bottle , bowl , box , buffet , cake , can , carafe , dozen , foot , full pan , gallon , half gallon , half pan , item , kit , liter , package , pan , person , pie , piece , pint , pizza , platter , pound , quart , roll , six pack , skewer , slider , taco , tray , twelve pack , two liter menu requirements per ezcater’s equal price guarantee https //catering ezcater com/en/help/what are the pricing requirements for my menu , which is agreed to by all caterers in the terms & conditions of the platform (or signed msa if applicable), you agree that the pricing you provide us for menu items, service and other fees to display on your ezcater pages for a given location will match the lowest prices and fees you charge customers through your or any other website or online channel for substantially similar offerings at that location ezcater cannot sell items for higher than the lowest advertised price online ezcater requires all items to have a price greater than zero please don’t forget the utensils! ezcater’s core customer base is people and groups at work who often need forks, napkins, and plates you can add utensils for a fee as items or you can provide free utensils as options/choices ezcater does require utensils to be added to menu items with limited exceptions see appendix b ezcater integrated plates / napkins / utensils https //api ezcater io/menus api#8akre for additional information and examples menu create user permissioning prior to requesting user create permissions, an api user must be created, and confirmation that all public api documentation on this platform has been read and understood must be provided once those steps are completed, a request needs to be submitted to integrations\@ezcater com this request must include the following required information to ensure the process can move forward brand name integrator name api user email (the integrator should know this if the brand does not) it is also highly preferred that the request includes the number of locations that will be integrated and a rough estimate of when the go live event(s) would begin, as this information is very helpful to the ezcater team please note that the ezcater integrations team reserves the right to withhold permission assignment until all required information is completed to ensure data cleanliness and system security appendix a category names & order ezcater customers value uniformity across menus it helps to make selecting food for work quick and efficient the following category names and order are used by ezcater associates to build menus standard offering is generally used for most restaurants ezcater also uses cuisine specific naming standard offerings breakfast all breakfast items (except drinks) go in the breakfast category, regardless of where they would go on a regular menu this includes things like breakfast sides, pastries, breakfast packages, and breakfast sandwiches brunch items are added to breakfast boxed/bagged lunches items that are in a box or bag with other items such as sides, drinks, and/or desserts the item is not a boxed lunch if it is a singular item just so happens to be served in a box appetizers/tapas catering packages generally come with a drink and/or dessert buffets can be catering packages, but if they are a la carte make a buffets category some cp’s will list an item as “chicken parmesan package”, but if it only comes with chicken parmesan it would go in hot entrees items that come with multiple sides to feed a large group of people can be considered catering packages sandwiches/pizza/specialty items/burgers/hot dogs basically anything handheld bowls hot entrees generally come with a side pasta a la carte meats can include basic items like chicken & meats served by the pound or simply without sides, or meats with bulk pricing soups can include stews salads salads that are mayo based go into sides salads that are vegetable forward go into salads sides side salads generally go in the salads category, other side sized items can be placed in the sides category this indicates the item is not an entree portion hors d'oeuvres must be labeled as hors d'oeuvres on the cp’s menu desserts beverages miscellaneous utensils/paper goods/extended service/bags of ice, etc cuisine specific category names and order chinese cuisine menu category names & order appetizers chicken entrees beef entrees pork entrees seafood entrees vegetarian entrees rice & noodles salads sides desserts beverages indian cuisine menu category names & order appetizers dosas (rice & lentil crepes) chicken entrees lamb entrees seafood entrees vegetarian entrees curries rice & biryani bread salads sides desserts beverages italian (w/ pizza) cuisine menu category names & order appetizers pizza calzones sandwiches & wraps hot entrees salads sides desserts beverages japanese/sushi cuisine menu category names & order appetizers bento boxes sushi hot entrees rice & noodles salads sides desserts beverages mediterranean cuisine menu category names & order appetizers sandwiches & wraps hot entrees a la carte kebabs, meat, entrees, etc if applicable salads sides desserts beverages mexican cuisine menu category names & order appetizers tacos & burritos sandwiches & wraps hot entrees a la carte meat, entrees, etc if applicable salads sides desserts beverages smoothie cuisine menu category names & order breakfast sandwiches & wraps salads sides desserts smoothies juices beverages thai cuisine menu category names & order appetizers hot entrees curry rice & noodles salads sides desserts beverages appendix b ezcater integrated plates / napkins / utensils to service ezcater’s food for work clientele, ezcater requires menus including utensils individually and serving utensils paid for vs free utensil configuration paid for items tagged as “utensil” and presented in the menu customers can select these items and add them to the cart as they build their order free items modeled as an option/choice are tagged as “utensil”, hidden on the menu, and presented as part of the checkout experience ezcater expects a majority, if not all items using this approach will have a utensil configuration free utensil order experience ezcater provides consumers the ability to select or deselect their utensil requirements as the order forms in the cart the experience includes feature 1 as items are added to the cart, tableware options appear in the cart in a dedicated section feature 2 upon edit the consumer can select or deselect “tableware” as needed the options available for selection change based on the item’s option/choices selected utensil item and option/choice configuration examples the following represents common language used by ezcater to describe different types of utensils standard items utensils plates napkins soups plates bowls napkins utensils drinks cups ice (optional) coffee plates napkins utensils cups stirrers sugar diet sweeteners creamer exceptions that would not require utensils individual drinks