Page 1

AMAZON MWS API 1


WHAT IS MWS API? • MWS STAND FOR MARKETPLACE WEB SERVICE • AMAZON MARKETPLACE WEB SERVICE (AMAZON MWS) IS AN INTEGRATED WEB SERVICE API THAT HELPS AMAZON SELLERS TO PROGRAMMATICALLY EXCHANGE DATA ON LISTINGS, ORDERS, PAYMENTS, REPORTS, AND MORE. • XML DATA INTEGRATION WITH AMAZON ENABLES HIGHER LEVELS OF SELLING AUTOMATION, WHICH HELPS SELLERS GROW THEIR BUSINESS. BY USING AMAZON MWS, SELLERS CAN INCREASE SELLING EFFICIENCY, REDUCE LABOR REQUIREMENTS, AND IMPROVE RESPONSE TIME TO CUSTOMERS • THERE ARE NO FEES ASSOCIATED WITH AMAZON MWS, BUT TO USE THE AMAZON MWS API YOU MUST HAVE AN AMAZON MWS-ELIGIBLE SELLER ACCOUNT AND YOU MUST REGISTER TO USE AMAZON MWS.

2


BASIC REQUIREMENT FOR MWS API 1) MWS END POINTS 2) MARKET PLACE ID 3) SELLER ID 4) AUTH TOKEN 5) SECRET KEY 6) ACCESS KEY ID

3


1)MWS ENDPOINT • FOR USE OF MWS API YOU NEED TO SPECIFY YOUR SELLER ACCOUNT ENDPOINT • END POINT IS KIND OF REGION OF YOUR SELLER ACCOUNT • FOR EXAMPLE IF YOUR ACCOUNT BELONGS TO NORTH AMERICA (NA) THEN YOUR ENDPOINT IS HTTPS://MWS.AMAZONSERVICES.COM YOU CAN FIND LIST OF REGIONS HERE HTTP:// DOCS.DEVELOPER.AMAZONSERVICES.COM/EN_IN/DEV_GUIDE/DG_ENDPOIN TS.HTML

2) MARKETPLACE • EVERY SELLER ACCOUNT HAS ITS MARKETPLACE ID WHICH YOU CAN DEFINE BASED ON REGION OF SELLER CENTRAL ACCOUNT YOU USE • EVERY REGIONS HAS ITS DIFFERENT MARKETPLACE ID SO ITS NECESSARY TO DEFINE MARKETPLACE ID WHEN YOU USE MWS API • YOU CAN FIND LIST OF MARKET PLACE ID HERE HTTP://DOCS.DEVELOPER.AMAZONSERVICES.COM/EN_IN/DEV_GUIDE/D G_ENDPOINTS.HTML

4


3) SELLERID • EVERY SELLER HAS HIS UNIQUE SELLERID THIS IS GENERATE WHEN SELLER HAS REGISTER FOR MWS API USE. THIS PARAMETER IS COMPULSORY WHEN YOU USE MWS API

4) AUTH TOKEN • EVERY SELLER HAS HIS UNIQUE AUTH TOKEN THIS IS GENERATE WHEN SELLER HAS REGISTER FOR MWS API USE. THIS PARAMETER IS COMPULSORY WHEN YOU USE MWS API

5) SECRETKEY • EVERY SELLER HAS HIS UNIQUE SECRETKEY THIS IS GENERATE WHEN SELLER HAS REGISTER FOR MWS API USE. THIS PARAMETER IS COMPULSORY WHEN YOU USE MWS API

6) AWSACCESSKEYID • EVERY SELLER HAS HIS UNIQUE AWSACCESSKEYID THIS IS GENERATE WHEN 5 SELLER HAS REGISTER FOR MWS API USE. THIS PARAMETER IS COMPULSORY WHEN YOU USE MWS API


LIST OF MWS API REFERENCE BELOW ARE THE WIDELY USED API • • • • • • •

FEEDS FINANCES ORDER PRODUCT RECOMMENDATION REPORTS SUBSCRIPTION

6


GLIMPS OF API REFERENCES FEEDS  FEEDS API LETS YOU UPLOAD INVENTORY AND ORDER DATA TO AMAZON. YOU CAN ALSO USE THE AMAZON MWS FEEDS API SECTION TO GET INFORMATION ABOUT THE PROCESSING OF FEEDS.  LIST OF OPERATION PERFORM ON FEEDS API  SUBMITFEED  GETFEEDSUBMISSIONLIST  GETFEEDSUBMISSIONLISTBYNEXTTOKEN  GETFEEDSUBMISSIONCOUNT  CANCELFEEDSUBMISSIONS  GETFEEDSUBMISSIONRESULT 7


FINANCES  THE FINANCES API ENABLES YOU TO OBTAIN FINANCIAL INFORMATION RELEVANT TO YOUR BUSINESS WITH AMAZON. YOU CAN OBTAIN FINANCIAL EVENTS FOR A GIVEN ORDER, FINANCIAL EVENT GROUP, OR DATE RANGE WITHOUT HAVING TO WAIT UNTIL A STATEMENT PERIOD CLOSES. YOU CAN ALSO OBTAIN FINANCIAL EVENT GROUPS FOR A GIVEN DATE RANGE.  LIST OF OPERATION PERFORM ON FINANCES API  LISTFINANCIALEVENTGROUPS  LISTFINANCIALEVENTGROUPSBYNEXTTOKEN  LISTFINANCIALEVENTS  LISTFINANCIALEVENTSBYNEXTTOKEN  GETSERVICESTATUS

8


ORDERS

 WITH THE ORDERS YOU CAN BUILD SIMPLE APPLICATIONS THAT RETRIEVE ONLY THE ORDER INFORMATION THAT YOU NEED. THIS ENABLES YOU TO DEVELOP FAST, FLEXIBLE, CUSTOM APPLICATIONS IN AREAS LIKE ORDER SYNCHRONIZATION, ORDER RESEARCH, AND DEMAND-BASED DECISION SUPPORT TOOLS.  LIST OF OPERATION PERFORM ON ORDERS API  LISTORDERS  LISTORDERSBYNEXTTOKEN  GETORDER  LISTORDERITEMS  LISTORDERITEMSBYNEXTTOKEN

9


PRODUCT API

THE PRODUCTS API  HELPS YOU GET INFORMATION TO MATCH YOUR PRODUCTS TO EXISTING PRODUCT LISTINGS ON AMAZON MARKETPLACE WEBSITES AND TO MAKE SOURCING AND PRICING DECISIONS FOR LISTING THOSE PRODUCTS ON AMAZON MARKETPLACE WEBSITES. THE AMAZON MWS PRODUCTS API RETURNS PRODUCT ATTRIBUTES, CURRENT MARKETPLACE PRICING INFORMATION, AND A VARIETY OF OTHER PRODUCT AND LISTING INFORMATION.

LIST OF OPERATION PERFORM ON ORDERS API  LISTMATCHINGPRODUCTS  GETMATCHINGPRODUCT  GETMATCHINGPRODUCTFORID  GETCOMPETITIVEPRICINGFORSKU  GETLOWESTOFFERLISTINGSFORSKU  GETLOWESTOFFERLISTINGSFORASIN  GETLOWESTPRICEDOFFERSFORSKU  GETLOWESTPRICEDOFFERSFORASIN  GETMYFEESESTIMATE  GETMYPRICEFORSKU  GETMYPRICEFORASIN  GETPRODUCTCATEGORIESFORSKU  GETPRODUCTCATEGORIESFORASIN

10


RECOMMENDATIONS API

 THE RECOMMENDATIONS API SECTION OF AMAZON MWS ENABLES YOU TO PROGRAMMATICALLY RETRIEVE AMAZON SELLING COACH RECOMMENDATIONS BY RECOMMENDATION CATEGORY. A RECOMMENDATION IS AN ACTIONABLE, TIMELY, AND PERSONALIZED OPPORTUNITY TO INCREASE YOUR SALES AND PERFORMANCE. RECOMMENDATIONS ARE PROVIDED FOR THE FOLLOWING CATEGORIES:

• INVENTORY: RECOMMENDATIONS FOR RESTOCKING LOW OR OUT-OF-STOCK ITEMS IN YOUR INVENTORY. • SELECTION: RECOMMENDATIONS FOR NEW PRODUCT OPPORTUNITIES TO LIST ON AMAZON. • PRICING: RECOMMENDATIONS TO REVIEW PRICING ON ITEMS IN YOUR INVENTORY WHERE YOUR OFFER IS NOT THE LOWEST PRICE. • FULFILLMENT: RECOMMENDATIONS FOR THE TOP PRODUCTS TO FULFILL THROUGH FULFILLMENT BY AMAZON (FBA). • LISTING QUALITY: RECOMMENDATIONS FOR FIXING YOUR CURRENT LISTING DEFECTS. • GLOBAL SELLING: RECOMMENDATIONS FOR EXPANDING YOUR PRODUCTS TO MORE REGIONS AND MARKETPLACES. • ADVERTISING: RECOMMENDATIONS FOR ADVERTISING YOUR PRODUCTS AND FOR USING THE SPONSORED PRODUCTS PROGRAM.

 LIST OF OPERATION PERFORM ON RECOMMENDATIONS API  GETLASTUPDATEDTIMEFORRECOMMENDATIONS  LISTRECOMMENDATIONS

11


REPORT

 THE REPORTS API LETS YOU REQUEST VARIOUS REPORTS THAT HELP YOU MANAGE YOUR SELL ON AMAZON BUSINESS.  THERE ARE AROUND 50 TO 60 TYPES OF REPORTS THAT YOU CAN GENERATE USING MWS API . THESE REPORTS ARE CATEGORIES INTO FOLLOWING TYPE • LISTINGS REPORTS • ORDER REPORTS • ORDER TRACKING REPORTS • PENDING ORDER REPORTS • PERFORMANCE REPORTS • SETTLEMENT REPORTS • FULFILLMENT BY AMAZON (FBA) REPORTS • SALES TAX REPORTS • BROWSE TREE REPORTS 12


REPORT

 LIST OF OPERATION PERFORM ON RECOMMENDATIONS API • REQUESTREPORT • GETREPORTREQUESTLIST • GETREPORTREQUESTLISTBYNEXTTOKEN • GETREPORTREQUESTCOUNT • PERFORMANCE REPORTS • CANCELREPORTREQUESTS • GETREPORTLIST • GETREPORTLISTBYNEXTTOKEN • GETREPORTCOUNT • GETREPORT • MANAGEREPORTSCHEDULE • GETREPORTSCHEDULELIST • GETREPORTSCHEDULECOUNT

13


REPORT  WHEN YOU WORKING WITH REPORTS API PLEASE MAKE SURE YOU ENTER VALID REPORT NAME YOU WANT TO GENERATE  ALSO IF YOU WORKING WITH REPORT PLEASE TAKE A NOT THAT WHEN YOU REQUEST ANY REPORT TO GENERATE IT WILL GO INTO MWS QUEUE SO SOMETIME IT WILL TAKE TIME TO GENERATE YOU CAN’T DIRECTLY FIND RESPONSE OF THE REPORTS  THERE ARE SOME REPORT THAT YOU CAN NOT GENERATE DIRECTLY YOU HAVE TO ADD REPORT IN TO SCHEDULE API ONCE YOU SET SCHEDULE THE REPORT IT WILL AUTOMATICALLY GENERATE REPORT ACCORDING TO YOUR SETTING

14


SELLER

 THE SELLER AP LETS SELLERS RETRIEVE INFORMATION ABOUT THEIR SELLER ACCOUNT, SUCH AS THE MARKETPLACES THEY PARTICIPATE IN. ALONG WITH LISTING THE MARKETPLACES THAT A SELLER CAN SELL IN, THE API ALSO PROVIDES ADDITIONAL INFORMATION ABOUT THE MARKETPLACE SUCH AS THE DEFAULT LANGUAGE AND THE DEFAULT CURRENCY. THE API ALSO PROVIDES SELLER-SPECIFIC INFORMATION SUCH AS WHETHER THE SELLER HAS SUSPENDED LISTINGS IN THAT MARKETPLACE  LIST OF OPERATION PERFORM ON SELLER API • LISTMARKETPLACEPARTICIPATIONS • LISTMARKETPLACEPARTICIPATIONSBYNEXTTOKEN

15


HOW TO INTEGRATE MWS API  SINCE AMAZON PROVIDE ALL LIBRARY FOR THAT YOU DON’T NEED TO WRITE ANY CODE YOU HAVE TO JUST DOWNLOAD THE LIBRARY OF API YOU WANT TO INTEGRATE  AMAZON PROVIDE THE LIBRARY FOR PHP,JAVA,C#  ONCE YOU PLACED LIBRARY INTO YOU APPLICATION YOU HAVE TO JUST CALL LIBRARY FUNCTION FROM YOU CODE  SINCE AMAZON PROVIDE THE RESPONSE DATA INTO XML YOU NEED TO CONVERT THAT INTO ARRAY OR THE FORMAT YOU WANT.  LET LOOK AT THE EXAMPLE FOR INTEGRATION 16


17


18


19


20


www.drsarma.in

21


www.drsarma.in

22


ERROR HANDLING IN MWS API

www.drsarma.in

23


POINTS TO TAKE CARE  ONCE THE DATA RETURNS YOU NEED TO CONVERT INTO THE FORMAT YOU WANT BECAUSE AMAZON RETURN RESPONSE ALWAYS IN XML FORMAT  THERE ARE LIMIT ON EVERY REQUEST YOU MAKE USING MWS API. EVERY API HAS DIFFERENT LIMIT FOR EXAMPLE YOU CAN MAKE ONLY 30 REQUEST OF LIST ORDER API IN 1 MINUTE OTHER WISE MWS WILL THROWS THROTTLE ERROR.  OTHER NOTABLE THING IS WHEN YOU WORKING WITH MULTIPLE SELLER OR YOU DEVELOPING PRODUCT BASE APPLICATION FOR AMAZON SELLERS YOU HAVE TO CREATE YOU OWN DEVELOPER APPLICATION AFTER CREATING THAT YOU WILL RECEIVE ACCESSKEYID AND SECRET KEY WHICH YOU CAN USE IN ALL THE SELLER CENTRAL ACCOUNT WITHIN APPLICATION

24


Kanhasoft.com India +91 99133-44050Â USA +1 618-300-1610

25

What is MWS API and Basic requirement for It  

Amazon Marketplace Web Service (Amazon MWS) is an integrated Web service API that helps Amazon sellers to programmatically exchange data on...

What is MWS API and Basic requirement for It  

Amazon Marketplace Web Service (Amazon MWS) is an integrated Web service API that helps Amazon sellers to programmatically exchange data on...

Advertisement