# Conectar o ERP de uma loja

> Para o proprietário: conecte o Guarani ou o Bling a uma loja na Vendria, troque as credenciais, desligue a conexão e veja o que muda logo depois.

Fonte: https://vendria.com/ajuda/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](/ajuda/estoque-na-cotacao).
- ⚠️ **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](/ajuda/o-que-sincroniza-com-o-erp).

## 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.