MadeiraMadeira é a maior loja online de móveis e decoração da América Latina com mais de 16 milhões de acessos por mês e 5 milhões de clientes atendidos no Brasil.
Este artigo orienta como configurar a integração com MadeiraMadeira. O primeiro passo é entrar em contato com o parceiro por meio do cadastro na MadeiraMadeira Marketplace. Após o cadastro, faça login no Portal MadeiraMadeira Marketplace.
Feito isso, dê continuidade às etapas da integração, que foram organizadas nas seguintes seções:
Configurações na plataforma VTEX
Para integrar com a MadeiraMadeira, é necessário realizar as seguintes etapas no seu Admin:
- Definir política comercial
- Definir Estratégia de Envio
- Criar coleção
- Criar permissões Access key e secret
- Criar perfil de acesso
- Criar afiliado
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 na MadeiraMadeira, 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 na MadeiraMadeira, 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 a MadeiraMadeira 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 na MadeiraMadeira é 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 a MadeiraMadeira, 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:
- Cadastrar Política de envio, associada à política comercial usada na integração.
- Cadastrar Doca, associada à política comercial usada na integração.
- Cadastrar Estoque, associado à Doca criada no passo anterior.
Criar coleção
A Coleção é um recurso de agrupamento de produtos e existem diferentes tipos de coleção. É comum utilizá-la para realizar ações comerciais temáticas ou selecionar produtos com critérios semelhantes. Se você já possui uma coleção configurada, você pode utilizá-la na integração com MadeiraMadeira, não é necessário criar outra.
Se você ainda não possui uma coleção, há duas formas de configurar uma. É possível criar uma coleção pelo módulo Coleções Beta ou fazer o Cadastro de Coleções CMS.
Com a coleção feita, você deverá adicionar os produtos que farão parte dela.
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 MadeiraMadeira. 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:
- No avatar do seu perfil, clique em CONFIGURAÇÕES DA CONTA.
- Clique em Conta.
- Em Segurança, clique em
Gerar access key e secret
. - Preencha com um nome para o novo access key.
- 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 a MadeiraMadeira 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:
- No avatar do seu perfil, clique em CONFIGURAÇÕES DA CONTA.
- Selecione a opção
Usuário
. - Clique no botão
Novo Usuário
. - Preencha o campo email com
vtexappkey-madeiramadeira-GFXVZH
- Selecione o perfil de acesso
IntegrationProfile - Fulfillment Oms
. - Clique em
Adicionar perfil de acesso
. - Clique em
Salvar
.
Se você não possui o perfil de acesso IntegrationProfile-Fulfillment_Oms, será necessário Criar o Perfil de acesso manualmente.
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 MadeiraMadeira, é preciso configurar um afiliado exclusivo. Para criar um novo ID do afiliado, siga os passos abaixo:
- Acesse o Admin.
- No menu Configurações da loja > Pedidos.
- Selecione a opção Configurações.
- Clique na aba de Afiliados.
- Agora, clique no botão
+ Novo Afiliado
. - Preencha os campos da tela, descritos abaixo, e em seguida clique em
Salvar
.
- Nome: designação do novo afiliado, a sugestão do parceiro é utilizar MadeiraMadeira.
- 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 MDM.
- 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 MadeiraMadeira.
- 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://iron-man.madeiramadeira.com.br/v1/vtex/produto/notificacao
- 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 MadeiraMadeira
Uma vez concluídas as configurações na plataforma VTEX, para dar continuidade à integração é necessário enviar alguns dados para a MadeiraMadeira. Essas informações devem ser encaminhadas para o Suporte da MadeiraMadeira ou para o seu gerente comercial.
- Account Name: é o 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.
- Sales Channel: código da política comercial cadastrada na VTEX na etapa Definir política comercial.
- ID do afiliado: código identificador do afiliado configurado na etapa Criar afiliado.
- E-mail do responsável pela integração: preencha com um email do responsável pela integração da sua loja com a MadeiraMadeira.
- Telefone do responsável pela integração: cadastre um telefone para contato. CNPJ da empresa: preencher com o CNPJ da sua loja.
Reindexar base dos produtos
Depois de concluir o preenchimento do formulário com as informações solicitadas, o suporte do MadeiraMaderia 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:
- Acesse a URL abaixo, substituindo {accountname} pelo nome da sua loja.
https://{AccountName}.myvtex.com/admin/Site/fullcleanup.aspx
- Clique no botão
Reindexar Base
.
Uma vez que você tenha concluído todas as etapas anteriores, sua loja será integrada na plataforma da MadeiraMadeira e a integração será concluída pelo parceiro.
Você também pode conferir as orientações para integração fornecidas pela MadeiraMadeira pela página Integração via VTEX - Início.