Uma função é o mecanismo usado pelas Selling Partner APIs para determinar se um desenvolvedor ou aplicativo tem acesso a uma operação ou recurso. Como desenvolvedor, você deve solicitar e se qualificar para uma função específica ou não poderá acessar as operações e os recursos agrupados nessa função. As funções protegem o acesso a informações de identificação pessoal (PII) e outros dados confidenciais e limitam o acesso aos dados para garantir que os desenvolvedores acessem apenas os dados necessários para um aplicativo. Isso ajuda a garantir que os clientes confiem na Amazon e nas empresas de serviços de parceiros de vendas que empregam Selling Partner APIs.
Na tabela a seguir, Restrito significa que a função requer informações confidenciais que podem incluir informações de identificação pessoal (PII). Você será solicitado a fornecer informações adicionais sobre o uso dos dados e seus controles de segurança.
| Função | Descrição |
|---|
| Brand Analytics | Acesse relatórios que contêm informações sobre o desempenho do vendedor(seller) e do fornecedor(vendor) na Amazon e relatórios de comportamento do consumidor que fornecem informações sobre como os clientes encontram e compram os produtos de um parceiro de vendas na Amazon. Operações de exemplo que requerem esta atribuição da função:- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT . Este relatório retorna dados sobre os ASINs mais clicados por palavra-chave de pesquisa e departamento para um marketplace.
- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_PROMOTION_PERFORMANCE_REPORT . Este relatório retorna dados de campanhas promocionais para ajudar fornecedores e vendedores a otimizar suas promoções e ajustar suas estratégias publicitárias.
Consulte Brand Analytics para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Oferta de produtos | Crie e gerencie listas de produtos. Geralmente usado para relatórios e feeds relacionados ao catálogo de produtos e operações. Exemplos de operações que requerem esta atribuição da função:- A operação getCatalogItem da API Selling Partner para Catalog Items, que retorna informações sobre o item indicado e seus atributos.
- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_MERCHANT_LISTINGS_INACTIVE_DATA . Este relatório retorna listagens inativas detalhadas.
- A operação getMyFeesEstimateForSKU da Selling Partner API para Product Fees, que retorna as taxas estimadas para o item indicado.
Consulte Oferta de produtos para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Precificação | Determine preços de tabela e automatize a precificação de produtos. Geralmente usado para relatórios, feeds e operações relacionados a preços. Exemplos de operações que requerem esta atribuição da função:- A operação createFeed da API Selling Partner para Feeds quando usada para enviar um feed RFQ_UPLOAD_FEED . Isso permite que você carregue descontos por quantidade em resposta a solicitações de clientes comerciais.
- A operação getPricing da API Selling Partner para Pricing, que retorna informações de preços para listagens de ofertas de um vendedor(seller).
- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_MERCHANT_CANCELLED_LISTINGS_DATA . Este relatório retorna listagens canceladas.
Consulte Precificação para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Enviado pela Amazon | Envie para a Amazon, e a Amazon envia diretamente para os clientes (Fulfillment by Amazon (FBA), Amazon Fulfillment Network (AFN)). Geralmente usado para relatórios de vendas FBA, relatórios de rastreamento de pedidos e operações relacionadas ao atendimento de pedidos. Exemplos de operações que requerem esta atribuição da função:- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA . Este relatório contém estimativas de taxas de vendas e atendimento da Amazon.
- A operação getSubscription da Selling Partner API para notificações quando usada para assinar notificações FBA_OUTBOUND_SHIPMENT_STATUS . Essas notificações são enviadas sempre que criamos ou cancelamos uma remessa FBA para um vendedor(seller).
- A operação getLabels da API Selling Partner para Fulfillment Inbound, que retorna etiquetas de pacotes/paletes.
- A operação createFeed da API Selling Partner para Feeds quando usada para enviar um feed POST_FBA_INBOUND_CARTON_CONTENTS . Isso permite que você envie informações sobre o conteúdo da caixa ao enviar inventário para a rede de atendimento da Amazon.
Consulte Enviado pela Amazon para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Comunicação com o comprador | Gerencie mensagens de e para compradores da Amazon. Geralmente usado para enviar mensagens para compradores da Amazon usando a API de parceiros de vendas para mensagens. Exemplos de operações que requerem esta atribuição da função:- A operação getMessagingActionsForOrder da API Selling Partner para Messaging, que retorna uma lista de tipos de mensagens disponíveis para um pedido especificado.
- A operação createConfirmOrderDetails da API Selling Partner para Messaging, que envia uma mensagem para fazer ao comprador uma pergunta relacionada ao pedido antes do envio.
- A operação createConfirmDeliveryDetails da API Selling Partner para Messaging, que envia uma mensagem a um comprador para agendar uma entrega ou confirmar informações de contato para fazer uma entrega.
Consulte Comunicação com o comprador para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Solicitação do cliente | Solicite feedback aos compradores da Amazon. Geralmente usado para solicitar feedback dos compradores da Amazon usando a API de Parceiro de Vendas para Solicitações. Exemplos de operações que requerem esta atribuição da função:- A operação getSolicitationActionsForOrder da API Selling Partner para Solicitações, que retorna uma lista de tipos de solicitação disponíveis para um pedido.
- A operação createProductReviewAndSellerFeedbackSolicitation , que envia uma solicitação a um comprador solicitando feedback e uma avaliação do produto para um pedido.
Consulte Solicitação do cliente para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Informações do parceiro de vendas | Visualize informações sobre a conta e o desempenho do Amazon Selling Partner. Geralmente usado para relatórios e operações usadas para retornar insights do vendedor(seller). Exemplos de operações que requerem esta atribuição da função:- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_V1_SELLER_PERFORMANCE_REPORT . Este relatório contém métricas de desempenho individuais do painel do Seller Central.
- A operação getMarketplaceParticipations da API Selling Partner para Vendedores, que retorna uma lista de marketplaces nos quais um vendedor(seller) pode vender e informações sobre a participação do vendedor(seller) nesses marketplaces.
Consulte Informações do parceiro de vendas para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Finanças e contabilidade | Produzir demonstrações contábeis e financeiras. Geralmente usado para criar demonstrações contábeis e financeiras. Exemplos de operações que requerem esta atribuição da função:- A operação getReports da API Selling Partner para Reports, quando usada para retornar uma lista dos relatórios GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE criados.
- A operação getSubscription da API Selling Partner para Notificações, quando usada para retornar informações sobre assinaturas para o tipo de notificação FEE_PROMOTION .
Consulte Finanças e Contabilidade para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Inventário e Rastreamento de Pedidos | Analisar e gerenciar estoque. Geralmente usado para relatórios de vendas FBA, relatórios de rastreamento de pedidos e operações relacionadas a pedidos, pedidos de fornecedores, métricas de pedidos de vendas e gerenciamento de estoque. As operações que exigem essa função não usam PII necessárias para enviar um pedido. Em vez disso, essa função é necessária para aplicativos que rastreiam remessas de pedidos para gerenciar estoque/fabricação/compras. Exemplos de operações que requerem esta atribuição da função:- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_MERCHANT_LISTINGS_DATA . Este relatório retorna listagens ativas detalhadas.
- A operação createFeed da API Selling Partner para Feeds quando usada para enviar um feed POST_FLAT_FILE_FULFILLMENT_DATA . Isso permite que você envie informações de atendimento de pedidos para a Amazon.
- A operação getOrderMetrics da API Selling Partners para Vendas, que retorna métricas agregadas de pedidos.
Consulte Inventário e rastreamento de pedidos para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Envio direto para o consumidor ( restrito ) | Envie pedidos diretamente aos clientes usando a transportadora de sua escolha, incluindo a Amazon. As operações que exigem essa função usam PII para permitir o envio. Geralmente usado para relatórios de pedidos, relatórios de rastreamento de pedidos, EasyShip e para operações relacionadas ao envio de pedidos feitos na Amazon. Operações de exemplo que requerem esta atribuição da função:- A operação getShipment da API Selling Partner para Merchant Fulfillment, que retorna informações de remessa para uma remessa específica.
- A operação getOrders da API Selling Partner para Orders, que retorna uma lista de pedidos e informações de pedidos com base nos critérios especificados.
- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_FLAT_FILE_ORDER_REPORT_DATA_SHIPPING .
- A operação createFeed da API Selling Partner para Feeds, quando usada para enviar um feed POST_ORDER_FULFILLMENT_DATA . Este feed permite que seu sistema atualize o sistema da Amazon com informações de atendimento de pedidos.
Consulte Envio direto para o consumidor (Restrito) para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Faturamento de impostos ( Restrito ) | Gere notas fiscais para cumprir a regulamentação tributária. As operações que exigem essa função exigem PII para permitir a geração de notas fiscais. Geralmente utilizado para Reports Fiscais e Reports de Pedidos, e operações que retornam informações sobre pedidos. Exemplos de operações que requerem esta atribuição da função:- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_AMAZON_FULFILLED_SHIPMENTS_INVOICING . Este relatório retorna informações detalhadas do pedido/remessa/item.
- A operação getOrderAddress da API Selling Partner para Orders, que retorna o endereço de entrega de um pedido.
- A operação getOrderBuyerInfo da API Selling Partner para Orders, que retorna informações do comprador para um pedido.
- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_EASYSHIP_DOCUMENTS . Este relatório contém a fatura, etiqueta de envio e documentos de garantia para um pedido Easy Ship.
Consulte Faturamento de impostos(Restrito) para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
| Imposto sobre remessas ( Restrito ) | Calcular e remeter impostos sobre vendas. As operações que exigem essa função podem usar PII para calcular impostos sobre vendas. Geralmente usado para relatórios de vendas e relatórios de pedidos da FBA e operações que retornam informações sobre pedidos. Exemplos de operações que requerem esta atribuição da função:- A operação createReport da API Selling Partner para Reports, quando usada para solicitar o relatório GET_AMAZON_FULFILLED_SHIPMENTS_REMITTANCE . Este relatório retorna informações detalhadas do pedido/remessa/item.
- A operação getOrderItems da API Selling Partner para Orders, que retorna informações detalhadas do item do pedido.
- A operação getOrders da API Selling Partner para Orders, que retorna uma lista de informações do item do pedido para um período de tempo e um intervalo de critérios.
Consulte Imposto sobre remessas(Restrito) para obter uma lista completa das operações e dos tipos de feed, report, e notification que exigem essa função. |
Você solicita e se qualifica para funções de API de parceiro de vendas preenchendo seu perfil de desenvolvedor. As informações específicas solicitadas dependem de você já ser um desenvolvedor do Amazon Marketplace Web Service (MWS) ou não e de já ter se registrado anteriormente.
Depois que seu perfil é enviado, a Amazon avalia as informações fornecidas e aprova ou nega sua solicitação. Se negado, você pode abordar o motivo da recusa e reenviar seu perfil.
Ao criar seu aplicativo de API de Parceiro de Vendas na página de criação do cliente do aplicativo, você pode escolher funções dentre aquelas que foram solicitadas e aprovadas em seu perfil de desenvolvedor. Se a função necessária estiver ausente, você deverá atualizar as funções em seu perfil de desenvolvedor para incluí-la e reenviar seu perfil para avaliação pela Amazon. Depois de aprovada, a função adicionada estará disponível para seleção para sua inscrição.
Nota: Se você tiver um aplicativo SP-API híbrido publicado, deverá listar novamente seu aplicativo antes da reautorização.
Revise as descrições da função neste documento para entender a finalidade de cada função e ver exemplos dos recursos e operações regidos por cada função. Para cada função, use o link fornecido para navegar até a documentação que fornece uma lista completa das operações e os tipos de feed, report, e notification que exigem a função.
A resposta à solicitação terá um código de status HTTP 403 e informações de erro no corpo da resposta.
Para adicionar uma nova função após a publicação do seu aplicativo, siga estas etapas:
- Vá para o seu perfil de desenvolvedor e envie uma função para ser adicionada.
- Depois que seu perfil de desenvolvedor for aprovado, vá para a configuração do seu aplicativo e aplique a função recém-aprovada ao seu aplicativo. Salve as alterações e liste novamente o aplicativo.
- Depois que o aplicativo for aprovado, obtenha novas autorizações para gerar um novo token de atualização que concederá acesso às operações da API , report, feeds e notifications que a nova função fornecerá.
