(MFC) Walmart - Acknowledge Order

See Acknowledge Orders for more information about this call.

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

Acknowledges an entire order, including all of its order lines. Walmart requires a seller to acknowledge orders within four hours of receipt of the order, except in extenuating circumstances.

The response to a successful call contains the acknowledged order.

In general, only orders that are in a “Created” state should be acknowledged. As a good practice, acknowledge your orders to avoid underselling. Orders that are in an “Acknowledged” state can be re-acknowledged, possibly in response to an error response from an earlier call to acknowledge order. Orders with line items that are shipped or canceled should not be re-acknowledged.

Chilkat C/C++ Library Downloads MS Visual C/C++ Libs

See Also: Using MFC CString in Chilkat

#include <CkStringBuilder.h>
#include <CkAuthUtil.h>
#include <CkJsonObject.h>
#include <CkHttp.h>
#include <CkHttpResponse.h>

void ChilkatSample(void)
    {
    CkString strOut;

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

    CkStringBuilder sbUrl;
    bool success = sbUrl.Append("https://marketplace.walmartapis.com/v3/orders/{purchaseOrderId}/acknowledge");
    int numReplaced = sbUrl.Replace("{purchaseOrderId}","1111691995111");

    const char *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.
    CkAuthUtil authUtil;

    const char *wmConsumerId = "WALMART_CONSUMER_ID";
    const char *wmPrivateKey = "WALMART_PRIVATE_KEY";
    const char *jsonStr = authUtil.walmartSignature(sbUrl.getAsString(),wmConsumerId,wmPrivateKey,requestMethod);
    if (authUtil.get_LastMethodSuccess() != true) {
        strOut.append(authUtil.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    // 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
    CkJsonObject json;
    json.Load(jsonStr);

    CkHttp http;
    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);
    // Note: Make sure to replace "WALMART_CHANNEL_TYPE" with the actual value for your seller account...
    http.SetRequestHeader("WM_CONSUMER.CHANNEL.TYPE","WALMART_CHANNEL_TYPE");
    http.put_Accept("application/xml");

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

    // Walmart provides the option to send/receive JSON or XML.  This example will use JSON.
    // Note: Please see the online JSON/XML code generation tools at https://tools.chilkat.io/
    // The online tools generate code to create/parse XML or JSON.  (You copy sample JSON/XML into the online format,
    // and generate code in your selected programming language.  It's a big time saver.)

    http.SetRequestHeader("Accept","application/json");
    // The body of this particular POST request contains just "{}". (The order ID is already in the URL path.)
    CkHttpResponse *resp = http.PostJson2(sbUrl.getAsString(),"application/json","{}");
    if (http.get_LastMethodSuccess() != true) {
        strOut.append(http.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    // Get the JSON response body, which could contain an error, or if successful contains
    // the acknowledged order.
    CkStringBuilder sbBody;
    resp->GetBodySb(sbBody);

    // A successful response should have a 200 response status
    if (resp->get_StatusCode() != 200) {
        strOut.append(sbBody.getAsString());
        strOut.append("\r\n");
        strOut.append("Response Status Code: ");
        strOut.appendInt(resp->get_StatusCode());
        strOut.append("\r\n");
        strOut.append("Failed.");
        strOut.append("\r\n");
        delete resp;
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    delete resp;

    // Parse the JSON response.
    // A sample response is shown below this code.  (The online tools at https://tools.chilkat.io were used to generate the 
    // fragment of code below using the sample response data at 
    // https://developer.walmart.com/#/apicenter/marketPlace/latest?country=us#acknowledgingOrders

    json.LoadSb(sbBody);
    const char *orderPurchaseOrderId = 0;
    const char *orderCustomerOrderId = 0;
    const char *orderCustomerEmailId = 0;
    int orderOrderDate;
    const char *orderShippingInfoPhone = 0;
    int orderShippingInfoEstimatedDeliveryDate;
    int orderShippingInfoEstimatedShipDate;
    const char *orderShippingInfoMethodCode = 0;
    const char *orderShippingInfoPostalAddressName = 0;
    const char *orderShippingInfoPostalAddressAddress1 = 0;
    const char *orderShippingInfoPostalAddressAddress2 = 0;
    const char *orderShippingInfoPostalAddressCity = 0;
    const char *orderShippingInfoPostalAddressState = 0;
    const char *orderShippingInfoPostalAddressPostalCode = 0;
    const char *orderShippingInfoPostalAddressCountry = 0;
    const char *orderShippingInfoPostalAddressAddressType = 0;
    int i;
    int count_i;
    const char *lineNumber = 0;
    const char *itemProductName = 0;
    const char *itemSku = 0;
    const char *orderLineQuantityUnitOfMeasurement = 0;
    const char *orderLineQuantityAmount = 0;
    int statusDate;
    bool refundRefundId;
    bool refundRefundComments;
    int j;
    int count_j;
    const char *chargeType = 0;
    const char *chargeName = 0;
    const char *chargeAmountCurrency = 0;
    int chargeAmountAmount;
    const char *taxTaxName = 0;
    const char *taxTaxAmountCurrency = 0;
    int taxTaxAmountAmount;
    const char *status = 0;
    const char *statusQuantityUnitOfMeasurement = 0;
    const char *statusQuantityAmount = 0;
    bool cancellationReason;
    int trackingInfoShipDateTime;
    bool trackingInfoCarrierNameOtherCarrier;
    const char *trackingInfoCarrierNameCarrier = 0;
    const char *trackingInfoMethodCode = 0;
    const char *trackingInfoTrackingNumber = 0;
    const char *trackingInfoTrackingURL = 0;
    const char *refundReason = 0;
    const char *chargeChargeType = 0;
    const char *chargeChargeName = 0;
    const char *chargeChargeAmountCurrency = 0;
    int chargeChargeAmountAmount;
    bool chargeTax;

    orderPurchaseOrderId = json.stringOf("order.purchaseOrderId");
    orderCustomerOrderId = json.stringOf("order.customerOrderId");
    orderCustomerEmailId = json.stringOf("order.customerEmailId");
    orderOrderDate = json.IntOf("order.orderDate");
    orderShippingInfoPhone = json.stringOf("order.shippingInfo.phone");
    orderShippingInfoEstimatedDeliveryDate = json.IntOf("order.shippingInfo.estimatedDeliveryDate");
    orderShippingInfoEstimatedShipDate = json.IntOf("order.shippingInfo.estimatedShipDate");
    orderShippingInfoMethodCode = json.stringOf("order.shippingInfo.methodCode");
    orderShippingInfoPostalAddressName = json.stringOf("order.shippingInfo.postalAddress.name");
    orderShippingInfoPostalAddressAddress1 = json.stringOf("order.shippingInfo.postalAddress.address1");
    orderShippingInfoPostalAddressAddress2 = json.stringOf("order.shippingInfo.postalAddress.address2");
    orderShippingInfoPostalAddressCity = json.stringOf("order.shippingInfo.postalAddress.city");
    orderShippingInfoPostalAddressState = json.stringOf("order.shippingInfo.postalAddress.state");
    orderShippingInfoPostalAddressPostalCode = json.stringOf("order.shippingInfo.postalAddress.postalCode");
    orderShippingInfoPostalAddressCountry = json.stringOf("order.shippingInfo.postalAddress.country");
    orderShippingInfoPostalAddressAddressType = json.stringOf("order.shippingInfo.postalAddress.addressType");
    i = 0;
    count_i = json.SizeOfArray("order.orderLines.orderLine");
    while (i < count_i) {
        json.put_I(i);
        lineNumber = json.stringOf("order.orderLines.orderLine[i].lineNumber");
        itemProductName = json.stringOf("order.orderLines.orderLine[i].item.productName");
        itemSku = json.stringOf("order.orderLines.orderLine[i].item.sku");
        orderLineQuantityUnitOfMeasurement = json.stringOf("order.orderLines.orderLine[i].orderLineQuantity.unitOfMeasurement");
        orderLineQuantityAmount = json.stringOf("order.orderLines.orderLine[i].orderLineQuantity.amount");
        statusDate = json.IntOf("order.orderLines.orderLine[i].statusDate");
        refundRefundId = json.IsNullOf("order.orderLines.orderLine[i].refund.refundId");
        refundRefundComments = json.IsNullOf("order.orderLines.orderLine[i].refund.refundComments");
        j = 0;
        count_j = json.SizeOfArray("order.orderLines.orderLine[i].charges.charge");
        while (j < count_j) {
            json.put_J(j);
            chargeType = json.stringOf("order.orderLines.orderLine[i].charges.charge[j].chargeType");
            chargeName = json.stringOf("order.orderLines.orderLine[i].charges.charge[j].chargeName");
            chargeAmountCurrency = json.stringOf("order.orderLines.orderLine[i].charges.charge[j].chargeAmount.currency");
            chargeAmountAmount = json.IntOf("order.orderLines.orderLine[i].charges.charge[j].chargeAmount.amount");
            taxTaxName = json.stringOf("order.orderLines.orderLine[i].charges.charge[j].tax.taxName");
            taxTaxAmountCurrency = json.stringOf("order.orderLines.orderLine[i].charges.charge[j].tax.taxAmount.currency");
            taxTaxAmountAmount = json.IntOf("order.orderLines.orderLine[i].charges.charge[j].tax.taxAmount.amount");
            j = j + 1;
        }

        j = 0;
        count_j = json.SizeOfArray("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus");
        while (j < count_j) {
            json.put_J(j);
            status = json.stringOf("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].status");
            statusQuantityUnitOfMeasurement = json.stringOf("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].statusQuantity.unitOfMeasurement");
            statusQuantityAmount = json.stringOf("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].statusQuantity.amount");
            cancellationReason = json.IsNullOf("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].cancellationReason");
            trackingInfoShipDateTime = json.IntOf("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.shipDateTime");
            trackingInfoCarrierNameOtherCarrier = json.IsNullOf("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.carrierName.otherCarrier");
            trackingInfoCarrierNameCarrier = json.stringOf("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.carrierName.carrier");
            trackingInfoMethodCode = json.stringOf("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.methodCode");
            trackingInfoTrackingNumber = json.stringOf("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.trackingNumber");
            trackingInfoTrackingURL = json.stringOf("order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.trackingURL");
            j = j + 1;
        }

        j = 0;
        count_j = json.SizeOfArray("order.orderLines.orderLine[i].refund.refundCharges.refundCharge");
        while (j < count_j) {
            json.put_J(j);
            refundReason = json.stringOf("order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].refundReason");
            chargeChargeType = json.stringOf("order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].charge.chargeType");
            chargeChargeName = json.stringOf("order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].charge.chargeName");
            chargeChargeAmountCurrency = json.stringOf("order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].charge.chargeAmount.currency");
            chargeChargeAmountAmount = json.IntOf("order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].charge.chargeAmount.amount");
            chargeTax = json.IsNullOf("order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].charge.tax");
            j = j + 1;
        }

        i = i + 1;
    }

    strOut.append("Success!");
    strOut.append("\r\n");

    // Sample Walmart Order Acknowledge Response:

    // {
    //   "order": {
    //     "purchaseOrderId": "1577684050862",
    //     "customerOrderId": "2861700797280",
    //     "customerEmailId": "jsanthanam@walmartlabs.com",
    //     "orderDate": 1484458949000,
    //     "shippingInfo": {
    //       "phone": "4151234567",
    //       "estimatedDeliveryDate": 1485586800000,
    //       "estimatedShipDate": 1484636400000,
    //       "methodCode": "Value",
    //       "postalAddress": {
    //         "name": "Asha  Chakre",
    //         "address1": "860 W California ave",
    //         "address2": null,
    //         "city": "Sunnyvale",
    //         "state": "CA",
    //         "postalCode": "94086",
    //         "country": "USA",
    //         "addressType": "RESIDENTIAL"
    //       }
    //     },
    //     "orderLines": {
    //       "orderLine": [
    //         {
    //           "lineNumber": "1",
    //           "item": {
    //             "productName": "Kellogg's Rice Krispies Cereal, 24 oz",
    //             "sku": "MGR_07_21_00100123"
    //           },
    //           "charges": {
    //             "charge": [
    //               {
    //                 "chargeType": "PRODUCT",
    //                 "chargeName": "ItemPrice",
    //                 "chargeAmount": {
    //                   "currency": "USD",
    //                   "amount": 19.99
    //                 },
    //                 "tax": {
    //                   "taxName": "Tax1",
    //                   "taxAmount": {
    //                     "currency": "USD",
    //                     "amount": 1.7
    //                   }
    //                 }
    //               }
    //             ]
    //           },
    //           "orderLineQuantity": {
    //             "unitOfMeasurement": "EACH",
    //             "amount": "1"
    //           },
    //           "statusDate": 1487888747000,
    //           "orderLineStatuses": {
    //             "orderLineStatus": [
    //               {
    //                 "status": "Shipped",
    //                 "statusQuantity": {
    //                   "unitOfMeasurement": "EACH",
    //                   "amount": "1"
    //                 },
    //                 "cancellationReason": null,
    //                 "trackingInfo": {
    //                   "shipDateTime": 1485549015000,
    //                   "carrierName": {
    //                     "otherCarrier": null,
    //                     "carrier": "FedEx"
    //                   },
    //                   "methodCode": "Value",
    //                   "trackingNumber": "3445435443441221",
    //                   "trackingURL": "http://walmart.narvar.com/walmart/tracking/Fedex?&type=MP&seller_id=801&promise_date=01/28/2017&dzip=94086&tracking_numbers=3445435443441221"
    //                 }
    //               }
    //             ]
    //           },
    //           "refund": {
    //             "refundId": null,
    //             "refundComments": null,
    //             "refundCharges": {
    //               "refundCharge": [
    //                 {
    //                   "refundReason": "ItemNotReceivedByCustomer",
    //                   "charge": {
    //                     "chargeType": "PRODUCT",
    //                     "chargeName": "Lost in Transit",
    //                     "chargeAmount": {
    //                       "currency": "USD",
    //                       "amount": -0.01
    //                     },
    //                     "tax": null
    //                   }
    //                 }
    //               ]
    //             }
    //           }
    //         }
    //       ]
    //     }
    //   }
    // }


    SetDlgItemText(IDC_EDIT1,strOut.getUnicode());

    }