Confirmación y reservación
OTA_NotifReportRQ
El mensaje OTA_NotifReportRQ es enviado por el PMS a PmsXchange para confirmar la entrega de una o más reservas, modificaciones o cancelaciones. Si una reserva, modificación o cancelación no se confirma como entregada, se continuará entregando al PMS en respuesta al mensaje OTA_ReadRQ. Tenga en cuenta que confirmar la entrega de una reserva no significa necesariamente que la reserva se haya creado correctamente en el PMS. El mensaje OTA_NotifReportRQ permite confirmar una entrega errónea.
NOTA: pmsXchange fallará automáticamente (Error) cualquier reserva que cumpla con los siguientes criterios:
- Se ha solicitado (OTA_ReadRQ) al menos 5 veces, sin que se haya devuelto OTA_NotifReportRQ válido al solicitar el PMS.
- La creación/ultima modificación/fecha es de mas de 60 minutos atrás.
IMPORTANTE: la funcionalidad mencionada es una función de seguridad, esperamos recibir siempre un 'Correcto' o 'Error' OTA_NotifReportRQ. No se puede confiar en que este mecanismo a prueba falla las reservas cuando no se pueden procesar.
OTA_NotifReportRQ
Tenga en cuenta que un OTA_NotifReportRQ debe contener un elemento "Success" o de "Error". Si se procesaron varias reservas y es necesario devolver tanto un mensaje de error como un mensaje de éxito, entonces se deben enviar dos mensajes de OTA_NotifReportRQ. Uno que contiene el elemento de Éxito y los identificadores para las reservas procesadas con éxito y otro que contiene los Errores y los ID de las reservas que no se procesaron.
Ejemplo de PMS que confirma la entrega de una reserva de lo que se procesó con éxito
La presencia del elemento
Leyenda O = Opcional
| O | Número | Elemento /@Atributo | Tipo de dato | Descripción |
|---|---|---|---|---|
| 1 | OTA_NotifReportRQ | Nodo raíz | ||
| 1 | @EchoToken | String | Identificador global único para la solicitud, esta debe ser reflejada como un EchoToken en la respuesta. | |
| 1 | @Version | Decimal | Versión.Actualmente 1.0. | |
| NotifDetails | Nodo | Contiene datos de notificación. | ||
| HotelNotifReport | Nodo | Notificación a hotel. | ||
| HotelReservation /HotelReservation | Nodo | Datos de reservaciónes. | ||
| @CreateDateTime | String | Fecha de reserva. | ||
| @ResStatus | String | Estado de la reserva. | ||
| UniqueID | Nodo | Identificadores. | ||
| @Type | Integer | Tipo de solicitud. | ||
| @ID | String | Identificador de origen para petición. | ||
| ResGlobalInfo | Nodo | Datos generales de reservación. | ||
| HotelReservationIDs /HotelReservationID | Nodo | Códigos de identificación para la reservación. | ||
| @ResID_Type | Integer | Identificador para tipo de reserva. | ||
| @ResID_Value | String | Identificador de reserva. |
<OTA_NotifReportRQ EchoToken="123sd" Version="1" xmlns="http://tempuri.org/">
<NotifDetails xmlns="http://www.opentravel.org/OTA/2003/05">
<HotelNotifReport>
<HotelReservations>
<HotelReservation CreateDateTime="2018-08-27T15:12:40.0018914-06:00" ResStatus="Book">
<UniqueID Type="16" ID="307614" />
<ResGlobalInfo>
<HotelReservationIDs>
<HotelReservationID ResID_Type="14" ResID_Value="000002" />
</HotelReservationIDs>
</ResGlobalInfo>
</HotelReservation>
</HotelReservations>
</HotelNotifReport>
</NotifDetails>
</OTA_NotifReportRQ>
OTA_NotifReportRQ Specification
Leyenda O = Opcional
| O | Número | Elemento /@Atributo | Tipo de dato | Descripción | 1 | OTA_NotifReportRQ. | Nodo raíz | 1 | @Version | Decimal | Current Version 1.0. | 1 | @EchoToken | String | Identificador global único para la solicitud, el valor sera regresado en la respuesta EchoToken. | 1 | @TimeStamp | DateTime | Tiempo de la transacción en formato de esquema xml. | 0:1 | OTA_NotifReportRQ /Success | Nodo | Puede ser exitoso o erróneo. | 0:1 | OTA_NotifReportRQ / Errors | Nodo | Contiene una lista de errores si la preservación, modificación o cancelación falla durante el proceso. | 1:n | Errors / Error | Nodo | Debería haber al menos un nodo si hay un Nodo de Errores. | 1 | @Type | Integer | Obligatorio si hay un error. Se puede usar cualquier tipo de la tabla de códigos OTA para 'Tipo de advertencia de error'. En particular, se usan los siguientes tipos. Tipo 3: regla de Biz (no se cumplieron las reglas de negocio para el mensaje de solicitud). Tipo 4: error de autenticación (si el nombre de usuario y la contraseña no están autenticados). Tipo 6: error de autorización (si el nombre de usuario autenticado no está autorizado a alterar los datos del hotel). Tipo 10: campo obligatorio faltante (si xml no cumple con el esquema, es decir, campos de solicitud faltantes o tipos de datos no válidos). | 0:1 | @Code | String | Se puede usar cualquier código de la tabla de códigos OTA para 'Códigos de error (ERR)'. | 1 | OTA_NotifReportRQ / NotifDetails / HotelNotifReport | Nodo | Datos de notificación en relación hotel - OTA. | 1:n | HotelNotifReport / HotelReservations / HotelReservation | Nodo | Uno por cada reserva confirmada. | 0:1 | @CreateDateTime | String | La hora en que se creó la reserva en el PMS. Obligatorio si ResStatus es "Book". | 0:1 | @LastModifyDateTime | String | La hora en que se actualizó la reserva en el PMS. Obligatorio si ResStatus es Modificar o Cancelar. | 0:1 | @ResStatus | String | Los valores permitidos son "Book", "Modify" o "Cancel". | 1 | HotelReservation /UniqueID | Integer | El identificador del mensaje de reserva conocido por PmsXchange, The HotelReservation UniqueID del tipo 16 de la respuesta OTA_ResRetrieveRS. | 1 | @Type | Integer | Valor de '16' que hace referencia a la tabla de códigos Tipo de Id. Único (UIT) de OTA. | 1 | @ID | String | Identificador PmsXchange de la reserva. | 0:1 | HotelReservation /ResGlobalInfo | Nodo | Presente si la reserva es parte de un lote de entrega exitoso. | 1 | HotelReservation / ResGlobalInfo / HotelReservationIDs/ HotelReservationID | Nodo | Contenedor para el identificador de reserva de PMS. | 1 | @ResID_Type | Integer | Valor de '14' que se refiere a 'Reserva' en la tabla de códigos Tipo de Id. Único (UIT) de OTA. | 1 | @ResID_Value | String | Identificador de la reserva creada por el PMS. |
|---|