BookingEngine XML API Documentation

Introduction

Levart uses a subset of the Open Travel Alliance (OTA) XML specifications for the BookingEngine API. Levart has made use of the latest "2015B" version of the specifications for this implementation. The full OTA documentation including all schemas can be downloaded from http://www.opentravel.org/Specifications/Default.aspx

The OTA XML messages are implemented over the SOAP v1.2 protocol over a secure TLS1.2, HTTPS connection and are additionally protected with HTTP Basic authentication (via HTTP header). A username and password will be supplied to you for access in the introductory email from Levart.

Levart also provides a WSDL (Web Services Definition Language) file that describes the usage of the XML web services over SOAP including all XML schemas.

Messages Supported

SOAP/OTA Diagram

SOAP Message Structure

POST /servers/changeme.html HTTP/1.1
Host: secure.levartdistributionsystems.com.au
Content-type: application/soap+xml; charset=utf-8
Content-length: 656
Authorization: Basic aHR0cHdhdGNoOmY=
SoapAction: PingRQ

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope
        xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Body>
    // OTA XML REQUEST HERE e.g. OTA_PingRQ message
  </soapenv:Body>
</soapenv:Envelope>

HTTP/1.1 200 OK
Date: Wed, 10 Feb 2016 03:02:55 GMT
Server: Apache/2.2.15 (Oracle)
Connection: close
Content-Type: application/soap+xml

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Body>
    // OTA XML RESPONSE HERE e.g. OTA_PingRS message
  </soapenv:Body>
</soapenv:Envelope>

More reading: https://en.wikipedia.org/wiki/SOAP

Generic Error Response (OTA_ErrorRS)

You may get an OTA_ErrorRS message in return instead of the expected OTA message if an error occurs early on in the parsing or authorization process.

<OTA_ErrorRS xmlns="http://www.opentravel.org/OTA/2003/05" Status="NotProcessed" Version="1.0" TimeStamp="2016-01-28T15:15:00+08:00" ErrorMessage="Messages must be authenticated via HTTP Basic"/>

Specification for OTA_ErrorRS

Levart Interface Contact