Esse tópico tem por objetivo auxiliar na configuração de um processo de integração de pedidos e status com o sistema BLING.
Ativação da API no Bling
Para ativar a API no Bling é preciso acessar Preferências / Integrações / Configurações de integração com lojas virtuais e marketplaces
Selecionar uma opção Bling API , porém tem que procurar a que não é criada para algum outro sistema
Informar um nome para a integração, como “WMS TECH” por exemplo.
os demais campos não precisam ser alterados e basta salvar.
Cadastro do usuário da API no Bling
Para que possamos autenticar é necessário criar um usuário no sistema Bling para a API acessando Preferências / Sistema.
Acessar a opção Usuário e usuário API
Clicar em Incluir Usuário
Selecionar a opção Usuário API
Informar os seguintes campo
Nome: Informar um nome para o usuário como Integração
Selecionar a Aba Vendas para adicionar as permissões de integração do usuário marcando Integrações Logísticas e as opções de pedidos de venda.
Após informar os dados clicar em Gerar para que seja gerado o Token do usuário que será utilizado na configuração do WMS.
Cadastro do Bling na integração do WMS
Para cadastrar a integração basta acessar a ferramenta Ambiente / Integrações / Integrações e clicando em adicionar
Informar o nome do sistema para integração e o Access token, que foi gerado no cadastro do usuário de integração no Bling
Cadastro do usuário de integração no WMS
Para que a integração funcione é necessário criar um usuário de integração no sistema WMS do cliente com os seguintes dados:
Usuário: integracoes
senha: @integracoes!
Com permissão de acesso externo somente.
Criação do parâmetro do HUB para criação de pedido
Para criar o parâmetro basta acessar HUB / Parâmetros
Descrição: Informar uma descrição clara para o parâmetro
E-mail Responsável: Informar o e-mail da pessoa responsável pela operação para receber eventuais mensagens de notificação de possíveis falhas de sincronização
Projeto: Estoque
Tipo: Execução
Nome interno: Deverá criar um nome interno que será utilizado na configuração do Bling sem espaços ou caracteres especiais.
Formato : Estoque Obtém programação Bling
Tipo de operação WMS: Informar de acordo com o cliente
Sistema: Informar a mesma descrição do sistema informado no cadastro da integração no WMS.
Situação Consulta: Informar o Código da situação para obtenção dos pedidos, deve ser combinado com o cliente junto ao fluxo da operação
Situação Alteração: Informar o Código da situação no Bling para confirmação da obtenção do pedido, deve ser combinado com o cliente junto ao fluxo da operação.
Esse hub deverá ser agendado conforme combinado com o cliente para que ele seja executado de tempos em tempos. Deverá ser aberta uma tarefa para o DEV para criação da chave de agendamento do
Criação do parâmetro do HUB para atualização da situação no Bling
Descrição: Informar uma descrição clara para o parâmetro
E-mail Responsável: Informar o e-mail da pessoa responsável pela operação para receber eventuais mensagens de notificação de possíveis falhas de sincronização
Projeto: Estoque
Tipo: ImportaçãoC
Nome interno: Deverá criar um nome interno que será utilizado na configuração do Bling sem espaços ou caracteres especiais.
Formato : Estoque Altera Status Expedição Bling
Tipo de operação WMS: Informar de acordo com o cliente
Sistema: Informar a mesma descrição do sistema informado no cadastro da integração no WMS.
Programação c/ ocorrências: Informar a ocorrência que ao ser lançada irá disparar a troca da situação no Bling.
Programação s/ Ocorrências: Informar a ocorrência de confirmação da troca da situação no Bling.
Configuração dos E-commerces
Para que as programações de saída tenham as informações do e-commerce é necessário configurar os mesmos de acordo com a integração que esta sendo realizada, nesse caso com o Bling iremos obter as informações dos responses enviados pelo Bling no histórico do HUB.
Nesse caso acessando Estoque / Configurações / Cadastros de E-commerce iremos adicionar conforme segue:
Descrição: Informar a descrição do E-commerce que irá aparecer no pedido
Loja: Informar a loja
Cód Ecommerce: Informar o código do e-commerce que esta vindo na integração
no caso do Bling essa informação é obtida do seguinte campo “loja” do response da integração.
Logo: Informar o logo para a loja selecionada
Configuração de métodos de envio
Para que as programações de saída tenham as informações do método de envio é necessário configurar os mesmos de acordo com a integração que esta sendo realizada, nesse caso com o Bling iremos obter as informações dos responses enviados pelo Bling no histórico do HUB.
Nesse caso acessando Estoque / Configurações / Cadastros de Métodos de Envio iremos adicionar conforme segue:
Descrição: Descrição do método de envio
Contrato: Numero do contrato com o método de envio quando houver, (Ex contrato com os correios).
Cód Método Envio : Informar o código do método de envio que vem na integração.
O mesmo será selecionado na programação de saída conforme o campo “codigoServico”.
Nome interno: Informar o método de envio conforme as opções do select
E-commerce: Selecionar o e-commerce que utilizará esse método de envio.
Logo: Adicionar o logo do método de envio para a impressão da etiqueta
Logo símbolo encaminhamento: Informar o logo do símbolo de encaminhamento.
Com esses cadastros ao importar o pedido do Bling o sistema já irá selecionar o e-commerce e o método de envio.
