O cadastro do conector é feito no Admin da VTEX. Para realizá-lo, siga as instruções abaixo.
- No Admin VTEX, acesse Marketplace > Conexões >Marketplace e integrações ou digite Marketplace e integrações na barra de busca.
- Busque pelo conector da Casas Bahia Marketplace.
- Clique em
Conectar
. - Preencha os campos da tela descritos logo abaixo e, em seguida, clique no botão
Salvar Configuração
(campos marcados com o símbolo * são obrigatórios).
- Id do afiliado:* código identificador para criação de um afiliado qque ainda não esteja cadastrado no seu sistema. O código deve ser composto de três consoantes, sejam elas repetidas ou não, vogais não são aceitas. Sugestão:
VVJ
. A configuração do conector cria automaticamente o afiliado. - Afiliate Email:* preencha com o e-mail cadastrado na etapa Criar conta de seller na Casas Bahia Marketplace.
- Política comercial:* ID da política comercial que será utilizada para a integração com a Casas Bahia Marketplace. São os produtos dessa política comercial que serão enviados para o marketplace.
- Chave de acesso: preencha com o Token enviado pela Casas Bahia Marketplace na etapa Solicitar token na Via.
- CNPJ:* preencha esse campo com o CNPJ da sua loja. Essa informação é obrigatória para que seja possível faturar os pedidos. Leia o artigo Fluxo de configuração da Casas Bahia Marketplace para saber mais.
- Nome do campo de Especificação de Produto que contém sua Descrição: preencha esse campo para utilizar uma descrição diferente da que já está cadastrada no catálogo VTEX. Ao preencher esse campo, você deverá criar um campo de produto do tipo
Texto Grande
. O conector priorizará o envio da descrição contida no campo criado. - Estoque mínimo:* determina o valor mínimo de estoque de segurança. Se a quantidade de itens de um produto em estoque estiver abaixo do valor escolhido, seu anúncio é pausado para evitar que sejam feitas vendas sem estoque durante o tempo de atualização da Casas Bahia Marketplace pela VTEX. O valor de estoque mínimo é aplicado a todos os produtos, portanto verifique se algum produto deixaria de ser anunciado devido ao seu estoque inicial.
- Enviar KIT:* ao escolher
Não
, SKUs cadastrados como kit não são enviados para a Casas Bahia Marketplace. Ao habilitarSim
, todos os itens da sua política comercial são enviados para o marketplace, sem filtrar SKUs cadastrados como kit. Mudanças na configuração do conector podem ser feitas a qualquer momento, sendo que isso não afeta SKUs que já tenham sido enviados. Por exemplo, se você mudasse sua configuração deSim
paraNão
, SKUs enviados anteriormente para a Casas Bahia Marketplace não seriam removidos ou sofreriam qualquer alteração. Se você mudar sua configuração deNão
paraSim
, você precisará reindexar a base para que a configuração seja aplicada.
Com a opção Não ativada, tentativas de envio para a Casas Bahia Marketplace de SKUs cadastrados como kit resultarão no seguinte aviso: O conector está configurado para não enviar SKUs do tipo Kit. Esta mensagem pode ser visualizada no Admin, no módulo MARKETPLACE > Integrações > Produtos, ao se clicar sobre o SKU.
- E-mails Para Notificação de Pedidos Não Integrados:* preencher com o e-mail do responsável técnico. Caso ocorra algum erro na integração do pedido, será enviada uma mensagem para o e-mail cadastrado.
Caso você não aperte no botão
+
para inserir o E-MAIL PARA NOTIFICAÇÃO DE PEDIDOS NÃO INTEGRADOS, aparecerá um alerta de erro ao salvar a configuração.
Mapeamento de Campos Customizados (Nome e descrição): Para utilizar esse mapeamento é necessário criar um campo customizado. Para saber como criar campos customizados, acesse a documentação Cadastrar especificações ou campos de produto.
O mapeamento de campos customizáveis está disponível apenas para nome do produto e descrição do produto. Exemplo de nome para o novo campo:
CBH_ProductName
para nome do produto eCBH_ProductDescription
para descrição do produto.
Para o mapeamento funcionar, é necessário o seller seguir os seguintes passos:
- Criar um campo do tipo
Texto grande
. - Desativar a opção
Exibe especificação
. - Preencher os campos criados em cada produto cadastrado.
O preenchimento desse campo deve ser realizado da seguinte maneira:
- Preencha o campo DE com o nome do campo de origem.
ObrigatoriamenteProductName
para título do produto ou ObrigatoriamenteProductDescription
para descrição do produto. - Preencha o campo PARA com o nome do novo campo.
CBH_ProductName
para nome do produto eCBH_ProductDescription
para descrição do produto. - Clique no botão e uma regra de mapeamento será adicionada a sua integração.
Cada regra cadastrada mapeia apenas um campo. Caso o campo mapeado não tenha um valor preenchido, será enviado o valor padrão de
Título
ouDescrição
cadastrados no catálogo.