Menu
Feedback
Comece aqui
Tutoriais


Tutoriais
Configurações de integrações
Integração com a AMARO
5 min de leitura

Fundada em 2012, a AMARO é uma marca brasileira de varejo digital especializada em moda feminina. Desde 2020, a empresa atua como marketplace por meio de uma curadoria de marcas da própria empresa.

{"base64":"  ","img":{"width":1050,"height":300,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":18585,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/integra%C3%A7%C3%B5es/configura%C3%A7%C3%B5es-de-integra%C3%A7%C3%B5es/integracao-com-a-amaro_1.png"}}

A Amaro é agora conector certificado, disponível para parceria com clientes VTEX. Este guia orienta o seller a configurar a integração, sendo parte do processo no Admin VTEX e parte da AMARO. Para isso, as etapas são as seguintes:

  • Configurações de conta na AMARO
  • Configurações no Admin VTEX
  • Envio de informações para AMARO

Configurações de conta na AMARO

Para vender seus produtos na AMARO, o seller deve cumprir os seguintes pré-requisitos:

  • Ter uma empresa legalmente constituída.
  • Ter todos os funcionários registrados.
  • Ter capacidade produtiva interna ou por meio de contratação de terceiros identificados.
  • Atender aos requisitos do Código de Conduta da AMARO.

Cumprindo os requisitos citados, o seller deverá entrar em contato com o time de Marcas Parcerias AMARO cadastrando-se no formulário, ou através do email sellers@amaro.com. Com isso, os departamentos de Marcas Parceiras e Compliance avaliarão a solicitação.

Uma vez aprovada a parceria, o time AMARO disponibilizará a URL do Seller Center AMARO.

Configurações no Admin VTEX

No Admin VTEX, é necessário realizar as seguintes etapas:

  • Definir política comercial
  • Criar novo AppKey e AppToken
  • Criar ID do afiliado

Definir política comercial

A política comercial é o que determina o sortimento de produtos, preços e estratégia de envio da sua loja VTEX em um canal de venda. Para vender na AMARO, o seller deverá configurar uma política comercial para marketplace com um sortimento inicial de produtos, contendo o mínimo de cinco itens com fotografia, preços e estoque disponíveis. Não existe cobrança para a contratação de políticas comerciais adicionais para integrar sua loja VTEX com conectores nativos, conectores certificados, tais como a AMARO, ou outras lojas VTEX.

Criar novo AppKey e AppToken

A chave de integração, chamada de AppKey, é o que possibilita o fluxo de envio e atualização de informações entre sua loja VTEX e a AMARO. Somente o usuário Titular da conta (owner) tem permissão para criar um AppKey e AppToken, e a opção só é visível no Admin VTEX para este usuário.

Para configurar uma nova chave, siga os passos abaixo:

  1. No Admin VTEX, em Configurações da conta, clique em Chaves de aplicação.
  2. Clique em Gerenciar minhas chaves.
  3. Clique em Gerar chave.
  4. Preencha o campo Rótulo com um nome para o novo AppKey.
  5. Clique em Adicionar perfis e selecione os perfis desejados.
  6. Clique em Gerar.

O AppToken, só aparece para o usuário esta única vez, não é possível recuperar a informação pelo sistema posteriormente. Portanto, tenha a certeza de guardá-lo em local seguro.

Criar ID do afiliado

O afiliado é o identificador de um seller VTEX em um marketplace, sendo necessário que o seller tenha um ID do afiliado diferente para cada marketplace onde venda seus produtos. Isso significa que, para integrar com a AMARO, é preciso configurar um afiliado exclusivo.

Para criar um novo ID do afiliado, siga os passos abaixo:

  1. No Admin VTEX, acesse Configurações da loja > Pedidos > Configurações, ou digite Pedidos na barra de busca no topo da página e selecione Configurações da loja / Pedidos.
  2. Na aba Afiliados, clique em +Novo afiliado.
  3. Preencha os campos da tela, descritos abaixo, e em seguida clique em Salvar.
  • Nome: designação do novo afiliado.
  • ID: código identificador do afiliado, deve ser composto de três consoantes, sejam elas repetidas ou não. Vogais não são aceitas. A sugestão é usar MRR para a AMARO.
    -Política Comercial: número da política comercial que definirá o sortimento de catálogo, preço e estratégia de envio dos itens utilizados na integração com a AMARO.
  • E-mail de Follow Up: endereço eletrônico que receberá notificações sobre a integração.
  • Endpoint de Search: URL da aplicação que receberá notificações de produtos, preço, estoque, dentre outras. O seller será informado sobre este dado pela AMARO.
  • Versão do Endpoint de Search: só existe a opção padrão 1.x.x. Deixe desmarcada a flag Usar meu meio de pagamento.

Envio de informações para AMARO

Uma vez concluídas as configurações na plataforma VTEX, para dar continuidade à integração é necessário enviar os dados de Informações do Admin VTEX para a AMARO. O contato para onde essas informações devem ser enviadas é fornecido pelos próprios parceiros.

Informações do Admin VTEX

Alguns dos dados a serem enviados são encontrados no seu Admin VTEX, são eles:

-Nome da conta: identificador da sua empresa no sistema da VTEX. Para encontrá-lo, acesse o Admin VTEX em Configurações da conta > Conta > Geral. -Dados de autenticação do sistema: appToken e appKey definidos na etapa Criar novo AppKey e AppToken. -ID do afiliado: identificador configurado na etapa Criar ID do afiliado. - Política comercial: número da política comercial determinada na etapa Definir política comercial. -ID do Seller: o valor a ser informado é o número 1. Para encontrá-lo, acesse o Admin no módulo Marketplace > Sellers > Gerenciamento > ID do Seller.

Uma vez que o seller tenha reunido esses dados, deverá enviá-los para o contato informado pelo time de Marcas Parceiras da AMARO. Desta forma,a integração será concluída pelo marketplace.

Após a primeira conexão com o seller center AMARO e verificação inicial do sucesso da integração, o time de Marcas Parceiras AMARO irá orientar o seller a adicionar os demais produtos na política comercial para a etapa final de curadoria e exibição dos itens no amaro.com e aplicativos AMARO.

Contribuidores
1
Photo of the contributor
+ 1 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Página de status da VTEX
« Anterior
Amazon Listing
Próximo »
Contribuidores
1
Photo of the contributor
+ 1 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na VTEX Community
Junte-se à nossa comunidade
Solicite suporte à VTEX
Receba assistência personalizada com nossos especialistas
Abra um ticket de suporte
GitHubDeveloper PortalComunidadeFeedback