REST Resource: notification.partners.bookings

Tài nguyên: Đặt chỗ

Lượt đặt trước cho một vị trí trong kho hàng

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 phòng: partners/{partner ID}/bookings/{booking ID}
merchantId

string

Mã nhận dạng của người bán cho vị trí
serviceId

string

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

string (Timestamp format)

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

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
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, có tối đa 9 chữ số thập phân, 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 lượt đặt phòng
paymentInformation

object (PaymentInformation)

Thông tin về các giao dịch thanh toán liên quan đến lượt đặt chỗ.
partySize

string (int64 format)

Số người tham gia bữa tiệc trong 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 phòng

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

PaymentInformation

Thông tin thanh toán liên quan đến lượt đặt chỗ

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 prepaymentStatus 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

Mã nhận dạng riêng biệt cho giao dịch thanh toán liên quan đến lượt đặt chỗ. Để trống nếu không áp dụng.

PrepaymentStatus

Trạng thái thanh toán trước của 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 Bạn đã trả trước phí đặt chỗ.
PREPAYMENT_NOT_PROVIDED Bạn chưa trả trước phí đặt chỗ.
PREPAYMENT_REFUNDED Trước đây, khoản phí này là PREPAYMENT_PROVIDED nhưng hiện đã được hoàn lại.

Phương thức

patch

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