C#
C#
Amazon SP-API Get Specific Order
See more Amazon SP-API Examples
Get a specific Amazon Seller order.Chilkat C# Downloads
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
string orderId = "TEST_CASE_200";
Chilkat.AuthAws authAws = new Chilkat.AuthAws();
authAws.AccessKey = "AWS_ACCESS_KEY";
authAws.SecretKey = "AWS_SECRET_KEY";
authAws.ServiceName = "execute-api";
// Use the region that is correct for your needs.
authAws.Region = "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
Chilkat.JsonObject jsonLwaToken = new Chilkat.JsonObject();
success = jsonLwaToken.LoadFile("qa_data/tokens/sp_api_lwa_token.json");
if (success == false) {
Debug.WriteLine("Failed to load LWA access token.");
return;
}
// Must use the non-sandbox domain for getting the RDT.
Chilkat.Rest rest = new Chilkat.Rest();
success = rest.Connect("sellingpartnerapi-eu.amazon.com",443,true,true);
if (success == false) {
Debug.WriteLine(rest.LastErrorText);
return;
}
success = rest.SetAuthAws(authAws);
// Add the x-amz-access-token request header.
string lwa_token = jsonLwaToken.StringOf("access_token");
rest.ClearAllHeaders();
rest.AddHeader("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"]
// }
// ]
// }
Chilkat.StringBuilder sbPath = new Chilkat.StringBuilder();
sbPath.Append("/orders/v0/orders/");
sbPath.Append(orderId);
Chilkat.JsonObject jsonRc = new Chilkat.JsonObject();
jsonRc.UpdateString("restrictedResources[0].method","GET");
jsonRc.UpdateString("restrictedResources[0].path",sbPath.GetAsString());
jsonRc.UpdateString("restrictedResources[0].dataElements[0]","buyerInfo");
jsonRc.UpdateString("restrictedResources[0].dataElements[1]","shippingAddress");
Chilkat.StringBuilder sbRequest = new Chilkat.StringBuilder();
jsonRc.EmitSb(sbRequest);
Chilkat.StringBuilder sbResponse = new Chilkat.StringBuilder();
string uri = "/tokens/2021-03-01/restrictedDataToken";
success = rest.FullRequestSb("POST",uri,sbRequest,sbResponse);
if (success == false) {
Debug.WriteLine(rest.LastErrorText);
return;
}
// Examine the response status.
int statusCode = rest.ResponseStatusCode;
if (statusCode != 200) {
Debug.WriteLine("Response status code: " + Convert.ToString(statusCode));
Debug.WriteLine("Response status text: " + rest.ResponseStatusText);
Debug.WriteLine("Response body: ");
Debug.WriteLine(sbResponse.GetAsString());
Debug.WriteLine("Failed.");
return;
}
// Get the restricted data token.
Chilkat.JsonObject jsonResp = new Chilkat.JsonObject();
jsonResp.LoadSb(sbResponse);
string restrictedDataToken = jsonResp.StringOf("restrictedDataToken");
Debug.WriteLine("Restricted Data Token: " + 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("sandbox.sellingpartnerapi-eu.amazon.com",443,true,true);
if (success == false) {
Debug.WriteLine(rest.LastErrorText);
return;
}
success = rest.SetAuthAws(authAws);
rest.ClearAllHeaders();
rest.AddHeader("x-amz-access-token",restrictedDataToken);
rest.ClearAllQueryParams();
rest.AddQueryParam("MarketplaceIds","ATVPDKIKX0DER");
rest.ClearAllPathParams();
rest.AddPathParam("{orderId}",orderId);
uri = "/orders/v0/orders/{orderId}";
success = rest.FullRequestNoBodySb("GET",uri,sbResponse);
if (success == false) {
Debug.WriteLine(rest.LastErrorText);
return;
}
// Examine the response status.
statusCode = rest.ResponseStatusCode;
if (statusCode != 200) {
Debug.WriteLine("Response status text: " + rest.ResponseStatusText);
Debug.WriteLine("Response body: ");
Debug.WriteLine(sbResponse.GetAsString());
Debug.WriteLine("Failed.");
return;
}
Debug.WriteLine(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
Chilkat.JsonObject json = new Chilkat.JsonObject();
json.LoadSb(sbResponse);
string strVal;
string AmazonOrderId = json.StringOf("payload.AmazonOrderId");
string PurchaseDate = json.StringOf("payload.PurchaseDate");
string LastUpdateDate = json.StringOf("payload.LastUpdateDate");
string OrderStatus = json.StringOf("payload.OrderStatus");
string FulfillmentChannel = json.StringOf("payload.FulfillmentChannel");
string SalesChannel = json.StringOf("payload.SalesChannel");
string ShipServiceLevel = json.StringOf("payload.ShipServiceLevel");
string CurrencyCode = json.StringOf("payload.OrderTotal.CurrencyCode");
string Amount = json.StringOf("payload.OrderTotal.Amount");
int NumberOfItemsShipped = json.IntOf("payload.NumberOfItemsShipped");
int NumberOfItemsUnshipped = json.IntOf("payload.NumberOfItemsUnshipped");
string PaymentMethod = json.StringOf("payload.PaymentMethod");
bool IsReplacementOrder = json.BoolOf("payload.IsReplacementOrder");
string MarketplaceId = json.StringOf("payload.MarketplaceId");
string ShipmentServiceLevelCategory = json.StringOf("payload.ShipmentServiceLevelCategory");
string OrderType = json.StringOf("payload.OrderType");
string EarliestShipDate = json.StringOf("payload.EarliestShipDate");
string LatestShipDate = json.StringOf("payload.LatestShipDate");
string EarliestDeliveryDate = json.StringOf("payload.EarliestDeliveryDate");
string LatestDeliveryDate = json.StringOf("payload.LatestDeliveryDate");
bool IsBusinessOrder = json.BoolOf("payload.IsBusinessOrder");
bool IsPrime = json.BoolOf("payload.IsPrime");
bool IsGlobalExpressEnabled = json.BoolOf("payload.IsGlobalExpressEnabled");
bool IsPremiumOrder = json.BoolOf("payload.IsPremiumOrder");
bool IsSoldByAB = json.BoolOf("payload.IsSoldByAB");
bool IsIBA = json.BoolOf("payload.IsIBA");
string Name = json.StringOf("payload.DefaultShipFromLocationAddress.Name");
string AddressLine1 = json.StringOf("payload.DefaultShipFromLocationAddress.AddressLine1");
string City = json.StringOf("payload.DefaultShipFromLocationAddress.City");
string StateOrRegion = json.StringOf("payload.DefaultShipFromLocationAddress.StateOrRegion");
string PostalCode = json.StringOf("payload.DefaultShipFromLocationAddress.PostalCode");
string CountryCode = json.StringOf("payload.DefaultShipFromLocationAddress.CountryCode");
string Phone = json.StringOf("payload.DefaultShipFromLocationAddress.Phone");
string AddressType = json.StringOf("payload.DefaultShipFromLocationAddress.AddressType");
string FulfillmentSupplySourceId = json.StringOf("payload.FulfillmentInstruction.FulfillmentSupplySourceId");
bool IsISPU = json.BoolOf("payload.IsISPU");
bool IsAccessPointOrder = json.BoolOf("payload.IsAccessPointOrder");
bool HasAutomatedShippingSettings = json.BoolOf("payload.AutomatedShippingSettings.HasAutomatedShippingSettings");
string EasyShipShipmentStatus = json.StringOf("payload.EasyShipShipmentStatus");
string ElectronicInvoiceStatus = json.StringOf("payload.ElectronicInvoiceStatus");
int i = 0;
int count_i = json.SizeOfArray("payload.PaymentMethodDetails");
while (i < count_i) {
json.I = i;
strVal = json.StringOf("payload.PaymentMethodDetails[i]");
i = i + 1;
}
Debug.WriteLine("Success!");