Esquema de inventario relacional

En esta página, se describe el formato para realizar pedidos de feeds de datos de extremo a extremo (especificaciones del catálogo de alimentos) que le proporcionas a Google. Para obtener una versión de esta información procesable, puedes descargar el esquema JSON.

Requisitos generales

Las entidades deben estructurarse para estar en una línea por entidad en los feeds (las entidades están separadas por caracteres de línea nueva). Para facilitar la lectura, los ejemplos de JSON en esta página no siguen esa estructura. Sin embargo, debes seguir esa estructura cuando envíes tus feeds. Por ejemplo, una entidad de menú debe estructurarse como el siguiente código:

{"@type": "Menu","name": "Coffee Shop A","@id": "1535"}

Cada entidad de "Restaurante" puede tener dos entidades de servicio (una de cada una para los tipos de servicios "DELIVERY" y "TakeOUT"). Cada entidad de "Service" solo puede tener una entidad "Menu".

Cualquier subentidad se puede volver a usar en varios restaurantes.

Lineamientos sobre el valor JSON

Coerción de tipo

Un tipo de valor JSON puede ser diferente del tipo definido en el esquema, siempre que el valor se pueda forzar al tipo requerido. Por ejemplo, las propiedades de la cadena pueden aceptar tanto cadenas como valores de números enteros como entrada. Del mismo modo, las propiedades de números enteros pueden aceptar el valor de una cadena siempre que esta se pueda analizar como un número entero válido.

La coerción de tipo también funciona para las propiedades repetidas. Las propiedades repetidas pueden aceptar valores como entrada sin encerrarse entre corchetes []. Por ejemplo, la propiedad OperationHours.serviceId acepta "service_id" y ["service_id"] como entradas válidas.

Valores de fecha y hora

DateTime se basa en el tipo de schema.org y, a menos que se indique lo contrario, debe seguir el formato ISO 8601 y, además, incluir la fecha, la hora y la zona horaria. Usa la siguiente sintaxis para DateTime:

// DateTime format:
YYYY-MM-DDTHH:MM:SS[∓HH:MM|Z]

Por ejemplo:

2017-05-01T06:30:00-07:00 // UTC minus 7 hours
2017-05-01T06:30:00Z  // UTC time zone. The optional "Z" suffix represents the UTC time zone.

Time es la hora local de la zona horaria de un restaurante o una ubicación de servicio determinados, también se basa en el tipo de schema.org y debe seguir el formato ISO 8601. La hora utiliza la siguiente sintaxis:

// Time format:
THH:MM:SS

Por ejemplo:

T08:08:00 // 8:08 AM

Ten en cuenta lo siguiente cada vez que especifiques un DateTime o Time:

  • El prefijo "T" antes de la hora forma parte del formato y es obligatorio.
  • Se debe especificar la zona horaria de DATETIME. No es necesario para TIME.
  • La hora debe especificarse en la hora local del restaurante o servicio.

Datos del restaurante

Restaurante (obligatorio)

Una entidad obligatoria para implementar. Describe un restaurante.

En la siguiente tabla, se enumeran las propiedades del tipo Restaurant:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: Restaurant

@id String

Obligatorio.

Es un identificador único del restaurante o del proveedor de entregas a domicilio.

Ejemplo: restaurant_1

name String

Obligatorio.

Indica el nombre del restaurante.

Ejemplo: Foo

description String

Es una descripción del restaurante.

Ejemplo: Best seafood in town

url URL

La URL que representa al restaurante. Se prefiere el dominio del restaurante en lugar del dominio del agregador.

Ejemplo: http://www.provider.com/somerestaurant

sameAs URL

Es el sitio web oficial del restaurante.

Ejemplo: http://www.provider2.com/somerestaurant

telephone String

Número de teléfono del restaurante.

Ejemplo: +12345665898

streetAddress String

Obligatorio.

La dirección del restaurante.

Ejemplo: 12345 Bar Avenu

addressLocality String

Obligatorio.

La localidad o la ciudad.

Ejemplo: San Francisco

addressRegion String

Obligatorio.

Es la región o el estado.

Ejemplo: CA

postalCode String

Obligatorio.

Corresponde al código postal,

Ejemplo: 94124

addressCountry String

Obligatorio.

Código de país ISO 3166-1 alpha-2 de dos letras.

Ejemplo: US

latitude Número

Es la latitud en grados. Los valores se restringen al rango [[-90, 90]]. La precisión debe ser de al menos 5 decimales.

Ejemplo: 35.7392607

longitude Número

Es la longitud en grados. Los valores se restringen al rango [[-180, 180]]. La precisión debe ser de al menos 5 decimales.

Ejemplo: -120.3895522

dealId List<String>

Los Deal aplicables del restaurante.

imprint String

Un sello discográfico de restaurante es una sección de información adicional sobre el restaurante, como el nombre legal, la dirección legal y el número de registro. Esta información se puede formatear con " ".

Ejemplo:

Three Brothers Tacos
123 FooSt
Mountain View
CA 94041, United States
email: contact@threebrotherstacos.com

Commercial Register: 123456789

economicOperator String

Información del operador económico asociada con el restaurante, si corresponde. Esta información aparecerá en la sección Información del comerciante. El texto puede darse formato con “ ”.

Ejemplo:

XYZ Corp
123 Main Street
555-555-5555

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de la entidad Restaurante en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

En el siguiente ejemplo, se muestra un elemento Restaurant:

Ejemplo

{
  "@type": "Restaurant",
  "@id": "10824",
  "name": "Pronto Wood Fired Pizzeria",
  "url": "https://www.provider.com/pronto-wood-fired-pizzeria",
  "telephone": "+16503659978",
  "streetAddress": "2560 El Camino Real",
  "addressLocality": "Palo Alto",
  "addressRegion": "CA",
  "postalCode": "94061",
  "addressCountry": "US",
  "latitude": 37.472842,
  "longitude": -122.217144
}

Acuerdo

Tipos de descuentos que se pueden aplicar a un carrito.

En la siguiente tabla, se enumeran las propiedades del tipo Deal:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: Deal

@id String

Obligatorio.

Es un identificador único del acuerdo.

Ejemplo: FREEDELIVERY

dealCode String

Obligatorio.

Es un ID único por acuerdo y por socio. Este ID debe identificar de manera inequívoca la oferta en tu sistema de promoción. Google te envía este identificador en el campo promotions.coupon de un CheckoutRequest para su validación.

Ejemplo: ADETRE23

applicableServiceType Lista<ServiceType>

Es el servicio al que se aplica esta oferta. El valor predeterminado supone un acuerdo aplicable a todos.

eligibleMaxOrders Número entero

Este acuerdo solo es apto cuando el usuario tiene una cantidad inferior o igual a esta cantidad de pedidos exitosos anteriores.

availabilityId List<String>

Son los valores @id de las entidades de disponibilidad que proporcionan detalles sobre cuándo está disponible la sección del menú.

Ejemplo: [ "availability_1" ]

isDisabled Booleano

Esto anula otras verificaciones de validez.

dealType DealType

Obligatorio.

La categoría del acuerdo al que se aplicará el descuento. La categoría puede ser el total del carrito, los cargos del servicio o los gastos de envío.

priceCurrency String

Es obligatorio cuando discount is defined.

Es obligatorio cuando eligibleTransactionVolumeMin is defined.

Es la moneda (en formato ISO 4217 de 3 letras) del descuento.

Ejemplo: USD

eligibleTransactionVolumeMin Número

Es el volumen de transacciones en una unidad monetaria para el que es válida esta promoción.

termsOfServiceUrl URL

Obligatorio.

Documentación sobre las condiciones del servicio legible por humanos

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de la entidad de acuerdo en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

Se requiere exactamente uno de los siguientes grupos de propiedades.
discount Grupo 1 Número

Es el valor del descuento como número.

discountPercentage Grupo 2 Número

Es el valor del descuento como porcentaje del precio original.

En el siguiente ejemplo, se muestra un elemento Deal:

Ejemplo 1

{
  "@type": "Deal",
  "@id": "ONEDOLLARFEE",
  "dealCode": "THREEDOLLARFEE",
  "dealType": "CART_OFF",
  "availabilityId": [
    "availability_may2020"
  ],
  "termsOfServiceUrl": "http://www.provider.com/onedollardeal",
  "applicableServiceType": [
    "TAKEOUT"
  ],
  "discount": 3,
  "priceCurrency": "USD"
}

Ejemplo 2

{
  "@type": "Deal",
  "@id": "10PERCOFF",
  "dealCode": "10PERCOFF",
  "dealType": "CART_OFF",
  "availabilityId": [
    "availability_weekdays_evening"
  ],
  "termsOfServiceUrl": "http://www.provider.com/deal",
  "discountPercentage": 10,
  "priceCurrency": "USD"
}

Ejemplo 3

{
  "@type": "Deal",
  "@id": "FREEDELIVERY",
  "dealCode": "FREEDELIVERY",
  "dealType": "DELIVERY_OFF",
  "availabilityId": [
    "availability_may"
  ],
  "applicableServiceType": [
    "DELIVERY"
  ],
  "termsOfServiceUrl": "http://www.provider.com/free_delivery_deal",
  "discountPercentage": 100,
  "eligibleTransactionVolumeMin": 25,
  "priceCurrency": "USD"
}

Datos de servicio

Servicio (obligatorio)

Describe los detalles del servicio de pedido de comida de un restaurante. Service es una entidad obligatoria para implementar.

En la siguiente tabla, se enumeran las propiedades del tipo Service:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: Service

@id String

Obligatorio.

Es el identificador del servicio de entrega.

Ejemplo: service_1

serviceType ServiceType

Obligatorio.

Es el tipo de servicio que se ofrece. Los valores posibles son "DELIVERY" o "TakeOUT".

Ejemplo: DELIVERY

restaurantId String

Obligatorio.

El valor @id de la entidad Restaurante que se correlaciona con esta entidad de servicio.

Ejemplo: restaurant_1

menuId String

Obligatorio.

El valor @id de la entidad de menú correlacionado con esta entidad de servicio.

Ejemplo: menu_1

dateModified Marca de tiempo ISO

La fecha y hora de última modificación del feed de entidad de servicio en formato de marca de tiempo ISO.

Ejemplo: 2017-01-02T00:00:00-07:00

isDisabled Booleano

Indica si la entidad está inhabilitada. Úsalo solo cuando debas inhabilitar la entidad debido a un evento inesperado y no sepas cuándo se restablecerá el servicio (p.ej., no lo uses para días festivos).

Ejemplo: true

servingConfig ServingConfig

Es la configuración de entrega del servicio que se usa para controlar varias funciones (p. ej., inhabilitar el widget promocional, etcétera).

actionLinkUrl String

Contiene una URL de un servicio de entrega a domicilio o para llevar que se usará durante la migración de la experiencia de pedido de comida de extremo a extremo al redireccionamiento.

En el siguiente ejemplo, se muestra un elemento Service:

Ejemplo 1

{
  "@type": "Service",
  "@id": "10824/takeout",
  "serviceType": "TAKEOUT",
  "menuId": "10824",
  "restaurantId": "10824",
  "actionLinkUrl": "https://www.rwgpartnerwebsite.com/foodorderpickup/merchant_foepa_3"
}

Ejemplo 2

{
  "@type": "Service",
  "@id": "10824/delivery",
  "serviceType": "DELIVERY",
  "menuId": "10824",
  "restaurantId": "10824",
  "actionLinkUrl": "https://www.rwgpartnerwebsite.com/foodorderdelivery/merchant_foepa_3"
}

ServiceArea

Describe la región geográfica en la que se pueden entregar los alimentos. Esta entidad es necesaria para implementarse si la entidad Service asociada tiene serviceType configurado como "DELIVERY".

En la siguiente tabla, se enumeran las propiedades del tipo ServiceArea:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: ServiceArea

@id String

Obligatorio.

Es un identificador único del área de servicio.

Ejemplo: service_area_1

serviceId List<String>

Obligatorio.

El valor @id de la entidad de servicio se correlaciona con esta entidad de ServiceArea.

Ejemplo: [ "service_1" ]

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de entidad ServiceArea en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

exclude Booleano

Excluye esta área de servicio de la región de entrega total. Por ejemplo, un código postal puede excluirse de un área de polígono más grande.

Se requiere exactamente uno de los siguientes grupos de propiedades.
polygon Grupo 1 List<String>

Un polígono o multipolígono expresado como una serie de tres o más puntos delimitados por espacios. Se recomienda que el primer y el último punto sean iguales, pero no es obligatorio. Cada punto de un polígono o un multipolígono se define por un punto de latitud seguido de un punto de longitud. También debes especificar los puntos en sentido antihorario.

Ejemplo: [ "37.806000 -122.425592 37.775849 -122.419043 37.795547 -122.394046 37.808747" ]

geoMidpointLatitude Grupo 2 Número

Indica la coordenada de latitud en el centro del área del CÍRCULO.

Ejemplo: 37.806000

geoMidpointLongitude Grupo 2 Número

Indica la coordenada de longitud en el centro del área del CÍRCULO.

Ejemplo: -122.425592

geoRadius Grupo 2 Número entero

Indica el radio aproximado (en metros) del área del CÍRCULO.

Ejemplo: 10000

postalCode Grupo 3 String

Indica el código postal.

Ejemplo: 91234

addressCountry Grupo 3 String

Indica el código de país ISO 3166-1 alpha-2 de dos letras

Ejemplo: US

En el siguiente ejemplo, se muestra un elemento ServiceArea:

Ejemplo

{
  "@type": "ServiceArea",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "polygon": [
    "37.4818562 -122.25801303 37.48247836 -122.25801303 37.48434484 -122.25621319 37.48621133 -122.25424681 37.49181077 -122.24704744 37.49305509 -122.24541414 37.49429942 -122.2436143 37.49803238 -122.23821477 37.49803238 -122.21285044 37.49367726 -122.15885517 37.49056645 -122.15722187 37.48621133 -122.15542202 37.48558917 -122.15525548 37.4818562 -122.15525548 37.43191387 -122.17865343 37.43191387 -122.23444854"
  ]
}

OperationHours (obligatorio)

Describe la ventana de pedidos en la que los usuarios pueden acceder al flujo y realizar pedidos lo antes posible o futuros. La implementación de OperationHours es obligatoria y, de forma predeterminada, representa las operaciones a todas horas, todos los días.

Los atributos OperationHours opens y closes especifican los horarios de apertura y cierre para el sistema en línea que permite a los usuarios realizar pedidos. Dentro de esas horas del sistema en línea, usa ServiceHours para especificar las horas de apertura y cierre en las que se pueden entregar los pedidos de los usuarios.

Los horarios se deben especificar en la hora local del servicio. No incluyas una zona horaria en un valor de opens. Si se especifica una zona horaria, Google ignorará esta información. Para obtener más información, consulta los formatos de fecha y hora.

En la siguiente tabla, se enumeran las propiedades del tipo OperationHours:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: OperationHours

@id String

Obligatorio.

Es un identificador único para la entidad que describe la ventana de pedido a la que los usuarios pueden acceder al flujo y realizar pedidos lo antes posible o futuros.

Ejemplo: operation_hour_1

serviceId List<String>

Obligatorio.

El valor @id de la entidad de servicio se correlaciona con esta entidad de OperationHours.

Ejemplo: [ "service_1" ]

opens Hora ISO (local)

Indica la hora específica del día en formato ISO a partir de la cual se pueden realizar los pedidos de los usuarios.

Ejemplo: T00:00

closes Hora ISO (local)

Indica la hora específica del día en formato ISO a partir de la cual no se pueden realizar los pedidos de los usuarios.

Ejemplo: T16:00

dayOfWeek Lista<DayOfWeek>

Una lista de los días de la semana para los que son válidos estos horarios de operación. Los valores aceptables son "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY" y "SUNDAY".

Ejemplo: [ "MONDAY", "TUESDAY" ]

validFrom Marca de tiempo ISO

Es obligatorio cuando isSpecialHour = true.

Una marca de tiempo ISO que indica la hora de inicio de la ventana de pedidos a la que los usuarios pueden acceder al flujo y realizar pedidos lo antes posible o futuros.

Ejemplo: 2017-01-01T00:00:00-07:00

validThrough Marca de tiempo ISO

Es obligatorio cuando isSpecialHour = true.

Una marca de tiempo ISO que indica la hora de finalización de la ventana de pedidos más allá de la cual los usuarios no pueden acceder al flujo y realizar pedidos lo antes posible o futuros.

Ejemplo: 2017-01-02T00:00:00-07:00

isSpecialHour Booleano

Un valor booleano que indica si OperationHours es para horarios especiales. Los valores aceptables son "false" y "true".

Ejemplo: False

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de entidades OperationHours en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

En el siguiente ejemplo, se muestra un elemento OperationHours:

Ejemplo 1

{
  "@type": "OperationHours",
  "@id": "10824/deliveryOh",
  "serviceId": [
    "10824/delivery"
  ],
  "isSpecialHour": false
}

Ejemplo 2

{
  "@type": "OperationHours",
  "@id": "10824/takeoutOh",
  "serviceId": [
    "10824/takeout"
  ],
  "isSpecialHour": false
}

Horas de servicio (obligatorio)

Describe el período de entrega en el que los usuarios pueden elegir ranuras de entrega (ranuras lo antes posible o futuras). La implementación de ServiceHours es obligatoria.

Los atributos OperationHours opens y closes especifican los horarios de apertura y cierre para el sistema en línea que permite a los usuarios realizar pedidos. Dentro de esas horas del sistema en línea, usa ServiceHours para especificar las horas de apertura y cierre en las que se pueden entregar los pedidos de los usuarios.

Los horarios se deben especificar en la hora local del servicio. No incluyas una zona horaria en un valor de opens. Si se especifica una zona horaria, Google ignorará esta información. Para obtener más información, consulta los formatos de fecha y hora.

En la siguiente tabla, se enumeran las propiedades del tipo ServiceHours:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: ServiceHours

@id String

Obligatorio.

Es un identificador único de la entidad que describe la ventana de entrega en la que los usuarios pueden elegir las ranuras de entrega, es decir, ranuras lo más pronto posible o futuras.

Ejemplo: service_hour_1

orderType OrderType

Obligatorio.

Es una cadena que indica si el horario de servicio se aplica a pedidos lo antes posible o avanzados. Los valores aceptables son “Lo antes posible” y “AVANZA”.

Ejemplo: ASAP

serviceId List<String>

Obligatorio.

El valor @id de la entidad de servicio correlacionado con esta entidad de ServiceHours.

Ejemplo: [ "service_1" ]

operationHoursId List<String>

Es obligatorio cuando isSpecialHour = false.

El valor @id de la entidad OperationHours correlacionado con esta entidad de ServiceHours.

Ejemplo: [ "operation_hour_1" ]

opens Hora ISO (local)

Indica la hora específica del día en formato ISO a partir de la cual se pueden entregar los pedidos de los usuarios.

Ejemplo: T00:00

closes Hora ISO (local)

Indica la hora específica del día en formato ISO a partir de la cual no se pueden entregar los pedidos de los usuarios.

Ejemplo: T16:00

dayOfWeek Lista<DayOfWeek>

Una lista de los días de la semana para los que son válidos estos horarios de operación.

Ejemplo: [ "MONDAY", "TUESDAY" ]

validFrom Marca de tiempo ISO

Es obligatorio cuando isSpecialHour = true.

Una marca de tiempo ISO que indica la hora de inicio de la ventana de pedidos a la que los usuarios pueden acceder al flujo y realizar pedidos lo antes posible o futuros.

Ejemplo: 2017-01-01T00:00:00-07:00

validThrough Marca de tiempo ISO

Es obligatorio cuando isSpecialHour = true.

Una marca de tiempo ISO que indica la hora de finalización de la ventana de pedidos más allá de la cual los usuarios no pueden acceder al flujo y realizar pedidos lo antes posible o futuros.

Ejemplo: 2017-01-02T00:00:00-07:00

isSpecialHour Booleano

Un valor booleano que indica si OperationHours es para horarios especiales. Los valores aceptables son "false" y "true".

Ejemplo: False

leadTimeMin Número entero

Tiempo estimado de entrega o retiro mínimo, en minutos, una vez que se haya realizado el pedido lo antes posible. Te recomendamos que configures esta propiedad.

Ejemplo: 60

leadTimeMax Número entero

Tiempo máximo estimado de entrega o retiro, en minutos, una vez que se haya realizado el pedido lo antes posible. Te recomendamos que configures esta propiedad.

Ejemplo: 70

advanceBookingRequirementMin Número entero

Es obligatorio cuando orderType = "ADVANCE".

Es la cantidad mínima de minutos desde la hora del pedido hasta que se puede completar el pedido por adelantado. Por ejemplo, si la entrega de un pedido por adelantado requiere al menos 60 minutos para completarse, el valor de AdvancedBookingRequirementMin es de 60.

Ejemplo: 15

advanceBookingRequirementMax Número entero

Es obligatorio cuando orderType = "ADVANCE".

Es la cantidad máxima de minutos desde la hora del pedido hasta que se puede completar el pedido por adelantado. Por ejemplo, si la entrega de un pedido por adelantado no se puede completar más de 2 días después, el valor deAdvanceBookingRequirementMax es 2,880.

Ejemplo: 10080

advanceBookingSlotInterval String

Es obligatorio cuando orderType = "ADVANCE".

Es el intervalo entre dos horarios de horarios disponibles de reserva anticipada sucesivos. Por ejemplo, si los horarios de apertura y cierre son de 8 a.m. y 8 p.m., y el tiempo de entrega avanzado para BookingSlotInterval es de 15 minutos, el usuario puede elegir horarios de entrega de 8 a.m., 8:15 a.m., 8:30 a.m., 8:45 a.m. y así sucesivamente hasta las 8 p.m. La duración se debe especificar como la duración del período ISO. Por ejemplo: “PT15M” significa intervalos de 15 minutos.

Ejemplo: PT15M

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de entidad de ServiceHours en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

En el siguiente ejemplo, se muestra un elemento ServiceHours:

Ejemplo 1

{
  "@type": "ServiceHours",
  "@id": "613741/delivery",
  "orderType": "ASAP",
  "serviceId": [
    "10824/delivery"
  ],
  "opens": "T00:00",
  "closes": "T00:00",
  "isSpecialHour": true,
  "validFrom": "2017-12-25T00:00:00-07:00",
  "validThrough": "2017-12-25T23:59:00-07:00"
}

Ejemplo 2

{
  "@type": "ServiceHours",
  "@id": "10824/takeoutSh_0",
  "orderType": "ASAP",
  "serviceId": [
    "10824/takeout"
  ],
  "operationHoursId": [
    "10824/takeoutOh"
  ],
  "opens": "11:00",
  "closes": "21:00",
  "dayOfWeek": [
    "MONDAY",
    "TUESDAY",
    "WEDNESDAY",
    "THURSDAY"
  ],
  "isSpecialHour": false
}

Tarifas

Describe una tarifa. Si la entidad Service asociada tiene serviceType configurado como "DELIVERY", se requiere un Fee con feeType configurado como "DELIVERY".

En la siguiente tabla, se enumeran las propiedades del tipo Fee:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: Fee

@id String

Obligatorio.

Es un identificador único de la entidad que describe la tarifa.

Ejemplo: service_fee_1

serviceId List<String>

Obligatorio.

El valor @id de la entidad de servicio se correlaciona con esta entidad de tarifa.

Ejemplo: [ "service_1" ]

feeType FeeType

Obligatorio.

Es una cadena que indica si se aplica la tarifa a pedidos de servicio o entrega. Los valores aceptables son "DELIVERY" y "SERVICE".

Ejemplo: DELIVERY

priceCurrency String

Obligatorio.

Corresponde al código de moneda ISO 4217 de 3 letras.

Ejemplo: USD

basePrice Número

Es el precio base de la tarifa, aplicable cuando se usan percentageOfCart o pricePerMeter.

Ejemplo: 2.0

minPrice Número

Tarifa mínima y límite del valor de la tarifa cuando se usan percentageOfCart o pricePerMeter.

Ejemplo: 2.0

maxPrice Número

Tarifa máxima y límite de la tarifa cuando se usan percentageOfCart o pricePerMeter.

Ejemplo: 10.0

eligibleRegion List<String>

El @id del ServiceArea para las regiones geopolíticas para las que es válida la tarifa. Usa esta propiedad solo si los costos de entrega varían según la región.

Ejemplo: [ "service_area_1" ]

eligibleTransactionVolumeMin Número

Es el volumen mínimo de transacciones, en una unidad monetaria, para el que es válida esta especificación de tarifa.

Ejemplo: 50

eligibleTransactionVolumeMax Número

Es el volumen máximo de transacciones, en una unidad monetaria, para el que es válida esta especificación de tarifa. Por ejemplo, la tarifa no se aplica si se supera un determinado volumen de pedido.

Ejemplo: 10

validFrom Marca de tiempo ISO

Una marca de tiempo ISO que indica la hora de inicio en la que la tarifa es válida.

Ejemplo: 2017-01-01T00:00:00-07:00

validThrough Marca de tiempo ISO

Una marca de tiempo ISO que indica la hora de finalización después de la cual la tarifa no es válida.

Ejemplo: 2017-01-02T00:00:00-07:00

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de entidad Tarifa en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

priority Número

Es un valor positivo distinto de cero. Si se aplica más de una tarifa al carrito del usuario, la tarifa de prioridad más alta prevalecerá sobre las tarifas inferiores. Si se proporciona este campo, la prioridad siempre tendrá prioridad sobre una prioridad calculada.

Ejemplo: 3

Se requiere exactamente uno de los siguientes grupos de propiedades.
price Grupo 1 Número

Es el precio de la tarifa. Si el precio no es fijo, se pueden proporcionar minPrice y maxPrice en lugar de price.

Ejemplo: 1.5

percentageOfCart Grupo 2 Número

Es la tarifa expresada como porcentaje del valor del carrito. Los valores aceptables son números de punto flotante entre 0 y 100, inclusive.

Ejemplo: 9.00

pricePerMeter Grupo 3 Número

Tarifa por metro para la distancia radial del usuario. P.ej., si la distancia al usuario es de 5 km y la tarifa es de USD 0.001, la tarifa del usuario será de USD 5.

Ejemplo: 0.001

En el siguiente ejemplo, se muestra un elemento Fee:

Ejemplo 1

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "price": 5
}

Ejemplo 2

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "pricePerMeter": 0.0005,
  "basePrice": 4
}

Ejemplo 3

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "pricePerMeter": 0.0005,
  "basePrice": 4,
  "minPrice": 5,
  "maxPrice": 50
}

Ejemplo 4

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "percentageOfCart": 5,
  "basePrice": 4
}

Ejemplo 5

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "percentageOfCart": 5,
  "basePrice": 4,
  "minPrice": 5,
  "maxPrice": 50
}

Una entidad obligatoria para implementar. Describe un menú.

En la siguiente tabla, se enumeran las propiedades del tipo Menu:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: Menu

@id String

Obligatorio.

Es un identificador único del menú.

Ejemplo: menu_1

name String

Es el texto que puede identificar el menú cuando un usuario explora el menú.

Ejemplo: Foo

disclaimer String

Renuncia de responsabilidad del menú. Por ejemplo, la divulgación de información nutricional y la divulgación de alérgenos.

Ejemplo: Items may contain peanuts.

disclaimerUrl URL

URL que dirige a una página que proporciona más detalles sobre la renuncia de responsabilidad.

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de entidades de menú en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

En el siguiente ejemplo, se muestra un elemento Menu:

{
  "@type": "Menu",
  "@id": "10824"
}

Una entidad opcional para implementar. Describe una sección particular del menú.

En la siguiente tabla, se enumeran las propiedades del tipo MenuSection:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: MenuSection

@id String

Obligatorio.

Un identificador único de la sección del menú.

Ejemplo: menu_section_1

menuId Lista<ReverseReference>

El valor @id de la entidad de menú se correlaciona con esta entidad MenuSection.

Ejemplo: [ { "@id": "menu_id", "displayOrder": 4 } ]

menuSectionId List<String>

Es una lista de los valores @id de las entidades MenuSection secundarias que corresponden a esta entidad MenuSection.

Importante: Solo debes usar una referencia de menuSectionId o parentMenuSectionId(in child).

Ejemplo: [ "child_menu_section_1", "child_menu_section_2" ]

parentMenuSectionId Lista<ReverseReference>

El valor @id de la entidad principal MenuSection correlacionado con esta entidad MenuSection.

Importante: Solo debes usar una referencia de parentMenuSectionId o menuSectionId(in parent).

Ejemplo: [ { "@id": "parent_menu_section_id", "displayOrder": 4 } ]

name String

Obligatorio.

Es el texto que puede identificar el elemento MenuSection cuando un usuario explora el menú.

Ejemplo: Foo

description String

Es una descripción de la sección del menú.

Ejemplo: Example menu section description that helps users.

image URL

La URL de una imagen de la sección del menú.

Ejemplo: https://provider.com/someimage

menuItemId List<String>

Es una lista de los valores @id de las entidades MenuItem que corresponden a esta entidad MenuSection.

Importante: Solo debes usar una referencia de menuItemId o MenuItem.parentMenuSectionId.

Ejemplo: [ "menu_item1", "menu_item2" ]

parentMenuItemId Lista<ReverseReference>

Es una lista de los valores @id de las entidades principales MenuItem que corresponden a esta entidad MenuSection.

Importante: Solo debes usar una referencia de parentMenuItemId o MenuItem.menuAddOnId.

Ejemplo: [ { "@id": "parent_menu_item_id", "displayOrder": 4 } ]

parentMenuItemOptionId Lista<ReverseReference>

Es una lista de los valores @id de las entidades principales MenuItemOption que corresponden a esta entidad MenuSection.

Importante: Solo debes usar una referencia de parentMenuItemOptionId o MenuItemOption.menuAddOnId.

Ejemplo: [ { "@id": "parent_menu_item_option_id", "displayOrder": 4 } ]

eligibleQuantityMax Número entero

La cantidad máxima de complementos que se pueden seleccionar en la sección de complementos.

Ejemplo: 5

eligibleQuantityMin Número entero

La cantidad mínima de complementos que se deben seleccionar en la sección de complementos.

Ejemplo: 1

defaultItemId List<String>

Una lista de @id que hace referencia a las entidades MenuItem que se preseleccionarán de forma predeterminada para los usuarios del complemento MenuSection. Los usuarios pueden cambiar las selecciones finales. Si no se especifica defaultItemId, no se preselecciona ningún MenuItem.

Ejemplo: [ "item1", "item2" ]

availabilityId List<String>

Son los valores @id de las entidades de disponibilidad que proporcionan detalles sobre cuándo está disponible la sección del menú.

Ejemplo: [ "menu_availability_1" ]

numberOfFreeAddOns Número entero

Indica la cantidad de complementos que un usuario puede seleccionar sin cargo. Solo es válido para las secciones del menú de complementos.

Ejemplo: 3

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de entidad MenuSection en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

applicableServiceType Lista<ServiceType>

Es el servicio al que se aplica este MenuSection. El valor predeterminado supone un MenuSection aplicable a todos.

offeredById List<String>

Los valores @id de las entidades Restaurant en las que está disponible MenuSection. El valor predeterminado supone que un MenuSection está disponible en todas las ubicaciones.

Ejemplo: [ "restaurant_id_1", "restaurant_id_55" ]

En el siguiente ejemplo, se muestra un elemento MenuSection:

{
  "@type": "MenuSection",
  "@id": "853705",
  "menuId": [
    {
      "@id": "10824",
      "displayOrder": 853705
    }
  ],
  "menuSectionId": [
    12345,
    43645
  ],
  "name": "Pasta",
  "applicableServiceType": [
    "TAKEOUT"
  ],
  "offeredById": [
    "italian_restaurant_location_1"
  ]
}
{
  "@type": "MenuSection",
  "@id": "427484",
  "menuId": [
    {
      "@id": "4287",
      "displayOrder": 964376
    }
  ],
  "menuItemId": [
    46784,
    42728
  ],
  "name": "Burger",
  "applicableServiceType": [
    "TAKEOUT",
    "DELIVERY"
  ]
}
{
  "@type": "MenuSection",
  "@id": "3138486",
  "name": "Choose a side:",
  "parentMenuItemId": [
    {
      "@id": "6680295",
      "displayOrder": 3138486
    }
  ],
  "eligibleQuantityMax": "5",
  "numberOfFreeAddOns": "2"
}
{
  "@type": "MenuSection",
  "@id": "3138482",
  "name": "Additional Pizza Toppings",
  "parentMenuItemId": [
    {
      "@id": "6680246",
      "displayOrder": 3138482
    }
  ],
  "eligibleQuantityMax": "3"
}

Disponibilidad

Una entidad opcional para implementar. Describe el período durante el cual se entrega una entidad MenuSection.

En la siguiente tabla, se enumeran las propiedades del tipo Availability:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: Availability

@id String

Obligatorio.

Es un identificador único de la entidad que describe la disponibilidad de la sección del menú.

Ejemplo: menu_section_avail_1

availabilityStarts Hora ISO (local)

La marca de tiempo ISO que indica la hora de inicio en la que es válida la disponibilidad de la sección de menú.

Ejemplo: T00:00

availabilityEnds Hora ISO (local)

La marca de tiempo ISO que indica la hora de finalización después de la cual la disponibilidad de la sección de menú no es válida.

Ejemplo: T16:00

availableDay Lista<DayOfWeek>

Una lista de los días de la semana en los que la disponibilidad de la sección de menú es válida.

Ejemplo: [ "MONDAY", "TUESDAY" ]

validFrom Marca de tiempo ISO

Una marca de tiempo ISO que indica la hora de inicio en la que es válida la disponibilidad de la sección de menú.

Ejemplo: 2017-01-01T00:00:00-07:00

validThrough Marca de tiempo ISO

Una marca de tiempo ISO que indica la hora de finalización después de la cual la disponibilidad de la sección de menú no es válida.

Ejemplo: 2017-01-02T00:00:00-07:00

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de entidad de disponibilidad en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

En el siguiente ejemplo, se muestra un elemento Availability:

Ejemplo

{
  "@type": "Availability",
  "@id": "85343705",
  "availabilityStarts": "06:00",
  "availabilityEnds": "22:30",
  "availableDay": [
    "SATURDAY",
    "SUNDAY"
  ]
}

Una entidad obligatoria para implementar. Describe un elemento de una entidad Menu.

En la siguiente tabla, se enumeran las propiedades del tipo MenuItem:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: MenuItem

@id String

Obligatorio.

Un identificador único del elemento de menú.

Ejemplo: menu_item_1

name String

Obligatorio.

Es el texto que puede identificar el elemento MenuItem cuando un usuario explora el menú.

Ejemplo: Foo

description String

Es una descripción del elemento del menú.

Ejemplo: Foo

image URL

Una URL de una imagen del elemento de menú.

Ejemplo: http://someprovider.com/someimage

parentMenuSectionId Lista<ReverseReference>

Es una lista de los valores @id de las entidades principales MenuSection que corresponden a esta entidad MenuItem.

Importante: Solo debes usar una referencia de parentMenuSectionId o MenuSection.menuItemId.

Ejemplo: { "@id": "menu_section_parent_id", "displayOrder": 4 }

menuAddOnId List<String>

Es una lista de los valores @id de las entidades MenuSection que son de la sección de complementos y que corresponden a esta entidad MenuItem.

Importante: Solo debes usar una referencia de menuAddOnId o MenuSection.parentMenuItemId.

Ejemplo: menu_addon_1

nutrition NutritionInformation

Información nutricional del plato, en particular las calorías.

Ejemplo: { "calories": "120-150 Cal" }

allergen Lista<Allergen>

Alérgenos de este elemento de menú.

Ejemplo: [ { "allergenType": "PEANUTS", "levelOfContainment": "MAY_CONTAIN" } ]

additive Lista<Additive>

Aditivos de este MenuItem.

Ejemplo: [ { "additiveName": "Sodium nitrite", "levelOfContainment": "CONTAINS" } ]

suitableDiet Lista<RestrictedDiet>

El plato cumple con la restricción alimentaria descrita.

Ejemplo: [ "DIABETIC", "GLUTEN_FREE" ]

depositInfo DepositInfo

Información de empaquetado y reciclaje de este elemento de menú.

Ejemplo: { "depositCode": "RECYCLABLE", "depositValue": "0.05", "depositValueCurrency": "USD" }

numberOfServings Número entero

Cantidad de porciones disponibles en un elemento del menú determinado.

Ejemplo: 2

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de entidad MenuItem en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

En el siguiente ejemplo, se muestra un elemento MenuItem:

{
  "@type": "MenuItem",
  "@id": "18931508",
  "name": "Sauteed Baby Spinach",
  "parentMenuSectionId": [
    {
      "@id": "3138479",
      "displayOrder": 18931508
    }
  ]
}
{
  "@type": "MenuItem",
  "@id": "18931508",
  "name": "Hamburger",
  "parentMenuSectionId": [
    {
      "@id": "4645747",
      "displayOrder": 12345
    }
  ],
  "nutrition": {
    "calories": "400 cal"
  },
  "allergen": [
    {
      "allergenType": "GLUTEN",
      "levelOfContainment": "CONTAINS"
    }
  ],
  "additive": [
    {
      "additiveName": "Sodium nitrite",
      "levelOfContainment": "CONTAINS"
    }
  ],
  "suitableDiet": [
    "DIABETIC",
    "LOW_FAT"
  ]
}

Una entidad opcional para implementar. Describe las elecciones que un usuario tendría que tomar al seleccionar un plato o combo. El usuario debe seleccionar una opción; de lo contrario, el pedido se considerará no válido (p.ej., el usuario debe elegir pequeño, mediano o grande para una pizza).

En la siguiente tabla, se enumeran las propiedades del tipo MenuItemOption:

Propiedad Tipo Descripción
@type Const.

Valor: MenuItemOption

@id String

Obligatorio.

Un identificador único de la opción del elemento de menú.

Ejemplo: menu_item_1_option

menuItemId ReverseReference

Obligatorio.

El valor @id de la entidad MenuItem se correlaciona con esta entidad MenuItemOption.

Ejemplo: { "@id": "menu_item_1", "displayOrder": 4 }

optionType OptionType

Es una cadena que indica si la opción del elemento de menú está categorizada por tamaño, opción o lado de la pizza. Los valores aceptables son "SIZE", "OPTION" y "PIZZA_SIDE". "SIZE": Es el tamaño de MenuItemOption. Por ejemplo, pequeño, mediano o grande. "OPCIÓN": Cualquier variación que no sea el tamaño (p.ej., un plato que se prepara como ensalada o sándwich). Si no puedes distinguir entre "SIZE" y "OPTION", utiliza "OPTION". "PIZZA_SIDE": Específico para las pizzas. Por ejemplo, este MenuItemOption solo es válido para una porción o pizza entera (p. ej., con champiñones del lado izquierdo, del lado derecho o de pizza completa).

Ejemplo: SIZE

value String o PizzaSide

Es obligatorio cuando optionType is defined.

Es un valor de cadena o de enumeración. Los valores de enumeración son específicos del tipo de opción PIZZA_SIDE.

applicableParentOptionValue String

Es una cadena que contiene el valor de opción del elemento principal para el que esta opción está disponible.

Ejemplo: Small

menuAddOnId List<String>

Es una lista de los valores @id de las entidades MenuSection que son de la sección de complementos y que corresponden a esta entidad MenuItemOption.

Importante: Solo debes usar una referencia de menuAddOnId o MenuSection.parentMenuItemId.

Ejemplo: menuAddOnId

nutrition NutritionInformation

Información nutricional del plato, en particular las calorías.

Ejemplo: { "calories": "120-150 Cal" }

allergen Lista<Allergen>

Alérgenos de este elemento de menú.

Ejemplo: { "allergenType": "PEANUTS", "levelOfContainment": "MAY_CONTAIN" }

additive Lista<Additive>

Aditivos de este MenuItem.

Ejemplo: { "additiveName": "Sodium nitrite", "levelOfContainment": "CONTAINS" }

depositInfo DepositInfo

La información de empaquetado y reciclado de este MenuItem.

Ejemplo: { "depositCode": "RECYCLABLE", "depositValue": "0.05", "depositValueCurrency": "USD" }

numberOfServings Número entero

Cantidad de porciones disponibles en una opción de elemento del menú determinada.

Ejemplo: 2

dateModified Marca de tiempo ISO

La fecha y hora de última modificación del feed de entidades MenuItemOption en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

En el siguiente ejemplo, se muestra un elemento MenuItemOption:

{
  "@type": "MenuItemOption",
  "@id": "56177944",
  "menuItemId": {
    "@id": "18930213",
    "displayOrder": 1234
  },
  "optionType": "PIZZA_SIDE",
  "value": "PIZZA_SIDE_LEFT"
}
{
  "@type": "MenuItemOption",
  "@id": "56177944",
  "menuItemId": {
    "@id": "18930213",
    "displayOrder": 1234
  },
  "applicableParentOptionValue": "Small Pizza"
}

Una entidad obligatoria para implementar. Describe una oferta para una entidad MenuItem o MenuItemOption.

En la siguiente tabla, se enumeran las propiedades del tipo MenuItemOffer:

Propiedad Tipo Descripción
@type Const.

Obligatorio.

Valor: MenuItemOffer

@id String

Obligatorio.

Es un identificador único de la oferta del elemento del menú.

Ejemplo: menu_item_offer

sku String

Obligatorio.

Es un identificador de la oferta del elemento del menú. Los valores de los SKU pueden ser distintos o iguales en múltiples entidades de oferta de elementos del menú. El valor del SKU se establecerá en orden cuando te llamemos a la API.

Ejemplo: Menu_item_offer_sku

price Número

Obligatorio.

Es el precio de la oferta del elemento del menú.

Ejemplo: 2.5

priceCurrency String

Obligatorio.

Corresponde al código de moneda ISO 4217 de 3 letras.

Ejemplo: USD

availabilityId List<String>

Son los valores @id de las entidades de disponibilidad que proporcionan detalles sobre cuándo está disponible la oferta del elemento de menú.

Ejemplo: [ "menu_availability_1" ]

eligibleQuantityMin Número

La cantidad mínima de pedido para la que MenuItemOffer es válido.

Ejemplo: 1

eligibleQuantityMax Número

La cantidad máxima de pedido para la que MenuItemOffer es válido.

Ejemplo: 25

inventoryLevel Número

El nivel de inventario actual aproximado para el elemento o los elementos correspondientes a esta MenuItemOffer.

Ejemplo: 10

dateModified Marca de tiempo ISO

La fecha y hora modificadas por última vez del feed de entidad MenuItemOffer en formato de marca de tiempo ISO, pero con el tipo String.

Ejemplo: 2017-01-02T00:00:00-07:00

applicableServiceType Lista<ServiceType>

Es el servicio al que se aplica este MenuItemOffer. El valor predeterminado supone un MenuItemOffer aplicable a todos.

offeredById List<String>

Los valores @id de las entidades Restaurant en las que está disponible MenuItemOffer. El valor predeterminado supone que un MenuItemOffer está disponible en todas las ubicaciones.

Ejemplo: [ "restaurant_id_5", "restaurant_id_26" ]

Se requiere exactamente uno de los siguientes grupos de propiedades.
menuItemId Grupo 1 String

El valor @id de la entidad MenuItem se correlaciona con esta entidad MenuItemOffer.

Ejemplo: menu_item_1

menuItemOptionId Grupo 2 String

El valor @id de la entidad MenuItemOption se correlaciona con esta entidad MenuItemOffer.

Ejemplo: menu_item_option_1

En el siguiente ejemplo, se muestra un elemento MenuItemOffer:

{
  "@type": "MenuItemOffer",
  "@id": "6680262",
  "sku": "offer-mediterranean-bagel",
  "menuItemId": "896532",
  "price": 15.5,
  "priceCurrency": "USD",
  "applicableServiceType": [
    "DELIVERY"
  ],
  "offeredById": [
    "bagel_shop_location_5"
  ]
}

Común

ReverseReference

En la siguiente tabla, se enumeran las propiedades del tipo ReverseReference:

Propiedad Tipo Descripción
@id String

Obligatorio.

@id de la entidad principal.

displayOrder Número entero

Obligatorio.

Muestra el orden del elemento dentro del elemento superior.

NutritionInformation

En la siguiente tabla, se enumeran las propiedades del tipo NutritionInformation:

Propiedad Tipo Descripción
description String

Información nutricional en texto libre Por ejemplo, “Contiene conservantes”.

calories String

La cantidad de calorías en calorías, kcal o kJ, con el siguiente formato: valor Cal o min-max.

Ejemplo: 120.34 Cal

sodiumContent String

La cantidad de mg o g de sodio, en el siguiente formato: valor g o min-max g

Ejemplo: 1200 mg

En el siguiente ejemplo, se muestra un elemento NutritionInformation:

Ejemplo

{
  "calories": "120-150 Cal",
  "sodiumContent": "100 mg"
}

Alérgeno

En la siguiente tabla, se enumeran las propiedades del tipo Allergen:

Propiedad Tipo Descripción
allergenType AllergenType

Obligatorio.

Tipo de alérgeno.

levelOfContainment ContainmentLevel

Nivel de un alérgeno determinado en el elemento del menú.

En el siguiente ejemplo, se muestra un elemento Allergen:

Ejemplo

{
  "allergenType": "PEANUTS",
  "levelOfContainment": "MAY_CONTAIN"
}

Aditiva

En la siguiente tabla, se enumeran las propiedades del tipo Additive:

Propiedad Tipo Descripción
additiveName String

Obligatorio.

Es el nombre del aditivo.

levelOfContainment ContainmentLevel

Nivel de un aditivo determinado en el elemento de menú.

En el siguiente ejemplo, se muestra un elemento Additive:

Ejemplo

{
  "additiveName": "Sodium nitrite",
  "levelOfContainment": "CONTAINS"
}

DepositInfo

En la siguiente tabla, se enumeran las propiedades del tipo DepositInfo:

Propiedad Tipo Descripción
depositCode DepositCode

Código de depósito.

depositValue Número

Valor numérico del depósito del elemento, por ejemplo, cuando se recicla.

depositValueCurrency String

Moneda del valor del depósito

En el siguiente ejemplo, se muestra un elemento DepositInfo:

Ejemplo

{
  "depositCode": "RECYCLABLE",
  "depositValue": 0.05,
  "depositValueCurrency": "USD"
}

ServingConfig

Es la configuración de entrega del servicio que se usa para controlar varias funciones (p. ej., inhabilitar el widget promocional, etcétera).

En la siguiente tabla, se enumeran las propiedades del tipo ServingConfig:

Propiedad Tipo Descripción
disableOrderInstructions Booleano

Oculta la capacidad de especificar instrucciones de pedido.

disableMenuItemSpecialInstructions Booleano

Oculta la capacidad de especificar instrucciones especiales en un elemento de menú.

disableTipWidget Booleano

Oculta el widget de propina en la página “Realizar pedido” del flujo de pedidos.

disablePromoWidget Booleano

Oculta el widget promocional en la página “Realizar pedido” del flujo de pedidos.

menuItemSpecialInstructionsMaxLength Número

Especifica la cantidad máxima de caracteres que puede contener una instrucción especial de un elemento de menú.

orderInstructionsMaxLength Número

Especifica la cantidad máxima de caracteres que puede contener una instrucción de pedido.

En el siguiente ejemplo, se muestra un elemento ServingConfig:

Ejemplo 1

{
  "disableMenuItemSpecialInstructions": true
}

Ejemplo 2

{
  "disableTipWidget": true,
  "disablePromoWidget": true
}

Ejemplo 3

{
  "menuItemSpecialInstructionsMaxLength": 250,
  "orderInstructionsMaxLength": 1000
}

Enumeradores

DayOfWeek

El tipo DayOfWeek tiene los siguientes valores posibles:

  • MONDAY
  • TUESDAY
  • WEDNESDAY
  • THURSDAY
  • FRIDAY
  • SATURDAY
  • SUNDAY

ServiceType

El tipo ServiceType tiene los siguientes valores posibles:

  • DELIVERY
  • TAKEOUT

OrderType

El tipo OrderType tiene los siguientes valores posibles:

  • ASAP
  • ADVANCE

FeeType

El tipo FeeType tiene los siguientes valores posibles:

  • DELIVERY
  • SERVICE

OptionType

El tipo OptionType tiene los siguientes valores posibles:

  • SIZE
  • OPTION
  • PIZZA_SIDE

PizzaSide

El tipo PizzaSide tiene los siguientes valores posibles:

  • PIZZA_SIDE_LEFT
  • PIZZA_SIDE_RIGHT
  • PIZZA_SIDE_WHOLE

AllergenType

Tipo de alérgenos por gs1:AllergenTypeCode.

El tipo AllergenType tiene los siguientes valores posibles:

  • ALMONDS
  • ALPHA_ISOMETHYL_IONONE
  • ALCOHOL
  • AMYL_CINNAMAL
  • ANISE_ALCOHOL
  • BARLEY
  • BENZYL_ALCOHOL
  • BENZYL_BENZOATE
  • BENZYL_CINNAMATE
  • BENZYL_SALICYLATE
  • BRAZIL_NUTS
  • BUTYLPHENYL_METHYLPROPIONATE
  • CARROTS
  • CASHEW_NUTS
  • CELERY
  • CEREALS_CONTAINING_GLUTEN
  • CINNAMAL
  • CINNAMYL_ALCOHOL
  • CITRAL
  • CITRONELLOL
  • COCOA
  • CORIANDER
  • CORN
  • COUMARIN
  • CRUSTACEANS
  • EGGS
  • EUGENOL
  • EVERNIA_FURFURACEA
  • EVERNIA_PRUNASTRI
  • FARNESOL
  • FISH
  • GERANIOL
  • GLUTEN
  • HAZELNUTS
  • HEXYL_CINNAMAL
  • HYDROXYCITRONELLAL
  • HYDROXYISOHEXYL_3_CYCLOHEXENE_CARBOXALDEHYDE_ISOEUGENOL_LIMONENE_LINAL
  • KAMUT
  • LACTOSE
  • LUPINE
  • MACADAMIA_NUTS
  • METHYL_2_OCTYNOATE
  • MILK
  • MOLLUSCS
  • MUSTARD
  • NO_DECLARED_ALLERGENS
  • OAT
  • PEANUTS
  • PEAS
  • PECAN_NUTS
  • PISTACHIOS
  • POD_FRUITS
  • QUEENSLAND_NUTS
  • RYE
  • SESAME_SEEDS
  • SOYBEANS
  • SPELT
  • SULPHUR_DIOXIDE
  • TREE_NUTS
  • TREE_NUT_TRACES
  • WALNUTS
  • WHEAT

ContainmentLevel

El tipo ContainmentLevel tiene los siguientes valores posibles:

  • CONTAINS
  • FREE_FROM
  • MAY_CONTAIN

DepositCode

El tipo DepositCode tiene los siguientes valores posibles:

  • REUSABLE
  • RECYCLABLE

DealType

La categoría del acuerdo al que se aplicará el descuento. La categoría puede ser el total del carrito o las tarifas de envío.

El tipo DealType tiene los siguientes valores posibles:

  • CART_OFF
  • DELIVERY_OFF

RestrictedDiet

Tipos de dietas restringidas por schema.org:RestrictedDiet.

El tipo RestrictedDiet tiene los siguientes valores posibles:

  • DIABETIC
  • GLUTEN_FREE
  • HALAL
  • HINDU
  • KOSHER
  • LOW_CALORIE
  • LOW_FAT
  • LOW_LACTOSE
  • LOW_SALT
  • VEGAN
  • VEGETARIAN