Bling
A integração com o Bling conecta a sua conta ao idworks e sincroniza os fluxos correspondentes ao canal — credenciais, regras de sincronização de produtos, importação de pedidos, conciliação financeira e demais ações específicas dele. A configuração reúne 17 parâmetros distribuídos em 4 grupo(s).
Antes de configurar, ative a integração em Configurações → Integrações (aba Integrações Disponíveis), preencha o nome interno e (quando o tipo exigir) passe pelo fluxo de autenticação. A partir daí, os parâmetros abaixo ficam disponíveis em Configurar parâmetros.
Categoria no catálogo do idworks: Marketplace.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
Erros mais comuns
- A etiqueta do Bling não sai ou vem em formato não reconhecido
- A integração Bling ficou com status Erro
Referência rápida
O que é a integração Bling?
É a conexão entre o canal Bling e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é Marketplace), mas em geral cobre uma combinação de credenciais, regras de sincronização, gatilhos automáticos e parâmetros de conciliação.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → Bling.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Bling e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias instâncias do mesmo tipo.
- Clique em Salvar.
A integração aparece imediatamente em Minhas Integrações. Dependendo do tipo, o status inicial é Ativo (quando só requer credencial fixa) ou Não Autenticado (quando depende de autenticação externa).
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar e validar as credenciais?
Preencha o grupo Credenciais de Acesso (ver tabela abaixo). Quando a integração pede uma autorização externa (o canal abre a tela de login dele para você liberar o acesso), clique em Autenticar Integração na linha da integração (ícone de cadeado) — uma nova aba abre o login do canal e, ao confirmar, a conexão fica liberada. Para integrações com credencial fixa (usuário/senha/chave), basta preencher os campos e salvar.
Depois de salvar, use a ação Verificar credenciais (quando disponível) para confirmar que o canal responde. O status na listagem reflete o resultado: Ativo = OK, Erro = credencial inválida ou revogada, Não Autenticado = falta concluir o fluxo de autorização.
Pré-requisito: privilégio Editar parametrizações empresa.
Credenciais de Acesso
1 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
Integração de Vendas
12 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| ID Situação | Texto | Qual o status do pedido que o idworks deve integrar? 6-Em aberto, 9-Atendido, 12-Cancelado, 15-Em andamento, 18-Venda Agenciada, 21-Em digitação, 24-Verificado |
| ID pedido iniciar importação | Texto | A partir de qual número de pedido a idworks deve iniciar a integração? |
| Empresa Faturadora | Lista | Empresa responsável pelo faturamento dos pedidos, caso seja diferente da principal. |
| Incluir somente pedidos com NF | Sim/Não | Ative se quiser integrar somente pedidos com NF |
| Excluir valor frete na NF para PF | Sim/Não | Ative se quiser excluir o valor do frete na Nota Fiscal quando a venda por para pessoa física (PF) |
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| ID Situação após criação | Texto | Qual o status do pedido a idworks deve alterar após a sua criação |
| Código lojas importar pedido | Texto | Códigos das lojas do Bling cujos pedidos devem ser importados, separados por vírgula. Em branco, importa os pedidos de todas as lojas. |
| Utilizar código padrão de/para transportadora | Sim/Não | Ao ativar, todos os pedidos chegam com a mesma transportadora do canal — basta um único De-Para de transportadora, feito com o código padrão da integração (2), em vez de um mapeamento por transportadora. |
| Fechar pedido automaticamente | Sim/Não | Quando marcado, o idworks fecha o pedido integrado do canal de vendas através do hub. Se desmarcado, o pedido quando integrado permanece com o status de aberto para atualização manual. |
| Margem mínima desejável | % | Percentual mínimo de margem de contribuição para os pedidos desta integração. Quando a margem do pedido fica abaixo do valor configurado, o pedido é enviado para aprovação de margem em vez de seguir o fluxo automático. |
| Checar taxa/imposto efetivo do pedido | Sim/Não | Ao ativar, o sistema valida a margem de contribuição no fechamento do pedido. Exige que a Margem mínima desejável (ou a taxa efetiva) esteja preenchida. |
Integração de Produtos
2 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Atualizar saldo estoque | Sim/Não | Ative se quiser que a idworks atualize o saldo de estoque na integração. |
| Armazéns para somar quantidade | Lista múltipla | Selecionar os armazéns que deve somar a quantidade para enviar aos canais de venda. Caso não seja preenchido, será enviado a quantidade do armazém que esta no de/para |
Importação de Produtos
2 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Incluir Imagens | Sim/Não | Importar imagem para os produtos e skus |
| Incluir Imagens Produto | Sim/Não | Importar imagem para os produtos e skus |
A etiqueta do Bling não sai ou vem em formato não reconhecido
O idworks busca a etiqueta no Bling quando você usa a Etiqueta canal do pedido. O Bling pode devolver o arquivo de três formas, e o idworks trata todas:
- Etiqueta térmica (ZPL) — usada direto na impressora térmica.
- Arquivo compactado — o idworks abre o pacote e procura a etiqueta térmica dentro dele. Se lá dentro só houver PDF, converte a primeira página do PDF em etiqueta térmica.
- PDF avulso — também é convertido em etiqueta térmica.
Se mesmo assim aparecer o aviso "arquivo de etiqueta em formato não reconhecido" (ou uma observação vinda do próprio Bling no lugar dele):
- Confirme no Bling que a etiqueta já foi gerada para aquele pedido — antes disso o pacote vem vazio.
- Confirme que o pedido já está faturado no idworks. Sem nota fiscal emitida, a consulta nem chega ao Bling e devolve "Nota fiscal não emitida".
- Confira, no painel do Bling, qual formato de etiqueta está configurado para a transportadora do pedido. Formatos fora do padrão (imagem, arquivo proprietário da transportadora) não são convertidos.
- Se a observação exibida vier do Bling (por exemplo, pendência de coleta ou de dados do destinatário), resolva a pendência lá e consulte a etiqueta de novo.
A integração Bling ficou com status Erro
O acesso do idworks ao Bling vale por tempo limitado e é renovado automaticamente, sem nenhuma ação sua. O status exibido em Configurações → Integrações → Minhas Integrações reflete a última renovação:
| Status | Significado |
|---|---|
| Ativo | A renovação do acesso foi concluída com sucesso. |
| Erro | A última tentativa de renovar o acesso não deu certo. |
Quando o Bling responde com instabilidade ou limita o volume de chamadas, o idworks espera e tenta de novo antes de encerrar a rodada — oscilações rápidas do canal não derrubam mais a integração. A renovação também é repetida nas rodadas seguintes: se a falha foi passageira, o status volta sozinho para Ativo.
Enquanto o acesso não é renovado, as ações que dependem do Bling (importar pedidos, atualizar estoque, consultar etiqueta) podem falhar por falta de autorização.
O que fazer quando o status Erro persiste:
- Aguarde a próxima rodada de renovação e recarregue a tela — falhas momentâneas do canal se resolvem sozinhas.
- Se continuar em Erro, a autorização provavelmente foi revogada no Bling. Na linha da integração, clique em Autenticar Integração (ícone de cadeado) e conclua o login no Bling.
- Confirme que o status voltou para Ativo e refaça a ação que falhou.
Pré-requisito: privilégio Editar parametrizações empresa.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Configurar parâmetros, editar nome e status, autenticar e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |