Order

Une commande représente le contenu d'une commande en cours ou terminée d'un utilisateur.

Représentation JSON 
{
  "items": [
    {
      object (OrderItem)
    }
  ],
  "metadata": {
    object (OrderMetadata)
  },
  "fulfillment": {
    object (OrderFulfillment)
  },
  "priceInfo": {
    object (OrderPriceInfo)
  },
  "externalOrderId": string
}
Champs
items[]

object (OrderItem)

Facultatif. Articles de la commande.
metadata

object (OrderMetadata)

Facultatif. Autres métadonnées collectées ou déduites lors de la commande.
fulfillment

object (OrderFulfillment)

Facultatif. Informations sur le traitement de la commande.
priceInfo

object (OrderPriceInfo)

Facultatif. Informations tarifaires pour la commande.
externalOrderId

string

Uniquement en sortie. Identifiant externe de cette commande. Renseigné uniquement si une intégration de point de vente est activée.

OrderItem

OrderItem spécifie l'état d'un élément faisant partie d'une commande.

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

string

Facultatif. Identifiant unique attribué par le système pour cet élément.
itemId

string

Obligatoire. Identifiant d'un élément du menu, unique dans son menu.
displayName

string

Uniquement en sortie. Nom intelligible de cet élément de campagne à afficher dans les interfaces utilisateur.
image

object (Image)

Uniquement en sortie. Image à afficher pour cet élément dans l'UI.
basePrice

object (Money)

Uniquement en sortie. Prix de base de l'article. Cela peut être affecté par les modificateurs sélectionnés. Il s'agit du prix unitaire de l'article.
integrationAttributes

object (ItemIntegrationAttributes)

Uniquement en sortie. Métadonnées associées à cette entité et utilisées pour les intégrations en aval.
modifierGroups[]

object (OrderModifierGroup)

Facultatif. ModifierGroups appliqués à cet élément.
quantity

integer

Facultatif. Quantité de cet article dans la commande.

OrderModifierGroup

OrderModifierGroup spécifie l'état d'un ModifierGroup qui fait partie d'un OrderItem.

Représentation JSON 
{
  "modifierGroupId": string,
  "displayName": string,
  "integrationAttributes": {
    object (ModifierGroupIntegrationAttributes)
  },
  "modifiers": [
    {
      object (OrderModifier)
    }
  ]
}
Champs
modifierGroupId

string

Obligatoire. Identifiant de ce groupe de modificateurs, unique dans son menu.
displayName

string

Uniquement en sortie. Nom du groupe de modificateurs (par exemple, "Garnitures (sandwich)" ou "Accompagnement pour le menu moyen").
integrationAttributes

object (ModifierGroupIntegrationAttributes)

Uniquement en sortie. Métadonnées associées à cette entité et utilisées pour les intégrations en aval.
modifiers[]

object (OrderModifier)

Facultatif. Modificateurs appliqués à ce groupe de modificateurs.

OrderModifier

OrderModifier spécifie l'état d'un modificateur qui fait partie d'un OrderModifierGroup.

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

string

Facultatif. Identifiant unique attribué par le système pour ce modificateur.
modifierId

string

Obligatoire. Identifiant de ce modificateur, unique dans le menu.
displayName

string

Uniquement en sortie. Nom à afficher du modificateur dans les interfaces utilisateur.
priceAdjustment

object (Money)

Uniquement en sortie. Ajustement de prix associé à ce modificateur, le cas échéant. Il s'agit du prix unitaire du modificateur.
quantity

integer

Facultatif. Quantité de cette action de modification appliquée.
modifierAction

object (OrderModifierAction)

Facultatif. Action de modificateur appliquée à ce modificateur.
image

object (Image)

Uniquement en sortie. Image à afficher pour ce modificateur dans l'UI.
integrationAttributes

object (ModifierIntegrationAttributes)

Uniquement en sortie. Métadonnées associées à cette entité et utilisées pour les intégrations en aval.
modifierGroups[]

object (OrderModifierGroup)

Facultatif. Groupes de modificateurs imbriqués appliqués à ce modificateur.

OrderModifierAction

OrderModifierAction spécifie l'action ModifierAction associée à un OrderModifier appliqué.

Représentation JSON 
{
  "name": string
}
Champs
name

string

Facultatif. Nom de l'action du modificateur (par exemple, "SANS", "À CÔTÉ", "AJOUTER", "SUPPLÉMENT").

OrderMetadata

OrderMetadata contient d'autres métadonnées collectées ou déduites lors de la commande.

Représentation JSON 
{
  "collectedCustomerName": string,
  "callerPhoneNumber": string
}
Champs
collectedCustomerName

string

Facultatif. Nom du client, recueilli lors de la prise de la commande. Renseigné uniquement lorsque l'agent est configuré pour collecter le nom du client. Ces informations peuvent être recueillies oralement et contenir des fautes d'orthographe ou des erreurs de transcription.Il convient donc d'être prudent lorsque vous les affichez aux utilisateurs. De plus, elles ne doivent pas être considérées comme des informations de paiement, par exemple.
callerPhoneNumber

string

Facultatif. Numéro de téléphone du client qui passe la commande.

OrderFulfillment

OrderFulfillment contient des informations sur le traitement des commandes.

Représentation JSON 
{
  "fulfillmentMethod": enum (FulfillmentMethod),
  "createTime": string,
  "targetFulfillmentTime": string
}
Champs
fulfillmentMethod

enum (FulfillmentMethod)

Facultatif. Méthode de traitement de la commande.
createTime

string (Timestamp format)

Uniquement en sortie. Heure de création de la commande.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
targetFulfillmentTime

string (Timestamp format)

Facultatif. Heure à laquelle la commande doit être traitée, utilisée pour les commandes à l'avance. Si aucune date n'est fournie, la commande est considérée comme devant être livrée "dès que possible".

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

OrderPriceInfo

OrderPriceInfo encapsule les différents composants de prix d'une commande.

Représentation JSON 
{
  "totalPrice": {
    object (Money)
  },
  "subtotalPrice": {
    object (Money)
  },
  "taxPrice": {
    object (Money)
  }
}
Champs
totalPrice

object (Money)

Facultatif. Prix total final après application de toutes les taxes, de tous les frais et de toutes les remises.
subtotalPrice

object (Money)

Facultatif. Prix du sous-total de tous les articles et modificateurs, avant taxes et remises.
taxPrice

object (Money)

Facultatif. Montant des taxes appliquées à la commande.