Funções na Selling Partner API
Como as funções são usadas na Selling Partner API
Funções na Selling Partner API
O que é uma função?
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.
Definições de Funções
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
Perguntas frequentes
Como solicito e me qualifico para uma 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.
Como escolho as funções para meu aplicativo?
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.
Como determino quais funções solicitar?
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.
O que acontece quando chamo uma operação para a qual não tenho as funções necessários?
A resposta à solicitação terá um código de status HTTP 403 e informações de erro no corpo da resposta.
Como adiciono um 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:
- 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á.
Updated about 1 year ago