(Delphi ActiveX) Walmart - Send Shipping Notification

Note: This example uses classes, properties, or methods discontinued in Chilkat v11.0.0 or greater.

See Shipping notifications/updates for more information about this call.

Note: This example requires Chilkat v9.5.0.67 or greater.

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

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Chilkat_TLB;

...

procedure TForm1.Button1Click(Sender: TObject);
var
sbUrl: TChilkatStringBuilder;
success: Integer;
numReplaced: Integer;
requestMethod: WideString;
authUtil: TChilkatAuthUtil;
wmConsumerId: WideString;
wmPrivateKey: WideString;
jsonStr: WideString;
json: TChilkatJsonObject;
http: TChilkatHttp;
lineNumber: Integer;
shippingStatus: WideString;
quantity: Integer;
carrier: WideString;
shippingMethod: WideString;
trackingNumber: WideString;
dtNow: TCkDateTime;
shipDateTime: WideString;
xmlBody: TChilkatXml;
orderLine: IChilkatXml;
orderLineStatus: IChilkatXml;
resp: IChilkatHttpResponse;
xml: TChilkatXml;

begin
// ---------------------------------------------------------------------------------------------------------
// Note: This example is deprecated.  The Walmart API no longer uses the Signature method of authenticating.
// Walmart now uses OAuth2.  
// ---------------------------------------------------------------------------------------------------------

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

// Sends the following POST request:
// POST https://marketplace.walmartapis.com/v3/orders/{purchaseOrderId}/shipping

sbUrl := TChilkatStringBuilder.Create(Self);
success := sbUrl.Append('https://marketplace.walmartapis.com/v3/orders/{purchaseOrderId}/shipping');
numReplaced := sbUrl.Replace('{purchaseOrderId}','1111691995111');

requestMethod := 'POST';

// First we need to generate a signature for our request.
// The signature needs to be re-generated for each new Walmart HTTP request.
authUtil := TChilkatAuthUtil.Create(Self);

wmConsumerId := 'WALMART_CONSUMER_ID';
wmPrivateKey := 'WALMART_PRIVATE_KEY';
jsonStr := authUtil.WalmartSignature(sbUrl.GetAsString(),wmConsumerId,wmPrivateKey,requestMethod);
if (authUtil.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add(authUtil.LastErrorText);
    Exit;
  end;

// The JSON returned by WalmartSignature contains the values to be used in the following
// header fields: WM_SEC.AUTH_SIGNATURE, WM_SEC.TIMESTAMP, and WM_QOS.CORRELATION_ID
json := TChilkatJsonObject.Create(Self);
json.Load(jsonStr);

http := TChilkatHttp.Create(Self);
http.SetRequestHeader('WM_SVC.NAME','Walmart Marketplace');
http.SetRequestHeader('WM_QOS.CORRELATION_ID',json.StringOf('correlation_id'));
http.SetRequestHeader('WM_SEC.TIMESTAMP',json.StringOf('timestamp'));
http.SetRequestHeader('WM_SEC.AUTH_SIGNATURE',json.StringOf('signature'));
http.SetRequestHeader('WM_CONSUMER.ID',wmConsumerId);
http.SetRequestHeader('WM_CONSUMER.CHANNEL.TYPE','WALMART_CHANNEL_TYPE');
http.Accept := 'application/xml';

// Note: Do not explicitly set the "Host" header.  Chilkat will set it automatically.

// The body of the POST request will be XML that looks something like this:

// 	<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
// 	<ns2:orderShipment
// 	    xmlns:ns2="http://walmart.com/mp/v3/orders"
// 	    xmlns:ns3="http://walmart.com/">
// 	    <ns2:orderLines>
// 	        <ns2:orderLine>
// 	            <ns2:lineNumber>2</ns2:lineNumber>
// 	            <ns2:orderLineStatuses>
// 	                <ns2:orderLineStatus>
// 	                    <ns2:status>Shipped</ns2:status>
// 	                    <ns2:statusQuantity>
// 	                        <ns2:unitOfMeasurement>Each</ns2:unitOfMeasurement>
// 	                        <ns2:amount>1</ns2:amount>
// 	                    </ns2:statusQuantity>
// 	                    <ns2:trackingInfo>
// 	                        <ns2:shipDateTime>2016-06-27T05:30:15.000Z</ns2:shipDateTime>
// 	                        <ns2:carrierName>
// 	                            <ns2:carrier>FedEx</ns2:carrier>
// 	                        </ns2:carrierName>
// 	                        <ns2:methodCode>Standard</ns2:methodCode>
// 	                        <ns2:trackingNumber>12333634122</ns2:trackingNumber>
// 	                    </ns2:trackingInfo>
// 	                </ns2:orderLineStatus>
// 	            </ns2:orderLineStatuses>
// 	        </ns2:orderLine>
// 	    </ns2:orderLines>
// 	</ns2:orderShipment>

// Build the XML request body:
lineNumber := 1;
shippingStatus := 'Shipped';
quantity := 1;
carrier := 'USPS';
shippingMethod := 'Standard';
trackingNumber := '9999869903501929298999';

dtNow := TCkDateTime.Create(Self);
dtNow.SetFromCurrentSystemTime();
shipDateTime := dtNow.GetAsTimestamp(0);

xmlBody := TChilkatXml.Create(Self);
xmlBody.Tag := 'ns2:orderShipment';
xmlBody.AddAttribute('xmlns:ns2','http://walmart.com/mp/v3/orders');
xmlBody.AddAttribute('xmlns:ns3','http://walmart.com/');
xmlBody.UpdateChildContentInt('ns2:orderLines|ns2:orderLine|ns2:lineNumber',lineNumber);

orderLine := xmlBody.GetChildWithTag('ns2:orderLines|ns2:orderLine');
orderLine.UpdateChildContent('ns2:orderLineStatuses|ns2:orderLineStatus|ns2:status',shippingStatus);

orderLineStatus := orderLine.GetChildWithTag('ns2:orderLineStatuses|ns2:orderLineStatus');
orderLineStatus.UpdateChildContent('ns2:statusQuantity|ns2:unitOfMeasurement','Each');
orderLineStatus.UpdateChildContentInt('ns2:statusQuantity|ns2:amount',quantity);
orderLineStatus.UpdateChildContent('ns2:trackingInfo|ns2:shipDateTime',shipDateTime);
orderLineStatus.UpdateChildContent('ns2:trackingInfo|ns2:carrierName|ns2:carrier',carrier);
orderLineStatus.UpdateChildContent('ns2:trackingInfo|ns2:methodCode',shippingMethod);
orderLineStatus.UpdateChildContent('ns2:trackingInfo|ns2:trackingNumber',trackingNumber);

Memo1.Lines.Add('POST request body:');
Memo1.Lines.Add(xmlBody.GetXml());
Memo1.Lines.Add('--');

// This is a simple POST that can be sent w/ the PostXml method.
// Explicitly set the Content-Type header, otherwise "text/xml" will be used.
http.SetRequestHeader('Content-Type','application/xml');
resp := http.PostXml(sbUrl.GetAsString(),xmlBody.GetXml(),'utf-8');
if (http.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add(http.LastErrorText);
    Exit;
  end;

xml := TChilkatXml.Create(Self);
xml.LoadXml(resp.BodyStr);

// A successful response should have a 200 response status
if (resp.StatusCode <> 200) then
  begin
    Memo1.Lines.Add(xml.GetXml());
    Memo1.Lines.Add('Response Status Code: ' + IntToStr(resp.StatusCode));
    Memo1.Lines.Add('Failed.');

    Exit;
  end;

// Show the XML response..
Memo1.Lines.Add(xml.GetXml());
Memo1.Lines.Add('--');
Memo1.Lines.Add('Success!');
end;