(Unicode C) 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++ Linux/CentOS/Heroku C/C++ MAC OS X C/C++ C++ Builder	Solaris C/C++ iOS C/C++ Android C/C++ Raspberry Pi C/C++ Windows Mobile 5.0/Pocket PC 2003	ARM Embedded Linux C/C++ PowerLinux C/C++ FreeBSD C/C++ MinGW C/C++

#include <C_CkStringBuilderW.h>
#include <C_CkAuthUtilW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkHttpW.h>
#include <C_CkHttpResponseW.h>

void ChilkatSample(void)
    {
    HCkStringBuilderW sbUrl;
    BOOL success;
    int numReplaced;
    const wchar_t *requestMethod;
    HCkAuthUtilW authUtil;
    const wchar_t *wmConsumerId;
    const wchar_t *wmPrivateKey;
    const wchar_t *jsonStr;
    HCkJsonObjectW json;
    HCkHttpW http;
    HCkHttpResponseW resp;
    HCkStringBuilderW sbBody;
    const wchar_t *orderPurchaseOrderId;
    const wchar_t *orderCustomerOrderId;
    const wchar_t *orderCustomerEmailId;
    int orderOrderDate;
    const wchar_t *orderShippingInfoPhone;
    int orderShippingInfoEstimatedDeliveryDate;
    int orderShippingInfoEstimatedShipDate;
    const wchar_t *orderShippingInfoMethodCode;
    const wchar_t *orderShippingInfoPostalAddressName;
    const wchar_t *orderShippingInfoPostalAddressAddress1;
    const wchar_t *orderShippingInfoPostalAddressAddress2;
    const wchar_t *orderShippingInfoPostalAddressCity;
    const wchar_t *orderShippingInfoPostalAddressState;
    const wchar_t *orderShippingInfoPostalAddressPostalCode;
    const wchar_t *orderShippingInfoPostalAddressCountry;
    const wchar_t *orderShippingInfoPostalAddressAddressType;
    int i;
    int count_i;
    const wchar_t *lineNumber;
    const wchar_t *itemProductName;
    const wchar_t *itemSku;
    const wchar_t *orderLineQuantityUnitOfMeasurement;
    const wchar_t *orderLineQuantityAmount;
    int statusDate;
    BOOL refundRefundId;
    BOOL refundRefundComments;
    int j;
    int count_j;
    const wchar_t *chargeType;
    const wchar_t *chargeName;
    const wchar_t *chargeAmountCurrency;
    int chargeAmountAmount;
    const wchar_t *taxTaxName;
    const wchar_t *taxTaxAmountCurrency;
    int taxTaxAmountAmount;
    const wchar_t *status;
    const wchar_t *statusQuantityUnitOfMeasurement;
    const wchar_t *statusQuantityAmount;
    BOOL cancellationReason;
    int trackingInfoShipDateTime;
    BOOL trackingInfoCarrierNameOtherCarrier;
    const wchar_t *trackingInfoCarrierNameCarrier;
    const wchar_t *trackingInfoMethodCode;
    const wchar_t *trackingInfoTrackingNumber;
    const wchar_t *trackingInfoTrackingURL;
    const wchar_t *refundReason;
    const wchar_t *chargeChargeType;
    const wchar_t *chargeChargeName;
    const wchar_t *chargeChargeAmountCurrency;
    int chargeChargeAmountAmount;
    BOOL chargeTax;

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

    sbUrl = CkStringBuilderW_Create();
    success = CkStringBuilderW_Append(sbUrl,L"https://marketplace.walmartapis.com/v3/orders/{purchaseOrderId}/acknowledge");
    numReplaced = CkStringBuilderW_Replace(sbUrl,L"{purchaseOrderId}",L"1111691995111");

    requestMethod = L"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 = CkAuthUtilW_Create();

    wmConsumerId = L"WALMART_CONSUMER_ID";
    wmPrivateKey = L"WALMART_PRIVATE_KEY";
    jsonStr = CkAuthUtilW_walmartSignature(authUtil,CkStringBuilderW_getAsString(sbUrl),wmConsumerId,wmPrivateKey,requestMethod);
    if (CkAuthUtilW_getLastMethodSuccess(authUtil) != TRUE) {
        wprintf(L"%s\n",CkAuthUtilW_lastErrorText(authUtil));
        CkStringBuilderW_Dispose(sbUrl);
        CkAuthUtilW_Dispose(authUtil);
        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
    json = CkJsonObjectW_Create();
    CkJsonObjectW_Load(json,jsonStr);

    http = CkHttpW_Create();
    CkHttpW_SetRequestHeader(http,L"WM_SVC.NAME",L"Walmart Marketplace");
    CkHttpW_SetRequestHeader(http,L"WM_QOS.CORRELATION_ID",CkJsonObjectW_stringOf(json,L"correlation_id"));
    CkHttpW_SetRequestHeader(http,L"WM_SEC.TIMESTAMP",CkJsonObjectW_stringOf(json,L"timestamp"));
    CkHttpW_SetRequestHeader(http,L"WM_SEC.AUTH_SIGNATURE",CkJsonObjectW_stringOf(json,L"signature"));
    CkHttpW_SetRequestHeader(http,L"WM_CONSUMER.ID",wmConsumerId);
    // Note: Make sure to replace "WALMART_CHANNEL_TYPE" with the actual value for your seller account...
    CkHttpW_SetRequestHeader(http,L"WM_CONSUMER.CHANNEL.TYPE",L"WALMART_CHANNEL_TYPE");
    CkHttpW_putAccept(http,L"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.)

    CkHttpW_SetRequestHeader(http,L"Accept",L"application/json");
    // The body of this particular POST request contains just "{}". (The order ID is already in the URL path.)
    resp = CkHttpW_PostJson2(http,CkStringBuilderW_getAsString(sbUrl),L"application/json",L"{}");
    if (CkHttpW_getLastMethodSuccess(http) != TRUE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkStringBuilderW_Dispose(sbUrl);
        CkAuthUtilW_Dispose(authUtil);
        CkJsonObjectW_Dispose(json);
        CkHttpW_Dispose(http);
        return;
    }

    // Get the JSON response body, which could contain an error, or if successful contains
    // the acknowledged order.
    sbBody = CkStringBuilderW_Create();
    CkHttpResponseW_GetBodySb(resp,sbBody);

    // A successful response should have a 200 response status
    if (CkHttpResponseW_getStatusCode(resp) != 200) {
        wprintf(L"%s\n",CkStringBuilderW_getAsString(sbBody));
        wprintf(L"Response Status Code: %d\n",CkHttpResponseW_getStatusCode(resp));
        wprintf(L"Failed.\n");
        CkHttpResponseW_Dispose(resp);
        CkStringBuilderW_Dispose(sbUrl);
        CkAuthUtilW_Dispose(authUtil);
        CkJsonObjectW_Dispose(json);
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(sbBody);
        return;
    }

    CkHttpResponseW_Dispose(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

    CkJsonObjectW_LoadSb(json,sbBody);

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

        j = 0;
        count_j = CkJsonObjectW_SizeOfArray(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus");
        while (j < count_j) {
            CkJsonObjectW_putJ(json,j);
            status = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].status");
            statusQuantityUnitOfMeasurement = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].statusQuantity.unitOfMeasurement");
            statusQuantityAmount = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].statusQuantity.amount");
            cancellationReason = CkJsonObjectW_IsNullOf(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].cancellationReason");
            trackingInfoShipDateTime = CkJsonObjectW_IntOf(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.shipDateTime");
            trackingInfoCarrierNameOtherCarrier = CkJsonObjectW_IsNullOf(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.carrierName.otherCarrier");
            trackingInfoCarrierNameCarrier = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.carrierName.carrier");
            trackingInfoMethodCode = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.methodCode");
            trackingInfoTrackingNumber = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.trackingNumber");
            trackingInfoTrackingURL = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].orderLineStatuses.orderLineStatus[j].trackingInfo.trackingURL");
            j = j + 1;
        }

        j = 0;
        count_j = CkJsonObjectW_SizeOfArray(json,L"order.orderLines.orderLine[i].refund.refundCharges.refundCharge");
        while (j < count_j) {
            CkJsonObjectW_putJ(json,j);
            refundReason = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].refundReason");
            chargeChargeType = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].charge.chargeType");
            chargeChargeName = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].charge.chargeName");
            chargeChargeAmountCurrency = CkJsonObjectW_stringOf(json,L"order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].charge.chargeAmount.currency");
            chargeChargeAmountAmount = CkJsonObjectW_IntOf(json,L"order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].charge.chargeAmount.amount");
            chargeTax = CkJsonObjectW_IsNullOf(json,L"order.orderLines.orderLine[i].refund.refundCharges.refundCharge[j].charge.tax");
            j = j + 1;
        }

        i = i + 1;
    }

    wprintf(L"Success!\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
    //                   }
    //                 }
    //               ]
    //             }
    //           }
    //         }
    //       ]
    //     }
    //   }
    // }


    CkStringBuilderW_Dispose(sbUrl);
    CkAuthUtilW_Dispose(authUtil);
    CkJsonObjectW_Dispose(json);
    CkHttpW_Dispose(http);
    CkStringBuilderW_Dispose(sbBody);

    }