@bizon/mws-sdk

mws-sdk

SDK for Amazon Marketplace Web Services

Getting started

npm install --save @bizon/mws-sdk

Usage

const MWSClient = require('@bizon/mws-sdk')

const client = new MWSClient({
  accessKeyId: '', // defaults to process.env.MWS_ACCESS_KEY_ID
  secretAccessKey: '', // defaults to process.env.MWS_SECRET_ACCESS_KEY
  sellerId: '',
  mwsToken: '',
  mwsRegion: ''
})

Region and Marketplaces

The MWS documentation defines a list of regions and marketplaces available in each region.

The marketplaces in a region do not all share a common API endpoint, so this library defines a new concept of MWS region, based on the API endpoint. Here’s the list of the available MWS regions:

Generic MWS regions:

Region	API Endpoint	Name
na	mws.amazonservices.com	North America
eu	mws-eu.amazonservices.com	Europe
fe	mws-fe.amazonservices.com	Far East

Country specific MWS regions:

Region	API Endpoint	Name
ca	mws.amazonservices.ca	Canada
mx	mws.amazonservices.com.mx	Mexico
ae	mws.amazonservices.ae	United Arab Emirates
in	mws.amazonservices.in	India
jp	mws.amazonservices.jp	Japan
au	mws.amazonservices.com.au	Australia

This library also allows to specify a list of marketplaces (either 2 letter country codes or Marketplaces IDs) so you can restrict API calls to your marketplace participations:

const client = new MWSClient({
  accessKeyId: '',
  secretAccessKey: '',
  sellerId: '',
  mwsToken: '',
  marketplaces: [
    'A1F83G8C2ARO7P', // UK
    'fr'
  ]
})

Keep in mind that the specified marketplaces will have to be in the same MWS region, otherwise an error will be thrown.

API

Finances

Version: 2015-05-01

listFinancialEvents(options)

Options:

Name	Type	Default
maxResultsPerPage	Number	100
amazonOrderId	String
financialEventGroupId	String
postedAfter	Date
postedBefore	Date
nextToken	String

listFinancialEventGroups(options)

Options:

Name	Type	Default
maxResultsPerPage	Number	100
financialEventGroupStartedAfter	Date
financialEventGroupStartedBefore	Date
nextToken	String

FulfillmentInboundShipment

Version: 2010-10-01

listInboundShipments(options)

Options:

Name	Type	Default
shipmentStatusList	Array<String>
shipmentIdList	Array<String>
lastUpdatedAfter	Date
lastUpdatedBefore	Date
nextToken	String

listInboundShipmentItems(options)

Options:

Name	Type	Default
shipmentId	Array<String>
lastUpdatedAfter	Date
lastUpdatedBefore	Date
nextToken	String

FulfillmentInventory

Version: 2010-10-01

listInventorySupply(options)

Options:

Name	Type	Default
sellerSkus	Array<String>
queryStartDateTime	Date
responseGroup	String
marketplaceId	String
nextToken	String

Orders

Version: 2013-09-01

getOrders(options)

Options:

Name	Type	Default
amazonOrderIds	Array<String>

listOrders(options)

Options:

Name	Type	Default
createdAfter	Date
createdBefore	Date
lastUpdatedAfter	Date
lastUpdatedBefore	Date
orderStatus	String
marketplaceId	Array<String>	Selected region’s marketplaces
fulfillmentChannel	String
paymentMethod	String
buyerEmail	String
sellerOrderId	String
maxResultsPerPage	Number	100
tfmShipmentStatus	String
nextToken	String

listOrderItems(options)

Options:

Name	Type	Default
amazonOrderId	String
nextToken	String

Products

Version: 2011-10-01

getMatchingProduct(options)

Options:

Name	Type	Default
marketplaceId	String
asinList	Array<String>

getMatchingProductForId(options)

Options:

Name	Type	Default
marketplaceId	String
idType	String
idList	Array<String>

getMyPriceForAsin(options)

Options:

Name	Type	Default
marketplaceId	String
asinList	Array<String>
itemCondition	String

getMyPriceForSku(options)

Options:

Name	Type	Default
marketplaceId	String
sellerSkuList	Array<String>
itemCondition	String

getLowestPricedOffersForAsin(options)

Options:

Name	Type	Default
marketplaceId	String
asin	String
itemCondition	String

getLowestPricedOffersForSku(options)

Options:

Name	Type	Default
marketplaceId	String
sellerSku	String
itemCondition	String

Sellers

Version: 2011-07-01

listMarketplaceParticipations(options)

Options:

Name	Type	Default
nextToken	String

Reports

Version: 2009-01-01

requestReport(options)

Options:

Name	Type	Default
reportType	String
startDate	Date
endDate	Date
marketplaces	Array<String>
reportOptions	String

getReportRequestList(options)

Options:

Name	Type	Default
reportRequestIdList	Array<String>
reportTypeList	Array<String>
reportProcessingStatusList	Array<String>
maxCount	Number	100
requestedFromDate	Date
requestedToDate	Date
nextToken	String

getReportList(options)

Options:

Name	Type	Default
maxCount	Number	100
reportTypeList	Array<String>
acknowledged	Boolean
reportRequestIdList	Array<String>
availableFromDate	Date
availableToDate	Date
nextToken	String

getReport(options)

Options:

Name	Type	Default
reportId	String
format	Enum[raw, base64]

Subscriptions

Version: 2013-07-01

registerDestination(options)

Options:

Name	Type	Default
marketplaceId	String
sqsQueueUrl	String

deregisterDestination(options)

Options:

Name	Type	Default
marketplaceId	String
sqsQueueUrl	String

createSubscription(options)

Options:

Name	Type	Default
marketplaceId	String
sqsQueueUrl	String
isEnabled	Boolean	true
notificationType	String

deleteSubscription(options)

Options:

Name	Type	Default
marketplaceId	String
sqsQueueUrl	String
notificationType	String

sendTestNotificationToDestination(options)

Options:

Name	Type	Default
marketplaceId	String
sqsQueueUrl	String

parseNotification(xml)

Parse an XML notification. The following notifications are supported:

• Test
• AnyOfferChanged
• FeedProcessingFinished
• ReportProcessingFinished

Common

All entities except Reports support a getServiceStatus method to retrieve the API status.

License

MIT

Miscellaneous

    ╚⊙ ⊙╝
  ╚═(███)═╝
 ╚═(███)═╝
╚═(███)═╝
 ╚═(███)═╝
  ╚═(███)═╝
   ╚═(███)═╝