Gestión de solicitudes de reserva

Es importante gestionar las solicitudes de reserva de manera correcta para evitar errores y pérdidas

Descripción general

Debes poder diseñar el proceso de solicitudes de reserva de tal manera que sea flexible si se producen problemas de red. No interpretes la falta de respuestas como un indicador de fallo en la reserva. Si ocurre un problema de infraestructura tras enviar una solicitud de reserva y antes de recibir la respuesta, es posible que la reserva se haya cobrado y confirmado en los sistemas de Rapid. Estos son algunos fallos de la infraestructura:

• Se pierde la conexión de red (por ejemplo, si no se devuelve ninguna respuesta).
• Se devuelve un error del servidor (por ejemplo, el código HTTP 500 o 503).
• Se observa una puerta de enlace de red incorrecta (por ejemplo, se devuelve el código HTTP 502).
• Se agota el tiempo de espera de la puerta de enlace de la red (por ejemplo, se devuelve el código HTTP 504).
• No se observa una respuesta tras la documentación de Rapid (por ejemplo, falta un elemento clave en el mensaje de respuesta).
• El mensaje de respuesta no está en formato JSON (está en HTML, por ejemplo).
• Otros errores, excepciones, comportamientos desconocidos o interrupciones.

La solicitud de creación de reservas debe ir seguida de una solicitud de recuperación de reserva que incluya lo siguiente:

• El valor original de affiliate_reference_id y el correo electrónico usados en la respuesta para crear la reserva.
• O bien los valores de itinerary_id y links.retrieve.href devueltos en la respuesta para crear una reserva.

A continuación, se podrá recuperar el estado de la reserva, pero el resultado de las reservas nuevas podría retrasarse hasta 90 segundos.

Procedimiento recomendado

Envía siempre affiliate_reference_id

Genera un affiliate_reference_id único para cada reserva. Si reenvías los mismos detalles de la solicitud (por ejemplo, debido a un intento fallido), se debe 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

Rapid se conecta a sistemas externos para efectuar reservas en tiempo real. Estos son algunos sistemas dependientes: sistemas de reserva hoteleros, sistemas de recepción, procesadores de tarjetas de crédito y sistemas de detección de fraude. En el 98 % de las reservas, el proceso puede completarse en unos 13 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 esto no ocurre, ponte en contacto con los agentes del centro de llamadas de Rapid para solicitar asistencia.

Disputas en las reservas

Si tienes algún problema con una reserva por haberse agotado el tiempo de espera o debido a un error de código HTTP 50x u otros problemas de infraestructura, proporciona los siguientes registros de las transacciones de Rapid API para solucionarlo:

• La solicitud de reserva y la respuesta (si la tienes).
• La solicitud y la respuesta de recuperación de la reserva que se envió 90 segundos 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. Encontrarás más pautas acerca de cómo gestionar errores en este enlace.

Inicia sesión en tu cuenta de asistencia de Rapid para ver el ejemplo de la interfaz de usuario, el pseudocódigo para gestionar reservas y los ejemplos del plan de integración.