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 the listInventory operation. You can use this parameter to review quantity information for units that are in transit from Amazon Warehousing and Distribution (AWD) to a Fulfillment by Amazon (FBA) facility.
  • O conjunto de dados do Vendor Analytics agora inclui métricas como sellableInTransitInventory, unsellableInTransitInventory, mostRecentSubmitted, netOrderedGMS, e netShipmentGMS. 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 the supportedConfigurations property. This property replaces the supportedShippingConfigurations property.
  • Added sampleLocation to the response of the getCompetitiveSummary operation and the request of the getFeaturedOfferExpectedPriceBatch operation. You can use this metric to return location information for featured offers and to retrieve a location-specific feature offer expected price (FOEP).

Mudanças na documentação

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 and getInboundShipment responses. You can use this property to get the expiration date of a perishable item in your shipment. For more information, refer to Track an inbound shipment with expected and received SKU details.
  • Adicionou o prepDetails propriedade para o listInventory e getInboundShipment 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, and SHARE_OF_COUPON_SUBSCRIPTIONS metrics to the getSellingPartnerMetrics operation response. These metrics describe the revenue sources and subscription performance.
  • Added the SHARE_OF_COUPON_SUBSCRIPTIONS metric to the listOfferMetrics operation response. This metric describes the coupon acquisition performance.

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

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

12 de novembro de 2024

Mudanças na API

  • Added WasPrice to the getCompetitiveSummary operation (in the referencePrices list in the operation response). WasPrice is the 90-day median price that customers pay for the product on Amazon. You can use this value to set promotions and discounts based on the typical price on the product detail page.

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 the AdjustmentItem object. You can use this parameter to identify what the adjustment is related to. For example, Amazon Shipping customers can use this to get an invoice number that they can use to identify an Amazon Shipping invoice.
  • Added the following to the Fulfillment Outbound API v2020-07-01 Use Case Guide:
    • items 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 e createShipment 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

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

  • Adicionado um campo opcional, deliveryInformation, à resposta de GetFulfillmentOrder. Esse campo permite obter o deliveryDocumentList, que pode incluir uma foto ou assinatura de entrega de uma remessa de saída de logística multicanal. Você pode usar dropOffLocation para rastrear o local de entrega do pacote.
  • 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 require offerIdentifier in the FeaturedOfferExpectedPriceResponseBody. The offerIdentifier parameter is now optional in order to correctly deserialize getFeaturedOfferExpectedPriceBatch error responses, as FeaturedOfferExpectedPriceResponseBody doesn’t provide offerIdentifier in the response when there are errors.

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 the listInventory operation. You can use this parameter to track inventory in transit to Amazon Warehousing and Distribution.
  • Added a new optional request parameter skuQuantities to the getInboundShipment operation. You can use this parameter to reconcile and compare expected and received inventory for each SKU in a shipment.

You can now use the Amazon Warehousing and Distribution API to:

  • 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ção getItemEligibilityPreview. 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.

Mudanças na documentação

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 the getFeatureInventory operation. You can use this parameter to select inventory that has been updated since a specified date.

  • The Fulfillment Outbound API v2020-07-01 Use Case Guide provides steps on how to pass the queryStartDate parameter when retrieving a list of inventory items that are eligible for a specified fulfillment feature.

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

27 de junho de 2024

Mudanças na API

##### Fulfillment Outbound API v2020-07-01

- Added the queryStartDate parameter to the getFeatureInventory operation. Sellers can use this parameter to select inventory that has been updated since a specified date.
- The Fulfillment Outbound API v2020-07-01 Use Case Guide provides steps on how to pass the queryStartDate parameter when retrieving a list of inventory items that are eligible for a specified fulfillment feature.

##### Merchant Fulfillment v0 API

- Added the Benefits object, which contains a list of included and excluded Amazon benefits from a shipping service offer. Each excluded benefit has a list of reason codes for why it is excluded. Benefits represent services provided by Amazon (for example, CLAIMS_PROTECTED for A-to-z Guarantee) when sellers purchase shipping through Amazon. Sellers gain insight into what comes with buying a label through Amazon.

Mudanças na documentação

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

  • The Data Kiosk API v2023-11-05 is now in general availability.
  • The new Data Kiosk sample solution provides all the resources that you need to deploy a fully functional SP-API application that automates the creation and retrieval of Data Kiosk documents.
  • The new Data Kiosk workflow guide offers insights into best practices, answers common questions about API usage, and outlines optimal workflows.
  • The new Vendor Analytics dataset provides vendor data across multiple domains. You can aggregate data across any granularity (ASIN/Brand/Manufacturing/date) and access more than 100 metrics across sales, traffic, inventory, forecast, profitability, and new geographic sales metrics.
  • Added the new deliveryOffers operation. Sellers can use this operation to display Multi-Channel Fulfillment (MCF) standard delivery offers on pre-checkout pages. This operation is only available in the United States (US) marketplace.
  • Added the optional field lockerDetails to the getFulfillmentOrder response. Sellers can include the information that is needed to access the locker delivery boxes. This field is only available in the Japan (JP) marketplace.
  • Added the optional field deliveryPreferences to the createFulfillmentOrder request. Sellers can include the delivery preferences that are applied to the destination address. This field is only available in the Japan (JP) marketplace.
  • Developers who create or manage applications that integrate with the FBA Inventory API v1 and Fulfillment Outbound API v2020-07-01 can use the two dynamic sandbox environments to test code integrations between the FBA and Fulfillment Outbound API domains. These sandboxes simulate order fulfillment and inventory movements that mimic Amazon's production responses. For more information, refer to the Fulfillment Outbound Dynamic Sandbox Guide.
  • The getFeaturedOfferExpectedPriceBatch operation is now available in all marketplaces except Japan (JP). Sellers can use this operation to get the featured offer expected price (FOEP) data for up to 40 SKUs.
  • Added the metrics LOST_REVENUE_DUE_TO_OOS, SUBSCRIBER_NON_SUBSCRIBER_AVERAGE_REORDERS, and COUPONS_REVENUE_PENETRATION to the getSellingPartnerMetrics operation response. These metrics describe sources of revenue and lost revenue.
  • Added the metrics LOST_REVENUE_DUE_TO_OOS and COUPONS_REVENUE_PENETRATION to the listOfferMetrics operation response. These metrics describe sources of revenue and lost revenue.

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, and listDeliveryWindowOptions

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

  • Adicionada uma nova opção de parâmetro de consulta includedData chamada classifications, que substitui as operações descontinuadas GetProductCategoriesForSKU e GetProductCategoriesForASIN do MWS. Vendedores e fornecedores podem usar classifications para navegar pelas árvores de classificação atribuídas a um ASIN.

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 e getOrderBuyerInfo de 0,0167 para 0,5 e aumentado o limite de pico de 20 para 30.

  • Os tipos de objeto IsBuyerRequestedCancel, IsGift e NumberOfItems foram atualizados de booleano/inteiro para string.

  • Atualizada a operação getOrders para retornar os atributos AutomatedCarrier e AutomatedShipMethod.

  • 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:

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 atributos de mercadorias perigosas LiquidVolume, IsHazmat e DangerousGoodsDetails ao objeto Item.
  • Updated FEED_PROCESSING_FINISHED and REPORT_PROCESSING_FINISHED to include support for vendors. Both notifications include a new accountId property, which identifies the selling partner on whose behalf the feed or report was submitted. This change applies to all marketplaces.

Mudanças na documentação

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 and patchListingsItem operations. Use the mode=VALIDATION_PREVIEW query parameter to validate a listings item without persisting the data in the catalog. This feature allows you to preview listing errors in production without creating listings.
  • Adicionou o ShipsInProductPackaging valor para o PrepInstruction enumeração. PrepInstructionList é retornado na resposta para chamadas para prepInstructions.
  • Adicionado ExtendedFields e AddressExtendedFields 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 e Categories
  • O tipo da operação searchDefinitionsProductTypes foi atualizado para string

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 para resultStatus.
  • 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 e marketplaceId .
  • Atualizado para três novos parâmetros (itemName, locale e searchlocale) e um novo tipo de produto displayName .
  • As operações ListFinancialEvent e ListFinancialEventGroups atualizadas agora comunicam com mais clareza as respostas e o escopo esperados. A resposta para ChangeRefundTransactions foi modificada de um objeto para uma matriz.
  • O campo atualizado weight agora é obrigatório. Essa alteração gerará um erro ao invocar shipmentconfirmations para que os fornecedores não precisem esperar por um erro durante o status da transação.

Atualizações da documentação

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 de getItemOffers foi renomeado para ajudar os desenvolvedores a evitar erros ao estender seu código para casos de uso entre empresas (B2B). Os subcampos Landedprice e Shipping 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

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 valor Priority. 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 valor Priority para ShipmentServiceLevelCategory.
  • 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

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
Listings Items API
Notifications API
  • New LISTINGS_ITEM_MFN_QUANTITY_CHANGE notification is sent whenever there is change in the available quantity of a listings item.
  • New ORDER_CHANGE notification is sent whenever there is an important change in the order. Important changes include order status changes and buyer requested cancellations. This notification replaces ORDER_STATUS_CHANGE.
  • The B2B_ANY_OFFER_CHANGED notification has been updated to include the Quantity Discount (QD) pricing in the Offer section, with new attributes including multiple quantity tiers, discount type, and price. You can now use this notification to build QD re-pricing solutions, which eliminates the need to use pricing APIs for this purpose.
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

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 e ItemApprovalStatus foram removidos.

Atualizações da documentação

Avisos de descontinuação

19 de abril de 2023

Mudanças na API

  • A propriedade city foi atualizada no atributo address 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 e enumReplacement.
Atualizações do guia de C#

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

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 of buyerCustomizedInfo, returned by the getOrder and getOrders 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

Avisos de descontinuação

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

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

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

Atualizações da documentação

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 e getCatalogItem foram alinhadas para usar os mesmos conjuntos de dados, incluindo attributes
    • variations foi substituído por relationships 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)
  • 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ção ANY_OFFER_CHANGED.
  • A notificação de ANY_OFFER_CHANGED foi atualizada para suportar a filtragem de notificações apenas para marketplaceIds 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 e updateVerificationStatus.
  • 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 e getListingOffersBatch que recuperam preços de produtos e oferecem informações em uma lista de produtos.

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 the ORDER_STATUS_CHANGE notification that allows you to filter order status change notifications based on whether the order is fulfilled by Amazon (AFN) or fulfilled by seller (MFN).

Atualizações da documentação

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.

New Performance reports

  • 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 e YEAR. 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 e YEAR. 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

Entrada de logística

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

Orders API

  • Novo atributo de buyerTaxInformation para o marketplace da Turquia. Esse atributo inclui informações fiscais comerciais quando o comprador é uma empresa.

Notifications API

  • A nova notificação de Alteração do status do pedido é enviada sempre que há uma alteração no status de disponibilidade do pedido.

API de relatórios

  • 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


Esta página ajudou você?