Public API
Menus API
4min
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
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 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.
- "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: 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.
- Packing Tags: Identifies whether the item is individually wrapped.
- Drink/Dessert Tags: These values are specifically used for upsell opportunities. Please ensure all beverage and dessert items are tagged accordingly.
- Utensil Tags: For items and option choice representing utensils, please tag the entity as “Utensil”. See Appendix B 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
- Per ezCater’s Equal Price Guarantee, 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 for additional information and examples.