{"section":"tutorials","requestedLocale":"pt","requestedSlug":"integracao-com-o-kabum","locale":"pt","slug":"integracao-com-o-kabum","path":"docs/pt/tutorials/integrações/visão-geral-de-integrações/integracao-com-o-kabum.md","branch":"main","content":"O [KaBuM!](https://www.kabum.com.br/) é o maior ecommerce do segmento de tecnologia na América Latina e faz parte do grupo Magazine Luiza. \n\nPor meio da integração da Plataforma VTEX com o KaBuM!, você pode aumentar a visibilidade dos seus produtos e alavancar suas vendas. São mais de 20 mil produtos no catálogo do marketplace e 8 milhões de usuários cadastrados.\n\nEste artigo orienta como configurar a integração com o Kabum!. Dividimos esse artigo em 3 etapas:\n\n1. [Cadastro na plataforma do KaBuM!](#cadastro-na-plataforma-do-kabum)\n2. [Configurações na plataforma VTEX](#configuracoes-na-plataforma-vtex)\n3. [Envio de informações para o KaBuM!](#envio-de-informacoes-para-o-kabum)\n\n## Cadastro na plataforma do KaBuM!\n\nPara integrar a sua loja VTEX com o KaBuM!, antes é necessário ter um cadastro ativo como seller do KaBuM!. Caso não possua, realize  o cadastro no [formulário de interesse](https://docs.google.com/forms/d/17AkLuoggIdNQX-9nWPzYO2fsP7usWehQCnS53CDIK9s/edit). \n\nEm seguida, o time Kabum entrará em contato para tratativas comerciais podendo, eventualmente, levar à contratação e criação da conta. Caso queira mais informações sobre o marketplace, acesse o [Portal para parceiros](https://kabum.com.br/hotsite/sejaparceiro-off/).\n\nFeito isso, você pode dar continuidade às etapas da integração.\n\n## Configurações na plataforma VTEX\n\nPara integrar a sua loja VTEX com o KaBuM!, é necessário realizar as seguintes etapas:\n\n1. [Definir política comercial](#definir-politica-comercial-opcional)\n2. [Criar nova chave de acesso e segredo](#criar-nova-chave-de-acesso-e-segredo)\n3. [Criar afiliado](#criar-afiliado)\n\n### Definir política comercial (opcional)\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 no KaBuM!, não é necessário [criar uma política comercial nova](/pt/docs/tutorials/criar-uma-politica-comercial), 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 no KaBuM!, você pode [configurar uma política comercial para marketplace](/pt/docs/tutorials/configurando-a-politica-comercial-para-marketplace). Não existe cobrança para a contratação de políticas comerciais adicionais para integrar sua loja VTEX com [conectores nativos ou conectores certificados](/pt/docs/tutorials/estrategias-de-marketplace-na-vtex#integrado-a-conector-nativo-vtex).\n\n### Criar nova chave de acesso e segredo\n\nA chave de integração, chamada de chave de acesso, é o que possibilita o fluxo de envio e atualização de informações entre sua loja VTEX e o KaBuM!.\n\nPara configurar uma nova chave, siga os passos abaixo:\n\n1. No Admin VTEX, no módulo *CONFIGURAÇÕES DA CONTA*, clique em **Gerenciamento da conta**.\n2. Clique em **Conta**.\n3. Em Segurança, clique em `Gerar chave de acesso e segredo`.\n4. Preencha com um nome para o novo par de chave de acesso e segredo. \n5. Clique em `Gerar novo segredo`.\n\nAguarde a chave porque ela será utilizada na etapa [Envio de informações para o KaBuM!](#envio-de-informacoes-para-o-kabum)\n\n> ⚠️ A chave de acesso gerada 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 um local seguro.\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 o KaBuM!, é preciso [configurar um afiliado](/pt/docs/tutorials/como-configurar-afiliado) exclusivo. Para criar um novo afiliado, siga os passos abaixo:\n\n1. No Admin VTEX, no módulo *PEDIDOS*, clique em **Gerenciamento de pedidos**.\n2. Clique em **Configurações**.\n3. No topo da página, selecione a opção **Afiliados**.\n4. Clique em `+ Novo afiliado`.\n5. Preencha os campos da tela, descritos abaixo:\n   * **Nome:** designação do novo afiliado.\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 para integrar com o KaBuM! é usar `KBM`.\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 o KaBuM!.\n   * **E-mail de Follow Up:** endereço eletrônico que receberá notificações sobre a integração.\n   * **Endpoint de Search:** URL da aplicação que receberá notificações de produtos, preço, estoque, dentre outras. Você será informado sobre este dado pelo próprio parceiro.\n   * **Versão do Endpoint de Search:** só existe a opção padrão 1.x.x.\n   * Deixe desmarcada a opção <i class=\"fas fa-toggle-on\"></i> `Usar meu meio de pagamento`.\n6. Clique em `Salvar`.\n\n## Envio de informações para o KaBuM!\n\n> ℹ️ O processo de onboarding com conectores certificados é responsabilidade dos próprios parceiros.\n\nApós concluir as configurações na plataforma VTEX, para dar prosseguimento a integração com o KaBuM!, você precisará possuir uma **chave de API da KaBuM!**. Caso não possua, saiba como obtê-la lendo o artigo da KaBuM! [Geração de chave de API](https://kabum.movidesk.com/kb/article/269610/geracao-de-chave-de-api).\n\nA chave será utilizada para configuração no KaBuM!. Além desta chave, será necessário enviar para o marketplace as informações abaixo, relativas ao seu ambiente VTEX:\n\n* **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*.\n* **Dados de autenticação do sistema:** appKey e appToken definidos na etapa [Criar nova chave de acesso e segredo](#criar-nova-chave-de-acesso-e-segredo).\n* **ID do afiliado:** identificador do afiliado dedicado ao KaBuM!, configurado na etapa [Criar afiliado](#criar-afiliado).\n* **Política comercial:** número da política comercial determinada na etapa [Definir política comercial](#definir-politica-comercial).\n* **ID do Seller:** se você estiver integrando a partir da sua conta principal, o valor a ser informado é `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 VTEX, no módulo *MARKETPLACE > Sellers > Gerenciamento > ID do Seller*.\n\nUma vez que você tenha reunido esses dados, você deverá enviá-los no portal da KaBuM!, e a integração será concluída pelo parceiro. \n\nO KaBuM! também disponibiliza documentação sobre a integração  com a VTEX. Para consultá-la, basta acessar o [Guia de Integração com a VTEX](https://kabum.movidesk.com/kb/article/295830/integracao-com).\n\nPara verificar se seus produtos foram enviados para o marketplace, entre em contato com o [Suporte do KaBum!](https://www.kabum.com.br/cgi-local/site/atendimento/chat/chat.cgi).\n\n### Condições para o envio de produtos o KaBuM!\n\nO KaBuM! possui algumas [especificações](/pt/docs/tracks/especificacoes-definicao-de-conceito) obrigatórias para o envio de produtos. Por isso, é necessário verificar se os itens a serem integrados atendem às seguintes exigências:\n\n* Campo `EAN` no cadastro de SKU preenchido. Caso seja um kit, pode-se gerar um EAN fictício usando o padrão de `KBM + ID LOJA + SKU` do item tendo que conter exatamente 13 dígitos.\n* Informações sobre Garantia.\n* Peso em gramas.\n* Dimensões como profundidade, largura, altura devem ser em centímetros e possuir valores inteiros.\n* Imagens devem ser nítidas em fundo branco, sem logotipos, sem marca d'água.\n\nEm caso de erros no envio dos produtos para o KaBuM!, leia o artigo [Entendendo o rejeito de seus produtos e como corrigir cada um deles](https://kabum.movidesk.com/kb/article/279827/entendendo-o-rejeito-de-seus-produtos-e-como-corrigir-cada-um-de)."}