Pular para o conteúdo

Checklist de certificação

Processo para certificar que a integração de um parceiro com a Wholesalers API funciona corretamente antes do acesso à produção.

O processo de certificação valida o uso correto do fluxo de reserva completo:

  • Token
  • HotelRates
  • HotelCheckRates
  • BookingHold
  • BookingNew
  • BookingGet
  • BookingDelete

Busque dois hotéis simultaneamente em uma única chamada a /hotels/rates.

  • Verifique se ambos os hotéis retornam tarifas.
  • Verifique se o rateKey de cada hotel é único.

Reserva de 1 quarto com 1 adulto e 1 menor de 17 anos.

  • O array de pax contém: [{age: 30+}, {age: 0-16}].
  • Verifique se a tarifa reflete corretamente a idade do menor.
  • Conclua o fluxo de reserva completo até BookingNew.

Reserva de 3 quartos:

  • 2 quartos com 2 adultos cada
  • 1 quarto com 2 adultos + 1 menor de 7 anos
  • Verifique se o rateKey multi-quarto é retornado.
  • Verifique se o valor é igual à soma dos 3 quartos.
  • Conclua BookingHold e BookingNew.

Test 4 — Quatro quartos, configuração complexa

Seção intitulada “Test 4 — Quatro quartos, configuração complexa”

Reserva de 4 quartos:

  • 1 quarto: 1 adulto + 1 menor de 3 anos
  • 1 quarto: 2 adultos + 1 menor de 5 anos
  • 1 quarto: 1 adulto apenas
  • 1 quarto: 1 adulto + 2 menores (de 1 e 2 anos)
  • Verifique se todas as combinações são precificadas corretamente.
  • Conclua o fluxo de reserva completo.

Use BookingGet para recuperar uma reserva criada em qualquer teste anterior.

  • Verifique se o bookingId retornado corresponde.
  • Verifique status: CONFIRMED.
  • Verifique se uma reserva CONFIRMED com hotels[].confirmationCode vazio é tratada como confirmada.
  • Verifique se os dados de client e do hotel retornados pelo BookingGet correspondem ao que você enviou. Não espere que os nomes de pax enviados no HotelRates sejam retornados — ver BookingGet.

Use BookingDelete em uma reserva criada em testes anteriores.

  • Aguarde ao menos 90 segundos após a criação antes de cancelar.
  • Verifique a resposta status: CANCELLED.
  • Verifique se as políticas de cancelamento foram aplicadas corretamente.

A PT validará a integração do parceiro contra:

  1. Precisão de preços: a tarifa sobe/desce corretamente ao alterar a configuração de pax.
  2. Correção de cancelamentos: as reservas podem ser canceladas dentro da janela de política aplicável.
  3. Tratamento de status: o parceiro interpreta corretamente CONFIRMED / CANCELLED / CREATED.
  4. Tratamento de erros: o parceiro trata com elegância as respostas 4xx e 5xx.
  5. Disciplina de janelas de tempo: o parceiro respeita as janelas de 60 min / 20 min / 5 min / 90 s.

Para cada caso de teste, envie logs contendo:

  • Requisição completa (URL, headers excluindo a autenticação sensível, body)
  • Resposta completa (headers e body)
  • O eventId de cada resposta
  • Timestamp de cada chamada
  • Qualquer mensagem de erro encontrada
Falha Causa raiz
Valor não corresponde no Test 3/4 O parceiro soma tarifas de quarto individual em vez de usar o rateKey multi-quarto
O cancelamento do Test 6 falha O parceiro cancela dentro do cooldown de 90s
Resultado da reserva indefinido O parceiro reinicia o fluxo antes de consultar o BookingGet com um bookingId numérico conhecido ou de entrar em contato com a PT quando esse ID não está disponível.
Certificação no ambiente errado Os testes foram executados fora do ambiente de Integration
Token re-solicitado por chamada O parceiro não faz cache do token e atinge os rate limits
  • São emitidas credenciais de produção (client_id, client_secret do ambiente de Production).
  • É habilitado o channel ID específico do parceiro em Production.
  • Opcional: é provisionado um subdomínio dedicado (p. ex. ptapi-{partner}.pricetravel.com).