Notas de versão da SP-API
Novos recursos, atualizações de software e registro de alterações da API do parceiro de vendas.
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repo.
29 de janeiro de 2025
Mudanças na API
- Added the optional response parameter
replenishmentQuantity
to thelistInventory
operation. You can use this parameter to review quantity information for units that are in transit from Amazon Warehousing and Distribution (AWD) to a Fulfillment by Amazon (FBA) facility.
- O conjunto de dados do Vendor Analytics agora inclui métricas como
sellableInTransitInventory
,unsellableInTransitInventory
,mostRecentSubmitted
,netOrderedGMS
, enetShipmentGMS
. Você pode usar essas métricas para monitorar a disponibilidade do estoque, identificar problemas de atendimento e entender seu desempenho de vendas.
- 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.
Mudanças na documentação
- 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.
Avisos de descontinuação
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 de dezembro de 2024
Mudanças na API
- Added the expiration property to the
listInventory
andgetInboundShipment
responses. You can use this property to get the expiration date of a perishable item in your shipment. For more information, refer to Track an inbound shipment with expected and received SKU details. - Adicionou o
prepDetails
propriedade para olistInventory
egetInboundShipment
respostas. Você pode usar essa propriedade para obter os detalhes da preparação de um item, incluindo o proprietário da preparação, a categoria, as instruções e o proprietário da etiqueta.
- 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:
Essa API está disponível na região da UE.
- Added the
createContainerLabel
operation. You can use this operation to create a container (pallet) label.
- O
GetShipmentLabels
A operação da API Vendor Shipments v1 agora suporta a capacidade de recuperar etiquetas de pacotes pequenos para fornecedores.
Expansão do Seller Central Marketplace para a Irlanda (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.
Suporte de fornecedores terceirizados para desenvolvedores de SP-API do Reino Unido e da UE
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.
Mudanças na documentação
- Updated guidance on how to handle null enum values.
Avisos de descontinuação
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 de novembro de 2024
Mudanças na API
- Updated the EasyShip API v2022-03-23 for additional marketplace support in the Netherlands (NL) and Poland (PL).
12 de novembro de 2024
Mudanças na API
- Added
WasPrice
to thegetCompetitiveSummary
operation (in thereferencePrices
list in the operation response).WasPrice
is the 90-day median price that customers pay for the product on Amazon. You can use this value to set promotions and discounts based on the typical price on the product detail page.
11 de novembro de 2024
Mudanças na API
- Updated the rate limit for the
initiatePayout
operation from 0.5 to 0.017 and updated the burst rate from 30 to 2.
6 de novembro de 2024
Mudanças na API
- Added the
TransactionNumber
parameter to theAdjustmentItem
object. You can use this parameter to identify what the adjustment is related to. For example, Amazon Shipping customers can use this to get an invoice number that they can use to identify an Amazon Shipping invoice.
- Added the following to the Fulfillment Outbound API v2020-07-01 Use Case Guide:
items
agora tem limitações de quantidade (máximo de 100 itens de linha com um máximo de 250 unidades por pedido).shippingSpeedCategory
agora tem acordos de nível de serviço para o método de envio, que variam conforme o site.DeliveryPreferences
agora possui a preferência de entrega padrão configurada para deixar o pacote sem supervisão na porta da frente, para pedidos elegíveis.
- Atualizadas as operações
getEligibleShippingServices
ecreateShipment
para incluir novas taxas de limitação aumentadas.
- Added Japan (JP) marketplace support for the
getFeaturedOfferExpectedPriceBatch
operation. You can now retrieve the Featured Offer Expected Price (FOEP) for all marketplaces.
Mudanças na documentação
-
Added the following information to Usage Plans and Rate Limits:
- Detalhes sobre o algoritmo de limitação de taxa
- Fatores que influenciam os limites de taxa
- Como encontrar seus limites de taxa
-
Adicionadas as seguintes páginas de limites de taxa específicos da API:
-
Adicionadas novas referências interativas para as seguintes APIs:
Avisos de descontinuação
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
carga útil versão 1.0
11 de setembro de 2024
Mudanças na API
- Added support for the Japan (JP) marketplace. For more information on the marketplaces that support Easy Ship operations, refer to the EasyShip API v2022-03-23 marketplace support table.
- Adicionado um campo opcional,
deliveryInformation
, à resposta deGetFulfillmentOrder
. Esse campo permite obter odeliveryDocumentList
, que pode incluir uma foto ou assinatura de entrega de uma remessa de saída de logística multicanal. Você pode usardropOffLocation
para rastrear o local de entrega do pacote.
- 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.
- Adicionadas novas propriedades opcionais de detalhes de verificação às operações
regulatedInfo
. Os vendedores podem usar esses detalhes para verificar pedidos que contêm receitas médicas. - 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.
Avisos de descontinuação
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.
19 de agosto de 2024
Mudanças na API
- Added the optional response parameter
totalInboundQuantity
to thelistInventory
operation. You can use this parameter to track inventory in transit to Amazon Warehousing and Distribution. - Added a new optional request parameter
skuQuantities
to thegetInboundShipment
operation. You can use this parameter to reconcile and compare expected and received inventory for each SKU in a shipment.
You can now use the Amazon Warehousing and Distribution API to:
- Rastrear o inventário em trânsito para os centros de armazenamento e distribuição da Amazon para uma melhor visualização do inventário de ponta a ponta.
- Reconciliar e comparar o inventário esperado e recebido para cada código SKU em uma remessa.
14 de agosto de 2024
Mudanças na API
- Adicionado um novo valor de enumeração para inelegibilidade de entrada,
FBA_INB_0342
, à operaçãogetItemEligibilityPreview
. Esse valor oferece mais informações sobre os motivos pelos quais uma oferta não pode usar determinados códigos de barras do fabricante.
- Added the
getAccount
operation to retrieve information about seller accounts.
-
Adicionada uma nova variável
unitOfMeasure
para dar suporte a produtos de peso variável. Essa variável define a unidade de medida para preços de itens vendidos por peso. Caso esse campo não esteja presente, o item será vendido por unidade. As operações que retornam essa variável incluem:
Mudanças na documentação
- 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.
Avisos de descontinuação
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 de julho de 2024
Mudanças na API
-
Added the
queryStartDate
parameter to thegetFeatureInventory
operation. You can use this parameter to select inventory that has been updated since a specified date. -
The Fulfillment Outbound API v2020-07-01 Use Case Guide provides steps on how to pass the
queryStartDate
parameter when retrieving a list of inventory items that are eligible for a specified fulfillment feature.
Mudanças na documentação
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.
Avisos de descontinuação
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
8 de julho de 2024
Mudanças na 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.
28 de junho de 2024
Mudanças na API
- Removed the June 27, 2024 updates to Fulfillment Outbound API v2020-07-01 and Merchant Fulfillment v0 API.
27 de junho de 2024
Mudanças na API
- The Fulfillment Inbound API v2024-03-20 is now in general availability. You can use this API to select from multiple inbound placement service options and create inbound plans with support for up to 1500 SKUs.
- The Fulfillment Inbound API v2024-03-20 Use Case Guide provides tutorials on how to create shipments and guidance on the fulfillment inbound shipment workflow.
- The Fulfillment Inbound API frequently asked questions includes the benefits of the Fulfillment Inbound API v2024-03-20 and guidance on migrating from the Fulfillment Inbound API v0.
- Migrating Fulfillment Inbound workflows guide you through migrating from the Fulfillment Inbound API v0 to the new Fulfillment Inbound API v2024-03-20.
##### Fulfillment Outbound API v2020-07-01
- Added the queryStartDate
parameter to the getFeatureInventory
operation. Sellers can use this parameter to select inventory that has been updated since a specified date.
- The Fulfillment Outbound API v2020-07-01 Use Case Guide provides steps on how to pass the queryStartDate
parameter when retrieving a list of inventory items that are eligible for a specified fulfillment feature.
##### Merchant Fulfillment v0 API
- Added the Benefits
object, which contains a list of included and excluded Amazon benefits from a shipping service offer. Each excluded benefit has a list of reason codes for why it is excluded. Benefits represent services provided by Amazon (for example, CLAIMS_PROTECTED
for A-to-z Guarantee) when sellers purchase shipping through Amazon. Sellers gain insight into what comes with buying a label through Amazon.
- You can use the new Transfers API v2024-06-01 to initiate payouts and retrieve instrument details sellers' accounts by calling the
initiatePayout
andgetPaymentMethods
operations. For tutorials on how to use the Transfers API v2024-06-01, sellers can refer to the Transfers API v2024-06-01 Use Case Guide. This API is only available in private beta.
Mudanças na documentação
- 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.
Avisos de descontinuação
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 de junho de 2024
Mudanças na API
- Sellers can use the new Amazon Warehousing and Distribution API v2024-05-09 to track inventory inside AWD distribution centers and track shipments going into AWD distribution centers.
- The Data Kiosk API v2023-11-05 is now in general availability.
- The new Data Kiosk sample solution provides all the resources that you need to deploy a fully functional SP-API application that automates the creation and retrieval of Data Kiosk documents.
- The new Data Kiosk workflow guide offers insights into best practices, answers common questions about API usage, and outlines optimal workflows.
- The new Vendor Analytics dataset provides vendor data across multiple domains. You can aggregate data across any granularity (ASIN/Brand/Manufacturing/date) and access more than 100 metrics across sales, traffic, inventory, forecast, profitability, and new geographic sales metrics.
- Developers who create or manage applications that integrate with the FBA Inventory API v1 and Fulfillment Outbound API v2020-07-01 can use the two dynamic sandbox environments to test code integrations between the FBA and Fulfillment Outbound API domains. These sandboxes simulate order fulfillment and inventory movements that mimic Amazon's production responses. For more information, refer to the FBA Inventory Dynamic Sandbox Guide.
- Added the new
deliveryOffers
operation. Sellers can use this operation to display Multi-Channel Fulfillment (MCF) standard delivery offers on pre-checkout pages. This operation is only available in the United States (US) marketplace. - Added the optional field
lockerDetails
to thegetFulfillmentOrder
response. Sellers can include the information that is needed to access the locker delivery boxes. This field is only available in the Japan (JP) marketplace. - Added the optional field
deliveryPreferences
to thecreateFulfillmentOrder
request. Sellers can include the delivery preferences that are applied to the destination address. This field is only available in the Japan (JP) marketplace. - Developers who create or manage applications that integrate with the FBA Inventory API v1 and Fulfillment Outbound API v2020-07-01 can use the two dynamic sandbox environments to test code integrations between the FBA and Fulfillment Outbound API domains. These sandboxes simulate order fulfillment and inventory movements that mimic Amazon's production responses. For more information, refer to the Fulfillment Outbound Dynamic Sandbox Guide.
- The
getFeaturedOfferExpectedPriceBatch
operation is now available in all marketplaces except Japan (JP). Sellers can use this operation to get the featured offer expected price (FOEP) data for up to 40 SKUs.
- Added the metrics
LOST_REVENUE_DUE_TO_OOS
,SUBSCRIBER_NON_SUBSCRIBER_AVERAGE_REORDERS
, andCOUPONS_REVENUE_PENETRATION
to thegetSellingPartnerMetrics
operation response. These metrics describe sources of revenue and lost revenue. - Added the metrics
LOST_REVENUE_DUE_TO_OOS
andCOUPONS_REVENUE_PENETRATION
to thelistOfferMetrics
operation response. These metrics describe sources of revenue and lost revenue.
Avisos de descontinuação
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 de junho de 2024
Mudanças na API
- Novo recurso: visualize e selecione uma das janelas de entrega disponíveis para uma remessa chegar a uma instalação da Amazon
- Novo recurso: imprima etiquetas para itens individuais
- Select Partnered Carrier as an option for your less-than-truckload (LTL) shipments
- Atualize o nome dos planos de entrada e remessas
- Atualize a quantidade de unidades de um código SKU após a confirmação de envio
- Add three new mandatory operations:
confirmDeliveryWindowOptions
,generateDeliveryWindowOptions
, andlistDeliveryWindowOptions
Avisos de descontinuação
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:
22 de maio de 2024
Mudanças na API
-
Added the
lowestPricedOffers
andreferencePrices
attributes to the Product Pricing API v2022-05-01. This enhancement provides the top 20 lowest priced offers and reference prices. -
In the Product Pricing API v2022-05-01 Use Case Guide, the Tutorial: Retrieve a list of featured offers for a batch of up to 20 ASINs makes use of two new attributes:
lowestPricedOffers
andreferencePrices
. -
Added the Price Adjustment Automation Workflows Guide to our Selling Partner API documentation site. This guide outlines how to leverage the Product Pricing API v2022-05-01 and Pricing notifications to build best-in-class workflows that automate pricing management.
-
Added the Product pricing API and notifications frequently asked questions to our Selling Partner API documentation site. This documentation covers common questions and details for the Product Pricing API v2022-05-01.
- Adicionada uma nova opção de parâmetro de consulta
includedData
chamadaclassifications
, que substitui as operações descontinuadasGetProductCategoriesForSKU
eGetProductCategoriesForASIN
do MWS. Vendedores e fornecedores podem usarclassifications
para navegar pelas árvores de classificação atribuídas a um ASIN.
- The Order feeds attributes
POST_ORDER_FULFILLMENT_DATA
andPOST_FLAT_FILE_FULFILLMENT_DATA
are updated with a new field:ship-from-supply-source-id
.
Avisos de descontinuação
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.
24 de abril de 2024
Mudanças na API
-
Added the the
CompanyName
attribute to the Orders API v0 API. -
Atualizado o limite de taxa para as operações
getOrder
,getOrderAddress
egetOrderBuyerInfo
de 0,0167 para 0,5 e aumentado o limite de pico de 20 para 30. -
Os tipos de objeto
IsBuyerRequestedCancel
,IsGift
eNumberOfItems
foram atualizados de booleano/inteiro para string. -
Atualizada a operação
getOrders
para retornar os atributosAutomatedCarrier
eAutomatedShipMethod
.
- A licença foi atualizada da Licença de software Amazon para a Licença Apache 2.0.
- O código HTTP 413 foi adicionado à lista de respostas possíveis de cada operação.
Alterações no esquema do relatório
Adicionado o campo lastUpdatedDate
aos seguintes relatórios do fornecedor:
GET_VENDOR_SALES_REPORT
GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT
GET_VENDOR_TRAFFIC_REPORT
GET_VENDOR_FORECASTING_REPORT
GET_VENDOR_INVENTORY_REPORT
Expansão do mercado central de fornecedores para a Irlanda (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.
Mudanças na documentação
- 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.
Avisos de descontinuação
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 de entrada de logística v0 (Operações selecionadas)
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
carga útil versão 1.0
1º de abril de 2024
Mudanças na API
- Acesso antecipado à nova API de entrada de logística v2024-03-20, que oferece suporte à criação de remessas de entrada do FBA - Logística da Amazon e permite que você selecione entre várias opções de serviço de posicionamento de entrada, entre outros recursos.
Avisos de descontinuação
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 de entrada de logística v0 (Operações selecionadas)
createInboundShipmentPlan
updateInboundShipment
createInboundShipment
getPreorderInfo
confirmPreorder
getTransportDetails
putTransportDetails
voidTransport
estimateTransport
confirmTransport
getShipments
getShipmentItemsByShipmentId
getShipmentItems
20 de março de 2024
Mudanças na API
- Adicionados os objetos
AdditionalAddressNotes
,NdrAction
,NdrRequestData
eSubmitNdrFeedbackRequest
aondrFeedback parameter
. - Added tutorial for Using the ndrFeedback API to submit Non-Delivery Reports for eligible shipments.
- Adicionados os atributos de mercadorias perigosas
LiquidVolume
,IsHazmat
eDangerousGoodsDetails
ao objeto Item.
- 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.
- Adicionado o atributo
PaymentInformation
, obrigatório para a Índia, mas opcional para todos os outros sites. - Added tutorial on how to create an MCF order for India in the Fulfillment Outbound API v2020-07-01 Use Case Guide.
Mudanças na documentação
- 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.
- Reformatadas as páginas de "Valores do tipo de relatório" e consolidados os atributos de tipo de relatório para otimizar a descoberta.
Avisos de descontinuação
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 de autorização v1 (Todas as operações)
- API de FBA - Logística da Amazon Small and Light v1 (Todas as operações)
- API de entrada de logística v0 (Operações selecionadas)
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
carga útil versão 1.0
21 de fevereiro de 2024
Mudanças na 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.
- A API de gerenciamento de aplicativos v2023-11-30 foi promovida de Beta pública para Produção. Essa API permite que você alterne programaticamente suas credenciais (segredos do cliente) de Login com a Amazon (LWA).
Atualizações da documentação
- 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.
Avisos de descontinuação
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 de janeiro de 2024
Mudanças na API
- Added a new validation mode for the
putListingsItem
andpatchListingsItem
operations. Use themode=VALIDATION_PREVIEW
query parameter to validate a listings item without persisting the data in the catalog. This feature allows you to preview listing errors in production without creating listings.
- Adicionou o
ShipsInProductPackaging
valor para oPrepInstruction
enumeração.PrepInstructionList
é retornado na resposta para chamadas paraprepInstructions
.
- Adicionado
ExtendedFields
eAddressExtendedFields
objetos. Esses objetos estão disponíveis somente para endereços no Brasil e são retornados em respostas para endereços de entrega no Brasil que contêm campos estendidos.
Avisos de descontinuação
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 de autorização v1 (Todas as operações)
- API de FBA - Logística da Amazon Small and Light v1 (Todas as operações)
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
13 de dezembro de 2023
Mudanças na API
- A nova API de gerenciamento de aplicativos permite que você alterne programaticamente suas credenciais (segredos do cliente) de Login com a Amazon (LWA). Disponível na versão beta pública.
- Foi lançado suporte para envio de cargas perigosas (DG) nos mercados dos EUA e Reino Unido.
- A Índia (IN) agora é um site compatível
- Dois novos campos foram adicionados ao objeto
Issue
:Enforcements
eCategories
- O tipo da operação
searchDefinitionsProductTypes
foi atualizado para string
- Adicionado um parâmetro opcional
payloadVersion
- New Listings Item Issues Change Notification version 2023-12-13 has three new enforcement actions:
LISTING_SUPPRESSED
,ATTRIBUTE_SUPPRESSED
, andCATALOG_ITEM_REMOVED
Atualizações da documentação
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.
O relatório de faturas em massa do Enviado pela Amazon (FBA - Logística da Amazon) (FBA_BULK_INVOICE
) compartilha as faturas de um vendedor no intervalo de datas determinado. Essas faturas incluem pedidos de clientes atendidos pelo vendedor.
Avisos de descontinuação
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 de autorização v1 (Todas as operações)
- API de FBA - Logística da Amazon Small and Light v1 (Todas as operações)
- API de entrada de logística v0 (Operações selecionadas)
getInboundGuidance
- API de envio pelo vendedor v0 (Operações selecionadas)
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 de novembro de 2023
Mudanças na API
- A nova API de fontes de fornecimento configura e atualiza informações sobre fontes de fornecimento do vendedor, como lojas e armazéns.
- O Reino Unido agora é um site válido.
getFeaturedOfferExpectedPriceBatch
(FOEP) has been extended to Amazon.co.uk.ASIN_NOT_ELIGIBLE
agora é um valor pararesultStatus
.- A nova operação
competitiveSummary
retorna a resposta do resumo competitivo, incluindo as opções de compra em destaque para a combinação de ASIN emarketplaceId
.
- Atualizado para três novos parâmetros (
itemName
,locale
esearchlocale
) e um novo tipo de produtodisplayName
.
- As operações
ListFinancialEvent
eListFinancialEventGroups
atualizadas agora comunicam com mais clareza as respostas e o escopo esperados. A resposta paraChangeRefundTransactions
foi modificada de um objeto para uma matriz.
- O campo atualizado
weight
agora é obrigatório. Essa alteração gerará um erro ao invocarshipmentconfirmations
para que os fornecedores não precisem esperar por um erro durante o status da transação.
Atualizações da documentação
- 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.
Avisos de descontinuação
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 de autorização v1 (Todas as operações)
- API de FBA - Logística da Amazon Small and Light v1 (Todas as operações)
- API de entrada de logística v0 (Operações selecionadas)
getInboundGuidance
- API de envio pelo vendedor v0 (Operações selecionadas)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
ORDER_STATUS_CHANGE
11 de outubro de 2023
Mudanças na API
- O elemento de dados
ItemProcurement
foi alterado de objeto para uma matriz.
- Uma lista de itens associados foi adicionada à resposta da operação
getOrderItems
.
- O atributo
listingPrice
na resposta degetItemOffers
foi renomeado para ajudar os desenvolvedores a evitar erros ao estender seu código para casos de uso entre empresas (B2B). Os subcamposLandedprice
eShipping
deixaram de ser obrigatórios e agora são opcionais.
Avisos de descontinuação
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 de autorização v1 (Todas as operações)
- API de FBA - Logística da Amazon Small and Light v1 (Todas as operações)
- API de feeds v2020-09-04 (Todas as operações)
- API de entrada de logística v0 (Operações selecionadas)
getInboundGuidance
- API de envio pelo vendedor v0 (Operações selecionadas)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
- API de relatórios v2020-09-04 (Todas as operações)
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
ORDER_STATUS_CHANGE
20 de setembro de 2023
Mudanças na API
- A descrição da operação
BuyerCompanyName
na API de pedidos v0 foi atualizada para esclarecer o nome da empresa no endereço de destino.
Atualizações da documentação
- 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.
Avisos de descontinuação
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 de autorização v1 (Todas as operações)
- API de FBA - Logística da Amazon Small and Light v1 (Todas as operações)
- API de feeds v2020-09-04 (Todas as operações)
- API de entrada de logística v0 (Operações selecionadas)
getInboundGuidance
- API de envio pelo vendedor v0 (Operações selecionadas)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
- API de relatórios v2020-09-04 (Todas as operações)
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
16 de agosto de 2023
Mudanças na API
- A propriedade
ShipmentServiceLevelCategory
da definição do pedido foi atualizada para incluir o valorPriority
. Esse valor está disponível no novo modelo de envio, que já pode ser utilizado nos sites da França, Espanha, Alemanha, Polônia, Países Baixos, Suécia e Bélgica, para dar suporte a pedidos Prime enviados pelo vendedor. Se sua integração usar os novos modelos de envio para essas regiões, talvez seja necessário atualizar sua integração para aceitar o valorPriority
paraShipmentServiceLevelCategory
.
- O atributo
generic_keyword
é um dado proprietário específico do vendedor e não será mais retornado pela API de itens do catálogo. Os parceiros de vendas podem usar a API de itens de ofertas para visualizar os valores enviados.
Atualizações da documentação
- 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.
Avisos de descontinuação
Ajustamos a data de remoção das seguintes APIs:
Chamadas a essas APIs terão uma taxa de limitação menor entre 16 de agosto de 2023-* e 18 de outubro de 2023. As chamadas a essas APIs falharão em 18 de outubro de 2023.
For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
21 de junho de 2023
Mudanças na 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 de relatórios
- 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.
Análise rápida de varejo
- 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.
Análise rápida de varejo
- 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.
Atualizações da documentação
- 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
Avisos de descontinuação
os recursos da SP-API com descontinuação anunciada deixarão de ter suporte após a data de suspensão. As chamadas para recursos obsoletos falharão a partir da data de remoção
For more detailed information about SP-API deprecation dates, refer to the Deprecations table.
17 de maio de 2023
Mudanças na API
- O sandbox dinâmico foi atualizado para incluir a operação
createShippingLabels
.
- Remova o fluxo de trabalho de aprovações de pedidos genéricos. Os atributos
ItemApprovalTypes
eItemApprovalStatus
foram removidos.
Atualizações da documentação
-
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.
Avisos de descontinuação
- API de feeds v2020-09-04
- API de relatórios v2020-09-04
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
19 de abril de 2023
Mudanças na API
- A propriedade
city
foi atualizada no atributoaddress
de requerida para opcional.
- O campo
sellerSku
foi atualizado para incluir e analisar vírgulas.
Atualizações da documentação
- O metaesquema de definição de tipo de produto da Amazon (v1) foi atualizado para incluir as seguintes palavras-chave:
$lifecycle
,replacedBy
,replaces
,enumDeprecated
eenumReplacement.
Atualizações do guia de C#
- Added two new C# guides: Generate a C# SDK with LWA Token Generation and Authentication and Connect to the Selling Partner API using a generated C# SDK.
Avisos de descontinuação
29 de março de 2023
Mudanças na API
- Atualize
nextToken
para expirar após 30 segundos.
- A operação
confirmShipment
foi adicionada.
- O atributo
address
foi atualizado para incluir a cidade. - Atualizado para empregar um sandbox dinâmico para testes em vez de um sandbox estático. Inclui uma nova operação somente em sandbox.
Atualizações da documentação
- 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
- Três novos recursos da API de itens de ofertas para resolver questões comuns:
Avisos de descontinuação
22 de fevereiro de 2023
Mudanças na API
- Respostas simuladas atualizadas de sandbox estático para exibir os nomes de alguns métodos de envio doméstico do UPS (EUA) na SP-API.
- Added the following delivery preferences attributes to
getOrderAddress
to support Amazon Business customer orders:PreferredDeliveryTime
BusinessHours
OtherAttributes
AddressInstructions
Esses atributos contêm informações sobre como e quando um pacote é entregue.
- The
customedURL
attribute ofbuyerCustomizedInfo
, returned by thegetOrder
andgetOrders
operations, is now a Base 64 encoded URL using the UTF-8 character set.
- Atualizado para passar
six-month-past-in-date
como um parâmetro de consulta.
Atualizações da documentação
- 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.
Avisos de descontinuação
25 de janeiro de 2023
Alterações na API
- A nova operação
getFeaturedOfferExpectedPriceBatch
recupera respostas para um lote de até 40 solicitações de preço esperado da oferta em destaque (FOEP).
- Novo atributo
buyerCustomizedInfo
, que contém informações do comprador sobre produtos que o fornecedor configurou como personalizáveis, especificando os tipos de personalização ou configurações junto com os tipos e variações de seus produtos.
- O novo atributo
serialNumber
retorna uma lista de números de série de produtos eletrônicos que são enviados aos clientes. Retornado apenas para pedidos do Logística da Amazon.
- Novo tipo de evento financeiro:
CapacityReservationBillingEventList
permite que você recupere detalhes relacionados a uma cobrança de reserva de capacidade.
Atualizações da documentação
- 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.
Avisos de descontinuação
- API de feeds v2020-09-04
- API de relatórios v2020-09-04
- Relatórios de inventário do Logística da Amazon
- Notificação
MFN_ORDER_STATUS_CHANGE
6 de dezembro de 2022
Alterações na API
A API de itens de catálogo v2022-04-01 foi atualizada para incluir vários atributos adicionais no resumo e colocar a API de itens de catálogo em paridade com a seção Itens de catálogo do Marketplace Web Services:
In addition, the following attributes have been added to ItemSummaryByMarketplace
:
adultProduct
autographed
memorabilia
releaseDate
tradeInEligible
9 de novembro de 2022
Alterações na 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.
Atualizações da documentação
- 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 de outubro de 2022
Alterações na 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.
Atualizações da documentação
- New Selling Partner API Guard Implementation Guide describes architectural considerations and configuration steps for deploying Amazon Selling Partner Guard in AWS Cloud.
21 de setembro de 2022
Alterações na 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. - Atualização para produção e suporte dinâmico de sandbox para todas as operações equivalentes de Envio direto do fornecedor V1.
- Atualização para as seguintes operações restritas para oferecer suporte à API de Envio direto do fornecedor v2021-12-28:
createShippingLabels
getPackingSlip
getCustomerInvoice
getShippingLabel
- Updated Inventory Ledger Report (
GET_LEDGER_DETAIL_VIEW_DATA
) now includes a neweventType
filter to filter on particular warehouse events.
Atualizações da documentação
- 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 de agosto de 2022
Alterações na API
- Melhorias na API de pedidos para dar suporte às remessas do Easy Ship.
- Atualizado para a nova operação
getRangeSlotCapacity
, que fornece slots de capacidade em um formato semelhante aos registros de disponibilidade. - Atualização para a nova operação
getFixedSlotCapacity
, que fornece slots de capacidade fixa.
18 de maio de 2022
Alterações na API
- A nova versão 2022-04-01 da API de itens de catálogo melhora a experiência de API e aborda os comentários dos desenvolvedores com as seguintes alterações:
- Pesquisas baseadas em identificadores foram adicionadas à operação
searchCatalogItems
, permitindo solicitações em lote com até 20 identificadores por solicitação (ASINs, UPCs e EANs) - O conjunto de dados
dimensions
foi adicionado, fornecendo dimensões normalizadas do item e do pacote - Nomes de exibição foram adicionados para categoria de produtos, subcategoria de produtos e classificação de navegação
- Atributos de identificação expandidos para resumos de itens (classificação do item, quantidade da embalagem, número da peça, grupo de exibição do site)
- Classificações de navegação e grupos de exibição de sites foram adicionados às classificações de vendas
- As operações
searchCatalogItems
egetCatalogItem
foram alinhadas para usar os mesmos conjuntos de dados, incluindoattributes
variations
foi substituído porrelationships
para permitir que vários tipos de relacionamento sejam representados, como hierarquias de pacotes- Detalhes do tema de variação foram adicionados (nome dos detalhes dos relacionamentos)
- Pesquisas baseadas em identificadores foram adicionadas à operação
- Foi adicionado um parâmetro
processingDirective
que permite passar informações adicionais para a assinatura para controlar o processamento das notificações. Esse parâmetro é usado pela notificaçãoANY_OFFER_CHANGED
. - A notificação de
ANY_OFFER_CHANGED
foi atualizada para suportar a filtragem de notificações apenas paramarketplaceIds
específicos(as) e a limitação de notificações para uma a cada intervalo de cinco ou dez minutos.
- Atualizado para incluir suporte ao programa Purchase Shield, que gerencia pedidos regulamentados no Reino Unido. Os pedidos regulamentados são um conjunto limitado de pedidos que envolvem produtos que exigem receita médica, como medicamentos para animais de estimação, lentes de contato prescritas e óculos de grau. Duas novas operações foram adicionadas:
getOrderRegulatedInfo
eupdateVerificationStatus
. - Novo atributo
IsAccessPointOrder
para auxiliar na identificação de pedidos da rede de logística do vendedor (enviado pelo vendedor) que foram enviados para hubs de pontos de acesso (AP).
- Atualizado para a nova operação
getMyFeesEstimates
que recupera estimativas de taxas de produtos para uma lista de produtos e marketplaces.
- Atualizado para novas operações
getItemOffersBatch
egetListingOffersBatch
que recuperam preços de produtos e oferecem informações em uma lista de produtos.
- 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 de abril de 2022
Alterações na API
- New Easy Ship API helps you build applications that help sellers manage and ship Amazon Easy Ship orders.
- Updated FBA Inventory API for global availability and released new FBA Inventory Use Case Guide.
- New
PRICING_HEALTH
notification is sent whenever a seller offer is ineligible to be the Featured Offer (Buy Box offer) because of an uncompetitive price. - New
FulfillmentChannel
property in theORDER_STATUS_CHANGE
notification that allows you to filter order status change notifications based on whether the order is fulfilled by Amazon (AFN) or fulfilled by seller (MFN).
- New Vendor Direct Fulfillment Orders API v2021-12-28 provides programmatic access to a direct fulfillment vendor's order data. This v2021-12-28 release adds support for dynamic sandbox testing.
- New Vendor Direct Fulfillment Sandbox Test Data API v2021-10-28 provides programmatic access to vendor direct fulfillment sandbox test data.
- New Vendor Direct Fulfillment Shipping API v2021-12-28 reference provides programmatic access to a direct fulfillment vendor's shipping data. This v2021-12-28 release adds support for dynamic sandbox testing.
- New Vendor Direct Fulfillment Transactions API v2021-12-28 provides programmatic access to a direct fulfillment vendor's transaction status. This v2021-12-28 release adds support for dynamic sandbox testing.
Atualizações da documentação
- 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 de março de 2022
Alterações na API
- O novo parâmetro de
buyerRequestedCancel
fornece informações sobre se um comprador solicitou o cancelamento do pedido e o motivo do cancelamento.
New Seller retail analytics reports
- O novo Relatório comercial de vendas e tráfego ajuda você a gerenciar melhor suas análises fornecendo métricas-chave de desempenho de vendas, como vendas de produtos pedidos, receita, unidades pedidas e quantidade de contestações, além de métricas de tráfego de página, como visualizações da página e porcentagem da Buy Box de todo o catálogo de itens do vendedor agregados por data e ASIN. Esse relatório exige a função de API do parceiro de vendas da análise de marcas, que agora está disponível para todos os vendedores.
- O novo Relatório de desempenho de cupons ajuda você a otimizar suas promoções e ajustar suas estratégias de publicidade. O relatório inclui detalhes em nível de campanha (total de clipes, resgates) e detalhes em nível de cupom (data de início/término, clipes, resgates e informações sobre orçamento). Disponível para fornecedores com a função de API do parceiro de vendas para análise de marcas.
New Vendor retail analytics reports
- O novo Relatório de vendas do fornecedor ajuda você a gerenciar melhor seu inventário fornecendo as principais métricas de vendas no varejo, como receita pedida/enviada e unidades. Os dados são relatados no nível agregado no catálogo de itens de um fornecedor e no nível ASIN no períodos de relatório
DAY
,WEEK
,MONTH
,QUARTER
eYEAR
. Disponível para fornecedores que têm a função da API do parceiro de vendas para análise de marcas. - O novo Relatório de tráfego do fornecedor ajuda você a gerenciar melhor seu inventário fornecendo as principais métricas de tráfego no varejo, como visualizações da página de detalhes. Os dados são relatados no nível agregado no catálogo de itens de um fornecedor e no nível ASIN nos períodos de relatório
DAY
,WEEK
,MONTH
,QUARTER
eYEAR
. Disponível para fornecedores que têm a função da API do parceiro de vendas para análise de métricas. - O novo Relatório de previsão do fornecedor ajuda você a gerenciar melhor seu inventário fornecendo previsões semanais de demanda de clientes com média prospectiva, P70, P80 e P90. O sistema de previsão produz previsões para um ASIN em vários níveis P, também conhecidos como níveis de confiança. Se você estiver definindo um nível P de previsão de 0,80 (“P80”), isso significa que há uma probabilidade de 80% de a demanda do cliente não exceder as unidades semanais previstas. Os dados são reportados no nível de ASIN para a data de geração de previsão semanal mais recente. Disponível para fornecedores com a função API do parceiro de vendas para análise de marcas.
- O novo Relatório de integridade do inventário do fornecedor 2.0 ajuda você a gerenciar melhor seu inventário fornecendo métricas de inventário e integridade operacional, como unidades disponíveis comercializáveis e taxa de confirmação do fornecedor. Os dados são relatados no nível agregado no catálogo de itens de um fornecedor e no nível de ASIN nos períodos de relatório semanal, mensal, trimestral e anual. Disponível para fornecedores com a função API do parceiro de vendas para análise de marcas.
Documentation update for Invoice data reports
- O relatório de dados da fatura de IVA em arquivo simples e o relatório de dados da fatura de IVA em XML agora estão disponíveis na documentação. Esses relatórios são para vendedores inscritos no Serviço de cálculo de IVA da Amazon e que optam por enviar suas próprias faturas.
Atualizações da documentação
-
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 de janeiro de 2022
Alterações na API
- Novo código de erro
PRODUCTASSURANCE_SAFETYDOCUMENTATION
retornado para produtos não conformes que não têm documentação de conformidade de segurança. Esse código de erro é retornado nas seguintes operações:CreateInboundShipmentPlan
CreateInboundShipment
UpdateInboundShipment
PreviewItemEligibility
Read more about this change on Seller Central.
- Novo atributo de
buyerTaxInformation
para o marketplace da Turquia. Esse atributo inclui informações fiscais comerciais quando o comprador é uma empresa.
- A nova notificação de Alteração do status do pedido é enviada sempre que há uma alteração no status de disponibilidade do pedido.
- O novo Relatório de integridade de gerenciamento de inventário do Logística da Amazon ajuda você a gerenciar melhor seu inventário fornecendo uma visão consolidada de suas vendas (7, 30, 60 e 90 dias), do status de remessas (ativas, recebidas e enviadas), taxas estimadas de armazenamento e de longo prazo, além de unidades antigas e excedentes. Esse relatório inclui métricas de vendas, entradas, tarifas estimadas e ações recomendadas.
- O novo Relatório de transferência de estoque sob demanda fornece informações no nível da transação, como valor da fatura, número da fatura, alíquota do imposto e números de identificação fiscal de produtos e serviços (GSTINs) para transações de movimentação interestadual.
Atualizações da documentação
Guia de migração do Amazon MWS para a API do parceiro de vendas
- 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