Ir al contenido

Checklist de certificación

Proceso para certificar que la integración de un partner con la Wholesalers API funciona correctamente antes del acceso a producción.

El proceso de certificación valida el uso correcto del flujo de reserva completo:

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

Casos de prueba requeridos (logs a entregar)

Sección titulada «Casos de prueba requeridos (logs a entregar)»

Busca dos hoteles simultáneamente en una sola llamada a /hotels/rates.

  • Verifica que ambos hoteles devuelven tarifas.
  • Verifica que el rateKey de cada hotel es único.

Test 2 — Una habitación con adulto y menor

Sección titulada «Test 2 — Una habitación con adulto y menor»

Reserva de 1 habitación con 1 adulto y 1 menor de 17 años.

  • El array de pax contiene: [{age: 30+}, {age: 0-16}].
  • Verifica que la tarifa refleja correctamente la edad del menor.
  • Completa el flujo de reserva completo hasta BookingNew.

Test 3 — Tres habitaciones, configuración mixta

Sección titulada «Test 3 — Tres habitaciones, configuración mixta»

Reserva de 3 habitaciones:

  • 2 habitaciones con 2 adultos cada una
  • 1 habitación con 2 adultos + 1 menor de 7 años
  • Verifica que se devuelve el rateKey multi-habitación.
  • Verifica que el monto es igual a la suma de las 3 habitaciones.
  • Completa BookingHold y BookingNew.

Test 4 — Cuatro habitaciones, configuración compleja

Sección titulada «Test 4 — Cuatro habitaciones, configuración compleja»

Reserva de 4 habitaciones:

  • 1 habitación: 1 adulto + 1 menor de 3 años
  • 1 habitación: 2 adultos + 1 menor de 5 años
  • 1 habitación: 1 adulto solo
  • 1 habitación: 1 adulto + 2 menores (de 1 y 2 años)
  • Verifica que todas las combinaciones se cotizan correctamente.
  • Completa el flujo de reserva completo.

Usa BookingGet para recuperar una reserva creada en cualquier test anterior.

  • Verifica que el bookingId devuelto coincide.
  • Verifica status: CONFIRMED.
  • Verifica que una reserva CONFIRMED con hotels[].confirmationCode vacío se trata como confirmada.
  • Verifica que los datos de client y del hotel que devuelve BookingGet coinciden con lo que enviaste. No esperes que se devuelvan los nombres de pax enviados en HotelRates — ver BookingGet.

Usa BookingDelete sobre una reserva creada en tests anteriores.

  • Espera al menos 90 segundos después de la creación antes de cancelar.
  • Verifica la respuesta status: CANCELLED.
  • Verifica que las políticas de cancelación se aplicaron correctamente.

PT validará la integración del partner contra:

  1. Precisión de precios: la tarifa sube/baja correctamente al cambiar la configuración de pax.
  2. Corrección de cancelaciones: las reservas se pueden cancelar dentro de la ventana de política aplicable.
  3. Manejo de estados: el partner interpreta correctamente CONFIRMED / CANCELLED / CREATED.
  4. Manejo de errores: el partner maneja con gracia las respuestas 4xx y 5xx.
  5. Disciplina de ventanas de tiempo: el partner respeta las ventanas de 60 min / 20 min / 5 min / 90 s.

Por cada caso de prueba, envía logs que contengan:

  • Petición completa (URL, headers excluyendo la autenticación sensible, body)
  • Respuesta completa (headers y body)
  • El eventId de cada respuesta
  • Timestamp de cada llamada
  • Cualquier mensaje de error encontrado
Fallo Causa raíz
Monto no coincide en Test 3/4 El partner suma tarifas de habitación individual en vez de usar el rateKey multi-habitación
La cancelación del Test 6 falla El partner cancela dentro del cooldown de 90s
Resultado de reserva sin resolver El partner reinicia el flujo antes de consultar BookingGet con un bookingId numérico conocido o de contactar a PT cuando no dispone de ese ID.
Certificación en el entorno equivocado Los tests se ejecutaron fuera del entorno de Integration
Token re-solicitado por llamada El partner no cachea el token y golpea los rate limits
  • Se emiten credenciales de producción (client_id, client_secret del entorno de Production).
  • Se habilita el channel ID específico del partner en Production.
  • Opcional: se provisiona un subdominio dedicado (p. ej. ptapi-{partner}.pricetravel.com).