REST Resource: notification.partners.bookings

แหล่งข้อมูล: การจอง

การจองช่องสินค้าคงคลัง

การแสดง JSON
{
  "name": string,
  "merchantId": string,
  "serviceId": string,
  "startTime": string,
  "duration": string,
  "clientInformation": {
    object (ClientInformation)
  },
  "status": enum (BookingStatus),
  "paymentInformation": {
    object (PaymentInformation)
  },
  "partySize": string
}
ช่อง
name

string

ชื่อทรัพยากรของการจอง: partners/{partner ID}/bookings/{booking ID}

merchantId

string

รหัสของผู้ขายสำหรับช่อง

serviceId

string

รหัสของบริการของผู้ขาย

startTime

string (Timestamp format)

เวลาเริ่มต้นของช่วงการนัดหมาย

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

duration

string (Duration format)

ระยะเวลาของช่วงการนัดหมาย

ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย "s" เช่น "3.5s"

clientInformation

object (ClientInformation)

ข้อมูลส่วนบุคคลของลูกค้าที่ทำการนัดหมาย

status

enum (BookingStatus)

สถานะการจอง

paymentInformation

object (PaymentInformation)

ข้อมูลเกี่ยวกับธุรกรรมการชำระเงินที่เกี่ยวข้องกับการจอง

partySize

string (int64 format)

จำนวนคนสำหรับการจอง

ClientInformation

ข้อมูลส่วนบุคคลเกี่ยวกับบุคคลที่ทำการจอง

การแสดง JSON
{
  "givenName": string,
  "familyName": string,
  "address": {
    object (PostalAddress)
  },
  "telephone": string,
  "email": string
}
ช่อง
givenName

string

ชื่อจริงของลูกค้า

familyName

string

นามสกุลของลูกค้า

address

object (PostalAddress)

ที่อยู่ของลูกค้า

telephone

string

หมายเลขโทรศัพท์ของลูกค้า

email

string

อีเมลของลูกค้า

BookingStatus

สถานะการจอง

Enum
BOOKING_STATUS_UNSPECIFIED ไม่ได้ระบุ
CONFIRMED ยืนยันการจองแล้ว
PENDING_MERCHANT_CONFIRMATION การจองกำลังรอการยืนยันจากผู้ขายก่อนที่จะเปลี่ยนสถานะเป็น "ยืนยันแล้ว" (ยังไม่รองรับในปัจจุบัน)
PENDING_CLIENT_CONFIRMATION การจองกำลังรอการยืนยันจากไคลเอ็นต์ก่อนที่จะเปลี่ยนสถานะเป็น "ยืนยันแล้ว" (ยังไม่รองรับในปัจจุบัน)
CANCELED ยกเลิกการจองในนามของผู้ใช้แล้ว
NO_SHOW ลูกค้าไม่ได้เข้าร่วมการนัดหมาย
NO_SHOW_PENALIZED ลูกค้าไม่ได้แสดงการนัดหมายที่ละเมิดนโยบายการยกเลิก
FAILED ดำเนินการจองไม่สำเร็จเนื่องจากประมวลผลไม่สำเร็จ
DECLINED_BY_MERCHANT ผู้ขายปฏิเสธการจองแบบไม่พร้อมกัน

PaymentInformation

รายละเอียดการชำระเงินที่เกี่ยวข้องกับการจอง

การแสดง JSON
{
  "prepaymentStatus": enum (PrepaymentStatus),
  "paymentTransactionId": string
}
ช่อง
prepaymentStatus

enum (PrepaymentStatus)

สถานะการชำระเงินล่วงหน้าของการจอง หากสถานะการชำระเงินล่วงหน้าเป็น PREPAYMENT_PROVIDED หรือ PREPAYMENT_REFUNDED รหัสการชำระเงินธุรกรรมจะมีรหัสธุรกรรมที่ไม่ซ้ำกันที่เกี่ยวข้อง

paymentTransactionId

string

ตัวระบุที่ไม่ซ้ำกันสำหรับธุรกรรมการชำระเงินที่เชื่อมโยงกับการจอง เว้นว่างไว้หากไม่เกี่ยวข้อง

PrepaymentStatus

สถานะการชำระเงินล่วงหน้าของการจอง

Enum
PREPAYMENT_STATUS_UNSPECIFIED ไม่ได้ระบุ ค่าเริ่มต้นคือ PREPAYMENT_NOT_PROVIDED
PREPAYMENT_PROVIDED ระบบเรียกเก็บค่าธรรมเนียมสำหรับการจองล่วงหน้าแล้ว
PREPAYMENT_NOT_PROVIDED คุณไม่ได้ชำระค่าธรรมเนียมการจองล่วงหน้า
PREPAYMENT_REFUNDED ก่อนหน้านี้ค่าธรรมเนียมได้รับ PREPAYMENT_PROVIDED แต่ได้รับการคืนเงินแล้ว

วิธีการ

patch

อัปเดต Booking ที่มีอยู่