Blog / Sistemas

Portal de orçamentos integrado ao Bling: o que ninguém te conta sobre a API

Alves Gustavo
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

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.

Leia também
Bastidores1min

Como o gerador de sites da Axolutions coloca um site no ar em um minuto

Por dentro do gerador de sites da Axolutions: o que é IA, o que é código comum e por que a parte mais importante é aquilo que a IA não faz.

10 de novembro de 2026 · 6 min de leitura
IA aplicadaIA

O que aprendi colocando atendentes de IA no WhatsApp

Construindo o Órbita, descobri que o difícil não é fazer o bot responder. É fazer ele responder a coisa certa, na hora certa, e saber quando ficar quieto.

28 de outubro de 2026 · 5 min de leitura
Fala comigo