...
| OTA | HTNG | IO | |
|---|---|---|---|
| Request | SOAPAction : "http://htng.org/PWSWG/2010/12/OTA_HotelResNotifRQ_SubmitRequest" | SOAPAction : "http://htng.org/PWSWG/2010/12/HTNG_HotelCheckInNotifRQ_SubmitRequest" | SOAPAction : "IO_StatsNotifRQ |
| Response | SOAPAction : "OTA_HotelResNotifRQHotelResNotifRS" | SOAPAction : "HTNG_HotelCheckInNotifRS" | SOAPAction : "IO_StatsNotifRS" |
...
| OTA | HTNG | IO | |
|---|---|---|---|
| Request | SOAPAction : "http://htng.org/PWSWG/2010/12/OTA_HotelResNotifRQ_SubmitRequest" | SOAPAction : "http://htng.org/PWSWG/2010/12/HTNG_HotelCheckInNotifRQ_SubmitRequest" | SOAPAction : "IO_StatsNotifRQ |
| Response | SOAPAction : "http://htng.org/PWSWG/2010/12/OTA_HotelResNotifRQ_SubmitResponse" | SOAPAction : "http://htng.org/PWSWG/2010/12/HTNG_HotelCheckInNotifRS_SubmitResponse" | SOAPAction : "IO_StatsNotifRS" |
Format of SOAP Environment
...
| Element | Namespace | Description | Occurrence |
|---|---|---|---|
| Envelope | http://www.w3.org/2003/05/soap-envelope | - | Mandatory |
| Envelope / Header | http://www.w3.org/2003/05/soap-envelope | Contains the SOAP headers of the message | Mandatory |
| Envelope / Header / Action | http://protel.io/soap | The required action (Message name) e.g. "OTA_HotelResNotifRQ" | Optional |
| Envelope / Header / CorrelationID | http://protel.io/soap | The CorrelationID of the message you are sending to identify the transaction (protel namespace) | Mandatory |
| Envelope / Header / Source | http://protel.io/soap | The Source of the message (Only outbound from protel to vendor) | Optional |
| Envelope / Header / CorrelationID | http://htng.org/PWSWG/2007/02/AsyncHeaders | The CorrelationID of the message you are sending to identify the transaction (HTNG namespace) | Mandatory |
| Envelope / Header / Target | http://protel.io/soap | The desired target service name of the message For message - ONLY for SYNC messages/s to protel PMS the correct values are:
| MandatoryOptional |
| Envelope / Body | http://www.w3.org/2003/05/soap-envelope | The HTNG/OTA/IO message | Mandatory |
...
The Content-Type needs to be added in the HTTP Header with the value "application/soap+xml".
Please note that depending on the message group used, the ACK has some differences between the standard OTA/HTNG and the protel extension IO message types:
| Codeblock | ||||
|---|---|---|---|---|
| ||||
<?xml version='1.0' encoding='UTF-8'?> <env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:Header> <htnga:CorrelationID xmlns:htnga="http://htng.org/PWSWG/2007/02/AsyncHeaders">RES#045627#CREATE#000002#1575294717780#6244XXX<>%1$s</htnga:CorrelationID> <htnga:RelatesToCorrelationID xmlns:htnga="http://htng.org/PWSWG/2007/02/AsyncHeaders">RES#045627#CREATE#000002#1575294717780#6244XXX<>%1$s</htnga:RelatesToCorrelationID> </env:Header> <env:Body> <ns:HTNG_AcknowledgeReceipt xmlns:ns="http://htng.org/2014B"/> </env:Body> </env:Envelope> |
| Codeblock | ||||
|---|---|---|---|---|
| ||||
<?xml version='1.0' encoding='UTF-8'?> <env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:Header> <htnga:CorrelationID xmlns:htnga="http://htng.org/PWSWG/2007/02/AsyncHeaders">%1$s</htnga:CorrelationID> <htnga:RelatesToCorrelationID xmlns:htnga="http://htng.org/PWSWG/2007/02/AsyncHeaders">%1$s</htnga:RelatesToCorrelationID> </env:Header> <env:Body> <io:IOAcknowledgeRS CorrelationID="%1$s" xmlns:io="http://protel.io/soap"> <io:Success>true</io:Success> </io:IOAcknowledgeRS> </env:Body> </env:Envelope> |
...
protel I/O Connection Endpoints
Connecting to TEST
| System | Endpoint | Variant | URL | Comments |
|---|---|---|---|---|
| ESB | Asynchronous API | SOAP 1.2 | https://service-test.protel.io/services/ProtelApiService.ProtelApiServiceHttpsSoap12Endpoint | Default Endpoint |
| Synchronous API | SOAP 1.2 | https://service-test.protel.io/services/ProtelApiSyncService.ProtelApiSyncServiceHttpsSoap12Endpoint | ||
| Asynchronous API (CD-Proxy) | SOAP 1.2 | https://qa-pci.protel.net/cd-proxy-io/pci/1/io/reservations | Endpoint for all inbound OTA_HotelResNotifRQ messages | |
| WSDL | SOAP 1.2 | https://wsdl-test.protel.io/services/ProtelApiService?wsdl |
Connecting to PROD
| System | Endpoint | Variant | URL | Comments |
|---|---|---|---|---|
| ESB | Asynchronous API | SOAP 1.2 | https://service.protel.io/services/ProtelApiService.ProtelApiServiceHttpsSoap12Endpoint | Default Endpoint |
| Synchronous API | SOAP 1.2 | https://service.protel.io/services/ProtelApiSyncService.ProtelApiSyncServiceHttpsSoap12Endpoint | ||
| Asynchronous API (CD-Proxy-Ireland) | SOAP 1.2 | https://pci.protel.net/cd-proxy-io/pci/1/io/reservations | Endpoint for all inbound OTA_HotelResNotifRQ messages | |
| Asynchronous API (CD-Proxy-Sydney) | SOAP 1.2 | https://pci-sydney.protel.net/cd-proxy-io/pci/1/io/reservations | Endpoint for all inbound OTA_HotelResNotifRQ messages for protel Customers located in Sydney | |
| WSDL | SOAP 1.2 | https://wsdl.protel.io/services/ProtelApiService?wsdl |
NAT Gateway IP Addresses
| Environment | NAT Gateway - Out |
|---|---|
| ESB TEST | 34.249.236.99 |
| ESB PROD | 34.248.234.12 |
Circular Message Flow
The circular message flow prevents a message loop between Integration Partner and Protel.
It is applicable for message types which the PMS accepts in both directions In/Out (e.g. OTA_ProfileModifyRQ, OTA_HotelResNotifRQ, etc.)
Sample:
The Integration Partner sends an OTA_ProfileModifyRQ message to Protel. This profile is modified in the PMS and then sent again as OTA_ProfileModifyRQ by the PMS. The Integration Partner will also modify the profile again and send it back to Protel, thus creating an endless loop.
To stop this endless loop, we have implemented the "Caused-By CorrelationID". The "Caused-By CorrelationID" is automatically added to the outbound messages by the PMS if a modification has been made due to an inbound message. Based on the "Caused-By CorrelationID", our ESB knows to which Ontegration Partner the message does not have to be sent.
