REST Resource: notification.partners.bookings

Tài nguyên: Đặt trước

Lượt đặt trước cho một vùng khoảng không quảng cáo

Biểu diễn dưới dạng JSON
{
  "name": string,
  "merchantId": string,
  "serviceId": string,
  "startTime": string,
  "duration": string,
  "clientInformation": {
    object (ClientInformation)
  },
  "status": enum (BookingStatus),
  "paymentInformation": {
    object (PaymentInformation)
  },
  "partySize": string
}
Trường
name

string

Tên tài nguyên của lượt đặt trước: partners/{partner ID}/bookings/{booking ID}

merchantId

string

Mã của người bán cho vùng đó

serviceId

string

Mã dịch vụ của người bán

startTime

string (Timestamp format)

Thời gian bắt đầu của khung giờ nhận đặt hẹn

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

Thời lượng của khung giờ nhận đặt hẹn

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

clientInformation

object (ClientInformation)

Thông tin cá nhân của khách hàng đặt lịch hẹn

status

enum (BookingStatus)

Trạng thái của yêu cầu đặt chỗ

paymentInformation

object (PaymentInformation)

Thông tin về các giao dịch thanh toán liên quan đến việc đặt phòng.

partySize

string (int64 format)

Quy mô bữa tiệc của yêu cầu đặt chỗ

ClientInformation

Thông tin cá nhân về người đặt chỗ

Biểu diễn dưới dạng JSON
{
  "givenName": string,
  "familyName": string,
  "address": {
    object (PostalAddress)
  },
  "telephone": string,
  "email": string
}
Trường
givenName

string

Tên của khách hàng

familyName

string

Họ của khách hàng

address

object (PostalAddress)

Địa chỉ của khách hàng

telephone

string

Số điện thoại của khách hàng

email

string

Địa chỉ email của khách hàng

BookingStatus

Trạng thái của lượt đặt trước

Enum
BOOKING_STATUS_UNSPECIFIED Chưa chỉ định.
CONFIRMED Đã xác nhận yêu cầu đặt vé
PENDING_MERCHANT_CONFIRMATION Yêu cầu đặt vé đang chờ người bán xác nhận trước khi có thể chuyển sang trạng thái ĐÃ XÁC NHẬN (tình trạng này hiện KHÔNG được hỗ trợ)
PENDING_CLIENT_CONFIRMATION Lượt đặt vé đang chờ khách hàng xác nhận trước khi có thể chuyển sang trạng thái ĐÃ XÁC NHẬN (tình trạng này hiện KHÔNG được hỗ trợ)
CANCELED Yêu cầu đặt vé đã bị hủy thay mặt cho người dùng.
NO_SHOW Khách hàng không xuất hiện để đặt cuộc hẹn
NO_SHOW_PENALIZED Khách hàng không xuất hiện trong cuộc hẹn do vi phạm chính sách huỷ.
FAILED Không thể hoàn tất quy trình đặt vé do có lỗi xử lý.
DECLINED_BY_MERCHANT Người bán đã từ chối không đồng bộ yêu cầu đặt vé.

PaymentInformation

Thông tin thanh toán liên quan đến một lượt đặt phòng

Biểu diễn dưới dạng JSON
{
  "prepaymentStatus": enum (PrepaymentStatus),
  "paymentTransactionId": string
}
Trường
prepaymentStatus

enum (PrepaymentStatus)

Trạng thái trả trước của lượt đặt phòng. Nếu paymentsStatus là PREPAYMENT_PROVIDED hoặc PREPAYMENT_REFUNDED, thì paymentTransactionId sẽ chứa mã giao dịch duy nhất được liên kết.

paymentTransactionId

string

Giá trị nhận dạng duy nhất của giao dịch thanh toán liên quan đến yêu cầu đặt phòng. Để trống nếu không có.

PrepaymentStatus

Trạng thái thanh toán trước của một lượt đặt phòng.

Enum
PREPAYMENT_STATUS_UNSPECIFIED Không được chỉ định, giá trị mặc định là PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED Phí đặt trước đã được thanh toán trước.
PREPAYMENT_NOT_PROVIDED Bạn chưa thanh toán trước phí đặt chỗ.
PREPAYMENT_REFUNDED Khoản phí trước đây là PREPAYMENT_PROVIDED nhưng hiện đã được hoàn lại.

Phương thức

patch

Cập nhật một Booking hiện có.