Como integrar e configurar o Bling
Este guia apresenta o fluxo de integração entre YouShop e Bling, desde a criação de contas e apps privados até a autenticação, configuração de callbacks (webhooks) e a integração de produtos, para sincronizar clientes, pedidos, notas fiscais e o catálogo entre as duas plataformas.
1 - Crie a conta Bling na YouShop
Vá até a tela de integrações https://app.youshop.com.br/integracoes e clique em Bling!
Clique em "Cadastrar conta".
Informe um nome para identificar a integração e clique em Gerar URL de redirecionamento.
No modal exibido, clique no ícone de copiar para copiar a URL de redirecionamento.
Caso o modal seja fechado, você poderá acessar novamente a conta do Bling criada, clicar nos três pontinhos e utilizar a opção Copiar URL de redirecionamento. Nesse menu, também é possível editar ou excluir a conta.
2 - Crie um app privado YouShop no Bling
Acesse o Bling: https://www.bling.com.br/cadastro.aplicativos.php#add e clique em "Criar aplicativo".
Em Tipo de aplicativo, selecione Privado.
Preencha os dados básicos do aplicativo (nome, descrição etc.).
Em Categoria, escolha Plataforma de e-commerce
Cole a URL de redirecionamento no campo Link de redirecionamento nos dados básicos do Bling.
Na lista de escopos, adicione os escopos mostrados na imagem
Lista de Escopos a Selecionar:
a. Clientes e Fornecedores → Gerenciar Contatos
b. Nota de Serviço → Gerenciar Notas de Serviço (opcional)
c. Notas Fiscais → Emissão de Nota Fiscal Eletrônica (NF-e)
d. Pedidos de Venda → Gerenciar Pedidos de Venda
e. Produtos → Gerenciar Produtos
f. Categorias de Produtos → Gerenciar Categorias de Produtos
Preencha as informações de contato conforme o exemplo da imagem:
Dica: Utilize exatamente os dados abaixo: • Nome: YouShop • E-mail: suporte@youshop.com.br • Telefone: (48) 4042-3175
Clique em Salvar e siga para o próximo passo da integração.
3 - Preencher dados de integração do Bling na YouShop
Após salvar o aplicativo, acesse Informações do app e copie o Client ID e o Client Secret.
Observação: o Client ID deve ser inserido no campo ID do cliente, e o Client Secret deve ser inserido no campo Chave privada.
Retorne à Youshop, cole cada código no respectivo campo e clique em Salvar.
4 - Autorizar aplicativo no Bling
Após preencher os campos Client ID e Client Secret, retorne ao Bling, copie o link de convite e abra-o em outra aba.
Após concluir a autorização, ao listar a conta cadastrada na YouShop, o status aparecerá como Autenticado. Em seguida, prossiga para o próximo passo.
5 - Como cadastrar o aplicativo de Webhooks
Acesse o link https://www.bling.com.br/configuracoes.integracoes.lojas.virtuais.php#list, pesquise por API e selecione API - Outro.
Na aba Autenticação, preencha o campo Nome do canal de venda com Integração YouShop.
Na aba Callbacks, selecione o tipo de retorno JSON. Habilite os callbacks de pedidos de venda e notas fiscais, conforme o exemplo na imagem. Em seguida, insira o Link de redirecionamento configurado na YouShop e, por fim, salve as alterações.
Caso precise acessar novamente o link de redirecionamento, você pode obtê-lo diretamente na YouShop. Localize a conta do Bling, clique nos três pontinhos e selecione a opção para copiar a URL de redirecionamento.
6 - Criar integração do produto com o Bling!
Atenção: para cada novo produto cadastrado, será necessário repetir o fluxo a partir do passo 20 para concluir corretamente a configuração.
Acesse https://app.youshop.com.br/produtos, selecione o produto desejado, clique nos três pontinhos e escolha a opção "Ver detalhes".
Acesse a aba "Nota Fiscal" e selecione a opção "Cadastrar".
Selecione a opção Bling!
Preencha as informações solicitadas e salve.
🐲 Pronto. A integração com o Bling foi concluída com sucesso.
Como enviar o identificador da loja para o bling
Copie o código da loja fornecido pelo Bling e informe-o no campo correspondente na YouShop.
Observação: Esse código é utilizado pela YouShop para identificar a loja de origem dos pedidos no Bling.
Coloque o código no campo "Identificador da loja".
Verifique as informações do pedido no Bling.
Após a integração, acesse um pedido no Bling e verifique as informações da loja. Antes de inserir o código da loja, esse campo aparecerá como “Nenhuma”, pois nenhuma loja estará vinculada ao pedido.
Confira a identificação da loja.
Após inserir o código da loja na integração, os novos pedidos receberão automaticamente a identificação da loja correspondente. O nome da loja será preenchido no pedido de acordo com a loja vinculada ao código informado.
Perguntas frequentes
- Quais escopos devo selecionar ao criar o aplicativo privado no Bling?
Selecione os escopos conforme a lista do guia: a) Clientes e Fornecedores → Gerenciar Contatos; b) Nota de Serviço → Gerenciar Notas de Serviço (opcional); c) Notas Fiscais → Emissão de Nota Fiscal Eletrônica (NF-e); d) Pedidos de Venda → Gerenciar Pedidos de Venda; e) Produtos → Gerenciar Produtos; f) Categorias de Produtos → Gerenciar Categorias de Produtos.
- Como obtenho e uso a URL de redirecionamento da YouShop no cadastro do app no Bling?
Após criar a conta Bling na YouShop (com zeros nos campos), clique nos três pontos da conta e copie a URL de redirecionamento disponibilizada. No Bling, ao criar o app privado, cole essa URL no campo Link de redirecionamento dos dados básicos do aplicativo. Mais tarde, na configuração de webhooks (callbacks), também insira o mesmo Link de redirecionamento configurado na YouShop.
- Como configurar os callbacks (webhooks) no Bling para funcionar com a YouShop?
Acesse https://www.bling.com.br/configuracoes.integracoes.lojas.virtuais.php#list, pesquise por API e selecione Bling!API. Na aba Autenticação, preencha o campo Nome do canal de venda com: Integração YouShop. Na aba Callbacks, selecione o tipo de retorno JSON, habilite os callbacks de pedidos de venda e notas fiscais conforme o exemplo do guia, insira o Link de redirecionamento configurado na YouShop e salve as alterações.
- Preciso configurar algo por produto? Como faço a integração do produto com o Bling?
Sim. Para cada novo produto cadastrado é necessário repetir o fluxo de integração do produto. Acesse https://app.youshop.com.br/produtos, selecione o produto desejado, clique nos três pontinhos e escolha "Ver detalhes". Na aba "Nota Fiscal" selecione "Cadastrar", escolha a opção Bling!, preencha as informações solicitadas e salve. O guia indica que este fluxo deve ser repetido para cada novo produto.