REST Resource: notification.partners.bookings

Risorsa: Booking

Una prenotazione per uno slot di inventario

Rappresentazione JSON 
{
  "name": string,
  "merchantId": string,
  "serviceId": string,
  "startTime": string,
  "duration": string,
  "clientInformation": {
    object (ClientInformation)
  },
  "status": enum (BookingStatus),
  "paymentInformation": {
    object (PaymentInformation)
  },
  "partySize": string
}
Campi
name

string

Nome risorsa della prenotazione: partners/{partner ID}/bookings/{booking ID}
merchantId

string

ID del commerciante per lo slot
serviceId

string

ID del servizio del commerciante
startTime

string (Timestamp format)

Ora di inizio dello spazio per appuntamenti

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
duration

string (Duration format)

Durata dello spazio per appuntamenti

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
clientInformation

object (ClientInformation)

Informazioni personali del cliente che prenota l'appuntamento
status

enum (BookingStatus)

Stato della prenotazione
paymentInformation

object (PaymentInformation)

Informazioni sulle transazioni di pagamento relative alla prenotazione.
partySize

string (int64 format)

Numero di persone della prenotazione

ClientInformation

Informazioni personali della persona che effettua una prenotazione

Rappresentazione JSON 
{
  "givenName": string,
  "familyName": string,
  "address": {
    object (PostalAddress)
  },
  "telephone": string,
  "email": string
}
Campi
givenName

string

Nome del cliente
familyName

string

Cognome del cliente
address

object (PostalAddress)

Indirizzo del cliente
telephone

string

Numero di telefono del cliente
email

string

Indirizzo email del cliente

BookingStatus

Stato di una prenotazione

Enum
BOOKING_STATUS_UNSPECIFIED Non specificato.
CONFIRMED La prenotazione è stata confermata
PENDING_MERCHANT_CONFIRMATION La prenotazione è in attesa di conferma da parte del commerciante prima di poter passare allo stato CONFERMATA (questa opzione NON è attualmente supportata)
PENDING_CLIENT_CONFIRMATION La prenotazione è in attesa di conferma da parte del cliente prima di poter passare allo stato CONFERMATA (questa operazione NON è attualmente supportata)
CANCELED La prenotazione è stata annullata per conto dell'utente.
NO_SHOW Il cliente non si è presentato all'appuntamento
NO_SHOW_PENALIZED Il cliente non si è presentato all'appuntamento in violazione delle norme relative all'annullamento.
FAILED La prenotazione non è stata completata a causa di un errore di elaborazione.
DECLINED_BY_MERCHANT La prenotazione è stata rifiutata in modo asincrono dal commerciante.

PaymentInformation

Dettagli di pagamento relativi a una prenotazione

Rappresentazione JSON 
{
  "prepaymentStatus": enum (PrepaymentStatus),
  "paymentTransactionId": string
}
Campi
prepaymentStatus

enum (PrepaymentStatus)

Stato del pagamento anticipato della prenotazione. Se prepaymentStatus è PREPAYMENT_PROVIDED o PREPAYMENT_REFUNDED, paymentTransactionId contiene l'ID transazione univoco associato.
paymentTransactionId

string

Identificatore univoco di una transazione di pagamento associata alla prenotazione. Vuoto se non applicabile.

PrepaymentStatus

Stato del pagamento anticipato di una prenotazione.

Enum
PREPAYMENT_STATUS_UNSPECIFIED Non specificato, il valore predefinito è PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED La tariffa per la prenotazione è stata pagata in anticipo.
PREPAYMENT_NOT_PROVIDED La tariffa per la prenotazione non è stata pagata in anticipo.
PREPAYMENT_REFUNDED La commissione era precedentemente PREPAYMENT_PROVIDED, ma ora è stata rimborsata.

Metodi

patch

 Aggiorna un Booking esistente.