Dart
Dart
Amazon SP-API Get Specific Order
See more Amazon SP-API Examples
Get a specific Amazon Seller order.Chilkat Dart Downloads
import 'package:chilkat/chilkat.dart';
void main() {
// 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
final orderId = 'TEST_CASE_200';
final authAws = CkAuthAws();
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
final jsonLwaToken = CkJsonObject();
try {
jsonLwaToken.loadFile('qa_data/tokens/sp_api_lwa_token.json');
} on ChilkatException {
print('Failed to load LWA access token.');
return;
}
// Must use the non-sandbox domain for getting the RDT.
final rest = CkRest();
try {
rest.connect('sellingpartnerapi-eu.amazon.com', 443, true, true);
} on ChilkatException catch (e) {
print(e.lastErrorText);
return;
}
rest.setAuthAws(authAws);
// Add the x-amz-access-token request header.
final lwaToken = jsonLwaToken.stringOf('access_token');
rest.clearAllHeaders();
rest.addHeader('x-amz-access-token', lwaToken);
// We're going to send a POST with the following JSON body:
// {
// "restrictedResources": [
// {
// "method": "GET",
// "path": "/orders/v0/orders/{orderId}",
// "dataElements": ["buyerInfo", "shippingAddress"]
// }
// ]
// }
final sbPath = CkStringBuilder();
sbPath.append('/orders/v0/orders/');
sbPath.append(orderId);
final jsonRc = CkJsonObject();
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');
final sbRequest = CkStringBuilder();
jsonRc.emitSb(sbRequest);
final sbResponse = CkStringBuilder();
var uri = '/tokens/2021-03-01/restrictedDataToken';
try {
rest.fullRequestSb('POST', uri, sbRequest, sbResponse);
} on ChilkatException catch (e) {
print(e.lastErrorText);
return;
}
// Examine the response status.
var statusCode = rest.responseStatusCode;
if (statusCode != 200) {
print('Response status code: $statusCode');
print('Response status text: ${rest.responseStatusText}');
print('Response body: ');
print(sbResponse.getAsString());
print('Failed.');
return;
}
// Get the restricted data token.
final jsonResp = CkJsonObject();
jsonResp.loadSb(sbResponse);
final restrictedDataToken = jsonResp.stringOf('restrictedDataToken');
print('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);
try {
rest.connect('sandbox.sellingpartnerapi-eu.amazon.com', 443, true, true);
} on ChilkatException catch (e) {
print(e.lastErrorText);
return;
}
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}';
try {
rest.fullRequestNoBodySb('GET', uri, sbResponse);
} on ChilkatException catch (e) {
print(e.lastErrorText);
return;
}
// Examine the response status.
statusCode = rest.responseStatusCode;
if (statusCode != 200) {
print('Response status text: ${rest.responseStatusText}');
print('Response body: ');
print(sbResponse.getAsString());
print('Failed.');
return;
}
print(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
final json = CkJsonObject();
json.loadSb(sbResponse);
var strVal = '';
final amazonOrderId = json.stringOf('payload.AmazonOrderId');
final purchaseDate = json.stringOf('payload.PurchaseDate');
final lastUpdateDate = json.stringOf('payload.LastUpdateDate');
final orderStatus = json.stringOf('payload.OrderStatus');
final fulfillmentChannel = json.stringOf('payload.FulfillmentChannel');
final salesChannel = json.stringOf('payload.SalesChannel');
final shipServiceLevel = json.stringOf('payload.ShipServiceLevel');
final currencyCode = json.stringOf('payload.OrderTotal.CurrencyCode');
final amount = json.stringOf('payload.OrderTotal.Amount');
final numberOfItemsShipped = json.intOf('payload.NumberOfItemsShipped');
final numberOfItemsUnshipped = json.intOf('payload.NumberOfItemsUnshipped');
final paymentMethod = json.stringOf('payload.PaymentMethod');
final marketplaceId = json.stringOf('payload.MarketplaceId');
final shipmentServiceLevelCategory = json.stringOf('payload.ShipmentServiceLevelCategory');
final orderType = json.stringOf('payload.OrderType');
final earliestShipDate = json.stringOf('payload.EarliestShipDate');
final latestShipDate = json.stringOf('payload.LatestShipDate');
final earliestDeliveryDate = json.stringOf('payload.EarliestDeliveryDate');
final latestDeliveryDate = json.stringOf('payload.LatestDeliveryDate');
final name = json.stringOf('payload.DefaultShipFromLocationAddress.Name');
final addressLine1 = json.stringOf('payload.DefaultShipFromLocationAddress.AddressLine1');
final city = json.stringOf('payload.DefaultShipFromLocationAddress.City');
final stateOrRegion = json.stringOf('payload.DefaultShipFromLocationAddress.StateOrRegion');
final postalCode = json.stringOf('payload.DefaultShipFromLocationAddress.PostalCode');
final countryCode = json.stringOf('payload.DefaultShipFromLocationAddress.CountryCode');
final phone = json.stringOf('payload.DefaultShipFromLocationAddress.Phone');
final addressType = json.stringOf('payload.DefaultShipFromLocationAddress.AddressType');
final fulfillmentSupplySourceId = json.stringOf('payload.FulfillmentInstruction.FulfillmentSupplySourceId');
final easyShipShipmentStatus = json.stringOf('payload.EasyShipShipmentStatus');
final electronicInvoiceStatus = json.stringOf('payload.ElectronicInvoiceStatus');
var i = 0;
final countI = json.sizeOfArray('payload.PaymentMethodDetails');
while (i < countI) {
json.i = i;
strVal = json.stringOf('payload.PaymentMethodDetails[i]');
i++;
}
print('Success!');
}