Sample code for 30+ languages & platforms
C#

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 C# Downloads

C#
bool success = false;

//  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>

Chilkat.Xml xml = new Chilkat.Xml();
xml.EmitXmlDecl = false;
xml.Tag = "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");

Chilkat.Http http = new Chilkat.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";

Chilkat.HttpResponse resp = new Chilkat.HttpResponse();
success = http.HttpStr("POST",endpointUrl,xml.GetXml(),"utf-8","text/xml",resp);
if (success == false) {
    Debug.WriteLine(http.LastErrorText);
    return;
}

Debug.WriteLine("response status code = " + Convert.ToString(resp.StatusCode));
Debug.WriteLine(resp.BodyStr);

//  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.BodyStr);

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.I = 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)");
    Debug.WriteLine(serviceName);
    i = i + 1;
}