Como integrar com a Vtex

Para integrar a sua conta olist com a ferramenta Vtex, siga os passos abaixo.
*ainda não é possível fazer diretamente no olist.

1- Como a Vtex ainda não possibilita uma tela para preenchimento dos dados para iniciar a integração, acesse o link abaixo:

https://integration-vtex.olist.com/

2- Clique em iniciar integração e você será direcionado para outra página onde será necessário configurar algumas informações:

3- O formulário abaixo necessita ser preenchido com os detalhamentos a seguir de como obter cada um dos dados nos próximos passos:

3.1- account name: é o nome da sua conta configurada na Vtex e pode ser obtida visualizando a página inicial na Vtex conforme a imagem:

3.2- Uma vez preenchido o account name, você precisa preencher o campo affiliate id.

Para isso, vá até aba Pedidos > Configurações > Clique no campo de afiliados:

Como ainda não possui nenhum afiliado integrado com o olist, é preciso que clicar em "novo afiliado" e preencher os campos solicitados pela Vtex.

• Nome: identificação do afiliado e recomendamos colocar olist ou algo similar;
• ID: 3 letras que precisam ser adicionadas para identificar o afiliado criado;
• Política Comercial: é necessário ter uma política comercial já criada e adicionar o número da mesma (para consultar na Vtex é só entrar no menu esquerdo em Configurações da Loja > Políticas Comerciais). Importante: caso deseje uma política comercial específica para o olist, você deverá solicitar com a Vtex a criação dessa política e configurar a mesma em seguida no seu painel na Vtex;
• E-mail de Follow-up: informação de contato necessária para a Vtex;
• Endpoint de Search: preencher com esse link https://integration-vtex.olist.com/webhook/
• Versão do Endpoint de Search: não é necessário configurar/editar.
• Usar meu meio de pagamento: não colocar o "check" no campo, deixar vazio.

Por fim, só clique em "salvar"e o novo afiliado será criado. Assim, o campo azul do lado do nome do afiliado criado estará disponível e você precisa inserir essa informação na área do Afilliate ID no formulário para se integrar com o olist.

3.3- Para preenchimento do "trade policy id", vá em Configurações da loja > Políticas Comerciais. Copie o número da política comercial a partir do campo id da segunda coluna conforme consta na imagem abaixo e preencha o formulário da autenticação.

Importante: é necessário ter uma política comercial já criada e caso deseje uma política comercial específica para o olist, você deverá solicitar com a Vtex a criação dessa política e configurar a mesma em seguida no seu painel na Vtex;

Até o momento o formulário para se integrar estará da seguinte forma: 

3.4- Agora é o momento de preencher o "app key". Para acessar essa informação vá em Configurações da conta > Gerenciamento da conta - Conta.

Clique em "gerar access key e secret"(somente a conta criadora da loja na Vtex vai ter acesso a esse campo de geração desses dados).

Após ter clicado no botão "gerar access key e secret", escolha um nome conforme consta na imagem abaixo:

Após clicar em "gerar novos secrets", aparecerá o App token e você deverá colocá-lo no formulário da integração.

Importante: essa informação não é gerada novamente pela Vtex. Salve em um lugar seguro e de fácil acesso.

3.5- Por fim, conforme consta na imagem abaixo, você visualizará o App key gerado do lado do nome configurado, cole os dados no formulário da integração.

Sempre deixe o status do token ativo com o "check" selecionado.

4- Após criar o usuário administrativo (appkey e apptoken), é possível criar um perfil de acesso específico para acesso olist

4.1- Vá em Gerenciamento da conta > Perfis de acesso > Novo Perfil e crie um perfil com as seguintes permissões:

• Recurso: Catalog

• Permissões:

  • Content > SKUs

• Recurso: License Manager

• Permissões:

  • Services Access Control > Get account by identifier

• Recurso: Checkout

• Permissões:

  • CheckoutResources > Shopping Cart Full Access

• Recurso: OMS

• Permissões:

  • AcessoOMS > Notify Invoice

  • AcessoOMS > View Order

Após clicar em Salvar, você verá a imagem similar a esta:

4.2- Agora você precisa adicionar o perfil de acesso ao usuário que acabou de criar:
Vá para Gerenciamento da conta > Usuários e selecione o seu usuário.
Depois, clique em "+ adicionar perfis" e adicione o perfil criado ao usuário. Pressione "salvar".

4.3- Em seguida, será necessário adicionar o perfil criado ao App Key:

Vá para Gerenciamento da conta > Chaves de aplicação. Clique em "adicionar", e insira seu App Key no campo "chave", adicione o perfil criado.

Clique em salvar.

5- Uma vez preenchida todas as informações no formulário da integração, clique em autorizar integração. 

6- Caso esteja tudo certo, aparecerá a tela abaixo para que você informe o login e senha da sua conta no olist. 

7- Informações preenchidas com sucesso, a mensagem abaixo que a integração foi autenticada irá aparecer e você poderá começar a exportar seus produtos da Vtex para o olist seguindo o passo a passo que explicamos aqui.