Schema dell'inventario relazionale

In questa pagina viene descritto il formato dei feed di dati end-to-end dell'ordine (specifica del catalogo alimentare) che fornisci a Google. Per una versione leggibile di queste informazioni, puoi scaricare lo schema JSON.

Requisiti generali

Le entità devono essere strutturate in modo da essere su una riga per entità nei feed (le entità sono separate da caratteri di nuova riga). Per motivi di leggibilità, gli esempi JSON in questa pagina non seguono questa struttura. Tuttavia, devi seguire questa struttura quando invii i feed. Ad esempio, un'entità del menu deve essere strutturata come il seguente codice:

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

Ogni entità "Ristorante" può avere due entità Servizio (una ciascuna per i tipi di servizio "Consegna" e "Asporto"). Ogni entità "Servizio" può avere una sola entità "Menu".

Le eventuali entità secondarie possono essere riutilizzate in più ristoranti.

Linee guida per i valori JSON

Coercizione del tipo

Un tipo di valore JSON può essere diverso dal tipo definito nello schema, purché il valore possa essere forzato nel tipo richiesto. Ad esempio, le proprietà stringa possono accettare valori sia stringa sia interi come input. Allo stesso modo, le proprietà con numeri interi possono accettare valori di stringa, purché la stringa possa essere analizzata in un numero intero valido.

La coercizione del tipo funziona anche per le proprietà ripetute. Le proprietà ripetute possono accettare valori come input senza essere racchiuse tra parentesi []. Ad esempio, la proprietà OperationHours.serviceId accetta sia "service_id" sia ["service_id"] come input validi.

Valori di data e ora

DateTime si basa sul tipo schema.org e, se non diversamente indicato, deve seguire il formato ISO 8601 e includere data, ora e fuso orario. Utilizza la seguente sintassi per DateTime:

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

Ad esempio:

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 è l'ora locale di un determinato ristorante o sede del servizio, si basa sul tipo schema.org e deve inoltre seguire il formato ISO 8601. L'ora utilizza la seguente sintassi:

// Time format:
THH:MM:SS

Ad esempio:

T08:08:00 // 8:08 AM

Tieni presente quanto segue ogni volta che specifichi un valore DateTime o Time:

  • Il prefisso "T" prima dell'ora fa parte del formato ed è obbligatorio.
  • È necessario specificare il fuso orario per DATETIME. Non è obbligatorio per TIME.
  • L'orario deve essere specificato nell'ora locale del ristorante o servizio.

Dati relativi ai ristoranti

Ristorante (obbligatorio)

Un'entità obbligatoria da implementare. Descrive un ristorante.

Nella tabella seguente sono elencate le proprietà per il tipo Restaurant:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: Restaurant

@id String

obbligatorio.

Un identificatore univoco del ristorante o del fornitore di servizi a domicilio.

Esempio: restaurant_1

name String

obbligatorio.

Nome del ristorante.

Esempio: Foo

description String

Una descrizione del ristorante.

Esempio: Best seafood in town

url URL

L'URL che rappresenta il ristorante. Il dominio del ristorante è preferito rispetto al dominio dell'aggregatore.

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

sameAs URL

Il sito web ufficiale del ristorante.

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

telephone String

Numero di telefono del ristorante.

Esempio: +12345665898

streetAddress String

obbligatorio.

L'indirizzo del ristorante.

Esempio: 12345 Bar Avenu

addressLocality String

obbligatorio.

La località o la città.

Esempio: San Francisco

addressRegion String

obbligatorio.

La regione o lo stato.

Esempio: CA

postalCode String

obbligatorio.

Il codice postale.

Esempio: 94124

addressCountry String

obbligatorio.

Codice paese ISO 3166-1 alpha-2 a due lettere.

Esempio: US

latitude Number

Latitudine in gradi. I valori sono limitati all'intervallo [[-90, 90]]. La precisione deve essere di almeno cinque cifre decimali.

Esempio: 35.7392607

longitude Number

Longitudine in gradi. I valori sono limitati all'intervallo [[-180, 180]]. La precisione deve essere di almeno cinque cifre decimali.

Esempio: -120.3895522

dealId List<String>

Deal applicabili dal ristorante.

imprint String

Un marchio editoriale è una sezione di informazioni aggiuntive sul ristorante, ad esempio nome legale, indirizzo sede legale e numero di registrazione. Queste informazioni possono essere formattate utilizzando " ".

Esempio:

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

Commercial Register: 123456789

economicOperator String

Informazioni sull'operatore economico associate al ristorante, se applicabili. Queste informazioni verranno visualizzate nella sezione Informazioni sul commerciante. Il testo può essere formattato utilizzando " ".

Esempio:

XYZ Corp
123 Main Street
555-555-5555

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed dell'entità Ristorante in formato timestamp ISO ma di tipo Stringa.

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

L'esempio seguente mostra un elemento Restaurant:

Esempio

{
  "@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
}

Deal

Tipi di sconti che possono essere applicati a un carrello.

Nella tabella seguente sono elencate le proprietà per il tipo Deal:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: Deal

@id String

obbligatorio.

Un identificatore univoco del deal.

Esempio: FREEDELIVERY

dealCode String

obbligatorio.

ID deal univoco per deal per partner. Questo ID deve identificare in modo univoco l'offerta nel tuo sistema di promozioni. Google ti invia questo identificatore nel campo promotions.coupon di un CheckoutRequest per la convalida.

Esempio: ADETRE23

applicableServiceType Elenco<ServiceType>

Il servizio a cui si applica questa offerta. Per impostazione predefinita, si presuppone un deal applicabile a tutti.

eligibleMaxOrders Intero

Questo deal è idoneo solo quando il numero di ordini andati a buon fine dell'utente è inferiore o uguale a questo.

availabilityId List<String>

I valori @id delle entità di disponibilità che forniscono dettagli su quando la sezione del menu è disponibile.

Esempio: [ "availability_1" ]

isDisabled Valore booleano

Questo sostituisce altri controlli di validità.

dealType DealType

obbligatorio.

Categoria dell'offerta a cui applicare lo sconto. La categoria può essere il totale dell'intero carrello, le commissioni di servizio o le commissioni di consegna.

priceCurrency String

Obbligatorio quando discount is defined.

Obbligatorio quando eligibleTransactionVolumeMin is defined.

Valuta (nel formato ISO 4217 a tre lettere) dello sconto.

Esempio: USD

eligibleTransactionVolumeMin Number

Volume di transazioni, in un'unità monetaria, per la quale è valida la promozione.

termsOfServiceUrl URL

obbligatorio.

Documentazione leggibile sui Termini di servizio.

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed dell'entità deal in formato timestamp ISO ma di tipo Stringa.

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

È richiesto esattamente uno dei seguenti gruppi di proprietà.
discount Gruppo 1 Number

Valore dello sconto in numero.

discountPercentage Gruppo 2 Number

Valore dello sconto espresso come percentuale del prezzo originale.

L'esempio seguente mostra un elemento Deal:

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

Esempio 2

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

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

Dati di servizio

Servizio (obbligatorio)

Descrive i dettagli del servizio di ordinazione di cibo di un ristorante. Service è un'entità che deve essere implementata.

Nella tabella seguente sono elencate le proprietà per il tipo Service:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: Service

@id String

obbligatorio.

Identificatore per il servizio di fulfillment.

Esempio: service_1

serviceType ServiceType

obbligatorio.

Il tipo di servizio offerto. I valori possibili sono "DELIVERY" o "TAKEOUT".

Esempio: DELIVERY

restaurantId String

obbligatorio.

Il valore @id dell'entità Ristorante correlato a questa entità del Servizio.

Esempio: restaurant_1

menuId String

obbligatorio.

Il valore @id dell'entità Menu correlato a questa entità di servizio.

Esempio: menu_1

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed Entità del servizio in formato timestamp ISO.

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

isDisabled Valore booleano

Indica se l'entità è disabilitata. Utilizza questo tipo solo quando devi disabilitare l'entità a causa di un evento imprevisto e non sai quando il servizio verrà ristabilito (ad es. non utilizzare per le festività).

Esempio: true

servingConfig ServingConfig

Configurazione di pubblicazione per il servizio utilizzato per controllare varie funzionalità, ad esempio la disattivazione del widget promozionale e così via.

actionLinkUrl String

Contiene un URL per un servizio di consegna/estrazione che verrà utilizzato durante la migrazione dall'esperienza di ordinazione di cibo end-to-end al reindirizzamento.

L'esempio seguente mostra un elemento Service:

Esempio 1

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

Esempio 2

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

ServiceArea

Descrive la regione geografica in cui è possibile consegnare il cibo. Questa entità è necessaria per l'implementazione se l'entità Service associata ha serviceType impostato su "DISTRIBUZIONE".

Nella tabella seguente sono elencate le proprietà per il tipo ServiceArea:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: ServiceArea

@id String

obbligatorio.

Un identificatore univoco dell'area coperta dal servizio.

Esempio: service_area_1

serviceId List<String>

obbligatorio.

Il valore @id dell'entità Servizio correlato a questa entità ServiceArea.

Esempio: [ "service_1" ]

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed dell'entità ServiceArea in formato timestamp ISO ma di tipo Stringa.

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

exclude Valore booleano

Escludi questa area coperta dal servizio dalla regione totale di consegna. Ad esempio, un codice postale può essere escluso da un'area poligonale più ampia.

È richiesto esattamente uno dei seguenti gruppi di proprietà.
polygon Gruppo 1 List<String>

Un poligono o un poligono multiplo espresso come una serie di tre o più punti delimitati da spazi. Ti consigliamo di fare in modo che il primo e l'ultimo punto siano uguali, ma non è obbligatorio. Ciascun punto di un poligono o di un poligono multiplo è definito da un punto di latitudine seguito da un punto di longitudine. Devi inoltre specificare i punti in senso antiorario.

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

geoMidpointLatitude Gruppo 2 Number

Indica la coordinata della latitudine al centro dell'area CERCHIA.

Esempio: 37.806000

geoMidpointLongitude Gruppo 2 Number

Indica la coordinata della longitudine al centro dell'area CERCHIA.

Esempio: -122.425592

geoRadius Gruppo 2 Intero

Indica il raggio approssimativo (in metri) dell'area della CERCHIA.

Esempio: 10000

postalCode Gruppo 3 String

Indica il codice postale.

Esempio: 91234

addressCountry Gruppo 3 String

Indica il codice paese alpha-2 nel formato ISO 3166-1 di due lettere

Esempio: US

L'esempio seguente mostra un elemento ServiceArea:

Esempio

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

Orario di apertura (obbligatorio)

Descrive la finestra di ordinazione in cui gli utenti possono accedere al flusso ed effettuare ordini il prima possibile o in futuro. L'implementazione di OperationHours è obbligatoria. Per impostazione predefinita, viene usato lo stesso orario per tutti i giorni.

Gli attributi opens e closes OperationHours specificano gli orari di apertura e chiusura per il sistema online che consente agli utenti di effettuare gli ordini. All'interno di questi orari di sistema online, utilizza ServiceHours per specificare gli orari di apertura e chiusura al momento dell'evasione degli ordini degli utenti.

Gli orari devono essere specificati nell'ora locale del servizio. Non includere un fuso orario in un valore opens. Se viene specificato un fuso orario, Google ignora queste informazioni. Per ulteriori informazioni, consulta la sezione Formati di data e ora.

Nella tabella seguente sono elencate le proprietà per il tipo OperationHours:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: OperationHours

@id String

obbligatorio.

Un identificatore univoco dell'entità che descrive la finestra di ordinazione con cui gli utenti possono accedere al flusso ed effettuare ordini il prima possibile/futuri.

Esempio: operation_hour_1

serviceId List<String>

obbligatorio.

Il valore @id dell'entità Servizio correlato a questa entità OperationHours.

Esempio: [ "service_1" ]

opens Ora ISO (locale)

Indica l'ora specifica del giorno in formato ISO a partire dalla quale possono essere effettuati gli ordini degli utenti.

Esempio: T00:00

closes Ora ISO (locale)

Indica l'ora specifica del giorno in formato ISO oltre la quale non è possibile effettuare gli ordini degli utenti.

Esempio: T16:00

dayOfWeek Elenco<DayOfWeek>

Un elenco dei giorni della settimana per cui sono validi questi orari di apertura. I valori accettati sono "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY" e "SUNDAY".

Esempio: [ "MONDAY", "TUESDAY" ]

validFrom Timestamp ISO

Obbligatorio quando isSpecialHour = true.

Un timestamp ISO che indica l'ora di inizio della finestra di ordinazione da cui gli utenti possono accedere al flusso ed effettuare ordini il prima possibile/futuri.

Esempio: 2017-01-01T00:00:00-07:00

validThrough Timestamp ISO

Obbligatorio quando isSpecialHour = true.

Un timestamp ISO che indica l'ora di fine della finestra di ordinazione oltre la quale gli utenti non possono accedere al flusso ed effettuare ordini il prima possibile/futuri.

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

isSpecialHour Valore booleano

Un valore booleano che indica se l'orario di operatività è riservato agli orari speciali. I valori accettati sono "false" e "true".

Esempio: False

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed dell'entità OperationHours in formato timestamp ISO ma di tipo Stringa.

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

L'esempio seguente mostra un elemento OperationHours:

Esempio 1

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

Esempio 2

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

Orario di servizio (obbligatorio)

Descrive la finestra di evasione in cui gli utenti possono scegliere gli slot di evasione (slot di fulfillment il prima possibile o slot futuri). L'implementazione di ServiceHours è obbligatoria.

Gli attributi opens e closes OperationHours specificano gli orari di apertura e chiusura per il sistema online che consente agli utenti di effettuare gli ordini. All'interno di questi orari di sistema online, utilizza ServiceHours per specificare gli orari di apertura e chiusura al momento dell'evasione degli ordini degli utenti.

Gli orari devono essere specificati nell'ora locale del servizio. Non includere un fuso orario in un valore opens. Se viene specificato un fuso orario, Google ignora queste informazioni. Per ulteriori informazioni, consulta la sezione Formati di data e ora.

Nella tabella seguente sono elencate le proprietà per il tipo ServiceHours:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: ServiceHours

@id String

obbligatorio.

Un identificatore univoco dell'entità che descrive la finestra di evasione degli ordini, che gli utenti possono scegliere tra slot di evasione, ad esempio slot "Appena possibile" o "fuori".

Esempio: service_hour_1

orderType OrderType

obbligatorio.

Una stringa che indica se l'orario di servizio è valido per ordini il più presto possibile o avanzati. I valori accettati sono "ASAP" e "ADVANCE".

Esempio: ASAP

serviceId List<String>

obbligatorio.

Il valore @id dell'entità Servizio correlato a questa entità ServiceHours.

Esempio: [ "service_1" ]

operationHoursId List<String>

Obbligatorio quando isSpecialHour = false.

Il valore @id dell'entità OperationHours correlato a questa entità ServiceHours.

Esempio: [ "operation_hour_1" ]

opens Ora ISO (locale)

Indica l'ora specifica del giorno in formato ISO a partire dalla quale è possibile evadere gli ordini degli utenti.

Esempio: T00:00

closes Ora ISO (locale)

Indica l'ora specifica del giorno in formato ISO oltre la quale non è possibile evadere gli ordini degli utenti.

Esempio: T16:00

dayOfWeek Elenco<DayOfWeek>

Un elenco dei giorni della settimana per cui sono validi questi orari di apertura.

Esempio: [ "MONDAY", "TUESDAY" ]

validFrom Timestamp ISO

Obbligatorio quando isSpecialHour = true.

Un timestamp ISO che indica l'ora di inizio della finestra di ordinazione da cui gli utenti possono accedere al flusso ed effettuare ordini il prima possibile/futuri.

Esempio: 2017-01-01T00:00:00-07:00

validThrough Timestamp ISO

Obbligatorio quando isSpecialHour = true.

Un timestamp ISO che indica l'ora di fine della finestra di ordinazione oltre la quale gli utenti non possono accedere al flusso ed effettuare ordini il prima possibile/futuri.

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

isSpecialHour Valore booleano

Un valore booleano che indica se l'orario di operatività è riservato agli orari speciali. I valori accettati sono "false" e "true".

Esempio: False

leadTimeMin Intero

Tempi di consegna/ritiro minimi stimati, in minuti, una volta effettuato l'ordine il prima possibile. Ti consigliamo vivamente di impostare questa proprietà.

Esempio: 60

leadTimeMax Intero

Tempi di consegna/ritiro massimi stimati, in minuti, una volta effettuato l'ordine il prima possibile. Ti consigliamo vivamente di impostare questa proprietà.

Esempio: 70

advanceBookingRequirementMin Intero

Obbligatorio quando orderType = "ADVANCE".

Il numero minimo di minuti dall'ora in cui è possibile evadere l'ordine in anticipo. Ad esempio, se un ordine anticipato richiede almeno 60 minuti per essere evaso, il requisito di prenotazione anticipata è pari a 60.

Esempio: 15

advanceBookingRequirementMax Intero

Obbligatorio quando orderType = "ADVANCE".

Il numero massimo di minuti dall'ora in cui è possibile evadere l'ordine in anticipo. Ad esempio, se l'evasione di un ordine anticipato non può essere evasa più di due giorni dopo, il valore anticipatiBookingRequestMax è 2880.

Esempio: 10080

advanceBookingSlotInterval String

Obbligatorio quando orderType = "ADVANCE".

Intervallo tra due orari di slot per prenotazione anticipata successivi. Ad esempio, se gli orari di apertura e chiusura sono le 8:00 e le 20:00 e l'intervallo di tempo per l'avanzamento della prenotazione è di 15 minuti, l'utente può scegliere gli orari di evasione degli ordini pari alle 8:00, alle 8:15, alle 8:30, alle 8:45 e così via fino alle 20:00. La durata deve essere specificata come durata del periodo ISO. Ad esempio: "PT15M" indica intervalli di 15 minuti.

Esempio: PT15M

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed dell'entità ServiceHours in formato timestamp ISO ma di tipo Stringa.

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

L'esempio seguente mostra un elemento ServiceHours:

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

Esempio 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
}

A pagamento

Indica un costo. Se l'entità Service associata ha serviceType impostato su "DISTRIBUZIONE", è necessario un Fee con feeType impostato su "DISTRIBUZIONE".

Nella tabella seguente sono elencate le proprietà per il tipo Fee:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: Fee

@id String

obbligatorio.

Un identificatore univoco dell'entità che descrive la tariffa.

Esempio: service_fee_1

serviceId List<String>

obbligatorio.

Il valore @id dell'entità Servizio correlato a questa Entità Tariffa.

Esempio: [ "service_1" ]

feeType FeeType

obbligatorio.

Una stringa che indica se la commissione si applica agli ordini di consegna o di servizio. I valori accettati sono "DISTRIBUZIONE" e "SERVICE".

Esempio: DELIVERY

priceCurrency String

obbligatorio.

Il codice di valuta ISO 4217 di 3 lettere.

Esempio: USD

basePrice Number

Prezzo base della commissione, applicabile quando viene utilizzato percentageOfCart o pricePerMeter.

Esempio: 2.0

minPrice Number

Tariffa minima, limita il valore della tariffa quando viene utilizzato percentageOfCart o pricePerMeter.

Esempio: 2.0

maxPrice Number

Tariffa massima, limita il valore della tariffa quando viene utilizzato percentageOfCart o pricePerMeter.

Esempio: 10.0

eligibleRegion List<String>

L'@id dell'area di servizio per le regioni geopolitiche per le quali è valida la tariffa. Utilizza questa proprietà solo se le spese di consegna variano in base alla regione.

Esempio: [ "service_area_1" ]

eligibleTransactionVolumeMin Number

Il volume minimo di transazioni, in un'unità monetaria, per il quale è valida la specifica della commissione.

Esempio: 50

eligibleTransactionVolumeMax Number

Il volume massimo di transazioni, in un'unità monetaria, per cui è valida questa specifica della commissione. Ad esempio, la commissione non viene applicata se al di sopra di un determinato volume di ordini.

Esempio: 10

validFrom Timestamp ISO

Un timestamp ISO che indica l'ora di inizio del momento in cui la tariffa è valida.

Esempio: 2017-01-01T00:00:00-07:00

validThrough Timestamp ISO

Un timestamp ISO che indica l'ora di fine oltre la quale la tariffa non è valida.

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

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed Entità Tariffa in formato timestamp ISO ma di tipo Stringa.

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

priority Number

Un valore positivo diverso da zero. Se al carrello dell'utente si applica più di una tariffa, la tariffa con priorità più elevata avrà la precedenza su quelle inferiori. Se questo campo viene fornito, la priorità avrà sempre la precedenza su una priorità calcolata.

Esempio: 3

È richiesto esattamente uno dei seguenti gruppi di proprietà.
price Gruppo 1 Number

Prezzo dell'addebito. Se il prezzo non è fisso, è possibile indicare minPrice e maxPrice al posto del prezzo.

Esempio: 1.5

percentageOfCart Gruppo 2 Number

Tariffa in percentuale del valore del carrello. Sono consentiti valori in virgola mobile compresi tra 0 e 100 inclusi.

Esempio: 9.00

pricePerMeter Gruppo 3 Number

Tariffa per metro per la distanza radiale dall'utente. Ad esempio, se la distanza dall'utente è di 5 km e la tariffa è di 0,001 $, la tariffa per l'utente sarà di 5 $.

Esempio: 0.001

L'esempio seguente mostra un elemento Fee:

Esempio 1

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

Esempio 2

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

Esempio 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
}

Esempio 4

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

Esempio 5

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

Un'entità obbligatoria da implementare. Descrive un menu.

Nella tabella seguente sono elencate le proprietà per il tipo Menu:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: Menu

@id String

obbligatorio.

Un identificatore univoco del menu.

Esempio: menu_1

name String

Il testo che può identificare il menu quando un utente naviga nel menu.

Esempio: Foo

disclaimer String

Limitazione di responsabilità per il menu. Ad esempio, divulgazione di informazioni nutrizionali e allergeni.

Esempio: Items may contain peanuts.

disclaimerUrl URL

URL che rimanda a una pagina con ulteriori dettagli sul disclaimer.

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed dell'entità Menu in formato timestamp ISO ma di tipo Stringa.

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

L'esempio seguente mostra un elemento Menu:

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

Un'entità facoltativa da implementare. Descrive una particolare sezione del menu.

Nella tabella seguente sono elencate le proprietà per il tipo MenuSection:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: MenuSection

@id String

obbligatorio.

Un identificatore univoco della sezione del menu.

Esempio: menu_section_1

menuId Elenco<ReverseReference>

Il valore @id dell'entità Menu correlato a questa entità MenuSection.

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

menuSectionId List<String>

Un elenco dei valori @id delle entità MenuSection secondarie che corrispondono a questa entità MenuSection.

Importante: devi utilizzare solo un riferimento menuSectionId o parentMenuSectionId(in child).

Esempio: [ "child_menu_section_1", "child_menu_section_2" ]

parentMenuSectionId Elenco<ReverseReference>

Il valore @id dell'entità MenuSection principale correlato a questa entità MenuSection.

Importante: devi utilizzare solo un riferimento parentMenuSectionId o menuSectionId(in parent).

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

name String

obbligatorio.

Il testo che può identificare il MenuSection quando un utente naviga nel menu.

Esempio: Foo

description String

Una descrizione della sezione del menu.

Esempio: Example menu section description that helps users.

image URL

L'URL di un'immagine della sezione del menu.

Esempio: https://provider.com/someimage

menuItemId List<String>

Un elenco dei valori @id delle entità MenuItem che corrispondono a questa entità MenuSection.

Importante: devi utilizzare solo un riferimento menuItemId o MenuItem.parentMenuSectionId.

Esempio: [ "menu_item1", "menu_item2" ]

parentMenuItemId Elenco<ReverseReference>

Un elenco dei valori @id delle entità MenuItem principali che corrispondono a questa entità MenuSection.

Importante: devi utilizzare solo un riferimento parentMenuItemId o MenuItem.menuAddOnId.

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

parentMenuItemOptionId Elenco<ReverseReference>

Un elenco dei valori @id delle entità MenuItemOption principali che corrispondono a questa entità MenuSection.

Importante: devi utilizzare solo un riferimento parentMenuItemOptionId o MenuItemOption.menuAddOnId.

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

eligibleQuantityMax Intero

Il numero massimo di componenti aggiuntivi che è possibile selezionare nella relativa sezione.

Esempio: 5

eligibleQuantityMin Intero

Il numero minimo di componenti aggiuntivi che deve essere selezionato nella relativa sezione.

Esempio: 1

defaultItemId List<String>

Un elenco di @id che fanno riferimento a entità MenuItem da preselezionare per impostazione predefinita per gli utenti nel componente aggiuntivo MenuSection. Gli utenti possono modificare le selezioni finali. Se defaultItemId non è specificato, non è preselezionato nessun MenuItem.

Esempio: [ "item1", "item2" ]

availabilityId List<String>

I valori @id delle entità di disponibilità che forniscono dettagli su quando la sezione del menu è disponibile.

Esempio: [ "menu_availability_1" ]

numberOfFreeAddOns Intero

Indica il numero di componenti aggiuntivi che un utente può selezionare senza costi. Valido solo per le sezioni del menu aggiuntive.

Esempio: 3

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed dell'entità MenuSection in formato timestamp ISO ma di tipo Stringa.

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

applicableServiceType Elenco<ServiceType>

Il servizio a cui è applicabile questo MenuSection. Per impostazione predefinita, si presuppone un valore MenuSection applicabile a tutti.

offeredById List<String>

I valori @id di Restaurant entità in cui è disponibile questo MenuSection. Per impostazione predefinita, si presuppone che sia disponibile un MenuSection in tutte le località.

Esempio: [ "restaurant_id_1", "restaurant_id_55" ]

L'esempio seguente mostra 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"
}

Disponibilità

Un'entità facoltativa da implementare. Descrive il periodo di tempo durante il quale viene pubblicata un'entità MenuSection.

Nella tabella seguente sono elencate le proprietà per il tipo Availability:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: Availability

@id String

obbligatorio.

Un identificatore univoco dell'entità che descrive la disponibilità della sezione del menu.

Esempio: menu_section_avail_1

availabilityStarts Ora ISO (locale)

Il timestamp ISO che indica l'ora di inizio in cui la disponibilità della sezione del menu è valida.

Esempio: T00:00

availabilityEnds Ora ISO (locale)

Il timestamp ISO che indica l'ora di fine oltre la quale la disponibilità della sezione del menu non è valida.

Esempio: T16:00

availableDay Elenco<DayOfWeek>

Un elenco dei giorni della settimana per cui è valida la disponibilità della sezione del menu.

Esempio: [ "MONDAY", "TUESDAY" ]

validFrom Timestamp ISO

Un timestamp ISO che indica l'ora di inizio in cui la disponibilità della sezione del menu è valida.

Esempio: 2017-01-01T00:00:00-07:00

validThrough Timestamp ISO

Un timestamp ISO che indica l'ora di fine oltre la quale la disponibilità della sezione del menu non è valida.

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

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed Entità di disponibilità in formato timestamp ISO ma di tipo Stringa.

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

L'esempio seguente mostra un elemento Availability:

Esempio

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

Un'entità obbligatoria da implementare. Descrive un elemento in un'entità Menu.

Nella tabella seguente sono elencate le proprietà per il tipo MenuItem:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: MenuItem

@id String

obbligatorio.

Un identificatore univoco della voce di menu.

Esempio: menu_item_1

name String

obbligatorio.

Il testo che può identificare il MenuItem quando un utente naviga nel menu.

Esempio: Foo

description String

Una descrizione della voce del menu.

Esempio: Foo

image URL

L'URL di un'immagine della voce del menu.

Esempio: http://someprovider.com/someimage

parentMenuSectionId Elenco<ReverseReference>

Un elenco dei valori @id delle entità MenuSection principali che corrispondono a questa entità MenuItem.

Importante: devi utilizzare solo un riferimento parentMenuSectionId o MenuSection.menuItemId.

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

menuAddOnId List<String>

Un elenco dei valori @id delle entità MenuSection provenienti dalla sezione del componente aggiuntivo e corrispondenti a questa entità MenuItem.

Importante: devi utilizzare solo un riferimento menuAddOnId o MenuSection.parentMenuItemId.

Esempio: menu_addon_1

nutrition NutritionInformation

Informazioni nutrizionali del piatto, in particolare le calorie.

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

allergen Elenco<Allergen>

Allergeni di questa voce di menu.

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

additive Elenco<Additive>

Additivi di questa voce di menu.

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

suitableDiet Elenco<RestrictedDiet>

Il piatto rispetta le restrizioni alimentari descritte.

Esempio: [ "DIABETIC", "GLUTEN_FREE" ]

depositInfo DepositInfo

Informazioni su imballaggio e riciclo di questo MenuItem.

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

numberOfServings Intero

Numero di porzioni disponibili in una determinata voce di menu.

Esempio: 2

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed dell'entità MenuItem in formato timestamp ISO ma di tipo Stringa.

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

L'esempio seguente mostra 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"
  ]
}

Un'entità facoltativa da implementare. Descrive le scelte che un utente deve fare quando seleziona un piatto/una combinazione. L'utente deve selezionare un'opzione, altrimenti l'ordine non verrà considerato valido (ad es. per una pizza l'utente deve scegliere una pizza piccola, media o grande).

Nella tabella seguente sono elencate le proprietà per il tipo MenuItemOption:

Proprietà Tipo Descrizione
@type Costante

Valore: MenuItemOption

@id String

obbligatorio.

Un identificatore univoco dell'opzione della voce di menu.

Esempio: menu_item_1_option

menuItemId ReverseReference

obbligatorio.

Il valore @id dell'entità MenuItem correlato a questa entità MenuItemOption.

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

optionType OptionType

Una stringa che indica se l'opzione della voce di menu è classificata per dimensione, opzione o lato pizza. I valori accettati sono "SIZE", "OPTION" e "PIZZA_SIDE". "SIZE": dimensioni di MenuItemOption. ad esempio piccolo, medio o grande. "OPTION": qualsiasi variante diversa dalle dimensioni (ad es. un piatto che viene fornito come insalata o panino). Se non riesci a distinguere tra "SIZE" e "OPTION", utilizza "OPTION". "PIZZA_SIDE": specifica per le pizze, ad esempio MenuItemOption è valido solo per una porzione o per la pizza intera (ad es. condimenti a base di funghi sul lato sinistro o destro oppure pizza intera).

Esempio: SIZE

value Stringa o PizzaSide

Obbligatorio quando optionType is defined.

Un valore stringa o di enumerazione. I valori Enum sono specifici per il tipo di opzione PIZZA_SIDE.

applicableParentOptionValue String

Una stringa contenente il valore dell'opzione dell'elemento principale per il quale questa opzione è disponibile.

Esempio: Small

menuAddOnId List<String>

Un elenco dei valori @id delle entità MenuSection provenienti dalla sezione del componente aggiuntivo e corrispondenti a questa entità MenuItemOption.

Importante: devi utilizzare solo un riferimento menuAddOnId o MenuSection.parentMenuItemId.

Esempio: menuAddOnId

nutrition NutritionInformation

Informazioni nutrizionali del piatto, in particolare le calorie.

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

allergen Elenco<Allergen>

Allergeni di questa voce di menu.

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

additive Elenco<Additive>

Additivi di questa voce di menu.

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

depositInfo DepositInfo

Le informazioni su imballaggio e riciclo di questo Articolo Menu.

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

numberOfServings Intero

Numero di porzioni disponibili in una determinata opzione di voce di menu.

Esempio: 2

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed di entità MenuItemOption in formato timestamp ISO ma di tipo Stringa.

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

L'esempio seguente mostra 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"
}

Un'entità obbligatoria da implementare. Descrive un'offerta per un'entità MenuItem o MenuItemOption.

Nella tabella seguente sono elencate le proprietà per il tipo MenuItemOffer:

Proprietà Tipo Descrizione
@type Costante

obbligatorio.

Valore: MenuItemOffer

@id String

obbligatorio.

Un identificatore univoco dell'offerta della voce di menu.

Esempio: menu_item_offer

sku String

obbligatorio.

Identificatore dell'offerta della voce di menu. I valori SKU potrebbero essere diversi o uguali in più entità di offerta di voci di menu. Il valore SKU verrà impostato in ordine quando effettueremo una chiamata API.

Esempio: Menu_item_offer_sku

price Number

obbligatorio.

Prezzo dell'offerta della voce di menu.

Esempio: 2.5

priceCurrency String

obbligatorio.

Il codice di valuta ISO 4217 di 3 lettere.

Esempio: USD

availabilityId List<String>

I valori @id delle entità di disponibilità che forniscono dettagli su quando l'offerta della voce di menu è disponibile.

Esempio: [ "menu_availability_1" ]

eligibleQuantityMin Number

La quantità minima d'ordine per la quale è valido MenuItemOffer.

Esempio: 1

eligibleQuantityMax Number

La quantità massima d'ordine per la quale è valido MenuItemOffer.

Esempio: 25

inventoryLevel Number

Il livello di inventario approssimativo per l'articolo o gli articoli corrispondenti a questa offerta MenuItemOffer.

Esempio: 10

dateModified Timestamp ISO

La data e l'ora dell'ultima modifica del feed dell'entità MenuItemOffer in formato timestamp ISO ma di tipo Stringa.

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

applicableServiceType Elenco<ServiceType>

Il servizio a cui è applicabile questo MenuItemOffer. Per impostazione predefinita, si presuppone un valore MenuItemOffer applicabile a tutti.

offeredById List<String>

I valori @id di Restaurant entità in cui è disponibile questo MenuItemOffer. Per impostazione predefinita, si presuppone che sia disponibile un MenuItemOffer in tutte le località.

Esempio: [ "restaurant_id_5", "restaurant_id_26" ]

È richiesto esattamente uno dei seguenti gruppi di proprietà.
menuItemId Gruppo 1 String

Il valore @id dell'entità MenuItem correlato a questa entità MenuItemOffer.

Esempio: menu_item_1

menuItemOptionId Gruppo 2 String

Il valore @id dell'entità MenuItemOption correlato a questa entità MenuItemOffer.

Esempio: menu_item_option_1

L'esempio seguente mostra 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"
  ]
}

Comune

ReverseReference

Nella tabella seguente sono elencate le proprietà per il tipo ReverseReference:

Proprietà Tipo Descrizione
@id String

obbligatorio.

@id dell'entità padre.

displayOrder Intero

obbligatorio.

Ordine di visualizzazione degli elementi all'interno dell'elemento principale.

NutritionInformation

Nella tabella seguente sono elencate le proprietà per il tipo NutritionInformation:

Proprietà Tipo Descrizione
description String

Informazioni nutrizionali in testo libero. Ad esempio, "Contiene conservanti".

calories String

Il numero di calorie in Cal, kcal o kJ, con il seguente formato: value Cal o min-max Cal

Esempio: 120.34 Cal

sodiumContent String

Il numero di mg o g di sodio, utilizzando il seguente formato: valore g o min-max g

Esempio: 1200 mg

L'esempio seguente mostra un elemento NutritionInformation:

Esempio

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

Allergeni

Nella tabella seguente sono elencate le proprietà per il tipo Allergen:

Proprietà Tipo Descrizione
allergenType AllergenType

obbligatorio.

Tipo di allergene.

levelOfContainment ContainmentLevel

Livello di un determinato allergene nella voce di menu.

L'esempio seguente mostra un elemento Allergen:

Esempio

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

Additivo

Nella tabella seguente sono elencate le proprietà per il tipo Additive:

Proprietà Tipo Descrizione
additiveName String

obbligatorio.

Nome dell'additivo.

levelOfContainment ContainmentLevel

Livello di un dato additivo nella voce di menu.

L'esempio seguente mostra un elemento Additive:

Esempio

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

DepositInfo

Nella tabella seguente sono elencate le proprietà per il tipo DepositInfo:

Proprietà Tipo Descrizione
depositCode DepositCode

Codice di deposito.

depositValue Number

Valore numerico del deposito dell'articolo, ad esempio in caso di riciclo.

depositValueCurrency String

Valuta del valore del deposito

L'esempio seguente mostra un elemento DepositInfo:

Esempio

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

ServingConfig

Configurazione di pubblicazione per il servizio utilizzato per controllare varie funzionalità, ad esempio la disattivazione del widget promozionale e così via.

Nella tabella seguente sono elencate le proprietà per il tipo ServingConfig:

Proprietà Tipo Descrizione
disableOrderInstructions Valore booleano

Nasconde la possibilità di specificare le istruzioni relative all'ordine.

disableMenuItemSpecialInstructions Valore booleano

Nasconde la possibilità di specificare istruzioni speciali su una voce di menu.

disableTipWidget Valore booleano

Nasconde il widget Suggerimento nella pagina "Effettua ordine" del flusso di ordinazione.

disablePromoWidget Valore booleano

Nasconde il widget promozionale nella pagina "Effettua ordine" del flusso di ordinazione.

menuItemSpecialInstructionsMaxLength Number

Specifica il numero massimo di caratteri che un'istruzione speciale di una voce di menu può contenere.

orderInstructionsMaxLength Number

Specifica il numero massimo di caratteri che può contenere un'istruzione di ordine.

L'esempio seguente mostra un elemento ServingConfig:

Esempio 1

{
  "disableMenuItemSpecialInstructions": true
}

Esempio 2

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

Esempio 3

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

Enum

DayOfWeek

Il tipo DayOfWeek ha i seguenti valori possibili:

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

ServiceType

Il tipo ServiceType ha i seguenti valori possibili:

  • DELIVERY
  • TAKEOUT

OrderType

Il tipo OrderType ha i seguenti valori possibili:

  • ASAP
  • ADVANCE

FeeType

Il tipo FeeType ha i seguenti valori possibili:

  • DELIVERY
  • SERVICE

OptionType

Il tipo OptionType ha i seguenti valori possibili:

  • SIZE
  • OPTION
  • PIZZA_SIDE

PizzaSide

Il tipo PizzaSide ha i seguenti valori possibili:

  • PIZZA_SIDE_LEFT
  • PIZZA_SIDE_RIGHT
  • PIZZA_SIDE_WHOLE

AllergenType

Tipo di allergeni per gs1:AllergenTypeCode.

Il tipo AllergenType ha i seguenti valori possibili:

  • 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

Il tipo ContainmentLevel ha i seguenti valori possibili:

  • CONTAINS
  • FREE_FROM
  • MAY_CONTAIN

DepositCode

Il tipo DepositCode ha i seguenti valori possibili:

  • REUSABLE
  • RECYCLABLE

DealType

Categoria dell'offerta a cui applicare lo sconto. La categoria può essere il totale dell'intero carrello o le spese di consegna.

Il tipo DealType ha i seguenti valori possibili:

  • CART_OFF
  • DELIVERY_OFF

RestrictedDiet

Tipo di diete limitate in base a schema.org:RestrictedDiet.

Il tipo RestrictedDiet ha i seguenti valori possibili:

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