Usage

Basic Usage

It is expected that you will use either async/await or Promise syntax to operate the mws-advanced API.

async/await Example

const marketplaces = (async () => await mws.getMarketplaces())();
console.log(marketplaces);

Promises Example

mws.getMarketplaces().then(marketplaces => {
    console.log(marketplaces);
});

Most mws-advanced functions will require at least one, if not several, parameters to function correctly. Most, if not all, parameters will be passed in as an object:

Example of passing parameters in as an object

const getLastSevenDaysOrders = async () => {
    const startDate = new Date();
    startDate.setDate(startDate.getDate() - 7);
    return await mws.listOrders({
        CreatedAfter: startDate,
        MarketplaceId: [ 'A2ZV50J4W1RKNI' ],
    });
};

Obtaining Marketplace Values

One of the first things you should probably do after calling init, is figure out what marketplace(s) you want your calls to operate on. Many of the MWS calls accept either a "MarketplaceId" string parameter to operate on a single marketplace, or a "MarketplaceIdList" Array parameter to provide operation across multiple marketplaces simultaneously.

You can do this by calling getMarketplaces. You probably want to store the values returned by this call somewhere for future use.

See also Using multiple marketplaces in the Amazon MWS documentation.

Advanced Usage

Using an authToken to operate on someone else's MWS account

See Using your API access for a different Amazon Seller

Report Processing

A large document can be written on Report Processing, and probably will in the future. For right now, please see the official MWS documentation: Reports Overview

Also, please note that the reporting functions are currently mostly just stubs, and will likely undergo significant changes, as we use them, and discover where they are lacking.