Order

L'ordine rappresenta i contenuti di un ordine in corso o completato di un utente.

Rappresentazione JSON 
{
  "items": [
    {
      object (OrderItem)
    }
  ],
  "metadata": {
    object (OrderMetadata)
  },
  "fulfillment": {
    object (OrderFulfillment)
  },
  "priceInfo": {
    object (OrderPriceInfo)
  },
  "externalOrderId": string
}
Campi
items[]

object (OrderItem)

Facoltativo. Gli articoli nell'ordine.
metadata

object (OrderMetadata)

Facoltativo. Altri metadati raccolti o dedotti durante l'ordine.
fulfillment

object (OrderFulfillment)

Facoltativo. Le informazioni sull'evasione dell'ordine.
priceInfo

object (OrderPriceInfo)

Facoltativo. Informazioni sul prezzo dell'ordine.
externalOrderId

string

Solo output. L'identificatore esterno per questo ordine. Compilato solo se è abilitata un'integrazione del punto vendita.

OrderItem

OrderItem specifica lo stato di un articolo che fa parte di un ordine.

Rappresentazione JSON 
{
  "uid": string,
  "itemId": string,
  "displayName": string,
  "image": {
    object (Image)
  },
  "basePrice": {
    object (Money)
  },
  "integrationAttributes": {
    object (ItemIntegrationAttributes)
  },
  "modifierGroups": [
    {
      object (OrderModifierGroup)
    }
  ],
  "quantity": integer
}
Campi
uid

string

Facoltativo. Un identificatore univoco assegnato dal sistema per questo elemento.
itemId

string

Obbligatorio. Identificatore di un elemento nel menu, univoco all'interno del menu.
displayName

string

Solo output. Nome leggibile di questo elemento pubblicitario da mostrare nelle interfacce utente.
image

object (Image)

Solo output. Immagine da visualizzare per questo elemento nell'interfaccia utente.
basePrice

object (Money)

Solo output. Il prezzo base dell'articolo. Questo valore potrebbe essere influenzato dai modificatori selezionati. È il prezzo per unità dell'articolo.
integrationAttributes

object (ItemIntegrationAttributes)

Solo output. Metadati associati a questa entità utilizzati per le integrazioni downstream.
modifierGroups[]

object (OrderModifierGroup)

Facoltativo. ModifierGroups applicati a questo articolo.
quantity

integer

Facoltativo. La quantità di questo articolo nell'ordine.

OrderModifierGroup

OrderModifierGroup specifica lo stato di un ModifierGroup che fa parte di un OrderItem.

Rappresentazione JSON 
{
  "modifierGroupId": string,
  "displayName": string,
  "integrationAttributes": {
    object (ModifierGroupIntegrationAttributes)
  },
  "modifiers": [
    {
      object (OrderModifier)
    }
  ]
}
Campi
modifierGroupId

string

Obbligatorio. Identificatore di questo gruppo di modificatori, univoco all'interno del menu.
displayName

string

Solo output. Il nome del gruppo di modificatori, ad esempio "Condimenti (panino)" o "Contorno per combo medio".
integrationAttributes

object (ModifierGroupIntegrationAttributes)

Solo output. Metadati associati a questa entità utilizzati per le integrazioni downstream.
modifiers[]

object (OrderModifier)

Facoltativo. I modificatori applicati a questo gruppo di modificatori.

OrderModifier

OrderModifier specifica lo stato di un modificatore che fa parte di un OrderModifierGroup.

Rappresentazione JSON 
{
  "uid": string,
  "modifierId": string,
  "displayName": string,
  "priceAdjustment": {
    object (Money)
  },
  "quantity": integer,
  "modifierAction": {
    object (OrderModifierAction)
  },
  "image": {
    object (Image)
  },
  "integrationAttributes": {
    object (ModifierIntegrationAttributes)
  },
  "modifierGroups": [
    {
      object (OrderModifierGroup)
    }
  ]
}
Campi
uid

string

Facoltativo. Un identificatore univoco assegnato dal sistema per questo modificatore.
modifierId

string

Obbligatorio. Identificatore di questo modificatore, univoco all'interno del menu.
displayName

string

Solo output. Il nome visualizzato del modificatore da mostrare nelle interfacce utente.
priceAdjustment

object (Money)

Solo output. L'aggiustamento del prezzo associato a questo modificatore, se presente. È il prezzo per unità del modificatore.
quantity

integer

Facoltativo. La quantità di questa azione di modifica applicata.
modifierAction

object (OrderModifierAction)

Facoltativo. L'azione del modificatore applicata a questo modificatore.
image

object (Image)

Solo output. Immagine da visualizzare per questo modificatore nell'interfaccia utente.
integrationAttributes

object (ModifierIntegrationAttributes)

Solo output. Metadati associati a questa entità utilizzati per le integrazioni downstream.
modifierGroups[]

object (OrderModifierGroup)

Facoltativo. Gruppi di modificatori nidificati applicati a questo modificatore.

OrderModifierAction

OrderModifierAction specifica ModifierAction associato a un OrderModifier applicato.

Rappresentazione JSON 
{
  "name": string
}
Campi
name

string

Facoltativo. Il nome dell'azione del modificatore, ad esempio "NO", "SIDE", "ADD", "EXTRA".

OrderMetadata

OrderMetadata contiene altri metadati raccolti o dedotti durante l'ordine.

Rappresentazione JSON 
{
  "collectedCustomerName": string,
  "callerPhoneNumber": string
}
Campi
collectedCustomerName

string

Facoltativo. Nome del cliente, raccolto durante l'acquisizione dell'ordine. Compilato solo quando l'agente è configurato per raccogliere il nome del cliente. Queste informazioni potrebbero essere raccolte verbalmente e contenere errori ortografici o di trascrizione, pertanto è necessario prestare attenzione quando vengono mostrate agli utenti e non devono essere considerate attendibili come, ad esempio, i dati di pagamento.
callerPhoneNumber

string

Facoltativo. Il numero di telefono del cliente che effettua l'ordine.

OrderFulfillment

OrderFulfillment contiene informazioni sull'evasione degli ordini.

Rappresentazione JSON 
{
  "fulfillmentMethod": enum (FulfillmentMethod),
  "createTime": string,
  "targetFulfillmentTime": string
}
Campi
fulfillmentMethod

enum (FulfillmentMethod)

Facoltativo. Il metodo di evasione dell'ordine.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato l'ordine.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
targetFulfillmentTime

string (Timestamp format)

Facoltativo. L'ora in cui è prevista l'evasione dell'ordine, utilizzata per l'opzione "Ordina in anticipo". Se non viene fornito, si presume che l'ordine sia per "il prima possibile".

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

OrderPriceInfo

OrderPriceInfo contiene i vari componenti di prezzo di un ordine.

Rappresentazione JSON 
{
  "totalPrice": {
    object (Money)
  },
  "subtotalPrice": {
    object (Money)
  },
  "taxPrice": {
    object (Money)
  }
}
Campi
totalPrice

object (Money)

Facoltativo. Il prezzo totale finale dopo l'applicazione di tutte le tasse, le commissioni e gli sconti.
subtotalPrice

object (Money)

Facoltativo. Il prezzo del subtotale di tutti gli articoli e modificatori, prima di tasse e sconti.
taxPrice

object (Money)

Facoltativo. L'importo delle imposte applicate all'ordine.