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 the listInventory 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.
  • ベンダー分析データセットには、次のような指標が含まれるようになりました。 sellableInTransitInventoryunsellableInTransitInventorymostRecentSubmittednetOrderedGMS、および netShipmentGMS。これらの指標を使用して、在庫状況を監視したり、フルフィルメントに関する問題を特定したり、販売実績を把握したりできます。
  • The response of the listPackingOptions operation now describes acceptable packing methods and package weights in the supportedConfigurations property. This property replaces the supportedShippingConfigurations property.
  • Added sampleLocation to the response of the getCompetitiveSummary operation and the request of the getFeaturedOfferExpectedPriceBatch operation. You can use this metric to return location information for featured offers and to retrieve a location-specific feature offer expected price (FOEP).

ドキュメントの変更

廃止の通知

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 and getInboundShipment 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, and SHARE_OF_COUPON_SUBSCRIPTIONS metrics to the getSellingPartnerMetrics operation response. These metrics describe the revenue sources and subscription performance.
  • Added the SHARE_OF_COUPON_SUBSCRIPTIONS metric to the listOfferMetrics operation response. This metric describes the coupon acquisition performance.

この 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.

ドキュメントの変更

廃止の通知

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の変更

2024年11月12日

APIの変更

  • Added WasPrice to the getCompetitiveSummary operation (in the referencePrices 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 the AdjustmentItem 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では、対象となる注文の場合、デフォルトの配送設定が置き配に設定されました。
  • スロットリングレートを新たに増加させるため、getEligibleShippingServicescreateShipmentオペレーションを更新しました。
  • Added Japan (JP) marketplace support for the getFeaturedOfferExpectedPriceBatch operation. You can now retrieve the Featured Offer Expected Price (FOEP) for all marketplaces.

ドキュメントの変更

廃止の通知

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の変更

  • オプションフィールドdeliveryInformationGetFulfillmentOrderレスポンスに追加しました。これを使用してdeliveryDocumentListを取得できます。これには、配送されたマルチチャネルフルフィルメント出荷の写真または署名が含まれる場合があります。dropOffLocationを使用して、出荷パッケージが配達された場所を確認できます。
  • 新しいオプションの検証詳細プロパティを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 require offerIdentifier in the FeaturedOfferExpectedPriceResponseBody. The offerIdentifier parameter is now optional in order to correctly deserialize getFeaturedOfferExpectedPriceBatch error responses, as FeaturedOfferExpectedPriceResponseBody doesn’t provide offerIdentifier 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 the listInventory operation. You can use this parameter to track inventory in transit to Amazon Warehousing and Distribution.
  • Added a new optional request parameter skuQuantities to the getInboundShipment 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_0342getItemEligibilityPreviewオペレーションに追加しました。この値により、特定のメーカーのバーコードを商品に使用できない理由が詳しくわかります。
  • Added the getAccount operation to retrieve information about seller accounts.
  • 可変重量商品をサポートするため、新しいunitOfMeasure変数を追加しました。この変数は、目方で販売する商品の価格の測定単位を提供します。このフィールドがない場合、その商品は個別に販売されます。この変数を返すオペレーションは次のとおりです。

ドキュメントの変更

廃止の通知

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 the getFeatureInventory 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の変更

2024年6月27日

APIの変更

##### 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.

ドキュメントの変更

廃止の通知

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の変更

  • 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.
  • 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 the getFulfillmentOrder 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 the createFulfillmentOrder 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, and COUPONS_REVENUE_PENETRATION to the getSellingPartnerMetrics operation response. These metrics describe sources of revenue and lost revenue.
  • Added the metrics LOST_REVENUE_DUE_TO_OOS and COUPONS_REVENUE_PENETRATION to the listOfferMetrics 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, and listDeliveryWindowOptions

廃止の通知

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の変更

  • classificationsという新しいincludedDataクエリーパラメーターオプションが追加されました。廃止されたMWS GetProductCategoriesForSKUGetProductCategoriesForASINオペレーションに代わるものです。出品者とベンダーはclassificationsを使用して、ASINに割り当てられている分類ツリーをブラウズできます。

廃止の通知

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.

  • getOrdergetOrderAddressgetOrderBuyerInfoオペレーションのレート制限を0.0167から0.5に更新し、バーストを20から30に増やしました。

  • IsBuyerRequestedCancelIsGiftNumberOfItemsのオブジェクトタイプをブール値/整数から文字列に更新しました。

  • AutomatedCarrier属性とAutomatedShipMethod属性を返すようにgetOrdersオペレーションを更新しました。

  • ライセンスをAmazonソフトウェアライセンスからApache License 2.0に更新しました。
  • 各オペレーションの可能なレスポンスのリストに413 HTTPコードを追加しました。

レポートスキーマの変更

次のベンダーレポートにlastUpdatedDateフィールドを追加しました。

ベンダーセントラルマーケットプレイスのアイルランド (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の変更

  • 危険な商品の属性、LiquidVolumeIsHazmatDangerousGoodsDetailsがアイテムオブジェクトに追加されました。
  • Updated FEED_PROCESSING_FINISHED and REPORT_PROCESSING_FINISHED to include support for vendors. Both notifications include a new accountId 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.

ドキュメントの変更

廃止の通知

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 and patchListingsItem operations. Use the mode=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オブジェクトに、EnforcementsCategoriesという新規フィールドが追加されました
  • searchDefinitionsProductTypesオペレーションタイプは文字列に更新されました

ドキュメントの更新

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_ELIGIBLEresultStatusの値になりました。
  • 新しいcompetitiveSummaryオペレーションでは、ASINとmarketplaceId を組み合わせた注目の購入オプションを含む競合概要レスポンスが返されます。
  • 3つの新しいパラメーター(itemNamelocalesearchlocale)および新しいdisplayName 商品タイプが更新されました。
  • 更新済みの ListFinancialEventおよびListFinancialEventGroupsオペレーションは、期待されるレスポンスとスコープをより明確に伝えます。ChangeRefundTransactionsのレスポンスは、オブジェクトから配列に変更されました。
  • 更新済みweightフィールドは必須になりました。この変更により、shipmentconfirmationsの呼び出し時にエラーが発生するため、ベンダーはトランザクションステータス中にエラーを待つ必要がなくなります。

ドキュメントの更新

廃止の通知

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属性の名前が変更され、開発者は企業間ユースケース向けにコードを拡張する際にエラーを回避できるようになりました。LandedpriceShippingのサブフィールドは必須ではなくオプションになりました。

廃止の通知

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オペレーションの説明が更新され、配送先住所の会社名がわかりやすくなりました。

ドキュメントの更新

廃止の通知

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が含まれるようになりました。この値は、フランス、スペイン、ドイツ、ポーランド、オランダ、スウェーデン、ベルギーの各マーケットプレイスで利用できる新しい配送テンプレートから取得でき、出品者が出荷したプライム注文に対応しています。これらの地域で新しい配送テンプレートを統合に使用している場合は、ShipmentServiceLevelCategoryPriorityの値を受け入れるように統合を更新しなければならない場合があります。
  • generic_keyword属性は出品者独自のデータであり、カタログアイテムAPIから返されなくなります。出品パートナーは出品アイテムAPIを使用して、送信された値を確認できます。

ドキュメントの更新

廃止の通知

次の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.
高速小売分析
Listings Items API
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 replaces ORDER_STATUS_CHANGE.
  • The B2B_ANY_OFFER_CHANGED notification has been updated to include the Quantity Discount (QD) pricing in the Offer 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.

ドキュメントの更新

廃止の通知

廃止を発表したSP-APIリソースは、廃止日を過ぎるとサポートされなくなります。廃止されるリソースへの呼び出しは、削除日以降は失敗します。

For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

2023年5月17日

APIの変更

  • 動的サンドボックスを更新して、createShippingLabelsオペレーションを追加しました。
  • 汎用注文承認ワークフローを削除します。ItemApprovalTypes属性とItemApprovalStatus属性は削除されました。

ドキュメントの更新

廃止の通知

2023年4月19日

APIの変更

  • cityプロパティ(address属性)を必須からオプションに更新しました。
  • sellerSkuフィールドが更新され、カンマが追加されて解析されます。

ドキュメントの更新

  • Amazon商品タイプ定義メタスキーマ(v1)が更新され、次のキーワードが追加されました。$lifecyclereplacedByreplacesenumDeprecated、およびenumReplacement.
C#ガイドの更新

廃止の通知

2023年3月29日

APIの変更

  • nextTokenが更新され、30秒後に期限切れになります。
  • confirmShipmentオペレーションが追加されました。
  • address属性が更新され、都市が追加されました。
  • 静的サンドボックスの代わりに動的サンドボックスをテストに使用するように、更新されました。サンドボックス専用のオペレーションが1つ追加されました。

ドキュメントの更新

廃止の通知

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 of buyerCustomizedInfo, returned by the getOrder and getOrders 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を使用すると、キャパシティ予約請求料金に関する詳細情報を取得できます。

ドキュメントの更新

廃止の通知

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.

ドキュメントの更新

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.

ドキュメントの更新

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 new eventType filter to filter on particular warehouse events.

ドキュメントの更新

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など)を使用するようにしました。
    • variationsrelationshipsに置き換え、パッケージ階層など、複数の関係タイプを表すことができるようになりました。
    • リレーションシップの詳細に、バリエーションテーマの詳細名が追加されました。
  • 通知の処理を制御するための追加情報をサブスクリプションに渡すことができるprocessingDirectiveパラメータが追加されました。このパラメータは、ANY_OFFER_CHANGED通知によって使用されます。
  • ANY_OFFER_CHANGED通知がアップデートされ、特定のmarketplaceIdsのみへの通知をフィルタリングし、5分または10分に1回の間隔に通知を制限できるようになりました。
  • 英国で規制対象の注文を管理する購入シールドプログラムのサポートを含むように更新されました。規制対象の注文は、処方箋を必要とする商品(ペット用医薬品、処方箋が必要なコンタクトレンズや眼鏡など)に対応する一連の限定注文です。2つの新しいオペレーション、getOrderRegulatedInfoupdateVerificationStatusが追加されました。
  • 新しいIsAccessPointOrder属性により、アクセスポイント(AP)ハブに発送されたMFN(出品者出荷)注文の識別がサポートされるようになりました。
  • 商品リストとマーケットプレイスの商品手数料の見積もりを取得する新しいgetMyFeesEstimatesオペレーションが追加され更新されました。
  • 製品リストにある商品の価格設定とオファー情報を取得する新しいgetItemOffersBatchオペレーションとgetListingOffersBatchオペレーションが追加され更新されました。

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 the ORDER_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).

ドキュメントの更新

2022年3月23日

APIの変更

  • 新しいbuyerRequestedCancelパラメーターは、購入者が注文のキャンセルを要求したかどうか、およびキャンセルの理由に関する情報を提供します。

New Seller retail analytics reports

  • 新しい販売とトラフィックに関するビジネスレポートは、より適切な分析管理に役立ちます。このレポートは、注文商品売上、収益、注文数、請求額などの主要な販売実績指標のほか、出品者の商品カタログ全体におけるページビューやショッピングカートボックス獲得率などのページトラフィック指標を日付とASIN別に集計して提供します。このレポートには、Selling Partner APIのブランド分析ロール(すべての出品者が利用可能)が必要です。

New Performance reports

  • 新しいクーポンパフォーマンスレポートは、プロモーションの最適化と広告戦略の調整に役立ちます。レポートには、キャンペーンレベルの詳細(合計クリップ数、利用回数)とクーポンレベルの詳細(開始日/終了日、クリップ、利用回数、予算情報)が含まれます。Selling Partner APIのブランド分析ロールを持つベンダーが利用できます。

New Vendor retail analytics reports

  • 新しいベンダー売上レポートは、注文/出荷の収益やユニット数など、主要な小売販売指標を提供することで、在庫をより適切に管理できます。データは、ベンダーの商品カタログ全体で集計レベルで報告され、DAYWEEKMONTHQUARTERYEAR の報告期間全体にわたってASINレベルで報告されます。ブランド分析Selling Partner APIのロールを持つベンダーが利用できます。
  • 新しいベンダートラフィックレポートは、詳細ページビューなど、主要な小売トラフィック指標を提供することで、在庫をより適切に管理できます。データは、ベンダーの商品カタログ全体で集計レベルで報告され、DAYWEEKMONTHQUARTERYEARの報告期間全体にわたって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.

Orders API

  • 新しいbuyerTaxInformation属性は、トルコのマーケットプレイスを対象としています。この属性は、購入者が法人である場合に法人税情報を追加します。

Notifications API

  • 新しい 注文ステータスの変更通知は、注文の利用可能性ステータスに変更があるたびに送信されます。

レポートAPI

  • 新しいFBA在庫管理健全性レポートは、より適切な在庫管理に役立ちます。このレポートは、売上(7日間、30日間、60日間、90日間)、出荷ステータス(作業中、受領済み、発送済み)、推定保管手数料と長期保管手数料、古い商品や過剰商品などを統合して表示します。売上、納品、手数料の見積もり、推奨アクションに関する指標が含まれます。
  • 新しいオンデマンド在庫転送レポートは、地域間移動取引について、請求書金額、請求書番号、税率、物品サービス税識別番号(GSTIN)など、取引レベルの情報を提供します。

ドキュメントの更新

Amazon MWSからSelling Partner APIへの移行ガイド


このページは役に立ちましたか?