Conectar o ERP de uma loja

Onde fica

No menu da sua conta, em Configurações da Empresa, no cartão Integração ERP. Ele fica abaixo de Dicas de extração de pedidos e acima da lista de Lojas.

⚠️ Só o Proprietário da empresa vê este cartão. Administrador da empresa e administrador de loja abrem a mesma página sem ele. E ele também some quando a conexão feita pelo próprio cliente está desligada para a sua empresa: nesse caso quem conecta o ERP é a equipe da Vendria. Não é defeito da tela: é o cartão que não se aplica a você.

Quais ERPs dá para conectar por aqui

Pelo cartão Integração ERP dá para conectar dois ERPs, que aparecem na lista Tipo de ERP em minúsculas: guarani e bling. Outros ERPs (o TOTVS Protheus, por exemplo) são conectados pela equipe da Vendria, não por esta tela.

A conexão é por loja: numa organização com três lojas, cada uma é conectada separadamente, e uma loja sem conexão continua funcionando sem ERP. Uma loja usa um tipo de ERP só: não dá para ter Guarani e Bling na mesma loja.

Como conectar o Guarani, passo a passo

Antes de começar, tenha em mãos o endereço do conector e as duas chaves de acesso (a API key e o webhook secret). Quem os fornece é quem instalou o conector do Guarani na sua empresa ou a equipe da Vendria.

1. Em Configurações da Empresa, no cartão Integração ERP, clique em Conectar ERP.
2. Em Loja, escolha a loja que usa esse Guarani.
3. Em Tipo de ERP, escolha guarani.
4. Em Endereço (base URL), cole o endereço do conector. Ele precisa começar com https://.
5. Preencha API key e Webhook secret. Os dois são obrigatórios.
6. Clique em Salvar. Aparece a mensagem ERP conectado.

A conexão aparece na lista do cartão com o nome da loja, o selo guarani, o selo verde Credenciais configuradas e a chave ligada. Ela já nasce ativa.

Como conectar o Bling, passo a passo

O Bling não usa chave digitada: ele pede que você autorize a Vendria na própria tela do Bling.

1. Em Configurações da Empresa, no cartão Integração ERP, clique em Conectar ERP.
2. Em Loja, escolha a loja que usa esse Bling.
3. Em Tipo de ERP, escolha bling. O Endereço (base URL) já vem preenchido com o endereço do Bling. Deixe como está.
4. Clique em Salvar. A conexão aparece com o selo amarelo Aguardando conexão e a chave desligada.
5. Clique em Conectar ao Bling, na linha da conexão. Você vai para a tela de autorização do Bling.
6. Entre com a conta do Bling da loja e autorize.
7. Ao terminar, aparece a página "Bling conectado com sucesso! Você já pode fechar esta aba." Volte para Configurações da Empresa: o selo passa a Conectado e a chave fica ligada sozinha.

⚠️ Para o Bling mandar as atualizações automáticas, a URL de notificação (webhook) da Vendria também precisa estar cadastrada no painel do Bling. Se você não sabe qual é, peça à equipe da Vendria.

O que acontece logo depois de conectar o ERP

• Estoque: se a loja controla estoque (em Regras Comerciais, a opção Empresa controla estoque), a consulta de estoque ao ERP começa na hora: a cotação passa a avisar falta de saldo linha a linha. Ver Estoque na cotação: o aviso de falta e as saídas.
• ⚠️ Pré-venda: quando esta é a primeira conexão ativa da organização, a chave Pré-venda conta como estoque (em Configurações da Empresa) é desligada automaticamente. É proposital: sem isso, a primeira confirmação de pedido depois de conectar poderia mandar ao ERP um pedido de reserva que ninguém pediu. Se a sua operação vende pré-venda, religue a chave depois de conectar. Conectar uma segunda loja não mexe mais nessa chave.
• Catálogo do Bling: a primeira carga do catálogo fica na fila assim que a autorização termina, e é aplicada quando a sincronização de catálogo estiver liberada para a loja.
• O resto é liberado loja a loja: catálogo automático, vendedores, clientes, preço praticado e envio de pedidos ao ERP não ligam só porque a conexão existe. A equipe da Vendria libera cada um depois de conferir o seu cadastro. Ver O que sincroniza com o ERP, e quando.

Editar a conexão ou trocar as credenciais

Na linha da conexão, clique em Editar. A janela Editar conexão ERP deixa mudar o Endereço (base URL) e trocar as credenciais. A Loja e o Tipo de ERP não mudam depois de criados.

Numa conexão Guarani, os campos de credencial vêm em branco, com a indicação (manter atual): deixar em branco mantém as chaves que já estão gravadas. As credenciais nunca são mostradas de volta, nem para o Proprietário. Numa conexão Bling não há credencial para digitar: a autorização é feita na tela do próprio Bling.

⚠️ Para trocar as credenciais, preencha API key e Webhook secret juntos. Se você preencher só um dos dois e salvar, a Vendria grava o endereço e mantém as duas chaves antigas. A mensagem Conexão atualizada aparece do mesmo jeito.

Desligar e religar uma conexão

A chave na linha da conexão liga e desliga, sem pedir confirmação. Com a conexão desligada, a Vendria para de usar esse ERP naquela loja: a consulta de estoque, os dados do cliente vindos do ERP e o envio de pedidos deixam de acontecer por ela. Nada é apagado: religar volta ao que era.

Não há botão de excluir conexão nesta tela; desligar é o gesto para parar de usar.

⚠️ Religar a única conexão da organização conta como uma primeira conexão: a chave Pré-venda conta como estoque é desligada de novo. Confira-a depois.

Quando dá errado

• "base_url deve usar https": o endereço começa com http://. Só endereços seguros são aceitos.
• "base_url deve apontar para um host público" ou "base_url inválida": o endereço aponta para uma rede interna, para localhost ou está mal escrito. O conector precisa estar acessível pela internet.
• "Loja … já usa ERP '…'. Todas as conexões de uma loja devem ser do mesmo tipo.": a loja já tem uma conexão de outro ERP. Uma loja não mistura ERPs.
• A loja aparece apagada na lista Loja: ela já tem uma conexão daquele tipo.
• "Conflito de conexão — tente novamente.": duas gravações ao mesmo tempo. Salve de novo.
• "Link de autorização inválido ou expirado. Refaça a conexão." (Bling): o link de autorização vale por pouco tempo e só uma vez. Volte a Configurações da Empresa e clique em Conectar ao Bling de novo.
• "Não foi possível concluir a autorização com o Bling. Tente novamente.": o Bling não confirmou a autorização. Repita o passo 5.
• Não vejo o cartão Integração ERP: você não é o Proprietário da empresa, ou a conexão pelo próprio cliente não está disponível para a sua empresa. Fale com a equipe da Vendria.