Como integrar o ERP com a Vtex
O que é a integração
Com a integração com a Vtex, você gerencia seus pedidos e catálogo de produtos. Além disso, seus estoques são atualizados automaticamente e os dados dos clientes relacionados aos pedidos são importados para o ERP.
Recursos disponíveis
| Receber pedidos | ✓ |
| Receber produtos | ✓ |
| Enviar produtos | ✓ |
| Enviar estoque | ✓ |
| Enviar preços | ✓ |
| Sincronizar situação | ✓ |
| OMS | ✓ |
Como instalar a integração passo a passo
Siga os passos abaixo para configurar a integração:
- Acesse menu > início > Integrações.
- Clique em adicionar integração, busque por Vtex e clique em instalar.
- No campo Nome da integração no ERP, informe o nome da integração no ERP.
- Na seção Autenticação, preencha os campos conforme as orientações:
- URL da loja: informe a URL da sua loja virtual.
- Nome da conta: informe o nome da sua conta na Vtex.
- APPKEY e APPTOKEN: as instruções para obter os dados encontram-se em Gerar APPKEY e APPTOKEN.
- Clique no botão conectar com VTEX.
- Após preencher os campos, verifique se os dados informados estão corretos em Testar configurações.
Como configurar no ERP
Ao finalizar a instalação e autenticação da conta do ERP, siga com o ajuste das configurações, conforme o artigo Como configurar uma integração e as especificações listadas abaixo.
Especificidades na configuração da integração
Aba Canais de Venda
Dica: caso você já tenha conectado algum canal diretamente ao ERP, não é necessário conectá-lo novamente por meio da Vtex.
- Clique em adicionar canal de venda para selecionar e configurar os canais de venda.
- Informe o código do canal de venda no e-commerce e selecione o intermediador da transação.
- Habilite se deseja importar valor do frete nos pedidos deste canal.
Defina os valores de taxa(%), valor mínimo de comissão, valor unitário mínimo, valor adicional mínimo e a base de cálculo para comissão: total da venda ou total da venda sem frete. - Habilite o campo integrador cobra taxa para este canal de venda se for esse o caso do canal escolhido e clique em salvar.
- Se desejar não utilizar um canal de venda, desabilite as conexões dos canais de venda já listados.
Aba Produtos
Fluxo de Produtos
Nesta seção, defina como as informações dos produtos serão enviadas ou recebidas entre o ERP e a VTEX.
- Enviar imagens dos produtos ao sincronizar: escolha entre Sim ou Apenas para novos produtos para o envio de imagens.
Observação: se o produto for enviado sem imagem, ele será cadastrado e mantido como Inativo na VTEX até que receba a informação.
- Enviar imagens do produto pai nas variações: ao Habilitar, as imagens do produto pai serão adicionadas às variações que não possuem imagens próprias.
- Ao importar produtos: defina se as imagens serão tratadas como Anexos ou se será importada apenas a URL. Escolha entre: Importar imagens como anexos ou Apenas importar a URL externa das imagens.
- Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU): Habilite para atualizar o Código (SKU) sempre que os produtos forem importados do e-commerce.
- Se EAN não preenchido, enviar código do produto no fabricante como EAN do produto: ao selecionar Sim, o sistema verifica o campo EAN. Se estiver vazio, o Código do produto no fabricante será enviado como EAN.
- Importar somente produtos ativos: ao Habilitar, serão importados apenas produtos com situação Ativos na VTEX. Se Desabilite, todos os produtos serão importados, independente da situação.
- Mostrar anúncios sem estoque na loja: ao Habilitar, os produtos sincronizados que não possuírem estoque para venda continuarão sendo exibidos na loja.
Aba Pedido
Dados Fiscais
-
Envio de dados da NFe
- Automático ao autorizar a nota fiscal: sempre que a nota fiscal for autorizada, o envio dos dados da NFe ao e-commerce será automático.
- Manual: o envio deverá ser realizado de forma Manual.
Como usar o ERP com a VTEX
Acesse o artigo Como usar uma integração no dia a dia para saber mais sobre o uso e descobrir como aproveitar ao máximo a integração.
Especificidades no uso da integração
Reajustar preço dos produtos no ERP e atualizar na Vtex
Para ajustar os preços no ERP e atualizá-los na loja virtual, siga os passos:
- Acesse menu > cadastros > Produtos > mais ações > reajustar preço dos produtos.
- Utilize as opções de filtros e clique em listar produtos.
- Na lista exibida, clique em informar reajuste.
- Selecione os produtos que deseja atualizar.
- Utilize o reajuste por Percentual ou insira o valor individual na coluna Novo preço.
- Marque a opção atualizar preços no e-commerce, selecione a integração correspondente e clique em salvar.
Enviar código de rastreio para a Vtex
Importante: para enviar o código de rastreamento, é preciso informar o transportador (Correios ou Transportadora) no pedido ou nota fiscal. O campo deve ser preenchido no Pedido de Venda ou na Nota Fiscal, com a posterior geração do agrupamento (PLP ou Coleta) no módulo de Expedição.
- Acesse o menu > vendas > Expedição.
- Filtre pela forma de envio Correios > aba concluídas.
- Clique no menu de contexto ao lado da expedição gerada e selecione enviar código de rastreio para o e-commerce.
Observação: ao enviar o código de rastreio, o sistema também envia a URL de rastreamento, identificação do transportador, chave de acesso da Nota Fiscal, data, hora, número e valor da nota. É necessário que a Nota Fiscal esteja Autorizada no Sefaz para o sucesso do envio. Um marcador será adicionado à expedição para identificar o envio concluído.
Enviar dados da chave de acesso ao e-commerce
O envio pode ser realizado pelos módulos de Expedição ou Nota Fiscal.
Envio pela expedição
- Acesse o menu > vendas > Expedição
- Utilize o primeiro filtro ao lado do campo de busca e selecione pedidos.
- No filtro ao lado, selecione Transportadora.
- Localize a expedição, clique no Menu de contexto e selecione Enviar chave de acesso para o e-commerce.
Envio pelas notas fiscais
- Acesse o menu > vendas > Notas Fiscais
- Clique na aba Emitidas.
- Selecione as notas desejadas.
- Acesse mais ações e clique em enviar dados da NFe para e-commerce.
Observação: além da chave de acesso, são enviados a data de envio, número e valor da NFe. A Nota Fiscal deve estar Autorizada no Sefaz.
Marcar pedidos como entregues na Vtex
Ao marcar os pedidos como entregue no ERP, o status será sincronizado na Vtex.
- Acesse menu > vendas > Expedição.
- Selecione a forma de envio e vá até a aba concluídas.
- Clique no menu de contexto ao lado da expedição e selecione marcar pedidos como entregue.
Um marcador será adicionado à expedição para identificar a sincronização.
Obter ID da forma de recebimento
Admin layout antigo
- No painel administrativo da Vtex, acesse PCI GATEWAY.
- Clique em Configurações para acessar as formas de recebimento.
- O ID das formas de recebimento estará destacado na listagem.
Admin novo layout
- No painel administrativo da Vtex, acesse Pagamentos > Configurações.
- Identifique o ID das formas de recebimento na tela.
Observação: na configuração no ERP, informe apenas o número do ID (Ex: 4).
Obter Código do canal de venda no e-commerce
O código do canal de venda que deve ser informado no ERP é o mesmo cadastrado na seção de Afiliados da Vtex.
