Table of Contents |
---|
Error Responses to SMX
...
It is expected that your application has a robust error handling process in place. An error response should contain a short description of the error to assist our support teamsSupport teams in troubleshooting.
Note |
---|
Error Responses using the <Errors></Errors> tag will flag the reservation delivery from SMX to your endpoint as Failed. |
Content-Type
The ‘Content-Type’ for all SOAP
XML messages must be application/xml; charset=utf-8
.
...
Code Block | ||
---|---|---|
| ||
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:Body xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <OTA_HotelResNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="20212022-08-01T09:30:47+08:00" EchoToken="abc123-unique"> <Errors> <Error Type="6" Code="392">Invalid hotel code: ABC</Error> </Errors> </OTA_HotelResNotifRS> </soap-env:Body> </soap-env:Envelope> |
...
Invalid Username or Password
Code Block | ||
---|---|---|
| ||
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:Body xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <OTA_HotelResNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="20212022-08-01T09:30:47+08:00" EchoToken="abc123-unique"> <Errors> <Error Type="36" Code="321497">Guest>Authorization emailerror address- isinvalid required<username</Error> </Errors> </OTA_HotelResNotifRS> </soap-env:Body> </soap-env:Envelope> |
...
Warning Responses to SMX
Any other warning responses that are not application or server level issues should be sent as Success + Warning to avoid reservation delivery failures. Please review https://siteminder.atlassian.net/wiki/spaces/SMXAPPS/pages/1383759931/OTA+HotelResNotifRS#Success-and-Warning.
Our Reservations API specifications will have non-mandatory fields/attributes that a Publisher might not send in the reservation XML if its not supported by them. Publishers should always send the mandatory reservation fields. Please review our https://siteminder.atlassian.net/wiki/spaces/SMXAPPS/pages/1383432331/OTA+HotelResNotifRQ#Request-Specification to view the mandatory and non-mandatory attributes.
Required Information Not Present - Missing email address
Code Block | ||
---|---|---|
| ||
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:Body xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <OTA_HotelResNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="20212022-08-01T09:30:47+08:00" EchoToken="abc123-unique"> <Success/> <Warnings> <Warning Type="10" Code="321">Guest email address is required</Warning> </Warnings> <HotelReservations> <HotelReservation> <UniqueID <Errors>ID="LH123456789"/> <ResGlobalInfo> <HotelReservationIDs> <HotelReservationID ResID_Type="10" ResID_Value="LH123456789"/> </HotelReservationIDs> </ResGlobalInfo> </HotelReservation> </HotelReservations> </OTA_HotelResNotifRS> </soap-env:Body> </soap-env:Envelope> |
Required Information Not Present - Missing phone number
Code Block | ||
---|---|---|
| ||
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:Body xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <OTA_HotelResNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2022-08-01T09:30:47+08:00" EchoToken="abc123-unique"> <Success/> <Error <Warnings> <Warning Type="610" Code="497316">Authorization>Phone errornumber -is invalid username</Error> </Errors>required</Warning> </Warnings> <HotelReservations> <HotelReservation> <UniqueID ID="LH123456789"/> <ResGlobalInfo> <HotelReservationIDs> <HotelReservationID ResID_Type="10" ResID_Value="LH123456789"/> </HotelReservationIDs> </ResGlobalInfo> </HotelReservation> </HotelReservations> </OTA_HotelResNotifRS> </soap-env:Body> </soap-env:Envelope> |
...