SP-API Sürüm Notları
Satış Ortağı API'si yeni özellikleri, yazılım güncellemeleri ve değişiklik günlüğü.
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repo.
29 Ocak 2025
API değişiklikleri
- 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.
- Satıcı Analitiği veri kümesi artık aşağıdaki gibi ölçümleri içeriyor:
sellableInTransitInventory
,unsellableInTransitInventory
,mostRecentSubmitted
,netOrderedGMS
, venetShipmentGMS
. Envanter kullanılabilirliğini izlemek, gönderim sorunlarını belirlemek ve satış performansınızı anlamak için bu metrikleri kullanabilirsiniz.
- 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.
Dokümantasyon değişiklikleri
- 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.
Kullanımdan kaldırma bildirimleri
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
18 Aralık 2024
API değişiklikleri
- 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. - Eklendi
prepDetails
mülkiyetlistInventory
vegetInboundShipment
cevaplar. Hazırlık sahibi, kategori, talimatlar ve etiket sahibi dahil olmak üzere bir öğeyle ilgili hazırlık ayrıntılarını almak için bu özelliği kullanabilirsiniz.
- 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:
Bu API, AB bölgesinde kullanılabilir.
- Added the
createContainerLabel
operation. You can use this operation to create a container (pallet) label.
-
GetShipmentLabels
Satıcı Gönderileri API v1'in çalışması artık satıcılar için küçük paket etiketlerini alma yeteneğini desteklemektedir.
İrlanda'ya Satıcı Merkezi Pazar Yeri Genişlemesi (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.
İngiltere ve AB SP-API geliştiricileri için üçüncü taraf sağlayıcı desteği
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.
Dokümantasyon değişiklikleri
- Updated guidance on how to handle null enum values.
Kullanımdan kaldırma bildirimleri
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.
14 Kasım 2024
API değişiklikleri
- Updated the EasyShip API v2022-03-23 for additional marketplace support in the Netherlands (NL) and Poland (PL).
12 Kasım 2024
API değişiklikleri
- 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.
11 Kasım 2024
API değişiklikleri
- Updated the rate limit for the
initiatePayout
operation from 0.5 to 0.017 and updated the burst rate from 30 to 2.
6 Kasım 2024
API değişiklikleri
- 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
şimdi miktar sınırlamaları var (sipariş başına maksimum 250 birim olmak üzere maksimum 100 satır öğesi).shippingSpeedCategory
artık pazara göre değişen nakliye yöntemi hizmet seviyesi anlaşmalarına sahiptir.DeliveryPreferences
artık uygun siparişler için paketi ön kapıda gözetimsiz bırakacak şekilde varsayılan teslimat tercihi ayarlanmıştır.
- Güncellendi
getEligibleShippingServices
vecreateShipment
yeni artan kısıtlama oranlarını içerecek işlemler.
- Added Japan (JP) marketplace support for the
getFeaturedOfferExpectedPriceBatch
operation. You can now retrieve the Featured Offer Expected Price (FOEP) for all marketplaces.
Dokümantasyon değişiklikleri
-
Added the following information to Usage Plans and Rate Limits:
- Hız sınırlama algoritması hakkında ayrıntılar
- Hız sınırlarını etkileyen faktörler
- Oran limitlerinizi nasıl bulabilirsiniz?
-
Aşağıdaki API'ye özgü oran limitleri sayfaları eklendi:
-
Aşağıdaki API'ler için yeni, etkileşimli referanslar eklendi:
Kullanımdan kaldırma bildirimleri
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
payload sürüm 1.0
Eylül 11, 2024
API değişiklikleri
- 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.
- İsteğe bağlı bir alan eklendi,
deliveryInformation
,GetFulfillmentOrder
cevap. Bunu almak için kullanabilirsinizdeliveryDocumentList
, teslim edilen bir Çok Kanallı Gönderim Giden gönderisi için fotoğraf veya imza içerebilir. KullanabilirsindropOffLocation
sevkiyat paketinin teslim edildiği yere ulaşmak için.
- 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.
- Yeni isteğe bağlı doğrulama ayrıntıları özellikleri eklendi
regulatedInfo
operasyonlar. Satıcılar, reçete içeren siparişleri doğrulamak için bu ayrıntıları kullanabilir. - 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.
Kullanımdan kaldırma bildirimleri
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.
Ağustos 19, 2024
API değişiklikleri
- 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:
- Uçtan uca envanter görünümünü iyileştirmek için Amazon Depolama ve Dağıtım'a taşınan envanteri takip edin.
- Bir gönderideki her SKU için beklenen ve alınan envanteri uzlaştırın ve karşılaştırın.
Ağustos 14, 2024
API değişiklikleri
- Yeni bir gelen uygunsuzluk enum değeri eklendi,
FBA_INB_0342
içindegetItemEligibilityPreview
operasyon. Bu değer, bir teklifin neden belirli üretici barkodlarını kullanamadığı hakkında daha fazla bilgi sağlar.
- Added the
getAccount
operation to retrieve information about seller accounts.
-
Yeni eklendi
unitOfMeasure
değişken ağırlıklı ürünleri desteklemek için değişken. Bu değişken, ağırlıkça satılan ürünlerin fiyatları için ölçü birimini sağlar. Bu alan yoksa, öğe her biri tarafından satılır. Bu değişkeni döndüren işlemler şunları içerir:
Dokümantasyon değişiklikleri
- 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.
Kullanımdan kaldırma bildirimleri
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
31 Temmuz 2022
API değişiklikleri
-
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.
Dokümantasyon değişiklikleri
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.
Kullanımdan kaldırma bildirimleri
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
Temmuz 8, 2024
API değişiklikleri
- 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.
28 Haziran 2024
API değişiklikleri
- Removed the June 27, 2024 updates to Fulfillment Outbound API v2020-07-01 and Merchant Fulfillment v0 API.
27 Haziran 2022
API değişiklikleri
- 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.
Dokümantasyon değişiklikleri
- 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.
Kullanımdan kaldırma bildirimleri
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.
19 Haziran 2024
API değişiklikleri
- 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.
Kullanımdan kaldırma bildirimleri
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.
4 Haziran 2024
API değişiklikleri
- Yeni özellik: Bir gönderinin bir Amazon tesisine ulaşması için mevcut teslimat pencerelerinden birini görüntüleyin ve seçin
- Yeni özellik: Bireysel öğeler için etiket yazdırın
- Select Partnered Carrier as an option for your less-than-truckload (LTL) shipments
- Gelen planların ve gönderilerin adını güncelleyin
- Sevkiyat onayından sonra bir SKU'nun birim miktarını güncelleyin
- Add three new mandatory operations:
confirmDeliveryWindowOptions
,generateDeliveryWindowOptions
, andlistDeliveryWindowOptions
Kullanımdan kaldırma bildirimleri
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:
Mayıs 22, 2024
API değişiklikleri
-
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.
- Yeni eklendi
includedData
sorgu parametresi seçeneği çağrıldıclassifications
, kullanımdan kaldırılan MWS'nin yerini alanGetProductCategoriesForSKU
veGetProductCategoriesForASIN
operasyonlar. Satıcılar ve satıcılar kullanabilirclassifications
ASIN'e atanan sınıflandırma ağaçlarına göz atmak için.
- The Order feeds attributes
POST_ORDER_FULFILLMENT_DATA
andPOST_FLAT_FILE_FULFILLMENT_DATA
are updated with a new field:ship-from-supply-source-id
.
Kullanımdan kaldırma bildirimleri
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.
Nisan 24, 2024
API değişiklikleri
-
Added the the
CompanyName
attribute to the Orders API v0 API. -
Ücret limiti güncellendi
getOrder
,getOrderAddress
, vegetOrderBuyerInfo
.0167'den .5'e kadar işlem yaptı ve patlama 20'den 30'a çıkarıldı. -
Güncellendi
IsBuyerRequestedCancel
,IsGift
veNumberOfItems
Boolean/tamsayıdan dizeye kadar nesne türleri. -
Güncellendi
getOrders
iade işlemiAutomatedCarrier
veAutomatedShipMethod
öznitelikleri.
- Lisans Amazon Yazılım Lisansından Apache Lisansı 2.0'a güncellendi.
- Her işlemin olası yanıtlar listesine 413 HTTP kodu eklendi.
Şema değişikliklerini bildir
Eklendi lastUpdatedDate
aşağıdaki Satıcı raporlarına alan:
GET_VENDOR_SALES_REPORT
GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT
GET_VENDOR_TRAFFIC_REPORT
GET_VENDOR_FORECASTING_REPORT
GET_VENDOR_INVENTORY_REPORT
İrlanda'ya Satıcı Merkezi Pazar Yeri Genişlemesi (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.
Dokümantasyon değişiklikleri
- 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.
Kullanımdan kaldırma bildirimleri
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.
- Gönderim Gelen API v0 (İşlemleri seçin)
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
payload sürüm 1.0
1 Nisan 2024
API değişiklikleri
- FBA Gelen gönderi oluşturmayı destekleyen ve diğer özelliklerin yanı sıra birden çok gelen yerleştirme hizmeti seçeneği arasından seçim yapmanıza olanak tanıyan yeni Fulfillment Inbound v2024-03-20 API'sine erken erişim.
Kullanımdan kaldırma bildirimleri
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.
- Gönderim Gelen API v0 (İşlemleri seçin)
createInboundShipmentPlan
updateInboundShipment
createInboundShipment
getPreorderInfo
confirmPreorder
getTransportDetails
putTransportDetails
voidTransport
estimateTransport
confirmTransport
getShipments
getShipmentItemsByShipmentId
getShipmentItems
20 Mart 2024
API değişiklikleri
- Eklendi
AdditionalAddressNotes
,NdrAction
,NdrRequestData
, veSubmitNdrFeedbackRequest
nesnelerendrFeedback parameter
. - Added tutorial for Using the ndrFeedback API to submit Non-Delivery Reports for eligible shipments.
- Tehlikeli Madde özellikleri eklendi
LiquidVolume
,IsHazmat
, veDangerousGoodsDetails
Item nesnesine.
- 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.
- Eklendi
PaymentInformation
Hindistan için gerekli olan ancak diğer tüm pazar yerleri için isteğe bağlı olan öznitelik. - Added tutorial on how to create an MCF order for India in the Fulfillment Outbound API v2020-07-01 Use Case Guide.
Dokümantasyon değişiklikleri
- 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.
- Rapor Türü Değerleri sayfalarını yeniden biçimlendirdi ve optimize edilmiş keşfedilebilirlik için rapor türü özniteliklerini birleştirdi.
Kullanımdan kaldırma bildirimleri
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.
- Yetkilendirme API v1 (Tüm işlemler)
- FBA Küçük ve Hafif API v1 (Tüm işlemler)
- Gönderim Gelen API v0 (İşlemleri seçin)
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
payload sürüm 1.0
Şubat 21, 2024
API değişiklikleri
- 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.
- Uygulama Yönetimi API'si v2023-11-30'u Genel Beta'dan Üretime yükseltti. Bu API, Amazon (LWA) kimlik bilgileri (istemci sırları) ile Giriş bilgilerinizi programlı olarak döndürmenizi sağlar.
Belgelerde güncelleme
- 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.
Kullanımdan kaldırma bildirimleri
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
31 Ocak 2024
API değişiklikleri
- 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.
- Eklendi
ShipsInProductPackaging
değeriPrepInstruction
enum.PrepInstructionList
çağrılar için yanıtta döndürülürprepInstructions
.
- Eklendi
ExtendedFields
veAddressExtendedFields
nesneler. Bu nesneler yalnızca Brezilya adresleri için kullanılabilir ve genişletilmiş alanlar içeren Brezilya gönderim adresleri için yanıtlarda döndürülür.
Kullanımdan kaldırma bildirimleri
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.
- Yetkilendirme API v1 (Tüm işlemler)
- FBA Küçük ve Hafif API v1 (Tüm işlemler)
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
Aralık 13, 2023
API değişiklikleri
- Yeni Uygulama Yönetimi API'si, Amazon ile Giriş Yap (LWA) kimlik bilgilerinizi (istemci gizli anahtarları) programlı olarak döndürmenizi sağlar. Genel beta sürümünde mevcuttur.
- ABD ve Birleşik Krallık pazaryerlerinde tehlikeli madde (DG) kargosu için destek başlatıldı.
- Hindistan (IN) artık desteklenen bir pazaryeri
Issue
nesnesine iki yeni alan eklendi:Enforcements
veCategories
searchDefinitionsProductTypes
işlem türü dizeye güncellendi
- İsteğe bağlı
payloadVersion
parametresi eklendi - New Listings Item Issues Change Notification version 2023-12-13 has three new enforcement actions:
LISTING_SUPPRESSED
,ATTRIBUTE_SUPPRESSED
, andCATALOG_ITEM_REMOVED
Belgelerde güncelleme
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.
Amazon Lojistik (FBA) toplu fatura raporu (FBA_BULK_INVOICE
) belirli bir tarih aralığında bir satıcıya ait faturaları paylaşır. Bu faturalar, satıcı tarafından sunulan müşteri siparişlerini içerir.
Kullanımdan kaldırma bildirimleri
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.
- Yetkilendirme API v1 (Tüm işlemler)
- FBA Küçük ve Hafif API v1 (Tüm işlemler)
- Gönderim Gelen API v0 (İşlemleri seçin)
getInboundGuidance
- Satıcı Gönderim API'si v0 (İşlemleri seçin)
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
8 Kasım 2023
API değişiklikleri
- Yeni Tedarik Kaynakları API'si, mağazalar ve depolar gibi satıcı tedarik kaynakları hakkındaki bilgileri yapılandırır ve günceller.
- Birleşik Krallık artık geçerli bir pazar yeri.
getFeaturedOfferExpectedPriceBatch
(FOEP) has been extended to Amazon.co.uk.ASIN_NOT_ELIGIBLE
şimdi için bir değerdirresultStatus
.- Yeni
competitiveSummary
operasyon, ASIN için öne çıkan satın alma seçenekleri de dahil olmak üzere rekabetçi özet yanıtı döndürür vemarketplaceId
kombinasyonu.
- Üç yeni parametre için güncellendi (
itemName
,locale
, vesearchlocale
) ve bir yenidisplayName
ürün tipi.
- Güncellendi
ListFinancialEvent
veListFinancialEventGroups
operasyonlar beklenen yanıtları ve kapsamı daha net bir şekilde iletir. YanıtChangeRefundTransactions
bir nesneden bir diziye değiştirildi.
- Güncellendi
weight
Alan artık zorunludur. Bu değişiklik çağrılırken bir hata üretecektirshipmentconfirmations
böylece satıcılar işlem durumu sırasında bir hata beklemek zorunda kalmazlar.
Belgelerde güncelleme
- 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.
Kullanımdan kaldırma bildirimleri
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.
- Yetkilendirme API v1 (Tüm işlemler)
- FBA Küçük ve Hafif API v1 (Tüm işlemler)
- Gönderim Gelen API v0 (İşlemleri seçin)
getInboundGuidance
- Satıcı Gönderim API'si v0 (İşlemleri seçin)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
ORDER_STATUS_CHANGE
11 Ekim 2023
API değişiklikleri
- Güncellendi
ItemProcurement
veri öğesi nesneden bir diziye değiştirildi.
- Yanıta ilişkili öğelerin bir listesi eklendi
getOrderItems
operasyon.
getItemOffers
yanıtındakilistingPrice
özniteliği, geliştiricilerin kodlarını işletmeler arası kullanım durumları için genişletirken hatalardan kaçınmalarına yardımcı olmak için yeniden adlandırıldı.Landedprice
veShipping
alt alanları artık zorunlu değil, isteğe bağlıdır.
Kullanımdan kaldırma bildirimleri
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.
- Yetkilendirme API v1 (Tüm işlemler)
- FBA Küçük ve Hafif API v1 (Tüm işlemler)
- Feeds API v2020-09-04 (Tüm işlemler)
- Gönderim Gelen API v0 (İşlemleri seçin)
getInboundGuidance
- Satıcı Gönderim API'si v0 (İşlemleri seçin)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
- Rapor API v2020-09-04 (Tüm işlemler)
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
ORDER_STATUS_CHANGE
20 Eylül 2023
API değişiklikleri
- Siparişler v0 API'sindeki
BuyerCompanyName
işlem açıklaması, hedef adresin şirket adını netleştirmek için güncellendi.
Belgelerde güncelleme
- 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.
Kullanımdan kaldırma bildirimleri
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.
- Yetkilendirme API v1 (Tüm işlemler)
- FBA Küçük ve Hafif API v1 (Tüm işlemler)
- Feeds API v2020-09-04 (Tüm işlemler)
- Gönderim Gelen API v0 (İşlemleri seçin)
getInboundGuidance
- Satıcı Gönderim API'si v0 (İşlemleri seçin)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
- Rapor API v2020-09-04 (Tüm işlemler)
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
16 Ağustos 2023
API değişiklikleri
-
ShipmentServiceLevelCategory
sipariş tanımının özelliği değeri içerecek şekilde güncellendiPriority
. Bu değer, satıcı tarafından gönderilen Prime siparişlerini desteklemek için Fransa, İspanya, Almanya, Polonya, Hollanda, İsveç ve Belçika pazarlarında bulunan yeni kargo şablonundan edinilebilir. Entegrasyonunuz bu bölgeler için yeni kargo şablonlarını kullanıyorsa, kabul etmek için entegrasyonunuzu güncellemeniz gerekebilir.Priority
için değerShipmentServiceLevelCategory
.
-
generic_keyword
öznitelik, satıcıya özgü tescilli verilerdir ve artık Katalog Öğeleri API'si tarafından iade edilmeyecektir. Satış Ortakları, gönderilen değerleri görüntülemek için Listeleme Öğeleri API'sini kullanabilir.
Belgelerde güncelleme
- 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.
Kullanımdan kaldırma bildirimleri
Aşağıdaki API'ler için kaldırma tarihini ayarladık:
Bu API'lere yapılan çağrılar aşağıdakilerden daha düşük bir gaz hızına sahip olacaktır. 16 Ağustos 2023-* üzerinden 18 Ekim 2023. Bu API'lere yapılan çağrılar başarısız olur 18 Ekim 2023.
For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
21 Haziran 2023
API değişiklikleri
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.
Rapor API'si
- 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.
Hızlı Perakende Analizleri
- 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.
Hızlı Perakende Analizleri
- 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.
Belgelerde güncelleme
- 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
Kullanımdan kaldırma bildirimleri
Kullanımdan kaldırılacağı duyurulan SP-API kaynakları, kullanımdan kaldırılma tarihinden sonra artık desteklenmez. Kullanımdan kaldırılan kaynaklara yapılan çağrılar, kullanımdan kaldırılma tarihlerinden itibaren başarısız olur
For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
17 Mayıs 2023
API değişiklikleri
- Dinamik korumalı alan,
createShippingLabels
işlemini içerecek şekilde güncellendi.
- Genel Sipariş Onayları iş akışını sonlandırın.
ItemApprovalTypes
veItemApprovalStatus
özellikleri kaldırıldı.
Belgelerde güncelleme
-
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.
Kullanımdan kaldırma bildirimleri
- Akışlar API'si v2020-09-04
- Raporlar API'si v2020-09-04
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
19 Nisan 2023
API değişiklikleri
address
özelliğindekicity
özelliği gerekli değerinden isteğe bağlı değerine güncellendi.
sellerSku
alanı virgülleri içerecek ve ayrıştıracak şekilde güncellendi.
Belgelerde güncelleme
- Amazon Ürün Türü Tanımı Meta Şeması (v1) şu anahtar kelimeleri içerecek şekilde güncellendi:
$lifecycle
,replacedBy
,replaces
,enumDeprecated
veenumReplacement.
C# rehberi güncellemeleri
- 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.
Kullanımdan kaldırma bildirimleri
29 Mart 2023
API değişiklikleri
nextToken
değerini 30 saniye sonra süresi dolacak şekilde ayarlayın
confirmShipment
işlemi eklendi.
address
şehri dahil edilecek şekilde güncellendi.- Test için statik korumalı alan yerine dinamik korumalı alan kullanılacak şekilde güncellendi. Sadece korumalı alana özel yeni bir işlem içerir.
Belgelerde güncelleme
- 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
- Sık sorulan soruları ele alan üç yeni Liste Kaydı Ürünleri API'si kaynağı:
Kullanımdan kaldırma bildirimleri
22 Şubat 2023
API değişiklikleri
- SP-API üzerinde belirli UPS yurtiçi (ABD) kargo yöntemlerinin adlarının gösterilmesi için statik korumalı alan sahte yanıtları güncellendi.
- Added the following delivery preferences attributes to
getOrderAddress
to support Amazon Business customer orders:PreferredDeliveryTime
BusinessHours
OtherAttributes
AddressInstructions
Bu özellikler, bir paketin nasıl ve ne zaman teslim edileceği hakkında bilgi içerir.
- The
customedURL
attribute ofbuyerCustomizedInfo
, returned by thegetOrder
andgetOrders
operations, is now a Base 64 encoded URL using the UTF-8 character set.
- Sorgu parametresi olarak
six-month-past-in-date
geçecek şekilde güncellendi.
Belgelerde güncelleme
- 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.
Kullanımdan kaldırma bildirimleri
25 Ocak 2023
API Değişiklikleri
- Yeni
getFeaturedOfferExpectedPriceBatch
işlemi, 40 adede kadar öne çıkan teklif beklenen fiyatı (FOEP) isteğine verilen yanıtları alır.
- Tedarikçinin özelleştirilebilir olarak yapılandırdığı ürünlerin alıcı bilgilerini içeren yeni
buyerCustomizedInfo
özelliği, ürünlerinin türleri ve yelpazeleriyle birlikte özelleştirme veya yapılandırma türlerini belirtir.
- Yeni
serialNumber
özelliği, müşterilere gönderilen elektronik ürünlerin seri numaralarının bir listesini döndürür. Yalnızca FBA (Amazon Lojistik) siparişlerininki döndürülür.
- Yeni finansal olay türü:
CapacityReservationBillingEventList
, Kapasite Rezervasyonu Faturalandırma ücretiyle ilgili ayrıntıları almanızı sağlar.
Belgelerde güncelleme
- 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.
Kullanımdan kaldırma bildirimleri
- Akışlar API'si v2020-09-04
- Raporlar API'si v2020-09-04
- FBA (Amazon Lojistik) Envanter Raporları
MFN_ORDER_STATUS_CHANGE
Bildirimi
6 Aralık 2022
API Değişiklikleri
Katalog Ürünleri v2022-04-01 API'si, Katalog Ürünleri API'sini Pazaryeri Web Hizmetleri Katalog Ürünleri bölümüyle aynı seviyeye getirmek için özette birkaç ek özellik içerecek şekilde güncellendi:
In addition, the following attributes have been added to ItemSummaryByMarketplace
:
adultProduct
autographed
memorabilia
releaseDate
tradeInEligible
9 Kasım 2022
API Değişiklikleri
-
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.
Belgelerde güncelleme
- 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.
19 Ekim 2022
API Değişiklikleri
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.
Belgelerde güncelleme
- New Selling Partner API Guard Implementation Guide describes architectural considerations and configuration steps for deploying Amazon Selling Partner Guard in AWS Cloud.
21 Eylül 2022
API Değişiklikleri
- 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. - Tüm eşdeğer Doğrudan Tedarikçi Gönderimli Kargo V1 işlemleri için üretim ve dinamik korumalı alan desteği alacak şekilde güncellendi.
- Doğrudan Tedarikçi Gönderimli Kargo API'si v2021-12-28'in desteklenmesi amacıyla şu kısıtlı işlemler için güncellendi:
createShippingLabels
getPackingSlip
getCustomerInvoice
getShippingLabel
- Updated Inventory Ledger Report (
GET_LEDGER_DETAIL_VIEW_DATA
) now includes a neweventType
filter to filter on particular warehouse events.
Belgelerde güncelleme
- 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.
10 Ağustos 2022
API Değişiklikleri
- Kolay Gönderim gönderilerini desteklemek için Siparişler API'sinde yapılan iyileştirmeler.
- Stok durumu kayıtlarına benzer bir formatta kapasite yuvaları sağlayan yeni
getRangeSlotCapacity
işlemi için güncellendi. - Sabit kapasiteli yuvalar sağlayan yeni
getFixedSlotCapacity
işlemi için güncellendi.
18 Mayıs 2022
API Değişiklikleri
- Yeni Katalog Ürünleri API'si sürümü 2022-04-01, API deneyimini geliştirmiş ve şu değişikliklerle geliştirici geri bildirimlerini dikkate almıştır:
searchCatalogItems
işlemine tanımlayıcı tabanlı aramalar eklenerek, istek başına 20'ye kadar tanımlayıcı (ör. ASIN'ler, UPC'ler, EAN'ler) içeren toplu isteklere olanak sağlandı- Standartlaştırılmış ürün ve paket boyutları sağlayan
dimensions
veri seti eklendi - Ürün kategorisi, ürün alt kategorisi ve göz atma sınıflandırması için ekran adları eklendi
- Ürün özetlerine genişletilmiş tanımlama özellikleri (ürün sınıflandırması, paket miktarı, parça numarası, web sitesi görüntüleme grubu)
- Satış sıralamalarına göz atma sınıflandırmaları ve web sitesi görüntüleme grupları eklendi
attributes
dahil olmak üzere aynı veri kümelerini kullanmak içinsearchCatalogItems
vegetCatalogItem
işlemleri uyumlu hâle getirildi- Paket hiyerarşileri gibi birden fazla ilişki türünün temsil edilmesine izin vermek için
variations
yerinerelationships
eklendi - Varyasyon teması ayrıntıları eklendi (ilişki ayrıntılarının adı)
- Bildirimlerin işlenmesini kontrol etmek için aboneliğe ek bilgi aktarmanıza olanak tanıyan bir
processingDirective
parametresi eklendi. Bu parametreANY_OFFER_CHANGED
bildirimi tarafından kullanılır. ANY_OFFER_CHANGED
bildirimi, yalnızca belirlimarketplaceIds
bildirimlerini filtrelemeyi destekleyecek ve bildirimleri beş ya da on dakikalık aralarda bir taneyle sınırlandıracak şekilde güncellendi.
- Birleşik Krallık'ta düzenlemeye tabi siparişleri yöneten
getOrderRegulatedInfo
programı desteğini içerecek şekilde güncellendi. Düzenlemeye tabi siparişler, reçete gerektiren ürünlerin (evcil hayvan ilaçları, reçeteli lensler ve reçeteli gözlükler) gönderildiği sınırlı sayıda siparişlerdir. Programı desteklemek içinupdateVerificationStatus
ve {{2}} işlemleri eklendi. - Erişim noktası (AP) merkezlerine gönderilen MFN (satıcıdan gönderim) siparişlerinin tanımlanmasını destekleyecek yeni
IsAccessPointOrder
özelliği.
- Bir ürün ve pazaryeri listesine yönelik ürün ücreti tahminlerini alan yeni
getMyFeesEstimates
işlemi için güncellendi.
- Ürün fiyatlandırma ve teklif bilgilerini ürün listesi hâlinde alan yeni
getItemOffersBatch
vegetListingOffersBatch
işlemleri için güncellendi.
- 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.
13 Nisan 2022
API Değişiklikleri
- 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.
Belgelerde güncelleme
- 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.
23 Mart 2022
API Değişiklikleri
- Yeni
buyerRequestedCancel
parametresi, bir alıcının sipariş iptali talep edip etmediği ve iptal nedeni hakkında bilgi sağlar.
New Seller retail analytics reports
- Yeni Satış ve Trafik İşletme Raporu; sipariş edilen ürün satışları, gelir, sipariş edilen birimler ve talep tutarı gibi temel satış performansı ölçümlerinin yanı sıra sayfa görüntülemeleri ve satıcının tüm ürün kataloğunun tarihe ve ASIN'e göre toplanmış satın alma kutusu yüzdesi gibi sayfa trafiği metrikleri sağlayarak analizlerinizi daha iyi yönetmenize yardımcı olur. Bu rapor için artık tüm satıcıların kullanabildiği Marka Analizi Satış Ortağı API'si rolü gerekir.
- Yeni Kuponlar Performans Raporu, promosyonlarınızı optimize etmenize ve reklam stratejilerinizi ayarlamanıza yardımcı olur. Rapor, kampanya düzeyinde ayrıntıları (toplam klipler, kullanımlar) ve kupon düzeyinde ayrıntıları (başlangıç/bitiş tarihi, klipler, kullanımlar ve bütçe bilgileri) içerir. Marka Analizi Satış Ortağı API'si rolüne sahip redarikçiler tarafından kullanılabilir.
New Vendor retail analytics reports
- Yeni Tedarikçi Satış Raporu, sipariş edilen/gönderilen gelir ve birimler gibi temel perakende satış metriklerini sağlayarak envanter yönetimini iyileştirir. Veriler, tedarikçinin ürün kataloğu genelinde toplu düzeyde ve
DAY
,WEEK
,MONTH
,QUARTER
veYEAR
raporlama dönemleri için ASIN düzeyinde raporlanır. Marka Analizi Satış Ortağı API'si rolüne sahip satıcılar tarafından kullanılabilir. - Yeni Tedarikçi Trafik Raporu, detay sayfası görüntülemeleri gibi temel perakende trafik metriklerini sağlayarak envanter yönetimini iyileştirir. Veriler, tedarikçinin ürün kataloğu genelinde toplu düzeyde ve
DAY
,WEEK
,MONTH
,QUARTER
veYEAR
raporlama dönemleri için ASIN düzeyinde raporlanır. Marka Analizi Satış Ortağı API'si rolüne sahip satıcılar tarafından kullanılabilir. - Yeni Tedarikçi Tahmin Raporu geleceğe dönük ortalama; P70, P80 ve P90 haftalık müşteri talep tahminleri sağlayarak envanterinizi daha iyi yönetmenize yardımcı olur. Tahmin sistemi, bir ASIN için güven seviyeleri olarak da bilinen çeşitli P düzeylerinde tahminler üretir. Tahmin P seviyesini .80 ("P80") olarak belirlerseniz, müşteri talebinin haftalık tahmin edilen birimleri aşmama olasılığının %80 olduğunu belirtirsiniz. Veriler, en son haftalık tahmin oluşturma tarihinde ASIN düzeyinde raporlanır. Marka Analizi Satış Ortağı API'si rolüne sahip tedarikçiler tarafından kullanılabilir.
- Yeni Tedarikçi Envanteri Performans Raporu 2.0, eldeki satılabilir birimler ve tedarikçi onay oranı gibi envanter ve operasyonel sağlık metrikleri sağlayarak envanterinizi daha iyi yönetmenize yardımcı olur. Veriler, bir satıcının ürün kataloğunda toplu düzeyde ve hafta, ay, çeyrek ve yıl raporlama dönemlerinde ASIN düzeyinde raporlanır. Marka Analizi Satış Ortağı API'si rolüne sahip tedarikçiler tarafından kullanılabilir.
Documentation update for Invoice data reports
- Stok Dosyası KDV Fatura Verileri Raporu ve XML KDV Fatura Verileri Raporu artık belgelerde mevcuttur. Bu raporlar, Amazon'un KDV Hesaplama Hizmeti'ne kayıtlı olan ve kendi faturalarını yüklemeyi tercih eden satıcılar için sunulur.
Belgelerde güncelleme
-
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.
19 Ocak 2022
API Değişiklikleri
- Güvenlik uyumluluğu belgelerine sahip olmayan uyumlu olmayan ürünler için yeni hata kodu olan
PRODUCTASSURANCE_SAFETYDOCUMENTATION
döndürülür. Bu hata kodu şu işlemlerde döndürülür:CreateInboundShipmentPlan
CreateInboundShipment
UpdateInboundShipment
PreviewItemEligibility
Read more about this change on Seller Central.
- Türkiye Pazaryeri için yeni
buyerTaxInformation
özelliği. Bu özellik, alıcı bir işletme olduğunda işletme vergi bilgilerini içerir.
- Yeni Sipariş Durumu Değişikliği bildirimi, siparişin stok durumunda bir değişiklik olduğunda gönderilir.
- Yeni FBA Envanter Yönetim Durumu Raporu, satışlarınız (7, 30, 60 ve 90 gün), kargo durumları ("çalışılıyor", "alındı" ve "gönderildi"), tahmini depolama ve uzun vadeli depolama ücretleri ile eski ve fazlalık birimler arasında konsolide bir görünüm sağlayarak envanterinizi daha iyi yönetmenize yardımcı olur. Bu rapor satışlar, gelenler, tahmini ücretler ve önerilen işlemlere ilişkin metrikleri içerir.
- Eyaletler arası hareket işlemleri için fatura değeri, fatura numarası, vergi oranı ve Mal ve Hizmet Vergisi Kimlik Numaraları (GSTIN'ler) gibi işlem düzeyinde bilgiler sağlayacak yeni Talep Üzerine Stok Transferi Raporu.
Belgelerde güncelleme
Amazon MWS'den Satış Ortağı API'sine Taşıma Rehberi
- 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