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)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
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 การจองกำลังรอการยืนยันจากลูกค้าก่อนที่จะเปลี่ยนเป็นสถานะ CONFIRMED ได้ (ปัจจุบันระบบยังไม่รองรับ)
CANCELED มีการยกเลิกการจองในนามของผู้ใช้
NO_SHOW ลูกค้าไม่มาตามนัดหมาย
NO_SHOW_PENALIZED ลูกค้าไม่มาตามนัดหมายซึ่งเป็นการละเมิดนโยบายการยกเลิก
FAILED จองไม่สำเร็จเนื่องจากประมวลผลไม่สำเร็จ
DECLINED_BY_MERCHANT ผู้ขายปฏิเสธการจองแบบไม่พร้อมกัน

PaymentInformation

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

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

enum (PrepaymentStatus)

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

string

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

PrepaymentStatus

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

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

เมธอด

patch

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