bethrezen / amazon-mws
Library to interface with Amazon MWS
0.1.16
2017-04-25 19:44 UTC
Requires
- php: >= 5.4
- guzzlehttp/guzzle: ~6.0
- league/csv: ^8.1
- spatie/array-to-xml: ^2.1
This package is auto-updated.
Last update: 2024-10-11 14:53:02 UTC
README
This is a fork of https://github.com/meertensm/amazon-mws package.
Added:
- ListOrdersByNextToken.
Interaction with the Amazon Api for vendors called MWS
Installation:
$ composer require mcs/amazon-mws
Initiate the client
require_once 'vendor/autoload.php'; $client = new MCS\MWSClient([ 'Marketplace_Id' => '', 'Seller_Id' => '', 'Access_Key_ID' => '', 'Secret_Access_Key' => '', 'MWSAuthToken' => '' // Optional. Only use this key if you are a third party user/developer ]); // Optionally check if the supplied credentials are valid if ($client->validateCredentials()) { // Credentials are valid } else { // Credentials are not valid }
Get orders
$fromDate = new DateTime('2016-01-01'); $orders = $client->ListOrders($fromDate); foreach ($orders as $order) { $items = $client->ListOrderItems($order['AmazonOrderId']); print_r($order); print_r($items); }
Get product attributes
$searchField = 'ASIN'; // Can be GCID, SellerSKU, UPC, EAN, ISBN, or JAN $result = $client->GetMatchingProductForId([ '<ASIN1>', '<ASIN2>', '<ASIN3>' ], $searchField); print_r($result);
Create or update a product
$product = new MCS\MWSProduct(); $product->sku = 'TESTNOTFORSALE'; $product->price = '1000.00'; $product->product_id = 'B0031S9***'; $product->product_id_type = 'ASIN'; $product->condition_type = 'New'; $product->quantity = 10; if ($product->validate()) { // You can also submit an array of MWSProduct objects $result = $client->postProduct($product); } else { $errors = $product->getValidationErrors(); }
Update product stock
$result = $client->updateStock([ 'sku1' => 20, 'sku2' => 9, ]); print_r($result); $info = $client->GetFeedSubmissionResult($result['FeedSubmissionId']); print_r($info);
Update product pricing
$result = $client->updatePrice([ 'sku1' => '20.99', 'sku2' => '100.00', ]); print_r($result); $info = $client->GetFeedSubmissionResult($result['FeedSubmissionId']); print_r($info);
Reports
For all report types, visit: http://docs.developer.amazonservices.com
$reportId = $client->RequestReport('_GET_MERCHANT_LISTINGS_DATA_'); // Wait a couple of minutes and get it's content $report_content = $client->GetReport($reportId); print_r($report_content);
Available methods
View source for detailed argument description. All methods starting with an uppercase character are also documented in the Amazon MWS documentation
// Returns the current competitive price of a product, based on ASIN. $client->GetCompetitivePricingForASIN($asin_array = []); // Returns the feed processing report and the Content-MD5 header. $client->GetFeedSubmissionResult($FeedSubmissionId); // Returns pricing information for the lowest-price active offer listings for up to 20 products, based on ASIN. $client->GetLowestOfferListingsForASIN($asin_array = [], $ItemCondition = null); // Returns lowest priced offers for a single product, based on ASIN. $client->GetLowestPricedOffersForASIN($asin, $ItemCondition = 'New'); // Returns a list of products and their attributes, based on a list of ASIN, GCID, SellerSKU, UPC, EAN, ISBN, and JAN values. $client->GetMatchingProductForId($asin_array, $type = 'ASIN'); // Returns a list of products and their attributes, based on an open text based query $client->ListMatchingProducts($query, $query_context_id = null); // Returns pricing information for your own offer listings, based on ASIN. $client->GetMyPriceForASIN($asin_array = [], $ItemCondition = null); // Returns pricing information for your own offer listings, based on SKU. $client->GetMyPriceForSKU($sku_array = [], $ItemCondition = null); // Returns an order based on the AmazonOrderId values that you specify. $client->GetOrder($AmazonOrderId); // Returns the parent product categories that a product belongs to, based on ASIN. $client->GetProductCategoriesForASIN($ASIN); // Returns the parent product categories that a product belongs to, based on SellerSKU. $client->GetProductCategoriesForSKU($SellerSKU); // Get a report's content $client->GetReport($ReportId); // Returns a list of reports that were created in the previous 90 days. $client->GetReportList($ReportTypeList = []); // Get a report's processing status $client->GetReportRequestStatus($ReportId); // Returns a list of marketplaces that the seller submitting the request can sell in, and a list of participations that include seller-specific information in that marketplace $client->ListMarketplaceParticipations(); // Returns order items based on the AmazonOrderId that you specify. $client->ListOrderItems($AmazonOrderId); // Returns orders created or updated during a time frame that you specify. $client->ListOrders($from, $allMarketplaces = false, $states = ['Unshipped', 'PartiallyShipped'], $FulfillmentChannel = 'MFN'); // Returns your active recommendations for a specific category or for all categories for a specific marketplace. $client->ListRecommendations($RecommendationCategory = null); // Creates a report request and submits the request to Amazon MWS. $client->RequestReport($report, $StartDate = null, $EndDate = null); // Uploads a feed for processing by Amazon MWS. $client->SubmitFeed($FeedType, $feedContent, $debug = false); // Call this method to get the raw feed instead of sending it $client->debugNextFeed(); // Post to create or update a product (_POST_FLAT_FILE_LISTINGS_DATA_) $client->postProduct($MWSProduct); // Update a product's price $client->updatePrice($array); // Update a product's stock quantity $client->updateStock($array); // A method to quickly check if the supplied credentials are valid $client->validateCredentials();