Menu
Feedback
Comece aqui
Tutoriais
Portal do desenvolvedor

Problemas conhecidos
Diretivas de suporte
Troubleshooting

Perguntas frequentes
Comunicados
Tutoriais
Tutoriais
Explore tutoriais detalhados para operar sua loja VTEX.
Tutoriais
Integrações
Configurações de integrações
Integração com Enjoei
Integração com Enjoei
6 min de leitura

O Enjoei é uma plataforma de e-commerce que funciona como um comércio de consumo colaborativo que conta com mais de 7,5 milhões de usuários cadastrados. Os produtos mais vendidos na plataforma são vestidos, calças e blusas.

Este artigo orienta como configurar a integração com o Enjoei. O primeiro passo é entrar em contato com o parceiro por meio do cadastro no Enjoei Marketplace, você poderá escolher entre duas opções de usuário no Enjoei:

Feito isso, dê continuidade às etapas da integração, que foram organizadas nas seguintes seções:

Configurações na plataforma VTEX

Para integrar com o Enjoei, é necessário realizar as seguintes etapas no seu Admin:

Definir a 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. Se você deseja que as mesmas configurações da sua loja sejam utilizadas para seus produtos no Enjoei, não é necessário criar uma política comercial nova, pois uma mesma política comercial pode ser usada para diferentes canais de venda.

Caso seja do seu interesse ter configurações específicas para vender no Enjoei, você pode configurar uma política comercial para marketplace.

A contratação de políticas comerciais adicionais para integrar com conectores certificados, certificados nativos ou outras lojas VTEX é isenta de taxas. Saiba mais sobre quem são esses parceiros em Estratégias de marketplace na VTEX.

Os produtos que você deseja enviar para o Enjoei devem estar associados à política comercial definida. Caso contrário, eles não serão integrados.

Definir a Estratégia de Envio

Para vender seus produtos no Enjoei é preciso determinar uma Estratégia de Envio, ou seja, informar qual será a logística de entrega dos seus produtos. A Estratégia de Envio é composta de três etapas logísticas: Política de Envio, Estoque e Doca.

É por meio da Doca que a Política de envio (transportadora) é associada ao Estoque da sua loja. A doca é o ponto intermediário entre a transportadora e o armazenamento da sua loja, e por meio dela, as condições entre envio e armazenagem são feitas.

Se for do seu interesse utilizar a mesma Estratégia de Envio definida para sua loja VTEX na integração com o Enjoei, não é necessário criar novas configurações de logística. Se, no entanto, você deseja criar uma Estratégia de Envio específica para o marketplace, é necessário realizar os seguintes passos:

  1. Cadastrar Política de envio, associada à política comercial usada na integração.
  2. Cadastrar Doca, associada à política comercial usada na integração.
  3. Cadastrar Estoque, associado à Doca criada no passo anterior.

Criar permissão para Access key e secret

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

Para configurar uma nova chave, siga os passos abaixo:

  1. No seu avatar de perfil, acesse CONFIGURAÇÕES DA CONTA.
  2. Clique em Conta.
  3. Em Segurança, clique em Gerar access key e secret.
  4. Preencha com um nome para o novo access key.
  5. Clique em Gerar novos secrets.

O secret gerado, também chamado de 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 perfil de acesso

O próximo é criar um perfil de acesso para o Enjoei na plataforma VTEX. Os perfis de acesso são autorizações concedidas a usuários para utilizarem os recursos da plataforma VTEX. Para criar um perfil de acesso, siga os passos a seguir:

  1. No avatar de seu perfil > CONFIGURAÇÕES DA CONTA.
  2. Selecione a opção Usuário.
  3. Clique no botão Novo.
  4. Preencha os campos da seguinte forma:
    • Email: preencha com o código do Access key obtido na etapa anterior.
    • Nome Completo: preencha com o nome do responsável pela conta.
  5. Selecione o perfil de acesso IntegrationProfile - Fulfillment Oms.
  6. Clique em Adicionar perfil de acesso.
  7. Clique em Salvar.

Criar afiliado

O afiliado é o identificador de uma loja 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 Enjoei, é preciso configurar um afiliado exclusivo. Para criar um novo ID do afiliado, siga os passos abaixo:

  1. Acesse o Admin.
  2. No menu configurações da loja > Pedidos.
  3. Selecione a opção Configurações.
  4. Clique na aba de Afiliados.
  5. Agora, clique no botão + Novo Afiliado.
  6. Preencha os campos da tela, descritos abaixo, e em seguida clique em Salvar.
  • Nome: nome que deseja dar ao afiliado, sugerimos nomeá-lo como Enjoei.
  • 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 NJD.
  • 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 Enjoei.
  • E-mail de follow-up: endereço eletrônico que receberá notificações sobre a integração.
  • Endpoint Search: URL da aplicação que receberá notificações de produtos, preço, estoque, dentre outras. Utilize

https://api.enjoei.com.br/vtex/webhook

  • Versão do Endpoint Search: Já preenchido com 1.x.x.
  • Usar meio de pagamento: Deixar desmarcado porque ainda não é suportado para integrações com Marketplace certificado.

Envio de informações para o Enjoei

Uma vez concluídas as configurações na plataforma VTEX, para dar continuidade à integração é necessário enviar alguns dados para o Enjoei, dividido em duas etapas:

Ativar a integração no Enjoei

Você deve enviar os seguintes dados para o Enjoei por meio do seguinte formulário. Todas as informações solicitadas no formulário devem ser preenchidas corretamente e revisadas antes do envio para evitar problemas fiscais, de repasse financeiro, ou no SLA de integração com a VTEX. São elas:

  • Nome da conta: identificador da sua empresa no sistema da VTEX. Para encontrá-lo, acesse o Admin no módulo CONFIGURAÇÕES DA CONTA > Gerenciamento da conta > Conta > Dados da empresa.
  • Dados de autenticação do sistema: token e appKey definidos na etapa Criar novo access key e secret.
  • 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: se você estiver integrando a partir da sua conta principal, o valor a ser informado é o número 1. Caso sua loja possua contas franquia e você esteja realizando a integração a partir de uma delas, é necessário enviar o ID do Seller dessa conta. Para encontrá-lo, acesse o Admin no módulo MARKETPLACE > Sellers > Gerenciamento > ID do Seller.
  • Atributos do produto: nomes dos atributos Cor e Tamanho como estão cadastrados na VTEX. Para encontrá-lo, acesse o Admin no módulo PRODUTO > Catálogo > Categorias. Selecione a categoria do produto, acesse Ações > Campo do produto.

Reindexar base dos produtos

Depois de concluir o preenchimento do formulário com as informações solicitadas, o suporte do Enjoei enviará um e-mail solicitando a reindexação da base dos produtos. Entretanto, somente usuários Master conseguem realizar essa etapa. Para reindexar, siga os passos a seguir:

  1. Acesse a URL abaixo, substituindo {accountname} pelo nome da sua loja.

https://{AccountName}.myvtex.com/admin/Site/fullcleanup.aspx

  1. Clique no botão Reindexar Base.

Uma vez que você tenha concluído todas as etapas anteriores, sua loja será integrada na plataforma do Enjoei e a integração será concluída pelo parceiro.

Você também pode conferir as orientações para integração fornecidas pelo Enjoei na documentação Configuração VTEX.

Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na comunidade VTEX.
Junte-se à nossa comunidade
Solicite suporte à VTEX
Para assistência personalizada, entre em contato com nossos especialistas.
Abra um ticket de suporte
GithubDeveloper portalComunidadeFeedback