Gestión de solicitudes de reserva

Evita errores y pérdidas gestionando bien las solicitudes de reserva

Esta información se aplica a:

• Rapid Lodging API
• Rapid Car API
• API de Rapid Flight

Nota: Algunos detalles pueden variar en función de las API que hayas implementado.

Configuración de red

Es importante que diseñes el flujo de trabajo de tus solicitudes de reserva de forma que sea resistente a los problemas de red. No interpretes la falta de respuesta como un indicio de que la reserva no se ha realizado. Si se produce un problema técnico después de enviar una solicitud de reserva, pero antes de recibir la respuesta, es posible que la reserva del viajero ya se haya cobrado y confirmado en nuestros sistemas. Estos son algunos fallos de la infraestructura:

• Se ha perdido la conexión a la red (no se ha recibido respuesta).
• Server-side Se devuelve un error (código HTTP 500 o 503).
• Se ha detectado un error en la pasarela de red (se devuelve el código HTTP 502).
• Se ha detectado un tiempo de espera agotado en la pasarela de red (se devuelve el código HTTP 504).
• La respuesta no sigue la documentación de Rapid API (falta un elemento clave en el mensaje).
• La respuesta no está en formato JSON (por ejemplo, el mensaje de respuesta está en HTML).
• Otros errores, excepciones, comportamientos desconocidos o interrupciones.

A la solicitud «Create Booking» le debe seguir una solicitud «Retrieve» que incluya:

• El valor original de affiliate_reference_id y el correo electrónico usados en la respuesta para crear la reserva. OR
• Los valores de itinerary_id y links.retrieve.href que aparecen en la respuesta de «Create Booking».

>> Lee más sobre una solicitud de recuperación de reserva

Nota: A veces, los itinerarios recién creados pueden tener un pequeño retraso entre el momento en que se crean y el momento en que se pueden consultar. Si te sale un error al intentar recuperar un itinerario que se ha creado correctamente, o si recibes una respuesta que incluye tanto « itinerary_id » como « creation_date_time », vuelve a intentarlo durante 30 minutos antes de ponerte en contacto con following-up para que nuestros agentes del centro de atención al cliente te ayuden.

Procedimiento recomendado

Envía siempre affiliate_reference_id

Genera un affiliate_reference_idúnico para cada reserva. Si vuelves a enviar los mismos datos de la solicitud (por ejemplo, porque el intento anterior falló), debes usar el mismo affiliate_reference_id. De esta manera, se evitará la creación de reservas por duplicado por accidente. Al enviar una nueva solicitud de creación de reserva, la API no responderá hasta que la reserva se haya confirmado o rechazado. La mayoría de las respuestas se devuelven a los pocos segundos. Sin embargo, en un número reducido de casos, este proceso puede tardar varios minutos en procesarse y generar una respuesta.

Control de reservas que no se resuelven rápidamente

El « Rapid API » se conecta a sistemas externos para hacer reservas en real-time. Entre los sistemas dependientes se incluyen los de reservas hoteleras o de recepción, los procesadores de tarjetas de crédito o los sistemas de detección de fraudes. El 98 % de las reservas se pueden completar en menos de 30 segundos. Sin embargo, si no recibes la respuesta de la reserva tras 90 segundos, verifica el progreso mediante una solicitud de recuperación con el mismo affiliate_reference_id que se envió con la reserva. Si la reserva sigue en curso o ha habido un fallo, aparecerá el error 404 con el texto "Itinerary was not found with provided request." (no se ha encontrado el itinerario con la solicitud facilitada). Si ves este mensaje, prueba a volver a efectuar la solicitud de reserva con el mismo affiliate_reference_id. En el caso de que la reserva aún no se haya completado, aparecerá un error 400 con el texto "An itinerary already exists with this affiliate reference ID" (ya hay un itinerario con este número de referencia de afiliado). Si se devuelve este error, puedes recuperar la reserva de nuevo para saber si es posible consultar los datos.

Es posible que la API de recuperación devuelva errores o una respuesta incompleta si una reserva aún se está procesando. Al efectuar una llamada de recuperación de la reserva, se resolverán el 99,99 % de los errores. Si se produce algún problema, vuelve a intentar la recuperación durante 30 minutos antes de ponerte en contacto con nosotros para recibir más ayuda.

Disputas en las reservas

Si tienes algún problema con la reserva debido a tiempos de espera agotados, errores con el código HTTP 50x u otros problemas de infraestructura, por favor, facilítanos los siguientes registros de transacciones para que podamos solucionar el problema:

• La solicitud de reserva y la respuesta (si la tienes).
• La solicitud y la respuesta de la consulta de reserva que se envió 30 minutos después del último intento de reserva.

El registro debe incluir los encabezados HTTP de la solicitud y la respuesta. El mensaje de respuesta tiene un encabezado transaction-id que nos permite identificar la transacción de Rapid API.

Te hemos dado más detalles sobre los errores más comunes de Rapid API, incluyendo ejemplos de respuestas de error HTTP, pseudocódigo para gestionar reservas y un ejemplo de interfaz de usuario:

>> Descubre cómo gestionar los errores más comunes
>> Echa un vistazo a un ejemplo de interfaz de usuario