{"section":"tutorials","requestedLocale":"pt","requestedSlug":"integracao-com-madeiramadeira","locale":"pt","slug":"integracao-com-madeiramadeira","path":"docs/pt/tutorials/integrações/configurações-de-integrações/integracao-com-madeiramadeira.md","branch":"main","content":"[MadeiraMadeira](https://www.madeiramadeira.com.br/) é 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.\n\nEste 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](https://www.madeiramadeira.com.br/marketplace). Após o cadastro, faça login no [Portal MadeiraMadeira Marketplace](https://painelmarketplace.madeiramadeira.com.br/).\n\nFeito isso, dê continuidade às etapas da integração, que foram organizadas nas seguintes seções:\n\n- [Configurações na plataforma VTEX](#configuracoes-na-plataforma-vtex)\n- [Envio de informações para MadeiraMadeira](#envio-de-informacoes-para-madeiramadeira)\n\n## Configurações na plataforma VTEX\n\nPara integrar com a MadeiraMadeira, é necessário realizar as seguintes etapas no seu Admin:\n\n- [Definir política comercial](#definir-a-politica-comercial)\n- [Definir Estratégia de Envio](#definir-a-estrategia-de-envio)\n- [Criar coleção](#criar-colecao)\n- [Criar permissões Access key e secret](#criar-permissao-para-access-key-e-secret)\n- [Criar perfil de acesso](#criar-perfil-de-acesso)\n- [Criar afiliado](#criar-afiliado)\n\n### Definir a política comercial\n\nA [política comercial](/pt/docs/tutorials/como-funciona-uma-politica-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](/pt/docs/tutorials/criar-uma-politica-comercial) nova, pois uma mesma política comercial pode ser usada para diferentes canais de venda.\n\nCaso seja do seu interesse ter configurações específicas para vender na MadeiraMadeira, você pode [configurar uma política comercial para marketplace](/pt/docs/tutorials/configurando-a-politica-comercial-para-marketplace/).\n\nA [contratação de políticas comerciais adicionais](/pt/docs/tutorials/contratacao-de-politica-comercial-adicional) 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](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex).\n\n> ⚠️ Os produtos que você deseja enviar para a MadeiraMadeira devem estar [associados à política comercial](/pt/docs/tutorials/associacao-de-sku-a-politica-comercial) definida. Caso contrário, eles não serão integrados.\n\n### Definir a Estratégia de Envio\n\nPara 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](/pt/docs/tutorials/politica-de-envio), [Estoque](/pt/docs/tutorials/estoque) e [Doca](/pt/tracks/logistica-101--13TFDwDttPl9ki9OXQhyjx/4Rr5XpzAzUPv2Eo9Mh7cEj?&utm_source=autocomplete).\n\nÉ por meio da Doca que a Política de envio ([transportadora](/pt/docs/tutorials/transportadoras-na-vtex)) é 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.\n\nSe 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:\n\n1. [Cadastrar Política de envio](/pt/docs/tutorials/politica-de-envio#cadastrar-uma-politica-de-envio), associada à política comercial usada na integração.\n2. [Cadastrar Doca](/pt/docs/tutorials/gerenciar-doca), associada à política comercial usada na integração.\n3. [Cadastrar Estoque](/pt/docs/tutorials/gerenciar-estoque), associado à Doca criada no passo anterior.\n\n### Criar coleção\n\nA Coleção é um recurso de agrupamento de produtos e existem diferentes [tipos de coleção](/pt/docs/tutorials/tipos-de-colecao). É 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.\n\nSe 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](/pt/docs/tutorials/cadastrar-colecoes-beta) ou fazer o [Cadastro de Coleções CMS](/pt/docs/tutorials/cadastro-de-colecoes-cms).\n\nCom a coleção feita, você deverá [adicionar os produtos](/pt/docs/tutorials/cadastrar-colecoes-beta#selecao-de-produtos) que farão parte dela.\n\n### Criar permissão para Access key e secret\n\nA 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)](/pt/tracks/contas-e-permissoes--5PxyAgZrtiYlaYZBTlhJ2A/56Bd0KpwbvAji1aFs94xdA?&utm_source=autocomplete) tem permissão para criar um [_access key e secret_](/pt/docs/tutorials/chaves-de-api), e a opção só é visível no Admin para este usuário. \n\nPara configurar uma nova chave, siga os passos abaixo:\n\n1. No avatar do seu perfil, clique em  *CONFIGURAÇÕES DA CONTA*.\n2. Clique em **Conta**.\n3. Em *Segurança*, clique em `Gerar access key e secret`.\n4. Preencha com um nome para o novo access key.\n5. Clique em `Gerar novos secrets`.\n\n> ⚠️ 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.\n\n### Criar perfil de acesso \n\nO próximo é criar um [perfil de acesso](/pt/tutorial/perfis-de-acesso--7HKK5Uau2H6wxE1rH5oRbc?&utm_source=autocomplete) 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:\n\n1. No avatar do seu perfil, clique em *CONFIGURAÇÕES DA CONTA*.\n2. Selecione a opção `Usuário`.\n3. Clique no botão `Novo Usuário`.\n4. Preencha o campo __email__ com `vtexappkey-madeiramadeira-GFXVZH`\n5. Selecione o perfil de acesso `IntegrationProfile - Fulfillment Oms`.\n6. Clique em `Adicionar perfil de acesso`.\n7. Clique em `Salvar`.\n\n> Se você não possui o perfil de acesso [IntegrationProfile-Fulfillment_Oms](/pt/docs/tutorials/perfis-de-acesso-predefinidos#integrationprofile-fulfillment-oms), será necessário [Criar o Perfil de acesso](/pt/docs/tutorials/perfis-de-acesso#criando-um-perfil-de-acesso) manualmente.\n\n### Criar afiliado\n\nO [afiliado](/pt/docs/tutorials/o-que-e-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](/pt/docs/tutorials/como-configurar-afiliado). Para criar um novo ID do afiliado, siga os passos abaixo:\n\n1. Acesse o Admin.\n2. No menu *Configurações da loja > Pedidos*.\n3. Selecione a opção **Configurações**.\n4. Clique na aba de **Afiliados**.\n5. Agora, clique no botão `+ Novo Afiliado`.\n6. Preencha os campos da tela, descritos abaixo, e em seguida clique em `Salvar`.\n\n- **Nome:** designação do novo afiliado, a sugestão do parceiro é utilizar MadeiraMadeira.\n- **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.\n- **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.\n- **E-mail de follow-up:** endereço eletrônico que receberá notificações sobre a integração.\n- **Endpoint Search:** URL da aplicação que receberá notificações de produtos, preço, estoque, dentre outras. Utilize  \n\n`https://iron-man.madeiramadeira.com.br/v1/vtex/produto/notificacao`\n\n- **Versão do Endpoint Search:** Já preenchido com 1.x.x.\n- **Usar meio de pagamento:** Deixar desmarcado porque ainda não é suportado para integrações com [Marketplace certificado](/pt/tutorial/estrategias-de-marketplace-na-vtex--tutorials_402?&utm_source=autocomplete#integrado-a-conector-certificado-parceiro).\n\n## Envio de informações para MadeiraMadeira\n\nUma 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](https://madeiramadeira.zendesk.com/hc/pt-br/requests/new) ou para o seu gerente comercial.\n\n- **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*.\n- **Sales Channel:** código da política comercial cadastrada na VTEX na etapa [Definir política comercial](#definir-a-politica-comercial).\n- **ID do afiliado:** código identificador do afiliado configurado na etapa [Criar afiliado](#criar-afiliado).\n- **E-mail do responsável pela integração:** preencha com um email do responsável pela integração da sua loja com a MadeiraMadeira.\n- **Telefone do responsável pela integração:** cadastre um telefone para contato.\nCNPJ da empresa: preencher com o CNPJ da sua loja.\n\n### Reindexar base dos produtos\n\nDepois 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](/pt/docs/tutorials/manutencao-de-base-full-cleanup) dos produtos. Entretanto, somente usuários Master conseguem realizar essa etapa. Para reindexar, siga os passos a seguir: \n\n1. Acesse a URL abaixo, substituindo *\\{accountname\\}* pelo nome da sua loja.\n\n  `https://{AccountName}.myvtex.com/admin/Site/fullcleanup.aspx`\n\n2. Clique no botão `Reindexar Base`.\n\nUma 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.\n\n> ℹ️ Você também pode conferir as orientações para integração fornecidas pela MadeiraMadeira pela página [Integração via VTEX - Início](https://madeiramadeira.zendesk.com/hc/pt-br/articles/360016223591-Integra%C3%A7%C3%A3o-via-Vtex-In%C3%ADcio)."}