Portal de orçamentos integrado ao Bling: o que ninguém te conta sobre a API
Alves Gustavo20 de outubro de 2026 · 5 min de leitura
ERP
Um dos projetos mais interessantes que fiz este ano foi um portal de orçamentos para a Theikós, uma empresa de serviços tecnológicos que usa o Bling como ERP. Interessante não porque a tela é bonita, mas porque o problema parece pequeno e não é.
O pedido inicial era assim: "a gente quer montar orçamento mais rápido e mandar o PDF pro cliente". O time comercial fazia isso numa planilha, consultava estoque no Bling em outra aba, calculava imposto na mão e torcia pra não errar. Quando o cliente aprovava, alguém digitava tudo de novo no Bling pra virar pedido.
O imposto é o projeto
A parte de cadastrar cliente, escolher produto e somar valor é trabalho de uma tarde. O que separa um portal de orçamentos útil de um brinquedo é o tributo. Quando a venda envolve ICMS ST, DIFAL e IPI, o valor final muda conforme o estado do cliente, o regime tributário, se o produto é para revenda ou uso e consumo, e as regras que o próprio contador cadastrou.
A primeira ideia de qualquer dev é reimplementar essa conta. Eu também pensei nisso por uns cinco minutos. Seria um erro. Qualquer diferença entre a minha conta e a conta do Bling vira uma nota fiscal com valor diferente do orçamento que o cliente aprovou, e esse tipo de diferença gera desconfiança, retrabalho e, no pior caso, problema fiscal.
A solução foi não calcular nada. O Bling tem um endpoint que, a partir de uma natureza de operação, devolve a tributação que ele mesmo usaria para emitir a nota. O portal pergunta ao Bling e mostra o que o Bling responde. Se o contador mudar uma regra lá dentro, o orçamento muda junto, sem eu tocar em código.
A armadilha da permissão que não existe
Aqui começa a parte que nenhuma documentação deixa clara. Para usar esse endpoint, o aplicativo precisa de permissão sobre naturezas de operação. Só que não existe uma permissão com esse nome na lista do Bling. Ela vem embutida na permissão de visualizar notas fiscais.
E tem mais: salvar qualquer alteração de permissão no aplicativo revoga todas as autorizações existentes. Você ajusta um escopo, salva, e o sistema em produção para de conversar com o ERP até alguém refazer o fluxo de autorização. O código de autorização, aliás, vale por um minuto. Descobri tudo isso do jeito mais caro.
Por isso escrevi um pequeno script de apoio que faz esse fluxo de ponta a ponta: gera a URL de autorização, troca o código pelo token e publica o token no banco, de onde o sistema lê e renova sozinho. Reautorizar virou um passo documentado de dois minutos, em vez de uma tarde de pânico.
Nunca mostrar zero
Uma decisão que defendi bastante: se o portal não consegue obter a tributação, ele não mostra zero e não mostra estimativa. Mostra a instrução de como corrigir. Um campo de imposto zerado parece um valor válido, e alguém vai mandar aquele PDF pro cliente. Um aviso claro de "falta configurar tal coisa" é chato, mas impede um erro que custaria dinheiro.
Essa é uma regra que eu levo pra qualquer sistema que mexe com valor: quando não sabe, diga que não sabe. Inventar um número plausível é o pior comportamento possível.
Do rascunho ao pedido
O fluxo ficou em cinco etapas: cliente, produtos, pagamento e frete, tributos (somente leitura, vindos do Bling) e revisão. Ao salvar, o orçamento vira rascunho e o PDF já sai pronto. A partir daí ele vive num kanban com quatro colunas: rascunho, enviado, aprovado e recusado. O time arrasta o card conforme a negociação anda.
Quando um card chega em aprovado, o portal pede confirmação e grava o pedido de venda direto no Bling. Aquela digitação dupla, que era onde mais aparecia erro, simplesmente deixou de existir.
Alçada de desconto
Outro pedido que parecia detalhe e virou regra de negócio importante: desconto. O dono não queria ter que aprovar todo orçamento, mas também não queria vendedor dando quinze por cento pra fechar no fim do mês.
Ficou assim: existe um limite configurável. Se o desconto efetivo passa dele, o orçamento vai pra uma fila de aprovação que só o administrador vê. Enquanto está pendente, o PDF ainda pode ser gerado (o vendedor precisa conversar com o cliente), mas o card não anda no kanban e não vira pedido no ERP. E se alguém aumentar o desconto de um orçamento que já tinha sido aprovado, ele volta pra fila. Parece óbvio, mas é exatamente o tipo de brecha que alguém acaba encontrando se o sistema deixar.
A stack
Next.js com App Router, TypeScript, Postgres no Supabase via Prisma, sessão em cookie assinado e PDF gerado com React. Nada exótico, e isso é proposital. Um sistema interno de uma empresa pequena vai ser mantido por anos, talvez por outra pessoa. Escolher ferramenta popular e bem documentada é uma gentileza com quem vem depois.
Também deixei um guia de contribuição com o mapa dos arquivos e, principalmente, a lista de armadilhas da API do Bling. A próxima pessoa que mexer nesse código não precisa descobrir sozinha que salvar uma permissão derruba a integração.
O que fica pra quem vai integrar com ERP
Deixe o ERP ser a fonte da verdade de tudo que é fiscal. Seu sistema mostra, não recalcula.
Documente o fluxo de autorização como se fosse um procedimento de emergência, porque um dia vai ser.
Quando faltar dado, mostre o problema em vez de um número bonito.
Regra de negócio sobre dinheiro (desconto, aprovação) merece tanto cuidado quanto a integração.
Se a sua empresa usa Bling e ainda monta orçamento em planilha, esse tipo de portal se paga rápido. Me chama no WhatsApp que eu te mostro funcionando.