Gestión de solicitudes de reserva
Evita errores y pérdidas gestionando correctamente las solicitudes de reserva.
Información general
Es importante diseñar tu flujo de trabajo de solicitud de reserva para que sea tolerante con los problemas de la red. No interpretes la falta de respuesta como indicador de una reserva fallida. Si se produce un problema de infraestructura después de enviar una solicitud de reserva, pero antes de recibir la respuesta, es posible que la reserva del viajero se haya cobrado y confirmado en nuestros sistemas. Estos son algunos fallos de la infraestructura:
- Se pierde la conexión de red (no se devuelve ninguna respuesta).
- Server-side se devuelve un error (código HTTP 500 o 503).
- Se observa una puerta de enlace de red defectuosa (se devuelve el código HTTP 502).
- Se cumple el tiempo de espera de la pasarela de red (se devuelve el código HTTP 504).
- Una respuesta no sigue la documentación de Rapid API (falta un elemento clave en el mensaje).
- Una respuesta no está en formato JSON (por ejemplo, un mensaje de respuesta está en HTML).
- 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_idy el correo electrónico usados en la respuesta para crear la reserva. OR - El valor de
itinerary_idylinks.retrieve.hrefdevuelto en la respuesta Crear reserva.
Nota: Los itinerarios recién creados pueden tener a veces un pequeño retraso entre el momento de su creación y el momento en que se puede recuperar el itinerario. Si recibes un error al intentar recuperar un itinerario que se creó correctamente, o si recibes una respuesta con itinerary_idy creation_date_time, vuelve a intentar la recuperación durante 30 minutos antes de following-up con nuestros agentes del centro de llamadas para obtener más ayuda.
Procedimiento recomendado
Envía siempre affiliate_reference_id
Genera un affiliate_reference_idúnico para cada reserva. Si vuelves a enviar los mismos detalles de la solicitud (por ejemplo, debido a un intento fallido), debes utilizar el mismoaffiliate_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. Los sistemas dependientes incluyen los sistemas de reserva o recepción del hotel, los procesadores de tarjetas de crédito o los sistemas de detección de fraudes. El 98% de las reservas pueden completar el proceso en ~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. Para cubrir un escenario de degradación, vuelve a intentar la recuperación durante 30 minutos antes de ponerte en contacto con nosotros para obtener más ayuda.
Disputas en las reservas
Si tienes algún problema con la reserva debido a tiempos de espera, errores de código HTTP 50x u otros problemas de infraestructura, facilítanos los siguientes registros de transacciones para solucionar el problema:
- La solicitud de reserva y la respuesta (si la tienes).
- La solicitud y la respuesta de Recuperar reserva que se enviaron 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.
Más pautas para el tratamiento de errores.
Accede a tu cuenta de asistencia Rapid API para ver un ejemplo de interfaz de usuario , un pseudocódigo para gestionar las reservas, y ejemplos de planes de integración.