SP-APIリリースノート
Selling Partner APIの新機能、ソフトウェアアップデート、および変更ログ。
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repo.
2025年1月29日
APIの変更
- Added the optional response parameter
replenishmentQuantity
to thelistInventory
operation. You can use this parameter to review quantity information for units that are in transit from Amazon Warehousing and Distribution (AWD) to a Fulfillment by Amazon (FBA) facility.
- ベンダー分析データセットには、次のような指標が含まれるようになりました。
sellableInTransitInventory
、unsellableInTransitInventory
、mostRecentSubmitted
、netOrderedGMS
、およびnetShipmentGMS
。これらの指標を使用して、在庫状況を監視したり、フルフィルメントに関する問題を特定したり、販売実績を把握したりできます。
- The response of the
listPackingOptions
operation now describes acceptable packing methods and package weights in thesupportedConfigurations
property. This property replaces thesupportedShippingConfigurations
property.
- Added
sampleLocation
to the response of thegetCompetitiveSummary
operation and the request of thegetFeaturedOfferExpectedPriceBatch
operation. You can use this metric to return location information for featured offers and to retrieve a location-specific feature offer expected price (FOEP).
- Updated the End User Data Report to include support for the Ireland (IE) marketplace.
ドキュメントの変更
- Added a new, interactive API reference for each API, where you can dynamically create requests in multiple languages.
- Added notes the welcome and errors FAQ pages to improve the discoverability of the API Health Dashboard.
- Restructured the VAT Calculation Service guide to improve flow and readability.
- Updated the Vendor Retail Procurement APIs v1 Use Case Guide to include the following operations for business requirements:
getPurchaseOrder
,SubmitShipmentConfirmations
,submitInvoices
, andGetShipmentDetails
. - Added a rate limit topic for each API. These new topics list the usage plans (rate limits and burst values) for each operation. For an example, refer to Data Kiosk API Rate Limits.
- Added a tutorial that shows how to use SP-APIs to retrieve and pass a purchase order number to UPS, FedEx, or USPS. For details, refer to Tutorial: Retrieve and Pass a Purchase Order Number to a Carrier.
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the SP-API Deprecation Schedule.
- The removal date for select Catalog Items API v0 operations has changed from December 11, 2024 to March 31, 2025. The affected operations are:
listCatalogItems
getCatalogItem
2024年12月18日
APIの変更
- Added the expiration property to the
listInventory
andgetInboundShipment
responses. You can use this property to get the expiration date of a perishable item in your shipment. For more information, refer to Track an inbound shipment with expected and received SKU details. - を追加しました
prepDetails
プロパティへlistInventory
そしてgetInboundShipment
レスポンス。このプロパティを使用して、準備オーナー、カテゴリ、説明書、ラベル所有者など、アイテムの準備の詳細を取得できます。
- The Vendor Analytics dataset now includes metrics such as Confirmed Units, Shipped COGS, MSRP, and customer ZIP Code data.
- Added the
searchListingsItems
operation. You can use this operation to return information for multiple listings items based on filters, which include listing IDs, issues, status, and creation date.
- Added
REVENUE_BY_DELIVERIES
,SUBSCRIBER_RETENTION
,REVENUE_PENETRATION_BY_SELLER_FUNDING
, andSHARE_OF_COUPON_SUBSCRIPTIONS
metrics to thegetSellingPartnerMetrics
operation response. These metrics describe the revenue sources and subscription performance. - Added the
SHARE_OF_COUPON_SUBSCRIPTIONS
metric to thelistOfferMetrics
operation response. This metric describes the coupon acquisition performance.
- Added the
storeName
property to thegetMarketplaceParticipations
response. You can use thestoreName
property to get the name of the seller's store as displayed in the marketplace. - Added the
MarketplaceParticipationList
array to thegetAccount
response. TheMarketplaceParticipationList
array replaces the array ofMarketplaceLevelAttributes
. - Removed the
sellingPlan
parameter from theMarketplaceParticipationList
array and added it to the root level of thegetAccount
response. For more information, refer to the Sellers API v1 Use Case Guide. - The
getAccount
operation requires the Account Information Service Provider (AISP) role. For more information about this role, refer to Third-Party Provider Registration.
- The Transfers API v2024-06-01 is now generally available. You can use this API to retrieve information about the payment methods associated with a seller and initiate payouts to a seller's deposit method on file. To use this API, you must select one of the following roles in the app registration page for your application:
この API は EU リージョンで利用できます。
- Added the
createContainerLabel
operation. You can use this operation to create a container (pallet) label.
- ザの
GetShipmentLabels
Vendor Shipments API v1 の運用で、ベンダーの小包ラベルを取得できるようになりました。
アイルランド (IE) へのセラーセントラルマーケットプレイスの拡大
On December 10, 2024, Seller Central launched support for the Ireland (IE) Marketplace. For more information, refer to the SP-API Seller Central URLs, SP-API Endpoints, and Marketplace IDs topics in the SP-API documentation.
英国および EU の SP-API 開発者向けのサードパーティプロバイダーサポート
Sellers in the UK and EU can now authorize third-party provider (TPPs) to access an account holder's account and payment services using the AISP and PISP roles.
For more information, refer to Third-Party Provider Registration and Third-Party Provider FAQ.
ドキュメントの変更
- Updated guidance on how to handle null enum values.
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the SP-API Deprecation Schedule.
-
The removal date for select Catalog Items API v0 operations has changed from December 11, 2024 to January 28, 2025. The affected operations are:
listCatalogItems
getCatalogItem
-
The removal date for the Notifications type value
LISTINGS_ITEM_ISSUES_CHANGE
(payload version 1.0) has changed from December 11, 2024 to March 26, 2025.
2024年11月14日
APIの変更
- Updated the EasyShip API v2022-03-23 for additional marketplace support in the Netherlands (NL) and Poland (PL).
2024年11月12日
APIの変更
- Added
WasPrice
to thegetCompetitiveSummary
operation (in thereferencePrices
list in the operation response).WasPrice
is the 90-day median price that customers pay for the product on Amazon. You can use this value to set promotions and discounts based on the typical price on the product detail page.
2024年11月11日
APIの変更
- Updated the rate limit for the
initiatePayout
operation from 0.5 to 0.017 and updated the burst rate from 30 to 2.
2024年11月6日
APIの変更
- Added the
TransactionNumber
parameter to theAdjustmentItem
object. You can use this parameter to identify what the adjustment is related to. For example, Amazon Shipping customers can use this to get an invoice number that they can use to identify an Amazon Shipping invoice.
- Added the following to the Fulfillment Outbound API v2020-07-01 Use Case Guide:
items
に数量制限が設定されました(品目数は最大100個、1回の注文につき最大250ユニット)。- マーケットプレイスによって異なる配送方法のサービスレベル契約が
shippingSpeedCategory
に含まれました。 DeliveryPreferences
では、対象となる注文の場合、デフォルトの配送設定が置き配に設定されました。
- スロットリングレートを新たに増加させるため、
getEligibleShippingServices
とcreateShipment
オペレーションを更新しました。
- Added Japan (JP) marketplace support for the
getFeaturedOfferExpectedPriceBatch
operation. You can now retrieve the Featured Offer Expected Price (FOEP) for all marketplaces.
ドキュメントの変更
-
Added the following information to Usage Plans and Rate Limits:
- レート制限アルゴリズムの詳細
- レート制限に影響する要因
- レート制限の確認方法
-
次のAPI固有レート制限ページを追加しました。
-
新しいインタラクティブなリファレンスを次のAPIに追加しました。
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the SP-API Deprecation Schedule.
-
Catalog Items API v0 (Select operations)
listCatalogItems
getCatalogItem
-
Fulfillment Inbound API v0 (Select operations)
confirmPreorder
confirmTransport
createInboundShipment
createInboundShipmentPlan
estimateTransport
getPreorderInfo
getTransportDetails
putTransportDetails
updateInboundShipment
voidTransport
For more information, refer to Migrating Fulfillment Inbound workflows.
POST_PRODUCT_DATA
POST_INVENTORY_AVAILABILITY_DATA
POST_PRODUCT_OVERRIDES_DATA
POST_PRODUCT_PRICING_DATA
POST_PRODUCT_IMAGE_DATA
POST_PRODUCT_RELATIONSHIP_DATA
POST_FLAT_FILE_INVLOADER_DATA
POST_FLAT_FILE_BOOKLOADER_DATA
POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
POST_UIEE_BOOKLOADER_DATA
For more information, refer to Migrating product feeds workflows.
LISTING_ITEM_ISSUES_CHANGE
ペイロードバージョン1.0
2024年9月11日
APIの変更
- Added support for the Japan (JP) marketplace. For more information on the marketplaces that support Easy Ship operations, refer to the EasyShip API v2022-03-23 marketplace support table.
- オプションフィールド
deliveryInformation
をGetFulfillmentOrder
レスポンスに追加しました。これを使用してdeliveryDocumentList
を取得できます。これには、配送されたマルチチャネルフルフィルメント出荷の写真または署名が含まれる場合があります。dropOffLocation
を使用して、出荷パッケージが配達された場所を確認できます。
- The Listings Items API v2021-08-01 and
JSON_LISTINGS_FEED
feed type now support Amazon Business (B2B) pricing functionality. - The new Manage Advanced Multiple-Offer and Multiple-Fulfillment Use Cases guide demonstrates how selling partners who are enrolled in the Amazon Business (B2B) program can create multiple offers on a listing, which creates differential pricing between regular buyers on Amazon websites (such as Amazon.com) and business buyers on Amazon Business websites.
- 新しいオプションの検証詳細プロパティを
regulatedInfo
オペレーションに追加しました。出品者はこれらの情報を使用して、処方箋を含む注文を確認できます。 - The Regulated orders guide includes a new tutorial on how to provide additional details about the verification of an order that contains regulated information.
- Updated the
getFeaturedOfferExpectedPriceBatch
to no longer requireofferIdentifier
in theFeaturedOfferExpectedPriceResponseBody
. TheofferIdentifier
parameter is now optional in order to correctly deserializegetFeaturedOfferExpectedPriceBatch
error responses, asFeaturedOfferExpectedPriceResponseBody
doesn’t provideofferIdentifier
in the response when there are errors.
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the SP-API Deprecation Schedule.
2024年8月19日
APIの変更
- Added the optional response parameter
totalInboundQuantity
to thelistInventory
operation. You can use this parameter to track inventory in transit to Amazon Warehousing and Distribution. - Added a new optional request parameter
skuQuantities
to thegetInboundShipment
operation. You can use this parameter to reconcile and compare expected and received inventory for each SKU in a shipment.
You can now use the Amazon Warehousing and Distribution API to:
- Amazonウェアハウジング&ディストリビューションに輸送中の在庫を追跡することで、在庫を隅々まで把握しやすくなります。
- 納品に含まれるSKUごとに、予定在庫と受領在庫の調整と比較を実行します。
2024年8月14日
APIの変更
- 新しい納品不適格列挙値
FBA_INB_0342
をgetItemEligibilityPreview
オペレーションに追加しました。この値により、特定のメーカーのバーコードを商品に使用できない理由が詳しくわかります。
- Added the
getAccount
operation to retrieve information about seller accounts.
-
可変重量商品をサポートするため、新しい
unitOfMeasure
変数を追加しました。この変数は、目方で販売する商品の価格の測定単位を提供します。このフィールドがない場合、その商品は個別に販売されます。この変数を返すオペレーションは次のとおりです。
ドキュメントの変更
- The new Services API v1 Use Case Guide outlines how to access service job details and confirm or reschedule appointments using the Services API v1.
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the deprecations table.
The following operations in the Catalog Items API v0 were deprecated on September 30, 2022 and will be removed on September 25, 2024:
listCatalogItems
getCatalogItem
2024年7月31日
APIの変更
-
Added the
queryStartDate
parameter to thegetFeatureInventory
operation. You can use this parameter to select inventory that has been updated since a specified date. -
The Fulfillment Outbound API v2020-07-01 Use Case Guide provides steps on how to pass the
queryStartDate
parameter when retrieving a list of inventory items that are eligible for a specified fulfillment feature.
ドキュメントの変更
The Selling Partner API Blog will be removed on July 31, 2024. For technical guidance on Selling Partner APIs, refer to the SP-API Documentation site. For supplementary guidance on Selling Partner APIs, refer to Developer University.
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the deprecations table.
The following operations in the Catalog Items API v0 were deprecated on September 30, 2022 and will be removed on September 25, 2024:
listCatalogItems
getCatalogItem
2024年7月8日
APIの変更
- Added the
Benefits
object, which contains a list of included and excluded Amazon benefits from a shipping service offer. Each excluded benefit has a list of reason codes for why it is excluded. Benefits represent services provided by Amazon (for example,CLAIMS_PROTECTED
for A-to-z Guarantee) when sellers purchase shipping through Amazon. Sellers gain insight into what comes with buying a label through Amazon.
2024年6月28日
APIの変更
- Removed the June 27, 2024 updates to Fulfillment Outbound API v2020-07-01 and Merchant Fulfillment v0 API.
2024年6月27日
APIの変更
- The Fulfillment Inbound API v2024-03-20 is now in general availability. You can use this API to select from multiple inbound placement service options and create inbound plans with support for up to 1500 SKUs.
- The Fulfillment Inbound API v2024-03-20 Use Case Guide provides tutorials on how to create shipments and guidance on the fulfillment inbound shipment workflow.
- The Fulfillment Inbound API frequently asked questions includes the benefits of the Fulfillment Inbound API v2024-03-20 and guidance on migrating from the Fulfillment Inbound API v0.
- Migrating Fulfillment Inbound workflows guide you through migrating from the Fulfillment Inbound API v0 to the new Fulfillment Inbound API v2024-03-20.
##### Fulfillment Outbound API v2020-07-01
- Added the queryStartDate
parameter to the getFeatureInventory
operation. Sellers can use this parameter to select inventory that has been updated since a specified date.
- The Fulfillment Outbound API v2020-07-01 Use Case Guide provides steps on how to pass the queryStartDate
parameter when retrieving a list of inventory items that are eligible for a specified fulfillment feature.
##### Merchant Fulfillment v0 API
- Added the Benefits
object, which contains a list of included and excluded Amazon benefits from a shipping service offer. Each excluded benefit has a list of reason codes for why it is excluded. Benefits represent services provided by Amazon (for example, CLAIMS_PROTECTED
for A-to-z Guarantee) when sellers purchase shipping through Amazon. Sellers gain insight into what comes with buying a label through Amazon.
- You can use the new Transfers API v2024-06-01 to initiate payouts and retrieve instrument details sellers' accounts by calling the
initiatePayout
andgetPaymentMethods
operations. For tutorials on how to use the Transfers API v2024-06-01, sellers can refer to the Transfers API v2024-06-01 Use Case Guide. This API is only available in private beta.
ドキュメントの変更
- The Finances v0 Use Case Guide outlines how to retrieve financial information, such as the current balance, transactions, and fund transfer status for your orders using the Finances API v0.
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail beginning on their removal date. For more information about SP-API deprecation dates, refer to the deprecations table.
2024年6月19日
APIの変更
- Sellers can use the new Amazon Warehousing and Distribution API v2024-05-09 to track inventory inside AWD distribution centers and track shipments going into AWD distribution centers.
- The Data Kiosk API v2023-11-05 is now in general availability.
- The new Data Kiosk sample solution provides all the resources that you need to deploy a fully functional SP-API application that automates the creation and retrieval of Data Kiosk documents.
- The new Data Kiosk workflow guide offers insights into best practices, answers common questions about API usage, and outlines optimal workflows.
- The new Vendor Analytics dataset provides vendor data across multiple domains. You can aggregate data across any granularity (ASIN/Brand/Manufacturing/date) and access more than 100 metrics across sales, traffic, inventory, forecast, profitability, and new geographic sales metrics.
- Developers who create or manage applications that integrate with the FBA Inventory API v1 and Fulfillment Outbound API v2020-07-01 can use the two dynamic sandbox environments to test code integrations between the FBA and Fulfillment Outbound API domains. These sandboxes simulate order fulfillment and inventory movements that mimic Amazon's production responses. For more information, refer to the FBA Inventory Dynamic Sandbox Guide.
- Added the new
deliveryOffers
operation. Sellers can use this operation to display Multi-Channel Fulfillment (MCF) standard delivery offers on pre-checkout pages. This operation is only available in the United States (US) marketplace. - Added the optional field
lockerDetails
to thegetFulfillmentOrder
response. Sellers can include the information that is needed to access the locker delivery boxes. This field is only available in the Japan (JP) marketplace. - Added the optional field
deliveryPreferences
to thecreateFulfillmentOrder
request. Sellers can include the delivery preferences that are applied to the destination address. This field is only available in the Japan (JP) marketplace. - Developers who create or manage applications that integrate with the FBA Inventory API v1 and Fulfillment Outbound API v2020-07-01 can use the two dynamic sandbox environments to test code integrations between the FBA and Fulfillment Outbound API domains. These sandboxes simulate order fulfillment and inventory movements that mimic Amazon's production responses. For more information, refer to the Fulfillment Outbound Dynamic Sandbox Guide.
- The
getFeaturedOfferExpectedPriceBatch
operation is now available in all marketplaces except Japan (JP). Sellers can use this operation to get the featured offer expected price (FOEP) data for up to 40 SKUs.
- Added the metrics
LOST_REVENUE_DUE_TO_OOS
,SUBSCRIBER_NON_SUBSCRIBER_AVERAGE_REORDERS
, andCOUPONS_REVENUE_PENETRATION
to thegetSellingPartnerMetrics
operation response. These metrics describe sources of revenue and lost revenue. - Added the metrics
LOST_REVENUE_DUE_TO_OOS
andCOUPONS_REVENUE_PENETRATION
to thelistOfferMetrics
operation response. These metrics describe sources of revenue and lost revenue.
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail beginning on their removal date. For more information about SP-API deprecation dates, refer to the Deprecations table.
2024年6月4日
APIの変更
- 新機能:Amazonの施設に納品物を届ける配達可能期間を表示し、どれか1つを選択する
- 新機能:個々の商品のラベルを印刷する
- Select Partnered Carrier as an option for your less-than-truckload (LTL) shipments
- 納品プランと納品の名前の更新
- 出荷確認後にSKUのユニット数を更新
- Add three new mandatory operations:
confirmDeliveryWindowOptions
,generateDeliveryWindowOptions
, andlistDeliveryWindowOptions
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail beginning on their removal date. For more information about SP-API deprecation dates, refer to the Deprecations table.
The following operations in Fulfillment Inbound API v0 are no longer deprecated:
2024年5月22日
APIの変更
-
Added the
lowestPricedOffers
andreferencePrices
attributes to the Product Pricing API v2022-05-01. This enhancement provides the top 20 lowest priced offers and reference prices. -
In the Product Pricing API v2022-05-01 Use Case Guide, the Tutorial: Retrieve a list of featured offers for a batch of up to 20 ASINs makes use of two new attributes:
lowestPricedOffers
andreferencePrices
. -
Added the Price Adjustment Automation Workflows Guide to our Selling Partner API documentation site. This guide outlines how to leverage the Product Pricing API v2022-05-01 and Pricing notifications to build best-in-class workflows that automate pricing management.
-
Added the Product pricing API and notifications frequently asked questions to our Selling Partner API documentation site. This documentation covers common questions and details for the Product Pricing API v2022-05-01.
classifications
という新しいincludedData
クエリーパラメーターオプションが追加されました。廃止されたMWSGetProductCategoriesForSKU
とGetProductCategoriesForASIN
オペレーションに代わるものです。出品者とベンダーはclassifications
を使用して、ASINに割り当てられている分類ツリーをブラウズできます。
- The Order feeds attributes
POST_ORDER_FULFILLMENT_DATA
andPOST_FLAT_FILE_FULFILLMENT_DATA
are updated with a new field:ship-from-supply-source-id
.
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail beginning on their removal date. For more information about SP-API deprecation dates, refer to the Deprecations table.
2024年4月24日
APIの変更
-
Added the the
CompanyName
attribute to the Orders API v0 API. -
getOrder
、getOrderAddress
、getOrderBuyerInfo
オペレーションのレート制限を0.0167から0.5に更新し、バーストを20から30に増やしました。 -
IsBuyerRequestedCancel
、IsGift
、NumberOfItems
のオブジェクトタイプをブール値/整数から文字列に更新しました。 -
AutomatedCarrier
属性とAutomatedShipMethod
属性を返すようにgetOrders
オペレーションを更新しました。
- ライセンスをAmazonソフトウェアライセンスからApache License 2.0に更新しました。
- 各オペレーションの可能なレスポンスのリストに413 HTTPコードを追加しました。
レポートスキーマの変更
次のベンダーレポートにlastUpdatedDate
フィールドを追加しました。
GET_VENDOR_SALES_REPORT
GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT
GET_VENDOR_TRAFFIC_REPORT
GET_VENDOR_FORECASTING_REPORT
GET_VENDOR_INVENTORY_REPORT
ベンダーセントラルマーケットプレイスのアイルランド (IE) への拡大
On April 23rd, 2024, Vendor Central launched support for Ireland (IE) Marketplace. For more information, refer to the SP-API Vendor Central URLs, SP-API Endpoints, and Marketplace IDs topics in the SP-API documentation.
ドキュメントの変更
- The Orders API v0 Use Case Guide includes new details about order age. Orders more than two years old will not be returned in the API response. The JP, AU, and SG marketplaces are an exception. In those marketplaces the Orders API v0 supports orders from 2016 to present.
廃止の通知
Deprecated SP-API resources will no longer receive technical support. Calls to deprecated SP-API resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
- フルフィルメント納品API v0(選択オペレーション)
createInboundShipmentPlan
updateInboundShipment
createInboundShipment
getPreorderInfo
confirmPreorder
getTransportDetails
putTransportDetails
voidTransport
estimateTransport
confirmTransport
getShipments
getShipmentItemsByShipmentId
getShipmentItems
POST_PRODUCT_DATA
POST_INVENTORY_AVAILABILITY_DATA
POST_PRODUCT_OVERRIDES_DATA
POST_PRODUCT_PRICING_DATA
POST_PRODUCT_IMAGE_DATA
POST_PRODUCT_RELATIONSHIP_DATA
POST_FLAT_FILE_INVLOADER_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_BOOKLOADER_DATA
POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
POST_UIEE_BOOKLOADER_DATA
LISTING_ITEM_ISSUES_CHANGE
ペイロードバージョン1.0
2024年4月1日
APIの変更
- 新しいフルフィルメント納品v2024-03-20 APIへの先行アクセス。FBA納品の作成がサポートされ、複数のインバウンド配置サービスオプションなどから選択できます。
廃止の通知
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
- フルフィルメント納品API v0(選択オペレーション)
createInboundShipmentPlan
updateInboundShipment
createInboundShipment
getPreorderInfo
confirmPreorder
getTransportDetails
putTransportDetails
voidTransport
estimateTransport
confirmTransport
getShipments
getShipmentItemsByShipmentId
getShipmentItems
2024年3月20日
APIの変更
AdditionalAddressNotes
、NdrAction
、NdrRequestData
、SubmitNdrFeedbackRequest
のオブジェクトがndrFeedback parameter
に追加されました。- Added tutorial for Using the ndrFeedback API to submit Non-Delivery Reports for eligible shipments.
- 危険な商品の属性、
LiquidVolume
、IsHazmat
、DangerousGoodsDetails
がアイテムオブジェクトに追加されました。
- Updated Marketplace ASIN Page View Metric report to include support for the UK. For more information about this report, refer to Regulatory Compliance Report Type Values. This change applies to the UK marketplace only.
- Published new Request and retrieve a bulk invoice report for Multi-Channel Fulfillment (MCF) orders for India tutorial to the Request a report tutorial page. The bulk invoice report lets MCF Sellers download the Goods and Service Tax invoice associated with their MCF order in a batch/zip format. Sellers can pass a date range to generate the download request and receive a zip file with delivered MCF order invoices.
- Updated
FEED_PROCESSING_FINISHED
andREPORT_PROCESSING_FINISHED
to include support for vendors. Both notifications include a newaccountId
property, which identifies the selling partner on whose behalf the feed or report was submitted. This change applies to all marketplaces.
PaymentInformation
属性を追加しました。インドでは必須ですが、その他すべてのマーケットプレイスでは省略可能です。- Added tutorial on how to create an MCF order for India in the Fulfillment Outbound API v2020-07-01 Use Case Guide.
ドキュメントの変更
- Added Python and Javascript client libraries for SDKs in the SP-API. To learn more about SP-API SDKs, refer to Using SDKs, Tutorial: Automate your SP-API calls using JavaScript SDK for Node.js, and Tutorial: Automate your SP-API calls using Python SDK.
- レポートタイプ値ページを再フォーマットし、レポートタイプの属性を整理して見つけやすくしました。
廃止の通知
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
- 認証API v1(すべてのオペレーション)
- FBA小型軽量商品API v1(すべてのオペレーション)
- フルフィルメント納品API v0(選択オペレーション)
getInboundGuidance
POST_PRODUCT_DATA
POST_INVENTORY_AVAILABILITY_DATA
POST_PRODUCT_OVERRIDES_DATA
POST_PRODUCT_PRICING_DATA
POST_PRODUCT_IMAGE_DATA
POST_PRODUCT_RELATIONSHIP_DATA
POST_FLAT_FILE_INVLOADER_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_BOOKLOADER_DATA
POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
POST_UIEE_BOOKLOADER_DATA
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
RFQ_UPLOAD_FEED
GET_PRODUCT_EXCHANGE_DATA
GET_FBA_UNO_INVENTORY_DATA
MFN_ORDER_STATUS_CHANGE
LISTING_ITEM_ISSUES_CHANGE
ペイロードバージョン1.0
2024年2月21日
APIの変更
- Added new Report Type Value EndUserDataReport provides personal customer data, including contact information, Glance View, and
Orderdata
for customers who have elected to share this data with the seller when completing a transaction in DE, FR, IT, ES, NL, PL, SE and BE (EU-8) marketplaces.
- アプリケーション管理API v2023-11-30を公開ベータ版から本番に昇格しました。このAPIでは、Amazonアカウントでログイン(LWA)の認証情報(クライアントシークレット)をプログラムでローテーションできます。
ドキュメントの更新
- Added six new code tutorials that detail how to do various tasks such as previewing orders, creating orders, and canceling orders. Find them in the Code Samples section.
廃止の通知
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
RFQ_UPLOAD_FEED
GET_PRODUCT_EXCHANGE_DATA
GET_FBA_UNO_INVENTORY_DATA
MFN_ORDER_STATUS_CHANGE
2024年1月31日
APIの変更
- Added a new validation mode for the
putListingsItem
andpatchListingsItem
operations. Use themode=VALIDATION_PREVIEW
query parameter to validate a listings item without persisting the data in the catalog. This feature allows you to preview listing errors in production without creating listings.
- を追加しました
ShipsInProductPackaging
への価値PrepInstruction
列挙。PrepInstructionList
への呼び出しに対する応答で返されますprepInstructions
。
- 追加しました
ExtendedFields
そしてAddressExtendedFields
オブジェクト。これらのオブジェクトはブラジルの住所でのみ使用でき、拡張フィールドを含むブラジルの配送先住所のレスポンスで返されます。
廃止の通知
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
- 認証API v1(すべてのオペレーション)
- FBA小型軽量商品API v1(すべてのオペレーション)
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
RFQ_UPLOAD_FEED
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
2023年12月13日
APIの変更
- 新しいアプリケーション管理APIを使用すると、Amazonアカウントでログイン(LWA)の認証情報(クライアントシークレット)をプログラムでローテーションできます。公開ベータ版で利用可能です。
- 米国および英国市場では、危険な商品(DG)出荷のサポートが開始されました。
- インド(IN)がサポート対象マーケットプレイスになりました
Issue
オブジェクトに、Enforcements
とCategories
という新規フィールドが追加されました
searchDefinitionsProductTypes
オペレーションタイプは文字列に更新されました
- オプションの
payloadVersion
パラメーターが追加されました - New Listings Item Issues Change Notification version 2023-12-13 has three new enforcement actions:
LISTING_SUPPRESSED
,ATTRIBUTE_SUPPRESSED
, andCATALOG_ITEM_REMOVED
ドキュメントの更新
Vendor Direct Fulfillment Orders API v1 Use Case Guide was updated to include a section on Direct Fulfillment customer data transmission. Vendors do not receive customer data such as name, address, or phone number for certain shipments fulfilled through the getOrder
and getOrders
operations. For Amazon label only vendors, certain fields will be replaced with the fictitious value XXXXX
.
The Vendor Retail Procurement APIs v1 Use Case Guide has been updated to include information on using the Operations SubmitShipments and GetShipmentDetails.
GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA
now includes updated column names. A note has been added to the FBA Long Term Storage Fee Charges Report on the Fulfillment by Amazon (FBA) Report Type Values page, outlining the correct way to generate the report.
フルフィルメントby Amazon(FBA)一括請求書レポート(FBA_BULK_INVOICE
)では、特定の日付範囲内にある出品者の請求書が共有されます。これらの請求書には、出品者が処理した購入者注文が含まれます。
廃止の通知
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
- 認証API v1(すべてのオペレーション)
- FBA小型軽量商品API v1(すべてのオペレーション)
- フルフィルメント納品API v0(選択オペレーション)
getInboundGuidance
- 出品者出荷API v0(選択オペレーション)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
RFQ_UPLOAD_FEED
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
ORDER_STATUS_CHANGE
2023年11月8日
APIの変更
- 新しいサプライソースAPIでは、ストアや倉庫などの出品者サプライソースに関する情報の設定と更新が行われます。
- 英国が有効なマーケットプレイスになりました。
getFeaturedOfferExpectedPriceBatch
(FOEP) has been extended to Amazon.co.uk.ASIN_NOT_ELIGIBLE
はresultStatus
の値になりました。- 新しい
competitiveSummary
オペレーションでは、ASINとmarketplaceId
を組み合わせた注目の購入オプションを含む競合概要レスポンスが返されます。
- 3つの新しいパラメーター(
itemName
、locale
、searchlocale
)および新しいdisplayName
商品タイプが更新されました。
- 更新済みの
ListFinancialEvent
およびListFinancialEventGroups
オペレーションは、期待されるレスポンスとスコープをより明確に伝えます。ChangeRefundTransactions
のレスポンスは、オブジェクトから配列に変更されました。
- 更新済み
weight
フィールドは必須になりました。この変更により、shipmentconfirmations
の呼び出し時にエラーが発生するため、ベンダーはトランザクションステータス中にエラーを待つ必要がなくなります。
ドキュメントの更新
- New Multi-Location Inventory (MLI) Integration guide advises Selling Partners on the APIs and operations that are mandatory for integration with MLI , which allows multi location sellers to provide Amazon with location-level data on their inventory and actual fulfillment capabilities.
- Updated Building Listings Management Workflows Guide now includes steps to retrieve a recommendation using the
itemName
orkeywords
in the List an item that does not already exist in the Amazon catalog workflow.
廃止の通知
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
- 認証API v1(すべてのオペレーション)
- FBA小型軽量商品API v1(すべてのオペレーション)
- フルフィルメント納品API v0(選択オペレーション)
getInboundGuidance
- 出品者出荷API v0(選択オペレーション)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
ORDER_STATUS_CHANGE
2023年10月11日
APIの変更
- 更新済み
ItemProcurement
データ要素は、オブジェクトから配列に変更されました。
- 関連項目のリストが、
getOrderItems
オペレーションのレスポンスに追加されました。
getItemOffers
レスポンスのlistingPrice
属性の名前が変更され、開発者は企業間ユースケース向けにコードを拡張する際にエラーを回避できるようになりました。Landedprice
とShipping
のサブフィールドは必須ではなくオプションになりました。
廃止の通知
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
- 認証API v1(すべてのオペレーション)
- FBA小型軽量商品API v1(すべてのオペレーション)
- フィードAPI v2020-09-04(すべてのオペレーション)
- フルフィルメント納品API v0(選択オペレーション)
getInboundGuidance
- 出品者出荷API v0(選択オペレーション)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
- レポートAPI v2020-09-04(すべてのオペレーション)
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
ORDER_STATUS_CHANGE
2023年9月20日
APIの変更
- 注文v0 APIの
BuyerCompanyName
オペレーションの説明が更新され、配送先住所の会社名がわかりやすくなりました。
ドキュメントの更新
- Updated Building Listings Management Workflows Guide includes guidance for using the Listings Items API to create package hierarchy relationships, which can link units, case packs, and pallets of a product to create a connected listing. For more information, refer to Configuring package hierarchies.
廃止の通知
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
- 認証API v1(すべてのオペレーション)
- FBA小型軽量商品API v1(すべてのオペレーション)
- フィードAPI v2020-09-04(すべてのオペレーション)
- フルフィルメント納品API v0(選択オペレーション)
getInboundGuidance
- 出品者出荷API v0(選択オペレーション)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
- レポートAPI v2020-09-04(すべてのオペレーション)
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
2023年8月16日
APIの変更
- 注文定義の
ShipmentServiceLevelCategory
プロパティが更新され、値Priority
が含まれるようになりました。この値は、フランス、スペイン、ドイツ、ポーランド、オランダ、スウェーデン、ベルギーの各マーケットプレイスで利用できる新しい配送テンプレートから取得でき、出品者が出荷したプライム注文に対応しています。これらの地域で新しい配送テンプレートを統合に使用している場合は、ShipmentServiceLevelCategory
のPriority
の値を受け入れるように統合を更新しなければならない場合があります。
generic_keyword
属性は出品者独自のデータであり、カタログアイテムAPIから返されなくなります。出品パートナーは出品アイテムAPIを使用して、送信された値を確認できます。
ドキュメントの更新
- The SP-API developer documentation site recently published a new Welcome topic. This topic provides resources for migrating to and integrating with SP-API, tips for searching the documentation site, and quick links to popular SP-API content.
- The SP-API developer documentation site has been updated to include new and improved developer registration topics including how to Register as a public developer, how to Register as a private developer, how to Register as a private vendor, how to Apply for restricted (PII) roles, and how to Check the status of your request to register as a developer.
廃止の通知
次のAPIの削除日を調整しました。
これらのAPIの呼び出しは2023年8月16日*から2023年10月18日までスロットルレートが下がります。APIの呼び出しは2023年10月18日に失敗します。
For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
2023年6月21日
APIの変更
Replenishment API
- New Replenishment API v2022-11-07 returns a selling partner's replenishment program (Subscribe & Save) metrics and offer information. This API is available in the following marketplaces: United States of America, Canada, Brazil, Mexico, United Kingdom, Germany, Spain, Italy, France, Netherlands, United Arab Emirates, India, Japan, and Australia.
レポートAPI
- New
MARKETPLACE_ASIN_PAGE_VIEW_METRICS
report provides information on the ASIN page view (glance view) metrics for the DE, FR, IT, ES, NL, PL, SE and BE (EU-8) marketplaces, with data available up to the last seven days.
高速小売分析
- New
GET_VENDOR_REAL_TIME_SALES_REPORT
shares sales data at an ASIN level, aggregated hourly. Requests can span multiple date range periods. - New
GET_VENDOR_REAL_TIME_TRAFFIC_REPORT
shares data on the customer traffic to the detail pages of the vendor's items, aggregated hourly. Requests can span multiple date range periods. - New
GET_VENDOR_REAL_TIME_INVENTORY_REPORT
shares inventory data at an ASIN level, aggregated hourly.
Listings Items API
- Listings Items API now available in the Belgium (BE) marketplace.
Notifications API
- New
LISTINGS_ITEM_MFN_QUANTITY_CHANGE
notification is sent whenever there is change in the available quantity of a listings item. - New
ORDER_CHANGE
notification is sent whenever there is an important change in the order. Important changes include order status changes and buyer requested cancellations. This notification replacesORDER_STATUS_CHANGE
. - The
B2B_ANY_OFFER_CHANGED
notification has been updated to include the Quantity Discount (QD) pricing in theOffer
section, with new attributes including multiple quantity tiers, discount type, and price. You can now use this notification to build QD re-pricing solutions, which eliminates the need to use pricing APIs for this purpose.
高速小売分析
- New
ITEM_SALES_EVENT_CHANGE
notification is sent five minutes after the beginning of each hour. This notification shares sales data at an ASIN level and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs are included when they have orders or cancellations during a given hour. Each notification can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour. - New
ITEM_INVENTORY_EVENT_CHANGE
notification is sent five minutes after the beginning of each hour. This notification shares inventory data at an ASIN level, and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs are included if the number of units available for purchase by customers has changed. Each notification can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour. - New
DETAIL_PAGE_TRAFFIC_EVENT
notification is sent five minutes after the beginning of each hour. This notification shares traffic data at an ASIN level and includes data for the hour before the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs that have glance views are included. Each notification can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.
ドキュメントの更新
- New Migrating Listings Management Workflows guide helps you migrate your existing listings management workflows from XML-based and flat file feeds to the Selling Partner Listings Items API and JSON-based feeds.
- Updated reports schemas repo includes
GET_B2B_PRODUCT_OPPORTUNITIES_RECOMMENDED_FOR_YOU
andGET_B2B_PRODUCT_OPPORTUNITIES_NOT_YET_ON_AMAZON
廃止の通知
廃止を発表したSP-APIリソースは、廃止日を過ぎるとサポートされなくなります。廃止されるリソースへの呼び出しは、削除日以降は失敗します。
For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
2023年5月17日
APIの変更
- 動的サンドボックスを更新して、
createShippingLabels
オペレーションを追加しました。
- 汎用注文承認ワークフローを削除します。
ItemApprovalTypes
属性とItemApprovalStatus
属性は削除されました。
ドキュメントの更新
-
New Reports attributes directory lists all the available attributes in SP-API reports.
-
New Vendor Retail Procurement FAQ includes frequently asked questions regarding the SP-API Vendor Retail Procurement API.
廃止の通知
- フィードAPI v2020-09-04
- レポートAPI v2020-09-04
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
2023年4月19日
APIの変更
city
プロパティ(address
属性)を必須からオプションに更新しました。
sellerSku
フィールドが更新され、カンマが追加されて解析されます。
ドキュメントの更新
- Amazon商品タイプ定義メタスキーマ(v1)が更新され、次のキーワードが追加されました。
$lifecycle
、replacedBy
、replaces
、enumDeprecated
、およびenumReplacement.
。
C#ガイドの更新
- Added two new C# guides: Generate a C# SDK with LWA Token Generation and Authentication and Connect to the Selling Partner API using a generated C# SDK.
廃止の通知
2023年3月29日
APIの変更
nextToken
が更新され、30秒後に期限切れになります。
confirmShipment
オペレーションが追加されました。
address
属性が更新され、都市が追加されました。- 静的サンドボックスの代わりに動的サンドボックスをテストに使用するように、更新されました。サンドボックス専用のオペレーションが1つ追加されました。
ドキュメントの更新
- New Orders API Use Case Guide for the Orders v0 shipment confirmation operation. The
confirmShipment
operation confirms the shipment status for a specified order. It can also be used to edit shipment details of orders that have been shipped. include link to guide (when available) - New use case guide Fulfillment Outbound API Dynamic Sandbox v2020-07-01 explains how test your applications without affecting production data or initiating real-world events.
- Expanded library of reports schemas available on selling-partner-api-models GitHub repo
- 出品アイテムAPIのよくある質問に対応した3つの新しいリソース
廃止の通知
2023年2月22日
APIの変更
- 静的サンドボックスの模擬レスポンスを更新して、一部のUPS国内(米国)配送方法の名前をSP-APIに表示するようにしました。
- Added the following delivery preferences attributes to
getOrderAddress
to support Amazon Business customer orders:PreferredDeliveryTime
BusinessHours
OtherAttributes
AddressInstructions
これらの属性には、パッケージがいつどのように配達されるかについての情報が含まれています。
- The
customedURL
attribute ofbuyerCustomizedInfo
, returned by thegetOrder
andgetOrders
operations, is now a Base 64 encoded URL using the UTF-8 character set.
- クエリーパラメータとして
six-month-past-in-date
を渡すように更新されました。
ドキュメントの更新
- New Amazon Business Orders Use Case Guide introduces operations to obtain information about Amazon Business customers and their delivery preferences.
- New Sales API Use Case Guide provides sellers with sales performance information. This is achieved through returning aggregated order metrics for a given period of time, broken down by granularity, and buyer type.
- New FBA Small & Light Use Case Guide introduces operations to help access the Small and Light FBA program.
廃止の通知
2023年1月25日
APIの変更
- 新しい
getFeaturedOfferExpectedPriceBatch
オペレーションは、最大40件のおすすめ商品予想価格(FOEP)リクエストのバッチ処理に対するレスポンスを取得します。
- 新しい
buyerCustomizedInfo
属性には、ベンダーがカスタマイズ可能に設定した商品の購入者情報が含まれており、カスタマイズまたは設定のタイプ、および商品のタイプと範囲を指定します。
- 新しい
serialNumber
属性は、購入者に配送される電子製品のシリアル番号のリストを返します。FBA注文の場合にのみ返されます。
- 新しいファイナンスイベントタイプ:
CapacityReservationBillingEventList
を使用すると、キャパシティ予約請求料金に関する詳細情報を取得できます。
ドキュメントの更新
- New use case directories identify the APIs, notifications, and reports that you’ll need for general SP-API Seller and Vendor use cases. Additionally, the SP-API models table indicates whether each API is available for sellers or vendors and includes links to each model’s reference and any relevant release notes.
- New Vendor Direct Fulfillment Orders API v2021-23-28 use case guide covers the Vendor DF Orders API, which provides programmatic access to a direct fulfillment vendor's order data.
- New Vendor Direct Fulfillment Transaction Status API v2021-12-28 use case guide covers the Vendor DF Transaction Status API, which provides programmatic access to a direct fulfillment vendor's transaction status.
- Updated dynamic usage plans topic for the Usage Plans and Rate Limits in the SP-API Guide includes the Product Pricing API and
getFeaturedOfferExpectedPriceBatch
operation.
廃止の通知
2022年12月6日
APIの変更
カタログアイテムv2022-04-01 APIが更新されていくつかの属性が概要に追加され、カタログアイテムAPIがマーケットプレイスWebサービスのカタログアイテムセクションと同等のものになりました。
In addition, the following attributes have been added to ItemSummaryByMarketplace
:
adultProduct
autographed
memorabilia
releaseDate
tradeInEligible
2022年11月9日
APIの変更
-
New GST Merchant Tax Report B2B
GET_GST_MTR_B2B_CUSTOM
provides detailed information about sales, refunds, and cancellations from Amazon Business invoices issued within a date range that you specify. Only available in the India Marketplace. -
New GST Merchant Tax Report B2C
GET_GST_MTR_B2C_CUSTOM
provides detailed information about sales, refunds, and cancellations from consumer invoices issued within a date range that you specify. Only available in the India Marketplace. -
New GST Merchant Stock Transfer Report
GET_GST_STR_ADHOC
provides details on inventory movements from Amazon fulfillment centers (FC) (FC removals or FC-to-FC transfers). The report contains transaction level details required for accounting and GST tax filing. Only available in the India Marketplace.
ドキュメントの更新
- New Building Listings Management Workflows Guide describes the steps you can take to build best-in-class listings creation and management workflows by integrating with the Selling Partner API.
2022年10月19日
APIの変更
Updated for new FBA_INVENTORY_AVAILABILITY_CHANGES
notification that is sent whenever there is a change in the Fulfillment By Amazon (FBA) inventory quantities. This notification includes a snapshot of the FBA inventory in all eligible marketplaces in a particular region.
-
Updated
GET_SALES_AND_TRAFFIC_REPORT
, which now includes B2B traffic data regarding traffic originating from Amazon Business customers. As of 08/28/2022 B2B conversion metrics have changed to use the new B2B traffic data. Data before 08/28/2022 is set to zero to avoid confusion. -
New Subscribe and Save Forecasting report
GET_FBA_SNS_FORECAST_DATA
provides an eight-week forecast of sales based on existing subscriptions and sales history. -
New Subscribe and Save Performance report
GET_FBA_SNS_PERFORMANCE_DATA
provides a trailing four-week view of items shipped, percentage of orders missed due to being out of stock, average post-discount sale price, and average discount for each SKU.
ドキュメントの更新
- New Selling Partner API Guard Implementation Guide describes architectural considerations and configuration steps for deploying Amazon Selling Partner Guard in AWS Cloud.
2022年9月21日
APIの変更
- Updated for new createShippingLabels synchronous operation that creates shipping labels for a purchase order and returns the labels. Note that the
createShippingLabels
operation does not have any sandbox support at this time. - ベンダー出品者出荷配送V1と同等のオペレーションすべてについて、実稼働の動的サンドボックスがサポートされるように更新されました。
- 以下の制限付きオペレーションが更新され、ベンダー出品者出荷配送API v2021-12-28をサポートしました。
createShippingLabels
getPackingSlip
getCustomerInvoice
getShippingLabel
- Updated Inventory Ledger Report (
GET_LEDGER_DETAIL_VIEW_DATA
) now includes a neweventType
filter to filter on particular warehouse events.
ドキュメントの更新
- New VAT Calculation Service Guide provides developers in EU marketplaces with guidance for Amazon’s VAT Calculation Service.
- New Solicitations API v1 Use Case Guide covers the Selling Partner API for Solicitations (Solicitations API) which helps you build applications that let sellers send consistent, high-quality solicitations to buyers.
- New Messaging API v1 Use Case Guide discusses the Messaging API.
- New URL encoding guide explains how to encode URLs to avoid errors with SKUs.
- Updated Vendor Direct Fulfillment Dynamic Sandbox Guide includes support for Vendor Direct Fulfillment Shipping v2021-12-28 operations. Note that the createShippingLabels operation does not have any sandbox support at this time.
2022年8月10日
APIの変更
- 注文APIの改善により、Easy Ship配送がサポートされるようになりました。
- 可用性レコードと同様の形式でキャパシティスロットを提供する新しい
getRangeSlotCapacity
オペレーションが追加され更新されました。 - 固定キャパシティスロットを提供する新しい
getFixedSlotCapacity
オペレーションが追加され更新されました。
2022年5月18日
APIの変更
- 新しいカタログアイテムAPIバージョン2022-04-01では、APIのエクスペリエンスが向上し、開発者のフィードバックに対応します。変更点は次のとおりです。
searchCatalogItems
オペレーションに識別子ベースの検索が追加され、リクエストごとに最大20の識別子(ASIN、UPC、EANなど)を使用したバッチのようなリクエストが可能になりました。- 正規化された商品とパッケージの寸法を提供する
dimensions
データセットが追加されました。 - 商品カテゴリー、商品サブカテゴリー、ブラウズ分類の表示名が追加されました。
- 識別属性を商品サマリー(商品分類、パッケージ数量、品番、ウェブサイト表示グループ)に拡張しました。
- ブラウズ分類とウェブサイト表示グループが売上ランキングに追加されました。
searchCatalogItems
オペレーションとgetCatalogItem
オペレーションを調整し、同じデータセット(attributes
など)を使用するようにしました。variations
をrelationships
に置き換え、パッケージ階層など、複数の関係タイプを表すことができるようになりました。- リレーションシップの詳細に、バリエーションテーマの詳細名が追加されました。
- 通知の処理を制御するための追加情報をサブスクリプションに渡すことができる
processingDirective
パラメータが追加されました。このパラメータは、ANY_OFFER_CHANGED
通知によって使用されます。 ANY_OFFER_CHANGED
通知がアップデートされ、特定のmarketplaceIds
のみへの通知をフィルタリングし、5分または10分に1回の間隔に通知を制限できるようになりました。
- 英国で規制対象の注文を管理する購入シールドプログラムのサポートを含むように更新されました。規制対象の注文は、処方箋を必要とする商品(ペット用医薬品、処方箋が必要なコンタクトレンズや眼鏡など)に対応する一連の限定注文です。2つの新しいオペレーション、
getOrderRegulatedInfo
とupdateVerificationStatus
が追加されました。 - 新しい
IsAccessPointOrder
属性により、アクセスポイント(AP)ハブに発送されたMFN(出品者出荷)注文の識別がサポートされるようになりました。
- 商品リストとマーケットプレイスの商品手数料の見積もりを取得する新しい
getMyFeesEstimates
オペレーションが追加され更新されました。
- 製品リストにある商品の価格設定とオファー情報を取得する新しい
getItemOffersBatch
オペレーションとgetListingOffersBatch
オペレーションが追加され更新されました。
- New EPR Monthly Report, EPR Quarterly Report, and EPR Annual Reports report types include data on the Extended Producer Responsibility (EPR) declarations for service providers in France and Germany to help sellers maintain compliance with EU regulations.
2022年4月13日
APIの変更
- New Easy Ship API helps you build applications that help sellers manage and ship Amazon Easy Ship orders.
- Updated FBA Inventory API for global availability and released new FBA Inventory Use Case Guide.
- New
PRICING_HEALTH
notification is sent whenever a seller offer is ineligible to be the Featured Offer (Buy Box offer) because of an uncompetitive price. - New
FulfillmentChannel
property in theORDER_STATUS_CHANGE
notification that allows you to filter order status change notifications based on whether the order is fulfilled by Amazon (AFN) or fulfilled by seller (MFN).
- New Vendor Direct Fulfillment Orders API v2021-12-28 provides programmatic access to a direct fulfillment vendor's order data. This v2021-12-28 release adds support for dynamic sandbox testing.
- New Vendor Direct Fulfillment Sandbox Test Data API v2021-10-28 provides programmatic access to vendor direct fulfillment sandbox test data.
- New Vendor Direct Fulfillment Shipping API v2021-12-28 reference provides programmatic access to a direct fulfillment vendor's shipping data. This v2021-12-28 release adds support for dynamic sandbox testing.
- New Vendor Direct Fulfillment Transactions API v2021-12-28 provides programmatic access to a direct fulfillment vendor's transaction status. This v2021-12-28 release adds support for dynamic sandbox testing.
ドキュメントの更新
- New Vendor Direct Fulfillment Dynamic Sandbox Guide introduces the available dynamic sandbox operations for the Vendor Direct Fulfillment APIs.
- New Vendor Retail Analytics Reports Migration Guide that explains changes to the vendor retail analytics reports and provides steps for migration.
2022年3月23日
APIの変更
- 新しい
buyerRequestedCancel
パラメーターは、購入者が注文のキャンセルを要求したかどうか、およびキャンセルの理由に関する情報を提供します。
New Seller retail analytics reports
- 新しい販売とトラフィックに関するビジネスレポートは、より適切な分析管理に役立ちます。このレポートは、注文商品売上、収益、注文数、請求額などの主要な販売実績指標のほか、出品者の商品カタログ全体におけるページビューやショッピングカートボックス獲得率などのページトラフィック指標を日付とASIN別に集計して提供します。このレポートには、Selling Partner APIのブランド分析ロール(すべての出品者が利用可能)が必要です。
- 新しいクーポンパフォーマンスレポートは、プロモーションの最適化と広告戦略の調整に役立ちます。レポートには、キャンペーンレベルの詳細(合計クリップ数、利用回数)とクーポンレベルの詳細(開始日/終了日、クリップ、利用回数、予算情報)が含まれます。Selling Partner APIのブランド分析ロールを持つベンダーが利用できます。
New Vendor retail analytics reports
- 新しいベンダー売上レポートは、注文/出荷の収益やユニット数など、主要な小売販売指標を提供することで、在庫をより適切に管理できます。データは、ベンダーの商品カタログ全体で集計レベルで報告され、
DAY
、WEEK
、MONTH
、QUARTER
、YEAR
の報告期間全体にわたってASINレベルで報告されます。ブランド分析Selling Partner APIのロールを持つベンダーが利用できます。 - 新しいベンダートラフィックレポートは、詳細ページビューなど、主要な小売トラフィック指標を提供することで、在庫をより適切に管理できます。データは、ベンダーの商品カタログ全体で集計レベルで報告され、
DAY
、WEEK
、MONTH
、QUARTER
、YEAR
の報告期間全体にわたってASINレベルで報告されます。ブランド分析Selling Partner APIのロールを持つベンダーが利用できます。 - 新しいベンダー予測レポートは、今後の平均、P70、P80、P90の週次顧客需要予測を提供することで、在庫をより適切に管理できます。予測システムは、ASINの予測をさまざまなPレベル(信頼レベル)で生成します。予測Pレベルを0.80(「P80」)に設定すると、顧客需要が週次予測数を超えない確率が80%あることになります。データはASINレベル(直近の週次予測生成日)で報告されます。Selling Partner APIのブランド分析ロールを持つベンダーが利用できます。
- 新しいベンダー在庫健全性レポート2.0は、販売可能な手持ち在庫数やベンダーの確認率など、在庫と運用の健全性指標を提供することで、在庫をより適切に管理できます。データは集計レベル(ベンダーの商品カタログ全体)、およびASINレベル(週、月、四半期、年の報告期間)で報告されます。Selling Partner APIのブランド分析ロールを持つベンダーが利用できます。
Documentation update for Invoice data reports
- 一括アップロードファイルVAT請求書データレポートとXML VAT請求書データレポートがドキュメントサイトで利用できるようになりました。これらのレポートは、AmazonのVAT計算サービスに登録していて、自分で請求書をアップロードすることを選択した出品者を対象としています。
ドキュメントの更新
-
New Migration Hub page aggregates all Amazon MWS to Selling Partner API migration-related timelines, planned deprecation dates, and resources into a single reference page.
-
New Selling Partner API Blog site includes articles from Amazon Solutions Architects and API experts covering a range of topics including customer stories, migration, best practices, tips and tricks, and much more.
2022年1月19日
APIの変更
- 安全コンプライアンス文書がない非準拠製品に対して、新しいエラーコード
PRODUCTASSURANCE_SAFETYDOCUMENTATION
が返されます。このエラーコードは次のオペレーションで返されます。CreateInboundShipmentPlan
CreateInboundShipment
UpdateInboundShipment
PreviewItemEligibility
Read more about this change on Seller Central.
- 新しい
buyerTaxInformation
属性は、トルコのマーケットプレイスを対象としています。この属性は、購入者が法人である場合に法人税情報を追加します。
- 新しい 注文ステータスの変更通知は、注文の利用可能性ステータスに変更があるたびに送信されます。
- 新しいFBA在庫管理健全性レポートは、より適切な在庫管理に役立ちます。このレポートは、売上(7日間、30日間、60日間、90日間)、出荷ステータス(作業中、受領済み、発送済み)、推定保管手数料と長期保管手数料、古い商品や過剰商品などを統合して表示します。売上、納品、手数料の見積もり、推奨アクションに関する指標が含まれます。
- 新しいオンデマンド在庫転送レポートは、地域間移動取引について、請求書金額、請求書番号、税率、物品サービス税識別番号(GSTIN)など、取引レベルの情報を提供します。
ドキュメントの更新
Amazon MWSからSelling Partner APIへの移行ガイド
- Updated documentation with additional migration guidance and resources, including the Selling Partner API (SP-API) Video Series on YouTube for step-by-step migration assistance and the Selling Partner API on AWS Quick Start for configuring IAM resources and deploying SP-API on the AWS Cloud.
Updated 23 days ago