Sample code for 30+ languages & platforms
Java

Royal Mail OBA Web Service -- Get Contracts

See more Royal Mail OBA Examples

Royal Mail OBA Web Service -- Get the contracts for an account.

Chilkat Java Downloads

Chilkat2 Java
import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Http;
import com.chilkatsoft.chilkat2.HttpResponse;
import com.chilkatsoft.chilkat2.Xml;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example requires the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        // Create the following XML:

        // <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:epro="urn:schemas-royalmail-com/webservice/epro">
        //    <soapenv:Header>
        //       <epro:Authentication>
        //          <epro:Username>my_username</epro:Username>
        //          <epro:Password>my_password</epro:Password>
        //          <epro:AccessCode>my_accessCode</epro:AccessCode>
        //          <epro:Version>1.0</epro:Version>
        //          <epro:SecurityToken>mysecuritytoken</epro:SecurityToken>
        //       </epro:Authentication>
        //    </soapenv:Header>
        //    <soapenv:Body>
        //       <epro:GetContracts>
        //         <epro:Account>account_number</epro:Account>
        //       </epro:GetContracts>
        //    </soapenv:Body>
        // </soapenv:Envelope>

        Xml xml = new Xml();
        xml.setEmitXmlDecl(false);
        xml.setTag("soapenv:Envelope");
        xml.addAttribute("xmlns:soapenv", "http://schemas.xmlsoap.org/soap/envelope/");
        xml.addAttribute("xmlns:epro", "urn:schemas-royalmail-com/webservice/epro");

        // Replace my_username, my_password, and my_accessCode with your actual values.  Do not replace "mysecuritytoken".
        xml.updateChildContent("soapenv:Header|epro:Authentication|epro:Username", "my_username");
        xml.updateChildContent("soapenv:Header|epro:Authentication|epro:Password", "my_password");
        xml.updateChildContent("soapenv:Header|epro:Authentication|epro:AccessCode", "my_accessCode");
        xml.updateChildContent("soapenv:Header|epro:Authentication|epro:Version", "1.0");

        // Literally use the string "mysecuritytoken" here.
        xml.updateChildContent("soapenv:Header|epro:Authentication|epro:SecurityToken", "mysecuritytoken");
        xml.updateChildContent("soapenv:Body|epro:GetContracts|epro:Account", "account_number");

        Http http = new Http();

        http.setRequestHeader("SOAPAction", "urn:schemas-royalmail-com/webservice/epro/GetContracts");

        // Use the sandbox endpoint:   http://interfaces.oba-v.royalmail.com/legacyws/EProImport.asmx
        // The live endpoint would be: http://www.epro.royalmail.com/WebServices/import/eproimport.asmx
        String endpointUrl = "http://interfaces.oba-v.royalmail.com/legacyws/EProImport.asmx";

        HttpResponse resp = new HttpResponse();
        try {
            http.httpStr("POST", endpointUrl, xml.getXml(), "utf-8", "text/xml", resp);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        System.out.println("response status code = " + resp.getStatusCode());
        System.out.println(resp.getBodyStr());

        // The response looks like this:

        // <?xml version="1.0" encoding="utf-8"?>
        // <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        //     <SOAP-ENV:Header/>
        //     <SOAP-ENV:Body>
        //         <ns1:GetContractsResponse xmlns:ns1="urn:schemas-royalmail-com/webservice/epro">
        //             <ns1:GetContractsResult Version="1">
        //                 <ns1:Contracts>
        //                     <ns1:ContractDetails ServiceName="ADV MAIL + RESPONSE UNSORTED 2C" ServiceReg="AC2" ServiceLevel="01" Contract="DEMOTEST1"/>
        //                     <ns1:ContractDetails ServiceName="PLANNED ENVELOPE POLL CARD MMK-2C      " ServiceReg="AG0" ServiceLevel="01" Contract=""/>
        //             ...
        //                 </ns1:Contracts>
        //             </ns1:GetContractsResult>
        //         </ns1:GetContractsResponse>
        //     </SOAP-ENV:Body>
        // </SOAP-ENV:Envelope>

        //

        xml.loadXml(resp.getBodyStr());

        String serviceName = "";
        String serviceReg = "";
        String serviceLevel = "";
        String contract = "";

        int i = 0;
        int numContracts = xml.numChildrenHavingTag("SOAP-ENV:Body|ns1:GetContractsResponse|ns1:GetContractsResult|ns1:Contracts|ns1:ContractDetails");
        while (i < numContracts) {
            xml.setI(i);
            serviceName = xml.chilkatPath("SOAP-ENV:Body|ns1:GetContractsResponse|ns1:GetContractsResult|ns1:Contracts|ns1:ContractDetails[i]|(ServiceName)");
            serviceReg = xml.chilkatPath("SOAP-ENV:Body|ns1:GetContractsResponse|ns1:GetContractsResult|ns1:Contracts|ns1:ContractDetails[i]|(ServiceReg)");
            serviceLevel = xml.chilkatPath("SOAP-ENV:Body|ns1:GetContractsResponse|ns1:GetContractsResult|ns1:Contracts|ns1:ContractDetails[i]|(ServiceLevel)");
            contract = xml.chilkatPath("SOAP-ENV:Body|ns1:GetContractsResponse|ns1:GetContractsResult|ns1:Contracts|ns1:ContractDetails[i]|(Contract)");
            System.out.println(serviceName);
            i = i + 1;
        }
    }
}