Conectar a conta Bling

• Acesso de administrador à conta Bling do seller — é ela que vai autorizar a conexão.
• Permissão para criar um aplicativo nessa conta Bling. É dele que saem as duas credenciais: o Client ID e o Client Secret (no ExlogWMS, o segundo aparece como Secret Key).
• O seller já cadastrado no ExlogWMS.

Cada integração usa um aplicativo criado dentro da conta Bling do seller. O aplicativo precisa de um endereço de retorno, o Callback URL, que o próprio ExlogWMS mostra na janela de cadastro. Por isso a ordem é: abrir a janela no ExlogWMS, copiar o Callback URL, criar o aplicativo no Bling e voltar com as credenciais.

1. Clique em Nova Integração. Abre a janela Cadastro de Integração.
2. No quadro Instruções para Configuração no Bling, no alto da janela, clique em Copiar ao lado de Callback URL. A tela confirma com URL copiada!. Deixe a janela aberta.

1. Em outra aba, entre na conta Bling do seller e abra Preferências → Integrações → Aplicativos.
2. Crie o aplicativo da loja, ou edite o que já existe.
3. No campo URL de Callback, cole o endereço copiado do ExlogWMS.
4. Salve o aplicativo e copie o Client ID e o Client Secret que o Bling mostra.

O quadro de instruções da janela do ExlogWMS traz esses mesmos passos para consulta.

1. De volta ao ExlogWMS, em Plataforma, escolha o Bling.
2. Em Apelido, dê um nome que ajude a reconhecer a conta (ex.: Bling loja principal). O campo é opcional, mas o mesmo seller não pode ter duas integrações da mesma plataforma com o mesmo apelido.
3. Cole o Client ID e a Secret Key. Os dois são obrigatórios. Na Secret Key, o ícone do olho mostra ou esconde o que foi digitado.
4. Clique em Salvar.

A tela avisa que a integração foi salva, a janela fecha e a lista é recarregada. A integração aparece com o status Pendente: as credenciais estão guardadas, mas o Bling ainda não autorizou o acesso.

Print pendenteassets/img/integracao-bling/janela-nova-integracao.png

Para trocar o apelido ou as credenciais, clique no lápis da coluna Ações, altere e clique em Salvar. A plataforma não pode ser trocada depois de salva; para mudar, exclua e cadastre de novo.

Para apagar, clique no lápis e depois em Excluir Integração. O sistema pede confirmação.

1. Na lista, clique no lápis da integração.
2. Na janela Cadastro de Integração, clique em Conectar com Bling. Esse botão só aparece em integração já salva.
3. A janela passa a mostrar o resumo da conexão: plataforma, apelido e status, com os botões Fechar, Renovar Token, Testar Integração e Conectar com Bling. O título continua sendo Cadastro de Integração. Clique de novo em Conectar com Bling.
4. O navegador abre a página do Bling. Entre com a conta do seller, se ele pedir.
5. Confira o nome do aplicativo e autorize o acesso.

Print pendenteassets/img/integracao-bling/janela-cadastro-editar.png

Print pendenteassets/img/integracao-bling/janela-conectar-bling.png

Depois da autorização, o Bling devolve você para o ExlogWMS, em uma tela com o resultado:

• Conectando com o Bling... — relógio girando enquanto a conexão é concluída;
• Conectado — a conexão deu certo; a tela conta 5 segundos e volta sozinha para a lista de integrações do seller. Para não esperar, clique em Ir agora;
• Erro — a conexão não foi concluída. A mensagem diz o motivo; veja a tabela abaixo.

O resumo da conexão (lápis → Conectar com Bling, Figura 5) traz mais duas ações. O resultado de cada uma aparece em um aviso no canto superior direito da janela.

• Testar Integração — confere se o Bling está respondendo com a autorização guardada. Quando está tudo certo, o aviso diz Integração respondendo normalmente no Bling. Se avisar que não há token, conecte primeiro; se avisar que o token está inválido ou expirado, renove ou conecte de novo.
• Renovar Token — renova a autorização sem passar de novo pela página do Bling. Quando dá certo, a janela recarrega já com o status atualizado. Se avisar que o token expirou ou foi revogado, é preciso conectar de novo pelo passo 4.

Para sair, clique em Fechar.

Print pendenteassets/img/integracao-bling/teste-integracao-ok.png