Sample code for 30+ languages & platforms
Unicode C++

Amazon SP-API Get Specific Order

See more Amazon SP-API Examples

Get a specific Amazon Seller order.

Chilkat Unicode C++ Downloads

Unicode C++
#include <CkAuthAwsW.h>
#include <CkJsonObjectW.h>
#include <CkRestW.h>
#include <CkStringBuilderW.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    //  Gets information for this order ID
    //  The order ID is something like "902-1845936-5435065" and it is the AmazonOrderId returned in the JSON when getting the list of orders.  For example:
    //  {
    //    "payload": {
    //      "CreatedBefore": "1.569521782042E9",
    //      "Orders": [
    //        {
    //          "AmazonOrderId": "902-1845936-5435065",
    //          "PurchaseDate": "1970-01-19T03:58:30Z",
    //  ...

    //  However, when using the sandbox, instead use the explicit keyword TEST_CASE_200
    const wchar_t *orderId = L"TEST_CASE_200";

    CkAuthAwsW authAws;
    authAws.put_AccessKey(L"AWS_ACCESS_KEY");
    authAws.put_SecretKey(L"AWS_SECRET_KEY");
    authAws.put_ServiceName(L"execute-api");
    //  Use the region that is correct for your needs.
    authAws.put_Region(L"eu-west-1");

    //  First get a restricted data token for the given order ID.
    //  This requires an LWA access token which cannot be more than 1 hour old.
    //  See Fetch SP-API LWA Access Token
    CkJsonObjectW jsonLwaToken;
    success = jsonLwaToken.LoadFile(L"qa_data/tokens/sp_api_lwa_token.json");
    if (success == false) {
        wprintf(L"Failed to load LWA access token.\n");
        return;
    }

    //  Must use the non-sandbox domain for getting the RDT.
    CkRestW rest;
    success = rest.Connect(L"sellingpartnerapi-eu.amazon.com",443,true,true);
    if (success == false) {
        wprintf(L"%s\n",rest.lastErrorText());
        return;
    }

    success = rest.SetAuthAws(authAws);

    //  Add the x-amz-access-token request header.
    const wchar_t *lwa_token = jsonLwaToken.stringOf(L"access_token");
    rest.ClearAllHeaders();
    rest.AddHeader(L"x-amz-access-token",lwa_token);

    //  We're going to send a POST with the following JSON body:

    //  {
    //    "restrictedResources": [
    //      {
    //        "method": "GET",
    //        "path": "/orders/v0/orders/{orderId}",
    //        "dataElements": ["buyerInfo", "shippingAddress"]
    //      }
    //    ]
    //  }

    CkStringBuilderW sbPath;
    sbPath.Append(L"/orders/v0/orders/");
    sbPath.Append(orderId);

    CkJsonObjectW jsonRc;
    jsonRc.UpdateString(L"restrictedResources[0].method",L"GET");
    jsonRc.UpdateString(L"restrictedResources[0].path",sbPath.getAsString());
    jsonRc.UpdateString(L"restrictedResources[0].dataElements[0]",L"buyerInfo");
    jsonRc.UpdateString(L"restrictedResources[0].dataElements[1]",L"shippingAddress");

    CkStringBuilderW sbRequest;
    jsonRc.EmitSb(sbRequest);

    CkStringBuilderW sbResponse;
    const wchar_t *uri = L"/tokens/2021-03-01/restrictedDataToken";
    success = rest.FullRequestSb(L"POST",uri,sbRequest,sbResponse);
    if (success == false) {
        wprintf(L"%s\n",rest.lastErrorText());
        return;
    }

    //  Examine the response status.
    int statusCode = rest.get_ResponseStatusCode();
    if (statusCode != 200) {
        wprintf(L"Response status code: %d\n",statusCode);
        wprintf(L"Response status text: %s\n",rest.responseStatusText());
        wprintf(L"Response body: \n");
        wprintf(L"%s\n",sbResponse.getAsString());
        wprintf(L"Failed.\n");
        return;
    }

    //  Get the restricted data token.
    CkJsonObjectW jsonResp;
    jsonResp.LoadSb(sbResponse);
    const wchar_t *restrictedDataToken = jsonResp.stringOf(L"restrictedDataToken");
    wprintf(L"Restricted Data Token: %s\n",restrictedDataToken);

    //  ------------------------------------------------------------------------------------------------------------
    //  ------------------------------------------------------------------------------------------------------------
    //  Now that we have the RDT, we can use it to get information about the order.
    //  
    //  Yes, the SP-API is horribly tedious and painful.  You must use an RDT specifically tailored to each request requiring an RDT,
    //  the RDT must not be over an hour old, and if you need to get a new RDT you must get it using an LWA token that itself is not
    //  more than an hour old.  If the LWA is more than an hour old, you must get a new one.  Ughhh!!!!!
    //  ------------------------------------------------------------------------------------------------------------

    //  Disconnect from the non-sandbox domain.  This example will use the sandbox.
    //  (The RDT was obtained using the non-sandbox domain.  For some reason, the sandbox domain does not work for getting the RDT.)
    rest.Disconnect(100);

    success = rest.Connect(L"sandbox.sellingpartnerapi-eu.amazon.com",443,true,true);
    if (success == false) {
        wprintf(L"%s\n",rest.lastErrorText());
        return;
    }

    success = rest.SetAuthAws(authAws);

    rest.ClearAllHeaders();
    rest.AddHeader(L"x-amz-access-token",restrictedDataToken);

    rest.ClearAllQueryParams();
    rest.AddQueryParam(L"MarketplaceIds",L"ATVPDKIKX0DER");

    rest.ClearAllPathParams();
    rest.AddPathParam(L"{orderId}",orderId);

    uri = L"/orders/v0/orders/{orderId}";
    success = rest.FullRequestNoBodySb(L"GET",uri,sbResponse);
    if (success == false) {
        wprintf(L"%s\n",rest.lastErrorText());
        return;
    }

    //  Examine the response status.
    statusCode = rest.get_ResponseStatusCode();
    if (statusCode != 200) {
        wprintf(L"Response status text: %s\n",rest.responseStatusText());
        wprintf(L"Response body: \n");
        wprintf(L"%s\n",sbResponse.getAsString());
        wprintf(L"Failed.\n");
        return;
    }

    wprintf(L"%s\n",sbResponse.getAsString());

    //  If successful, gets a JSON response such as the following:

    //  {
    //    "payload": {
    //      "AmazonOrderId": "902-1845936-5435065",
    //      "PurchaseDate": "1970-01-19T03:58:30Z",
    //      "LastUpdateDate": "1970-01-19T03:58:32Z",
    //      "OrderStatus": "Unshipped",
    //      "FulfillmentChannel": "MFN",
    //      "SalesChannel": "Amazon.com",
    //      "ShipServiceLevel": "Std US D2D Dom",
    //      "OrderTotal": {
    //        "CurrencyCode": "USD",
    //        "Amount": "11.01"
    //      },
    //      "NumberOfItemsShipped": 0,
    //      "NumberOfItemsUnshipped": 1,
    //      "PaymentMethod": "Other",
    //      "PaymentMethodDetails": [
    //        "Standard"
    //      ],
    //      "IsReplacementOrder": false,
    //      "MarketplaceId": "ATVPDKIKX0DER",
    //      "ShipmentServiceLevelCategory": "Standard",
    //      "OrderType": "StandardOrder",
    //      "EarliestShipDate": "1970-01-19T03:59:27Z",
    //      "LatestShipDate": "1970-01-19T04:05:13Z",
    //      "EarliestDeliveryDate": "1970-01-19T04:06:39Z",
    //      "LatestDeliveryDate": "1970-01-19T04:15:17Z",
    //      "IsBusinessOrder": false,
    //      "IsPrime": false,
    //      "IsGlobalExpressEnabled": false,
    //      "IsPremiumOrder": false,
    //      "IsSoldByAB": false,
    //      "IsIBA": false,
    //      "DefaultShipFromLocationAddress": {
    //        "Name": "MFNIntegrationTestMerchant",
    //        "AddressLine1": "2201 WESTLAKE AVE",
    //        "City": "SEATTLE",
    //        "StateOrRegion": "WA",
    //        "PostalCode": "98121-2778",
    //        "CountryCode": "US",
    //        "Phone": "+1 480-386-0930 ext. 73824",
    //        "AddressType": "Commercial"
    //      },
    //      "FulfillmentInstruction": {
    //        "FulfillmentSupplySourceId": "sampleSupplySourceId"
    //      },
    //      "IsISPU": false,
    //      "IsAccessPointOrder": false,
    //      "AutomatedShippingSettings": {
    //        "HasAutomatedShippingSettings": false
    //      },
    //      "EasyShipShipmentStatus": "PendingPickUp",
    //      "ElectronicInvoiceStatus": "NotRequired"
    //    }
    //  }

    //  Use this online tool to generate parsing code from sample JSON: 
    //  Generate Parsing Code from JSON

    CkJsonObjectW json;

    json.LoadSb(sbResponse);

    const wchar_t *strVal = 0;

    const wchar_t *AmazonOrderId = json.stringOf(L"payload.AmazonOrderId");
    const wchar_t *PurchaseDate = json.stringOf(L"payload.PurchaseDate");
    const wchar_t *LastUpdateDate = json.stringOf(L"payload.LastUpdateDate");
    const wchar_t *OrderStatus = json.stringOf(L"payload.OrderStatus");
    const wchar_t *FulfillmentChannel = json.stringOf(L"payload.FulfillmentChannel");
    const wchar_t *SalesChannel = json.stringOf(L"payload.SalesChannel");
    const wchar_t *ShipServiceLevel = json.stringOf(L"payload.ShipServiceLevel");
    const wchar_t *CurrencyCode = json.stringOf(L"payload.OrderTotal.CurrencyCode");
    const wchar_t *Amount = json.stringOf(L"payload.OrderTotal.Amount");
    int NumberOfItemsShipped = json.IntOf(L"payload.NumberOfItemsShipped");
    int NumberOfItemsUnshipped = json.IntOf(L"payload.NumberOfItemsUnshipped");
    const wchar_t *PaymentMethod = json.stringOf(L"payload.PaymentMethod");
    bool IsReplacementOrder = json.BoolOf(L"payload.IsReplacementOrder");
    const wchar_t *MarketplaceId = json.stringOf(L"payload.MarketplaceId");
    const wchar_t *ShipmentServiceLevelCategory = json.stringOf(L"payload.ShipmentServiceLevelCategory");
    const wchar_t *OrderType = json.stringOf(L"payload.OrderType");
    const wchar_t *EarliestShipDate = json.stringOf(L"payload.EarliestShipDate");
    const wchar_t *LatestShipDate = json.stringOf(L"payload.LatestShipDate");
    const wchar_t *EarliestDeliveryDate = json.stringOf(L"payload.EarliestDeliveryDate");
    const wchar_t *LatestDeliveryDate = json.stringOf(L"payload.LatestDeliveryDate");
    bool IsBusinessOrder = json.BoolOf(L"payload.IsBusinessOrder");
    bool IsPrime = json.BoolOf(L"payload.IsPrime");
    bool IsGlobalExpressEnabled = json.BoolOf(L"payload.IsGlobalExpressEnabled");
    bool IsPremiumOrder = json.BoolOf(L"payload.IsPremiumOrder");
    bool IsSoldByAB = json.BoolOf(L"payload.IsSoldByAB");
    bool IsIBA = json.BoolOf(L"payload.IsIBA");
    const wchar_t *Name = json.stringOf(L"payload.DefaultShipFromLocationAddress.Name");
    const wchar_t *AddressLine1 = json.stringOf(L"payload.DefaultShipFromLocationAddress.AddressLine1");
    const wchar_t *City = json.stringOf(L"payload.DefaultShipFromLocationAddress.City");
    const wchar_t *StateOrRegion = json.stringOf(L"payload.DefaultShipFromLocationAddress.StateOrRegion");
    const wchar_t *PostalCode = json.stringOf(L"payload.DefaultShipFromLocationAddress.PostalCode");
    const wchar_t *CountryCode = json.stringOf(L"payload.DefaultShipFromLocationAddress.CountryCode");
    const wchar_t *Phone = json.stringOf(L"payload.DefaultShipFromLocationAddress.Phone");
    const wchar_t *AddressType = json.stringOf(L"payload.DefaultShipFromLocationAddress.AddressType");
    const wchar_t *FulfillmentSupplySourceId = json.stringOf(L"payload.FulfillmentInstruction.FulfillmentSupplySourceId");
    bool IsISPU = json.BoolOf(L"payload.IsISPU");
    bool IsAccessPointOrder = json.BoolOf(L"payload.IsAccessPointOrder");
    bool HasAutomatedShippingSettings = json.BoolOf(L"payload.AutomatedShippingSettings.HasAutomatedShippingSettings");
    const wchar_t *EasyShipShipmentStatus = json.stringOf(L"payload.EasyShipShipmentStatus");
    const wchar_t *ElectronicInvoiceStatus = json.stringOf(L"payload.ElectronicInvoiceStatus");
    int i = 0;
    int count_i = json.SizeOfArray(L"payload.PaymentMethodDetails");
    while (i < count_i) {
        json.put_I(i);
        strVal = json.stringOf(L"payload.PaymentMethodDetails[i]");
        i = i + 1;
    }

    wprintf(L"Success!\n");
    }