Funções na API do parceiro de vendas
Saiba como usar funções na API do parceiro de vendas.
O que é uma função?
Uma função é o mecanismo usado pelas APIs do parceiro de vendas 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 sob essa função. As funções protegem o acesso a informações de identificação pessoal (PII) e outros dados confidenciais, além de limitar o acesso aos dados para garantir que os desenvolvedores acessem somente 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 as APIs de parceiros de vendas.
Definições de função
Na tabela a seguir, restrito indica que a função requer dados confidenciais que podem incluir informações de identificação pessoal (PII). Nesse caso, será necessário fornecer informações adicionais sobre o uso desses dados e os controles de segurança adotados.
Função | Descrição |
---|---|
Análise de marca | Acesse relatórios que contêm informações sobre o desempenho do vendedor e do fornecedor 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. Exemplos de operações que exigem essa atribuição de função:
|
Oferta de produtos | Crie e gerencie ofertas de produtos. Geralmente usado para relatórios, feeds e operações relacionados ao catálogo de produtos. Exemplos de operações que exigem essa atribuição de função:
|
Preços | Determine os preços sugeridos e automatize os preços dos produtos. Geralmente usado para relatórios, feeds e operações relacionados a preços. Exemplos de operações que exigem essa atribuição de função:
|
Logística da Amazon | Envie para a Amazon e a Amazon envia diretamente aos clientes (Logística da Amazon (FBA), Rede logística da Amazon (AFN)). Geralmente usado para relatórios de vendas do Logística da Amazon, relatórios de rastreamento de pedidos e operações relacionadas à gestão da logística de pedidos. Exemplos de operações que exigem essa atribuição de função:
|
Comunicação com o comprador | Gerencie mensagens de e para compradores da Amazon. Geralmente usado para enviar mensagens aos compradores da Amazon usando a API do parceiro de vendas para Mensagens. Exemplos de operações que exigem essa atribuição de função:
|
Solicitação do comprador | Solicite feedback dos compradores da Amazon. Geralmente usado para solicitar feedback dos compradores da Amazon usando a API do parceiro de vendas para Solicitações. Exemplos de operações que exigem a atribuição dessa função:
|
Insights sobre parceiros de vendas | Veja informações sobre a conta e o desempenho do parceiro de vendas da Amazon. Geralmente usado para relatórios e operações para devolver informações do vendedor. Exemplos de operações que exigem a atribuição dessa função:
|
Finanças e contabilidade | Produza demonstrações contábeis e financeiras. Geralmente usado para criar demonstrações contábeis e financeiras. Exemplos de operações que exigem a atribuição dessa função:
|
Rastreamento de inventário e pedidos | Analise e gerencie o inventário. Geralmente usado para relatórios de vendas do Logística da Amazon, 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 as 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 exigem a atribuição dessa função:
|
Armazenamento e distribuição na Amazon | Analyze and manage Amazon Warehousing and Distribution shipments and inventory. Generally used for interacting with AWD inventory information and shipment details using the Selling Partner API for Amazon Warehousing and Distribution. Examples of operations that require this role assignment:
|
Notificações no Seller Central | Send targeted notifications to sellers within Seller Central. Using the App Integrations API v2024-04-01, you can send notifications that inform the seller about their business or to encourage the seller to take action on your website. Examples of operations that require this role assignment:
|
Provedor de serviços de iniciação de pagamentos | Permite o início de um pagamento no método de depósito do vendedor e a emissão de um reembolso (ajuste) para um pedido. Você pode usar a função de Provedor de Serviços de Iniciação de Pagamento (PISP) para visualizar as formas de pagamento do vendedor. Para obter uma lista completa das operações e dos tipos de feed, relatório e notificação que exigem essa função, consulte Provedor de serviços de iniciação de pagamentos. Para obter informações sobre o registro de desenvolvedores de fornecedores terceirizados, consulte Registro de fornecedor terceiri. |
Provedor de serviços de informações de contas | Fornece informações sobre a conta do Parceiro de Vendas da Amazon, incluindo informações sobre a empresa do vendedor e os mercados em que a conta do vendedor está ativa. Você pode usar a função de provedor de serviços de informações da conta (AISP) para visualizar formas de pagamento e eventos financeiros para o vendedor. Para obter uma lista completa das operações e dos tipos de feed, relatório e notificação que exigem essa função, consulte Provedor de serviços de informações de contas. Para obter informações sobre o registro de desenvolvedores de fornecedores terceirizados, consulte Registro de fornecedor terceiri. |
Envio direto ao 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. Exemplos de operações que exigem a atribuição dessa função:
|
Faturamento fiscal (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 usado para relatórios fiscais e relatórios de pedidos e operações que retornam informações sobre pedidos. Exemplos de operações que exigem a atribuição dessa função:
|
Remessa fiscal (restrito) | Calculate and remit sales taxes. Operations that require this role might use PII to calculate sales taxes.
Generally used for FBA Sales Reports and Order Reports and operations that return information about
orders.
Examples of operations that require this role assignment:
|
Serviços profissionais (restrito) | Provides add-on services such as Room of Choice Delivery, Assembly and Installation to Amazon buyers. Generally used to provide add-on services to Amazon buyers using the Selling Partner API for Services. Examples of operations that require this role assignment:
|
Perguntas frequentes
Como faço para solicitar e me qualificar para uma função?
Você solicita e se qualifica para funções na API do parceiro de vendas preenchendo seu perfil de desenvolvedor. As informações específicas solicitadas dependem de você ter se cadastrado anteriormente.
Após o envio do seu perfil, a Amazon avalia as informações fornecidas e aprova ou recusa sua solicitação. Se a solicitação for recusada, você poderá resolver o motivo da recusa e reenviar seu perfil.
Como escolho as funções para meu aplicativo?
Ao criar seu aplicativo da API do parceiro de vendas na página de criação do cliente do aplicativo, você pode escolher funções dentre as que foram solicitadas e aprovadas em seu perfil de desenvolvedor. Se a função necessária estiver ausente, será necessário atualizar seu perfil de desenvolvedor para incluí-la e reenviar seu perfil para avaliação da Amazon. Após a aprovação, a função adicionada estará disponível para seleção no seu aplicativo.
Observação: se você tiver um aplicativo híbrido da SP-API publicado, deverá colocar novamente seu aplicativo em oferta antes da reautorização.
Como determino quais funções solicitar?
Analise as descrições das funções neste documento para entender a finalidade de cada uma e veja exemplos dos recursos e operações regidas por cada função. Para cada função, use o link fornecido para acessar a documentação com uma lista completa das operações e dos tipos de feed, relatório e notificação que exigem a função.
O que acontece quando eu chamo uma operação para a qual não tenho as funções necessárias?
A resposta à solicitação terá um código de status HTTP 403 e informações de erro no corpo da resposta.
Como adiciono uma nova função após a publicação do meu aplicativo?
Para adicionar uma nova função após a publicação do seu aplicativo, siga estas etapas:
- Acesse seu perfil de desenvolvedor e envie uma função para ser adicionada.
- Quando seu perfil do desenvolvedor for aprovado, acesse a configuração do seu aplicativo e aplique a função recém-aprovada ao aplicativo. Em seguida, salve as alterações e publique novamente o aplicativo.
- Depois que a inscrição for aprovada, obtenha novas autorizações para gerar um novo token de atualização que concederá acesso às operações, relatórios, feeds e notificações da API fornecida pela nova função.
Updated 27 days ago