Order Schema Reference

order schema reference objects address an address record can be for users, caterers, brands, etc field name description city order schema reference /#string the name of the city where the address is located deliveryinstructions order schema reference /#string specific instructions provided for the delivery, such as parking details or particular points of entry name order schema reference /#string the name associated with the address, which could be a business name or a contact person state order schema reference /#string the two letter abbreviation for the state in which the address is located (e g , ma for massachusetts) statename order schema reference /#string the full name of the state corresponding to the address (e g , massachusetts) street order schema reference /#string the primary street address or street line 1 street2 order schema reference /#string the secondary street address or street line 2, used for additional address components such as apartment or suite numbers street3 order schema reference /#string an additional address field for further granularity, often used for large complexes or extended addresses zip order schema reference /#string the postal code for the address location example { "city" "boston", "deliveryinstructions" "ask for jane at front desk", "name" "", "state" "ma", "statename" "massachusetts", "street" "12345 restaurant avenue", "street2" null, "street3" null, "zip" "54321" } acceptorderpayload return type of acceptorder field name description order order schema reference /#order a customer's order for catering example { "order" order! } caterer a caterer representing a specific location providing catering field name description address order schema reference /#address the physical location or mailing address of a store or entity, which can include various subfields such as street, city, state, and zip code live order schema reference /#boolean indicates whether an the caterer location is currently active, or operational name order schema reference /#string the name associated with the caterer location storenumber order schema reference /#string a unique identifier assigned to each store it is used to differentiate between different stores in a chain or franchise uuid order schema reference docid\ u2uigsyo0gfpxj 5tuif0 example { "address" address, "live" true, "name" "my caterer name", "storenumber" "00001", "uuid" "ezcater caterer id" } caterercart information about items on an order, from the caterer's perspective field name description feesanddiscounts(types \[feeordiscounttype!]) order schema reference /#lineitem enumeration of various fees and discounts provided to the caterer orderitems order schema reference /#orderitem the specific items ordered by a customer each order item typically includes details such as the item's name, price, quantity, special instructions, and any associated options or customizations tableware order schema reference /#tableware the collection of utensils and other tableware items included with the order, such as forks, knives, or plates totals order schema reference /#caterertotals the summarized financial details of the order, including subtotals, total due, taxes, tips, and overall amounts payable by the customer example { "feesanddiscounts" \[lineitem!]!, "orderitems" \[orderitem!]!, "tableware" tableware, "totals" caterertotals } caterertotals various order totals, from the caterer's perspective field name description caterertotaldue order schema reference /#float the sum of all order item prices, line items, and tip with commission and cc fee subtracted example { "caterertotaldue" 171 02 } event information about the event an order is associated with (e g time, date, location, etc ) field name description address(shouldusesearchaddress boolean = false) order schema reference /#address the location at which the order is expected to be delivered by the caterer when shouldusesearchaddress boolean = true then it includes the address the customer searched for (relevant for takeout orders) catererhandofffoodtime order schema reference /#utctimestamp the utc timestamp indicating when the caterer must be ready to give prepared food to the customer or delivery partner contact order schema reference /#eventcontact on site contact who will receive order on day of event customerprovidedname order schema reference /#string the name for the event that was provided by the customer headcount order schema reference /#id the number of people that an order is intended to serve ordertype(perspective ordertypeperspective) order schema reference /#ordertypeenum the specific manner in which an order is processed or fulfilled thirdpartydeliverypartner order schema reference /#string the third party delivery partner's name timezoneidentifier order schema reference /#string the time zone identifier of the event in a format like 'america/new york' full list of time zone identifiers here https //en wikipedia org/wiki/list of tz database time zones timezoneoffset order schema reference /#string the utc offset for time zone identifier, for example 4 00 timestamp order schema reference /#utctimestamp the utc timestamp indicating when the customer expects to receive food example { "address" address, "catererhandofffoodtime" "2025 03 27t16 15 00z", "contact" eventcontact, "customerprovidedname" "team building event", "headcount" 10, "ordertype" "delivery", "thirdpartydeliverypartner" null, "timezoneidentifier" "america/new york", "timezoneoffset" " 04 00", "timestamp" "2025 03 27t16 30 00z" } eventcontact on site contact who will receive order on day of event field name description name order schema reference /#string the name of the on site contact who will receive the order phone order schema reference /#string the phone number of the on site contact who will receive the order example { "name" "jane doe", "phone" "5555555555" } money monetary information on tip and totals for an order field name description currency order schema reference /#currency allowed currency values for money subunits order schema reference /#id monetary amount in currency sub units (e g for us dollars, this would be an amount in pennies); limited to 32 bit integer ( 2 147 483 647 == $21 474 836 47 ) subunitsv2 order schema reference /#bigint monetary amount in currency sub units (e g for us dollars, this would be an amount in pennies) example { "currency" "usd", "subunits" 23864, "subunitsv2" "23864" } lineitem order line items like taxes, fees, and discounts field name description cost order schema reference /#money monetary information for the order line item name order schema reference /#string name of the order line item example { "cost" money, "name" "delivery fee" } order a customer's catering order field name description caterer order schema reference /#caterer a caterer representing a specific location or store providing catering caterercart order schema reference /#caterercart the information about items on the order, from the caterer's perspective deliveryid order schema reference /#id the globally unique identifier of the delivery for the order event order schema reference /#event information about the order's event (e g time, date, location, etc ) istaxexempt order schema reference /#boolean whether or not this order is tax exempt lifecycle order schema reference /#orderlifecycle a description of where an order is in it's lifecycle ordercustomer order schema reference /#ordercustomer customer's contact information for privacy reasons, this may not always be provided ordernumber order schema reference /#string reference identifier to be used when interacting with support at ezcater ordersourcetype order schema reference /#ordersource the channel that an order comes in through taxableaddress order schema reference /#address the address used to calculate sales tax for an order this will either be the origin (store) address or the destination (event) address totals order schema reference /#ordertotals monetary information on order's tip and totals uuid order schema reference docid\ u2uigsyo0gfpxj 5tuif0 the id of the specific order example { "caterer" caterer, "caterercart" caterercart, "deliveryid" "3593ce70 7227 4fd4 8a78 9591083d0674", "event" event, "istaxexempt" false, "lifecycle" orderlifecycle, "ordercustomer" ordercustomer, "ordernumber" "o1o1o1", "ordersourcetype" "marketplace", "taxableaddress" address!, "totals" ordertotals, "uuid" "your ezcater order id" } ordercustomer a copy of the customer's contact information associated with an order field name description firstname order schema reference /#string customers first name lastname order schema reference /#string customers last name fullname order schema reference /#string customers full name example { "firstname" "jane", "lastname" "doe", "fullname" "jane doe" } orderitem individual selections from the menu a customer has made for an order field name description customizations order schema reference /#orderitemcustomization selected customizations for the order item labelfor order schema reference /#string the name of the person attached to the order item menuitemsizeid order schema reference docid\ u2uigsyo0gfpxj 5tuif0 the id corresponding with a specifically sized item in the caterer's menu menuitemsizename order schema reference /#string size selected by the customer in string format name order schema reference /#string name of the order item notetocaterer order schema reference /#string a note to describe what's included in the item only visible to the caterer positemid order schema reference /#string the the posid for the size specified by the order item this id represents the id of this item in an external api quantity order schema reference /#id quantity of the specific order item specialinstructions order schema reference /#string specific instructions written by the customer for this item totalinsubunits order schema reference /#money total cost of item, including customizations, in currency sub units uuid order schema reference /#uuid the id of the specific order item example { "customizations" \[orderitemcustomization!]!, "labelfor" null, "menuitemsizeid" "ezcater menu version size 12 inch pizza item selection id", "menuitemsizename" "12\\" pizza", "name" "margherita pizza", "notetocaterer" "12\\" thin crust margherita pizza", "positemid" "12 inch pizza item selection id", "quantity" 10, "specialinstructions" "please be careful not to burn crust", "totalinsubunits" money, "uuid" "83ec5c82 fa68 437c 90d7 ad861a2c151b" } orderitemcustomization customizations for an order item field name description customizationid order schema reference /#id id corresponding with a specifically sized item customization in the caterer's menu customizationtypeid order schema reference /#id id corresponding with a specific customization label in the caterer's menu customizationtypename order schema reference /#string name corresponding with a specific customization label in the caterer's menu name order schema reference /#string name of the order item customization poscustomizationid order schema reference /#string pos id corresponding with a specific customization in the caterer's menu quantity order schema reference /#id count of items with this customization note that these items may also have other customizations example { "customizationid" "ezcater menu version customization parmigiano reggiano choice 12 inch selection id", "customizationtypeid" "ezcater menu version customization type cheese addon options id", "customizationtypename" "cheese addon", "name" "parmigiano reggiano", "poscustomizationid" "parmigiano reggiano choice 12 inch selection id", "quantity" 10 } orderlifecycle describes where an order is in it's lifecycle field name description orderiscurrently order schema reference /#string where the order is in its lifecycle example { "orderiscurrently" "accepted" } ordertotals monetary information on tip and totals for an order field name description customertotaldue order schema reference /#money the total amount that the customer owes for their order pointofsaleintegrationfee order schema reference /#money fee charged for using a specific pos system salestax order schema reference /#money the sales tax collected for the order salestaxremittance order schema reference /#money the sales tax remitted by ezcater subtotal order schema reference /#money total cost of all food items in an order tip order schema reference /#money the gratuities added to the order for the delivery or kitchen personnel example { "customertotaldue" money!, "pointofsaleintegrationfee" money!, "salestax" money!, "salestaxremittance" money!, "subtotal" money!, "tip" money! } rejectorderpayload return type of rejectorder field name description order order schema reference /#order a customer's order for catering example { "order" order! } tableware a collection of tableware choices field name description specialinstructions order schema reference /#string instructions written by customer about tableware needs tablewarechoices order schema reference /#tablewarechoice tableware selections a customer has made for the order example { "specialinstructions" null, "tablewarechoices" \[tablewarechoice!] } tablewarechoice complimentary tableware items, such as plates, napkins, utensils field name description choiceuuid order schema reference docid\ u2uigsyo0gfpxj 5tuif0 id corresponding with the tableware item in the caterer's menu isincluded order schema reference /#boolean this boolean term indicates whether the tableware is included on the order itemcount order schema reference /#id the number of pieces of tableware included on the order name order schema reference /#string the name or description of the tableware item on the order example { "choiceuuid" "7acc72ed 2240 4b9f a903 f7873b94ba60", "isincluded" true, "itemcount" 10, "name" "napkins" } input objects rejectorderinput parameters for rejecting an order field name description explanation order schema reference /#string reason order schema reference /#rejectionreasonenum provides a reason for rejecting the order not all of the reasons are relevant to an api integration example { "explanation" "this location can't accept any more orders for that delivery date", "reason" "at daily capacity" } enums currency allowed currency values for money enum name description usd currency is in us dollars (usd) feeordiscounttype a list of fee or discounts types that can be included on an order applied to the feesanddiscounts as a filter on the field's return type enum name description adjustment adjustments can represent various alterations to the order total, such as refunds or corrections to previous charges delivery fee delivery fees are charged to cover the cost associated with delivering the order from the caterer to the customer discount discounts are applied to reduce the total amount due for the customer, often as a promotional offer or incentive misc fee miscellaneous fees can include various charges that do not fall under standard categories, such as concierge or specific administrative fees ordertypeenum allowed values for order type enum name description delivery the customer selects delivery, and the caterer is responsible for delivering the order themselves using their own fleet takeout the customers selects to pick up their order directly from the caterer's location, eliminating the need for delivery third party delivery the customer selects delivery, and the caterer uses ezdispatch, to deliver the order to the customer ordertypeperspective allowed values for an order type perspective applied to the ordertype as a filter on the field's return type enum name description caterer filters ordertype information to align with the perspective of the caterer customer filters ordertype information to align with the perspective of the customer ezcater filters ordertype information to align with the perspective of ezcater ordersource allowed values for order sources an order source represents what user flow the order originated from enum name description club soda order was placed through club soda, also known as relish, a service that allows for grouping individual catering orders from multiple people into one larger order, typically for workplace consumption direct entry order was placed through direct entry, a feature within ezcater that allows catering partners to submit their own orders directly into the system ez ordering order was placed through ezordering, an ordering platform supported by ezcater that enables catering partners to facilitate online orders through their own websites marketplace order was placed through the marketplace, ezcater’s primary platform where users can place catering orders from a broad range of partner restaurants rejectionreasonenum allowed values for an order rejection reason, though some are unlikely to be relevant to an api integration enum name description at daily capacity used when the caterer has reached their maximum order capacity for the entire day at hourly capacity used when the caterer has reached their maximum number of orders for a specific hour, rather than for the full day commission or fees too high used when the caterer rejects an order because the commission or fees associated with it are deemed too high distance too far used when the caterer rejects an order because the delivery distance is beyond their serviceable range does not offer take out or delivery used when the caterer doesn't provide either takeout or delivery services does not remember signing up for ezcater used when the caterer claims no recollection of subscribing to ezcater services emergency closure used when unforeseen circumstances cause the caterer to shut down temporarily holiday closure used when the caterer has planned closures on holidays lack of inventory used when the caterer has insufficient stock or ingredients lead time too short to deliver used when there's insufficient time to deliver the order as requested lead time too short to prepare used when there's not enough time to prepare the order menu incorrect used when there are issues with the menu items specified in the order missing customer contact information used when the order cannot be fulfilled due to the lack of necessary customer contact details no drivers available used when there are no drivers available to deliver the order no tip used when the lack of a tip influences the caterer's decision to reject the order ownership changed used when the ownership of the caterer has changed, which affects the order fulfillment capabilities permanently closed used when the caterer has ceased operations permanently reason not listed used when none of the listed reasons accurately describe the rejection this is a catch all category staff shortage used when there are not enough staff members to handle the order temporarily closed used when the caterer is temporarily closed for short term reasons weather used when adverse weather conditions preventing order fulfillment wrong hours used when the order is placed outside of the caterer's operational hours scalars bigint represents non fractional signed whole numeric values since the value may exceed the size of a 32 bit integer, it's encoded as a string boolean the boolean scalar type represents true or false date iso 8601 date only string, e g 2017 12 14 float the float scalar type represents signed double precision fractional values as specified by ieee 754 id the id scalar type represents a unique identifier, often used to refetch an object or as key for a cache the id type appears in a json response as a string; however, it is not intended to be human readable when expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an id iso8601datetime an iso 8601 encoded datetime @specifiedby(url https //tools ietf org/html/rfc3339 https //tools ietf org/html/rfc3339 ) int the int scalar type represents non fractional signed whole numeric values int can represent values between (2^31) and 2^31 1 json represents untyped json string the string scalar type represents textual data, represented as utf 8 character sequences the string type is most often used by graphql to represent free form human readable text utctimestamp iso8601 formatted date & timestamp in utc uuid universally unique identifier as defined by rfc 4122