Entità servizio

L'entità Service definisce i servizi di ordinazione di cibo disponibili in un ristorante, ad esempio da asporto o a domicilio. Quando definisci un'entità Service, utilizza il tipo Servizio. Ogni ristorante deve essere collegato ad almeno un'entità di servizio di tipo asporto o consegna a domicilio e al massimo due entità di servizio: una di asporto e una di consegna a domicilio.

Figura 1: Entità di servizio che mostra la relazione con le entità ServiceArea, ServiceHours, OperationHours e Tariffa.

Un'entità Servizio definisce proprietà come il tipo di servizio, le ore disponibili e l'area servita. L'entità servizio dovrebbe cambiare e aggiornare a ogni caricamento del feed di dati.

Esempio di entità di servizio

L'esempio seguente definisce un'entità Service di base che accetta ordini ogni giorno.

Attenzione: ogni entità deve essere definita su una singola riga del feed di dati. Il seguente esempio è formattato per essere più facilmente comprensibile, ma non rappresenta un modo valido per strutturare i dati.

{
  "@type":"Service",
  "@id":"takeout_1",
  "serviceType":"TAKEOUT",
  "menuId":"menu_1",
  "restaurantId":"restaraunt_1"
}
{
  "@type":"OperationHours",
  "@id":"takeout_1_op_hours",
  "serviceId":"takeout_1",
  "opens":"00:00",
  "closes":"23:59"
}
{
  "@type":"ServiceHours",
  "@id":"takeout_1_service_hours",
  "orderType":"ASAP",
  "serviceId":"takeout_1",
  "operationHoursId":"takeout_1_op_hours",
  "opens":"11:00",
  "closes":"21:00",
  "dayOfWeek":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY", "FRIDAY", "SATURDAY"],
  "leadTimeMin":"20",
  "leadTimeMax":"20",
  "isSpecialHour":false
}
{
  "@type":"ServiceHours",
  "@id":"takeout_1_service_hours_sun",
  "orderType":"ASAP",
  "serviceId":"takeout_1",
  "operationHoursId":"takeout_1_op_hours",
  "opens":"16:00",
  "closes":"21:00",
  "dayOfWeek":["SUNDAY"],
  "leadTimeMin":"20",
  "leadTimeMax":"20",
  "isSpecialHour":false
}
{
  "@type":"Service",
  "@id":"delivery_1",
  "serviceType":"DELIVERY",
  "menuId":"10824",
  "restaurantId":"10824"
}
{
  "@type":"OperationHours",
  "@id":"delivery_1_op_hours",
  "serviceId":"delivery_1",
  "opens":"00:00",
  "closes":"23:59"
}
{
  "@type":"ServiceHours",
  "@id":"delivery_1_service_hours",
  "orderType":"ASAP",
  "serviceId":"delivery_1",
  "operationHoursId":"delivery_1_op_hours",
  "opens":"11:00",
  "closes":"21:00",
  "dayOfWeek":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY", "FRIDAY", "SATURDAY",
  "SUNDAY"],
  "leadTimeMin":"50",
  "leadTimeMax":"50",
  "isSpecialHour":false
}
{
  "@type":"ServiceArea",
  "@id":"delivery_1_service_area",
  "serviceId":"delivery_1",
  "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"]
}
{
  "@type":"Fee",
  "@id":"delivery_1_fee",
  "serviceId":"delivery_1",
  "feeType":"DELIVERY",
  "priceCurrency":"USD",
  "eligibleRegion":"delivery_1_service_area",
  "eligibleTransactionVolumeMin":20,
  "percentageOfCart": 7
}

Ore "Appena possibile" e "In anticipo"

Gli utenti possono effettuare ordini il prima possibile durante il ServiceHours il prima possibile del ristorante oppure possono effettuare gli ordini in anticipo all'interno dell'OperationHours del ristorante per poterli evadere in anticipo durante il ServiceHours. Per definire gli orari di servizio anticipati, crea un'entità ServiceHours con la proprietà orderType impostata su ADVANCE. Consulta la sezione Orari di consegna e ritiro per ulteriori dettagli ed esempi.

Disattiva temporaneamente un'entità Service

Puoi sospendere temporaneamente o sovrascrivere ServiceHours per un periodo di tempo specifico noto in anticipo impostando orari festivi e speciali. Per disattivare un'entità Servizio per un motivo imprevisto, invia una richiesta di aggiornamento in tempo reale con la proprietà isDisabled dell'entità Servizio impostata su true.

Per ulteriori dettagli ed esempi, consulta Eliminare e disattivare entità.