(Delphi DLL) Alabama Motor Fuel Excise Tax E-Filing SOAP XML POST (NewSubmission)

Demonstrates how to post a NewSubmission to the Alabama MFET (Motor Fuel Excise Tax) e-File.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, StringBuilder, HttpResponse, Xml;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
sbXml: HCkStringBuilder;
xml: HCkXml;
http: HCkHttp;
resp: HCkHttpResponse;
xmlResult: HCkXml;
sbResult: HCkStringBuilder;

begin
// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// --------------------------------------------------------------------------------
// Also see Chilkat's Online WSDL Code Generator
// to generate code and SOAP Request and Response XML for each operation in a WSDL.
// --------------------------------------------------------------------------------

// Here is an example of an HTTP POST Request we'll be sending:

// POST /WebServices/MFET/ HTTP/1.1
// Content-Type: text/xml
// SOAPAction: NewSubmission
//  
// <soapenv:Envelope
//   xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
//   xmlns:tem="http://tempuri.org/"
//   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
//   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
//   <soapenv:Header/>
//   <soapenv:Body>
//     <tem:NewSubmission>
//       <tem:UserName>yourusername</tem:UserName>
//       <tem:Password>yourpassword</tem:Password>
//       <tem:File xsi:type="xsd:base64Binary">TRANSMISSION_XML_FILE_CONTENTS_AS_BASE64</tem:File>
//     </tem:NewSubmission>
//   </soapenv:Body>
// </soapenv:Envelope>

// In the above XML, the "TRANSMISSION_XML_FILE_CONTENTS_AS_BASE64" contains the base64 encoded
// string of the XML file that contains "<Transmission> ... </Transmission>"
// First let's load the transmission XML file and get the contents as base64.
sbXml := CkStringBuilder_Create();
success := CkStringBuilder_LoadFile(sbXml,'qa_data/xml/AL_SR_999802_test.xml','utf-8');
if (success <> True) then
  begin
    Memo1.Lines.Add('Failed to load XML file.');
    Exit;
  end;
CkStringBuilder_Encode(sbXml,'base64','utf-8');

// Build the XMl that will be the body of the HTTP request.
xml := CkXml_Create();
CkXml_putTag(xml,'soapenv:Envelope');
CkXml_AddAttribute(xml,'xmlns:soapenv','http://schemas.xmlsoap.org/soap/envelope/');
CkXml_AddAttribute(xml,'xmlns:tem','http://tempuri.org/');
CkXml_AddAttribute(xml,'xmlns:xsd','http://www.w3.org/2001/XMLSchema');
CkXml_AddAttribute(xml,'xmlns:xsi','http://www.w3.org/2001/XMLSchema-instance');
CkXml_UpdateChildContent(xml,'soapenv:Header','');
CkXml_UpdateChildContent(xml,'soapenv:Body|tem:NewSubmission|tem:UserName','yourusername');
CkXml_UpdateChildContent(xml,'soapenv:Body|tem:NewSubmission|tem:Password','yourpassword');
CkXml_UpdateAttrAt(xml,'soapenv:Body|tem:NewSubmission|tem:File',True,'xsi:type','xsd:base64Binary');
CkXml_UpdateChildContent(xml,'soapenv:Body|tem:NewSubmission|tem:File',CkStringBuilder__getAsString(sbXml));

http := CkHttp_Create();

CkHttp_SetRequestHeader(http,'Content-Type','text/xml');
CkHttp_SetRequestHeader(http,'SoapAction','NewSubmission');

resp := CkHttp_PostXml(http,'https://mattest.alabama.gov/WebServices/MFET/',CkXml__getXml(xml),'utf-8');
if (CkHttp_getLastMethodSuccess(http) <> True) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

Memo1.Lines.Add('Response status code = ' + IntToStr(CkHttpResponse_getStatusCode(resp)));
Memo1.Lines.Add('Response body text:');
Memo1.Lines.Add(CkHttpResponse__bodyStr(resp));

// The response will look like this:

// <?xml version="1.0" encoding="utf-8" ?>
// <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
//     <s:Body>
//         <NewSubmissionResponse xmlns="http://tempuri.org/">
//             <NewSubmissionResult i:type="a:base64Binary" xmlns:a="http://www.w3.org/2001/XMLSchema" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">BASE64_RESULT</NewSubmissionResult>
//         </NewSubmissionResponse>
//     </s:Body>
// </s:Envelope>

// We can get the base64 result like this:
xmlResult := CkXml_Create();
CkXml_LoadXml(xmlResult,CkHttpResponse__bodyStr(resp));
sbResult := CkStringBuilder_Create();
CkStringBuilder_Append(sbResult,CkXml__getChildContent(xmlResult,'s:Body|NewSubmissionResponse|NewSubmissionResult'));
CkStringBuilder_Decode(sbResult,'base64','utf-8');
Memo1.Lines.Add('Decoded result:');
Memo1.Lines.Add(CkStringBuilder__getAsString(sbResult));

// A sample of a decoded error response:

// <?xml version="1.0" encoding="utf-8"?>
// <!--ADOR Acknowledgement 1-->
// <Transmission xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.irs.gov/efile">
//   <Jurisdiction>ALABAMA</Jurisdiction>
//   <TransmissionId>2018-09-1019:14R000000001</TransmissionId>
//   <Timestamp>2018-09-10T19:14:12Z</Timestamp>
//   <Transmitter>
//     <ETIN>00000</ETIN>
//   </Transmitter>
//   <ProcessType>P</ProcessType>
//   <AgentIdentifier>ACK</AgentIdentifier>
//   <AcknowledgementID>0</AcknowledgementID>
//   <AcknowledgementTimeStamp>2018-09-11T21:16:34-05:00</AcknowledgementTimeStamp>
//   <Errors>
//     <Error>Process Type must be 'T' when submitted to Testing Web Service</Error>
//   </Errors>
// </Transmission>

CkHttpResponse_Dispose(resp);

CkStringBuilder_Dispose(sbXml);
CkXml_Dispose(xml);
CkHttp_Dispose(http);
CkXml_Dispose(xmlResult);
CkStringBuilder_Dispose(sbResult);

end;