Order

Pesanan mewakili konten pesanan pengguna yang sedang berlangsung atau telah selesai.

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

object (OrderItem)

Opsional. Item dalam pesanan.
metadata

object (OrderMetadata)

Opsional. Metadata lain yang dikumpulkan atau disimpulkan selama pemesanan.
fulfillment

object (OrderFulfillment)

Opsional. Informasi pemenuhan pesanan.
priceInfo

object (OrderPriceInfo)

Opsional. Informasi harga untuk pesanan.
externalOrderId

string

Hanya output. ID eksternal untuk pesanan ini. Hanya diisi jika integrasi point of sale diaktifkan.

OrderItem

OrderItem menentukan status Item yang merupakan bagian dari Order.

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

string

Opsional. ID unik yang ditetapkan sistem untuk item ini.
itemId

string

Wajib. ID untuk Item di Menu, unik dalam Menunya.
displayName

string

Hanya output. Nama yang dapat dibaca manusia untuk item baris ini yang akan ditampilkan di antarmuka pengguna.
image

object (Image)

Hanya output. Gambar yang akan ditampilkan untuk item ini di UI.
basePrice

object (Money)

Hanya output. Harga dasar item. Hal ini mungkin dipengaruhi oleh pengubah yang dipilih. Ini adalah harga per unit item.
integrationAttributes

object (ItemIntegrationAttributes)

Hanya output. Metadata yang terkait dengan entity ini yang digunakan untuk integrasi downstream.
modifierGroups[]

object (OrderModifierGroup)

Opsional. ModifierGroups yang diterapkan ke item ini.
quantity

integer

Opsional. Jumlah item ini dalam pesanan.
totalPrice

object (Money)

Hanya output. Harga total untuk item baris ini, termasuk pengubah yang dipilih dan mencerminkan jumlah item, sebelum pajak. Digunakan untuk tampilan tas per item.
categoryIds[]

string

Hanya output. ID kategori yang terkait dengan item menu yang mendasarinya. Mencerminkan Item.category_ids menu sehingga klien dapat mengelompokkan item yang dipesan berdasarkan kategori menu.

OrderModifierGroup

OrderModifierGroup menentukan status ModifierGroup yang merupakan bagian dari OrderItem.

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

string

Wajib. ID untuk grup pengubah ini, unik dalam menunya.
displayName

string

Hanya output. Nama grup pengubah -- mis. "Topping (Sandwich)" atau "Makanan Pendamping untuk Paket Sedang".
integrationAttributes

object (ModifierGroupIntegrationAttributes)

Hanya output. Metadata yang terkait dengan entity ini yang digunakan untuk integrasi downstream.
modifiers[]

object (OrderModifier)

Opsional. Pengubah yang diterapkan ke grup pengubah ini.

OrderModifier

OrderModifier menentukan status Pengubah yang merupakan bagian dari OrderModifierGroup.

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

string

Opsional. ID unik yang ditetapkan sistem untuk pengubah ini.
modifierId

string

Wajib. ID untuk pengubah ini, unik dalam menu.
displayName

string

Hanya output. Nama tampilan pengubah yang akan ditampilkan di antarmuka pengguna.
priceAdjustment

object (Money)

Hanya output. Penyesuaian harga yang terkait dengan pengubah ini, jika ada. Ini adalah harga per unit pengubah.
quantity

integer

Opsional. Jumlah tindakan pengubah ini yang diterapkan.
modifierAction

object (OrderModifierAction)

Opsional. Tindakan pengubah yang diterapkan ke pengubah ini.
image

object (Image)

Hanya output. Gambar yang akan ditampilkan untuk pengubah ini di UI.
integrationAttributes

object (ModifierIntegrationAttributes)

Hanya output. Metadata yang terkait dengan entity ini yang digunakan untuk integrasi downstream.
modifierGroups[]

object (OrderModifierGroup)

Opsional. Grup pengubah bertingkat yang diterapkan ke pengubah ini.
isDefault

boolean

Hanya output. Apakah pengubah ini adalah pilihan default untuk grup pengubahnya. Diperlukan agar klien dapat menghitung perbedaan pilihan yang akurat.

OrderModifierAction

OrderModifierAction menentukan ModifierAction yang terkait dengan OrderModifier yang diterapkan.

Representasi JSON 
{
  "name": string
}
Kolom
name

string

Opsional. Nama tindakan pengubah -- misalnya, "NO", "SIDE", "ADD", "EXTRA".

OrderMetadata

OrderMetadata berisi metadata lain yang dikumpulkan atau disimpulkan selama pemesanan.

Representasi JSON 
{
  "collectedCustomerName": string,
  "callerPhoneNumber": string,
  "deliveryAddress": {
    object (DeliveryAddress)
  }
}
Kolom
collectedCustomerName

string

Opsional. Nama pelanggan, yang dikumpulkan saat menerima pesanan. Hanya diisi jika agen dikonfigurasi untuk mengumpulkan nama pelanggan. Informasi ini dapat dikumpulkan secara lisan dan mungkin berisi kesalahan ejaan atau kesalahan transkripsi, sehingga harus berhati-hati saat menampilkannya kepada pengguna, dan tidak boleh dipercaya sebagai misalnya informasi pembayaran.
callerPhoneNumber

string

Opsional. Nomor telepon pelanggan yang melakukan pemesanan.
deliveryAddress

object (DeliveryAddress)

Opsional. Alamat pengiriman, jika pesanan adalah pesanan pengiriman.

DeliveryAddress

Alamat pengiriman pesanan. Alamat tersebut dapat berupa alamat tersimpan atau terkumpul yang sudah ada.

Representasi JSON 
{
  "address": {
    object (PostalAddress)
  },
  "validationStatus": enum (ValidationStatus),
  "coordinates": {
    object (LatLng)
  }
}
Kolom
address

object (PostalAddress)

Opsional. Alamat pengiriman.
validationStatus

enum (ValidationStatus)

Opsional. Status validasi alamat.
coordinates

object (LatLng)

Opsional. Koordinat geografis alamat. Digunakan untuk memvalidasi apakah alamat berada dalam jangkauan pengiriman toko.

ValidationStatus

Status validasi alamat pengiriman. Hal ini ditentukan oleh logika validasi khusus klien.

Enum
VALIDATION_STATUS_UNSPECIFIED Alamat belum divalidasi.
VALIDATION_STATUS_VALID Alamat valid.
VALIDATION_STATUS_INVALID Alamat tidak valid (tidak ada, tidak dapat diuraikan, dll.)
VALIDATION_STATUS_OUT_OF_RANGE Alamat ada dan telah di-resolve, tetapi berada di luar jangkauan toko.
VALIDATION_STATUS_INCOMPLETE_ADDRESS Alamat tidak memiliki kolom wajib (tidak ada nomor/nama jalan, kota, negara bagian, kode pos, dll.)

OrderFulfillment

OrderFulfillment berisi informasi tentang pemenuhan pesanan.

Representasi JSON 
{
  "fulfillmentMethod": enum (FulfillmentMethod),
  "createTime": string,
  "targetFulfillmentTime": string
}
Kolom
fulfillmentMethod

enum (FulfillmentMethod)

Opsional. Metode pemenuhan pesanan.
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan pesanan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
targetFulfillmentTime

string (Timestamp format)

Opsional. Waktu pesanan dijadwalkan untuk dipenuhi, digunakan untuk 'pesan di awal'. Jika tidak diberikan, pesanan akan dianggap 'secepatnya'.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

OrderPriceInfo

OrderPriceInfo mengenkapsulasi berbagai komponen harga pesanan.

Representasi JSON 
{
  "totalPrice": {
    object (Money)
  },
  "subtotalPrice": {
    object (Money)
  },
  "taxPrice": {
    object (Money)
  },
  "discount": {
    object (Money)
  },
  "saving": {
    object (Money)
  },
  "fees": {
    object (Money)
  }
}
Kolom
totalPrice

object (Money)

Opsional. Harga total akhir setelah semua pajak, biaya, dan diskon diterapkan.
subtotalPrice

object (Money)

Opsional. Harga subtotal semua item dan pengubah, sebelum pajak, diskon.
taxPrice

object (Money)

Opsional. Jumlah pajak yang diterapkan ke pesanan.
discount

object (Money)

Opsional. Total diskon yang diterapkan ke pesanan
saving

object (Money)

Opsional. Penghematan promo diterapkan ke pesanan
fees

object (Money)

Opsional. Total biaya yang diterapkan ke pesanan