Esquema de inventario relacional

En esta página, se describe el formato de los feeds de datos de pedidos de extremo a extremo (Especificación del catálogo de alimentos) que proporcionas a Google. Para obtener una versión legible por máquinas de esta información, puedes descargar el esquema JSON.

Requisitos generales

Las entidades deben estar estructuradas para que se muestren en una línea por entidad en los feeds (las entidades se separan 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 tener la siguiente estructura de código:

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

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

Cualquier subentidad se puede volver a usar en varios restaurantes.

Lineamientos para los valores JSON

Coerción de tipos

El tipo de un 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 valores de cadena y de números enteros como entrada. Del mismo modo, las propiedades de número entero pueden aceptar un valor de cadena, siempre que la cadena se pueda analizar en un número entero válido.

La coerción de tipos 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 DateTime 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 también 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 determinada, también se basa en el tipo de schema.org y debe seguir el formato ISO 8601. El tiempo usa 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 es parte del formato y es obligatorio.
  • Se debe especificar la zona horaria para DATETIME. No es obligatorio para TIME.
  • La hora se debe especificar en la hora local del restaurante o servicio.

Datos del restaurante

Restaurante (obligatorio)

Es 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 proveedor de entrega.

Ejemplo: restaurant_1

name String

Obligatorio.

Es el nombre del restaurante.

Ejemplo: Foo

description String

Es una descripción del restaurante.

Ejemplo: Best seafood in town

url URL

Es la URL que representa el restaurante. Se prefiere el dominio del restaurante al del agregador.

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

sameAs URL

El sitio web oficial del restaurante.

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

telephone String

Es el número de teléfono del restaurante.

Ejemplo: +12345665898

streetAddress String

Obligatorio.

Indica la dirección del restaurante.

Ejemplo: 12345 Bar Avenu

addressLocality String

Obligatorio.

Es la localidad o ciudad.

Ejemplo: San Francisco

addressRegion String

Obligatorio.

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 están restringidos 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 están restringidos al rango [[-180, 180]]. La precisión debe ser de al menos 5 decimales.

Ejemplo: -120.3895522

dealId Lista<String>

Los Deal aplicables del restaurante

imprint String

El sello editorial de un 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 dar formato 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 se mostrará en la sección Información del comerciante. El texto se puede dar formato con " ".

Ejemplo:

XYZ Corp
123 Main Street
555-555-5555

dateModified Marca de tiempo ISO

La fecha y hora de la última modificación del feed de 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

Son los 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 de la oferta.

Ejemplo: FREEDELIVERY

dealCode String

Obligatorio.

Es el ID de acuerdo único por acuerdo y por socio. Este ID debe identificar de forma exclusiva la oferta en tu sistema de promociones. 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. La opción predeterminada supone que hay una oferta aplicable a todos.

eligibleMaxOrders Número entero

Esta oferta solo es apta cuando el usuario tiene menos o igual a esta cantidad de pedidos realizados con éxito.

availabilityId Lista<String>

Los valores de @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 de la oferta a la que se aplicará el descuento. La categoría puede ser todo el total del carrito, cargos del servicio o cargos de envío.

priceCurrency String

Obligatorio cuando discount is defined.

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 de las Condiciones del Servicio legible por humanos

dateModified Marca de tiempo ISO

Es la fecha y hora de la última modificación del feed de la entidad de oferta en formato de marca de tiempo ISO, pero con el tipo Cadena.

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

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

Valor del descuento en forma de números.

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 pedidos 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.

El tipo de servicio que se ofrece. Los valores posibles son "DELIVERY" o "TAKEOUT".

Ejemplo: DELIVERY

restaurantId String

Obligatorio.

El valor de @id de la entidad Restaurant correlacionado con esta entidad Service

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

Es la fecha y hora de la última modificación del feed de la 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. Usa este tipo 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 durante las festividades).

Ejemplo: true

servingConfig ServingConfig

Configuración de publicación para el servicio que se usa para controlar varias funciones, p. ej., inhabilitar el widget de promoción, etcétera.

actionLinkUrl String

Contiene una URL para un servicio de entrega 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 se debe implementar si la entidad Service asociada tiene serviceType configurado como “ENTREGA”.

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 Lista<String>

Obligatorio.

El valor de @id de la entidad Service correlacionado con esta entidad ServiceArea

Ejemplo: [ "service_1" ]

dateModified Marca de tiempo ISO

Es la fecha y hora de la última modificación del feed de la 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, se puede excluir un código postal de un área de polígono más grande.

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

Es 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 multipolígono se define por un punto de latitud seguido de un punto de longitud. También debes especificar los puntos en el sentido contrario a las manecillas del reloj.

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 de CIRCLE.

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 el período de pedido en el 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 la operación a todas horas y todos los días.

Los atributos opens y closes de OperationHours especifican los horarios de apertura y cierre del sistema en línea que permite a los usuarios realizar pedidos. Dentro del horario de atención 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 opens. Si se especifica una zona horaria, Google ignora esta información. Para obtener más información, consulta 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 pedidos con la que los usuarios pueden acceder al flujo y realizar pedidos lo antes posible o futuros.

Ejemplo: operation_hour_1

serviceId Lista<String>

Obligatorio.

El valor @id de la entidad Service correlacionado con esta entidad 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 del día específica en formato ISO a partir de la cual no se pueden realizar pedidos de los usuarios.

Ejemplo: T16:00

dayOfWeek List<DayOfWeek>

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

Ejemplo: [ "MONDAY", "TUESDAY" ]

validFrom Marca de tiempo ISO

Obligatorio cuando isSpecialHour = true.

Es una marca de tiempo ISO que indica la hora de inicio del período de pedido en el que los usuarios pueden acceder al flujo y realizar pedidos lo antes posible o en el futuro.

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

validThrough Marca de tiempo ISO

Obligatorio cuando isSpecialHour = true.

Una marca de tiempo ISO que indica la hora de finalización del período de pedido después del cual los usuarios no pueden acceder al flujo ni realizar pedidos urgentes o futuros.

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

isSpecialHour Booleano

Es 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 última fecha y hora modificadas del feed de entidad 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
}

ServiceHours (obligatorio)

Describe el período de entrega en el que los usuarios pueden elegir los horarios de entrega (lo antes posible o en horarios futuros). Se requiere la implementación de ServiceHours.

Los atributos opens y closes de OperationHours especifican los horarios de apertura y cierre del sistema en línea que permite a los usuarios realizar pedidos. Dentro del horario de atención 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 deben especificarse en la hora local del servicio. No incluyas una zona horaria en un valor opens. Si se especifica una zona horaria, Google ignora esta información. Para obtener más información, consulta 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 el período de entrega en el que los usuarios pueden elegir los horarios de entrega, es decir, lo antes posible o en horarios futuros.

Ejemplo: service_hour_1

orderType OrderType

Obligatorio.

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

Ejemplo: ASAP

serviceId Lista<String>

Obligatorio.

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

Ejemplo: [ "service_1" ]

operationHoursId Lista<String>

Obligatorio cuando isSpecialHour = false.

El valor de @id de la entidad OperationHours correlacionado con esta entidad 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 del día específica en formato ISO a partir de la cual no se pueden entregar los pedidos de los usuarios.

Ejemplo: T16:00

dayOfWeek List<DayOfWeek>

Es una lista de los días de la semana para los que son válidas estas horas de operación.

Ejemplo: [ "MONDAY", "TUESDAY" ]

validFrom Marca de tiempo ISO

Obligatorio cuando isSpecialHour = true.

Es una marca de tiempo ISO que indica la hora de inicio del período de pedido en el que los usuarios pueden acceder al flujo y realizar pedidos lo antes posible o en el futuro.

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

validThrough Marca de tiempo ISO

Obligatorio cuando isSpecialHour = true.

Una marca de tiempo ISO que indica la hora de finalización del período de pedido después del cual los usuarios no pueden acceder al flujo ni realizar pedidos urgentes o futuros.

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

isSpecialHour Booleano

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

Ejemplo: False

leadTimeMin Número entero

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

Ejemplo: 60

leadTimeMax Número entero

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

Ejemplo: 70

advanceBookingRequirementMin Número entero

Obligatorio cuando orderType = "ADVANCE".

La cantidad mínima de minutos desde el momento en que se puede completar el pedido por adelantado. Por ejemplo, si se necesita un pedido por adelantado de al menos 60 minutos para que se complete, el valor deAdvanceBookingRequirementMin es de 60.

Ejemplo: 15

advanceBookingRequirementMax Número entero

Obligatorio cuando orderType = "ADVANCE".

Es la cantidad máxima de minutos a partir de la hora de pedido en la que se puede entregar el pedido anticipado. Por ejemplo, si se restringe la entrega de un pedido por adelantado más de 2 días después, el valorAdvanceBookingRequirementMax es de 2,880.

Ejemplo: 10080

advanceBookingSlotInterval String

Obligatorio cuando orderType = "ADVANCE".

Es el intervalo entre dos horarios de reserva anticipada consecutivos. Por ejemplo, si los horarios de apertura y cierre son a las 8 a.m. y a las 8 p.m., y el valor de advanceBookingSlotInterval es de 15 minutos, el usuario puede elegir los horarios de entrega de 8 a.m., 8:15 a.m., 8:30 a.m., 8:45 a.m., etcétera, hasta las 8 p.m. La duración se debe especificar como una duración de período ISO. Por ejemplo, "PT15M" significa intervalos de 15 minutos.

Ejemplo: PT15M

dateModified Marca de tiempo ISO

La última fecha y hora modificadas del feed de entidad 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 Lista<String>

Obligatorio.

Es el valor de @id de la entidad Service correlacionada con esta entidad Fee.

Ejemplo: [ "service_1" ]

feeType FeeType

Obligatorio.

Es una cadena que indica si la tarifa se aplica a los pedidos de entrega o de reparación. 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 usa percentageOfCart o pricePerMeter.

Ejemplo: 2.0

minPrice Número

Tarifa mínima, limita el valor de la tarifa cuando se usa percentageOfCart o pricePerMeter.

Ejemplo: 2.0

maxPrice Número

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

Ejemplo: 10.0

eligibleRegion Lista<String>

El @id del área de servicio correspondiente a las regiones geopolíticas para las cuales la tarifa es válida. Usa esta propiedad solo si las tarifas 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 tarifas.

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 volumen de pedidos determinado.

Ejemplo: 10

validFrom Marca de tiempo ISO

Una marca de tiempo ISO que indica la hora de inicio de la validez de la tarifa

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

Es la fecha y hora de la última modificación del feed de la entidad de tarifas en formato de marca de tiempo ISO, pero con el tipo Cadena.

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

priority Número

Un valor positivo distinto de cero. Cuando se aplica más de 1 tarifa al carrito del usuario, la tarifa de prioridad más alta tendrá prioridad sobre las más bajas. 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 como porcentaje del valor del carrito. Los valores aceptables son valores 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
}

Es una entidad necesaria 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 lo explora.

Ejemplo: Foo

disclaimer String

Renuncia de responsabilidad del menú. Por ejemplo, la divulgación de información nutricional y 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

Es la fecha y hora de la última modificación del feed de entidades de menú en formato de marca de tiempo ISO, pero con el tipo Cadena.

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.

Es un identificador único de la sección del menú.

Ejemplo: menu_section_1

menuId Lista<ReverseReference>

El valor de @id de la entidad Menu correlacionado con esta entidad MenuSection

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

menuSectionId Lista<String>

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

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

Ejemplo: [ "child_menu_section_1", "child_menu_section_2" ]

parentMenuSectionId List<ReverseReference>

El valor de @id de la entidad MenuSection superior correlacionada con esta entidad MenuSection.

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

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

name String

Obligatorio.

Es el texto que puede identificar el 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 Lista<String>

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

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

Ejemplo: [ "menu_item1", "menu_item2" ]

parentMenuItemId List<ReverseReference>

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

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

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

parentMenuItemOptionId List<ReverseReference>

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

Importante: Solo debes usar una de las referencias 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

Es la cantidad mínima de complementos que se debe seleccionar en la sección de complementos.

Ejemplo: 1

defaultItemId Lista<String>

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

Ejemplo: [ "item1", "item2" ]

availabilityId Lista<String>

Los valores de @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

Es la fecha y hora de la última modificación del feed de entidades MenuSection en formato de marca de tiempo ISO, pero con el tipo Cadena.

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

applicableServiceType List<ServiceType>

Es el servicio al que se aplica este MenuSection. De forma predeterminada, se supone que MenuSection se aplica a todos.

offeredById Lista<String>

Los valores de @id de las entidades Restaurant en las que está disponible este MenuSection De forma predeterminada, se supone que hay un MenuSection 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

Es una entidad opcional para implementar. Describe el período durante el cual se publica 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)

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

Ejemplo: T00:00

availabilityEnds Hora ISO (local)

Es la marca de tiempo ISO que indica la hora de finalización a partir de la cual la disponibilidad de la sección del menú no es válida.

Ejemplo: T16:00

availableDay List<DayOfWeek>

Es una lista de los días de la semana para los que es válida la disponibilidad de la sección del menú.

Ejemplo: [ "MONDAY", "TUESDAY" ]

validFrom Marca de tiempo ISO

Es una marca de tiempo ISO que indica la hora de inicio en la que es válida la disponibilidad de la sección del 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 del menú no es válida.

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

dateModified Marca de tiempo ISO

Es la fecha y hora de la última modificación del feed de entidades de disponibilidad en formato de marca de tiempo ISO, pero con el tipo Cadena.

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"
  ]
}

Es una entidad obligatoria para implementar. Describe un elemento en 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.

Es un identificador único del elemento de menú.

Ejemplo: menu_item_1

name String

Obligatorio.

Es el texto que puede identificar el MenuItem cuando un usuario está navegando por el menú.

Ejemplo: Foo

description String

Es una descripción del elemento de menú.

Ejemplo: Foo

image URL

Es la URL de una imagen del elemento de menú.

Ejemplo: http://someprovider.com/someimage

parentMenuSectionId List<ReverseReference>

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

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

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

menuAddOnId Lista<String>

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

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

Ejemplo: menu_addon_1

nutrition NutritionInformation

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

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

allergen List<Allergen>

Son los alérgenos de este MenuItem.

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

additive List<Additive>

Aditivos de este MenuItem.

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

suitableDiet List<RestrictedDiet>

El plato cumple con la restricción alimentaria descrita.

Ejemplo: [ "DIABETIC", "GLUTEN_FREE" ]

depositInfo DepositInfo

Información sobre el embalaje y el reciclaje de este elemento del menú.

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

numberOfServings Número entero

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

Ejemplo: 2

dateModified Marca de tiempo ISO

Es la fecha y hora de la última modificación del feed de entidades MenuItem en formato de marca de tiempo ISO, pero con el tipo Cadena.

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"
  ]
}

Es una entidad opcional para implementar. Describe las opciones que un usuario debería elegir cuando selecciona un plato o una combinación. El usuario debe seleccionar una opción; de lo contrario, el pedido se considera no válido (p.ej., el usuario debe elegir una pizza pequeña, mediana o grande).

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

Propiedad Tipo Descripción
@type Const

Valor: MenuItemOption

@id String

Obligatorio.

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

Ejemplo: menu_item_1_option

menuItemId ReverseReference

Obligatorio.

El valor de @id de la entidad MenuItem correlacionada con esta entidad MenuItemOption

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

optionType OptionType

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

Ejemplo: SIZE

value Cadena o PizzaSide

Obligatorio cuando optionType is defined.

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

applicableParentOptionValue String

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

Ejemplo: Small

menuAddOnId Lista<String>

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

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

Ejemplo: menuAddOnId

nutrition NutritionInformation

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

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

allergen List<Allergen>

Son los alérgenos de este MenuItem.

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

additive List<Additive>

Aditivos de este MenuItem.

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

depositInfo DepositInfo

La información de embalaje y reciclaje de este MenuItem.

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

numberOfServings Número entero

Cantidad de porciones disponibles en una opción de un elemento de menú determinado.

Ejemplo: 2

dateModified Marca de tiempo ISO

Es la fecha y hora de la ú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"
}

Es una entidad necesaria 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 de un elemento de menú. Los valores del SKU pueden ser diferentes o iguales en varias entidades de ofertas de elementos del menú. El valor del sku se establecerá en orden cuando te hagamos una llamada 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 Lista<String>

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

Ejemplo: [ "menu_availability_1" ]

eligibleQuantityMin Número

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

Ejemplo: 1

eligibleQuantityMax Número

Es la cantidad máxima de pedidos para la que es válida la MenuItemOffer.

Ejemplo: 25

inventoryLevel Número

Es el nivel de inventario aproximado actual del artículo o los artículos correspondientes a esta MenuItemOffer.

Ejemplo: 10

dateModified Marca de tiempo ISO

La fecha y hora de la última modificación 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. De forma predeterminada, se supone que MenuItemOffer se aplica a todos.

offeredById Lista<String>

Los valores de @id de las entidades Restaurant en las que está disponible este MenuItemOffer De forma predeterminada, se supone que hay un MenuItemOffer 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 de @id de la entidad MenuItem correlacionada con esta entidad MenuItemOffer

Ejemplo: menu_item_1

menuItemOptionId Grupo 2 String

El valor de @id de la entidad MenuItemOption correlacionada 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 superior.

displayOrder Número entero

Obligatorio.

Es el orden de visualización 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

Es la cantidad de calorías en calorías, kcal o kJ, con el siguiente formato: valor en calorías o calorías mínimas y máximas.

Ejemplo: 120.34 Cal

sodiumContent String

Es la cantidad de mg o g de sodio, con el siguiente formato: valor en g o rango mínimo-máximo en 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

Es el 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

Es el 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

Es el valor numérico del depósito del artículo, 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

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 del 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 "Confirmar pedido" del flujo de pedidos.

disablePromoWidget Booleano

Oculta el widget de promoción en la página "Confirmar 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
}

Enumeraciones

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 según 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 de la oferta a la que se aplicará el descuento. La categoría puede ser el total del carrito o los gastos de envío.

El tipo DealType tiene los siguientes valores posibles:

  • CART_OFF
  • DELIVERY_OFF

RestrictedDiet

Tipo de dietas restringidas según 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