DEV Community: Fabio Nobre

Transparência de Tributos dos Combustíveis: do PDF da Fecombustíveis ao XML do PDV, sem servidor

Fabio Nobre — Fri, 16 Oct 2026 19:35:08 +0000

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle

O que eu construí

Todo posto de combustível no Brasil precisa mostrar na nota/cupom quanto do preço é imposto (Lei 12.741/2012, a "Lei da Transparência"). Para combustíveis, os valores de ICMS, PMPF e PIS/COFINS mudam por estado e por mês, e a referência que todo mundo usa é o PDF "Carga tributária estadual" publicado pela Fecombustíveis.

O problema: alguém precisa abrir esse PDF todo mês, conferir 27 UFs × 6 combustíveis e redigitar tudo no arquivo TransparenciaTributos.xml que o sistema de PDV lê. É trabalho chato, manual e fácil de errar.

O Transparência de Tributos – Combustíveis automatiza isso:

a cada 8 horas um workflow do GitHub Actions procura o PDF novo no site da Fecombustíveis;
uma IA lê o PDF e devolve os valores por combustível e UF;
o sistema compara com o XML do mês anterior, destaca o que mudou e confere as contas (PMPF × alíquota = ICMS; PMPF × 9,25% = PIS/COFINS no GNV);
gera o XML novo — fechando o bloco antigo no dia anterior e abrindo um bloco novo de vigência só para os combustíveis que mudaram;
publica tudo e avisa por e-mail e Discord.

Quem pagaria por isso? Software houses de automação comercial que atendem postos (como a Imex Tecnologia, onde isso nasceu) e redes de postos que hoje fazem essa atualização na mão. É um nicho pequeno, específico e com uma dor recorrente todo mês — exatamente o tipo de "side hustle" que vira serviço por assinatura.

Demo

Gerador do XML: https://imextecnologia.github.io/tributacao/
Tributos por estado (atualiza sozinha a partir do XML mais recente): https://imextecnologia.github.io/tributacao/tributos.html

Código

imextecnologia / tributacao

tributacao

Transparência de Tributos – Combustíveis

Site estático (GitHub Pages) que gera todo mês o XML TransparenciaTributos a partir do PDF "Carga tributária estadual" da Fecombustíveis.

Site: https://imextecnologia.github.io/tributacao/ · Tributos por estado: https://imextecnologia.github.io/tributacao/tributos.html

Como funciona

Busca do PDF – a cada 8 horas um workflow procura o PDF novo na página da Fecombustíveis, salva em pdf/ e já gera o XML do mês em xml/ (veja Busca automática do PDF).
Leitura com IA – o site envia o PDF ao Google Gemini, que devolve os valores por combustível e UF.
Comparação – os valores são comparados com o XML do mês anterior (em xml/) e o que mudou fica destacado.
Geração – para cada combustível que mudou, o bloco antigo termina no dia anterior (ex.: 30/09/2026) e é criado um bloco novo (ex.: 01/10/2026 até 01/01/2050). Combustíveis sem mudança ficam como estão Também é possível baixar uma planilha…

View on GitHub

Como eu construí

Site 100% estático no GitHub Pages — HTML + JS puro, sem framework e sem servidor próprio. Tudo roda no navegador.
GitHub Actions — buscar-pdf.yml roda às 00:00, 08:00 e 16:00 UTC, baixa o PDF, gera o XML com scripts/gerar-xml.js (mesmas regras do site) e faz commit; pages.yml publica a cada push.
Leitura do PDF com IA — hoje o projeto usa o Google Gemini (plano gratuito), com fallback entre gemini-flash-latest, gemini-flash-lite-latest, gemini-2.5-flash e gemini-2.5-flash-lite.
Validação antes de confiar na IA — se algum valor não fecha a conta, o XML não é gravado automaticamente; ele fica para revisão humana no site (amarelo = mudou, borda vermelha = conta não fecha). O resultado da IA fica em cache no navegador e, se o XML do mês já existe, a IA nem é chamada.

O que fiz nesta semana (12 a 18 de outubro)

A Fecombustíveis publicou uma atualização no meio do mês (10/10), além do PDF de 01/10. Isso expôs um bug: a página inicial só procurava o XML com a data exata do PDF (20261001) e ignorava o 20261010.

13/10 — corrigi index.html para usar o XML mais recente a partir da data do PDF, comparando-o com o XML anterior a ele, sem chamar a IA de novo. Em tributos.html, o link do PDF passou a apontar para o PDF mais recente até a data do XML (já que uma atualização no meio do mês pode não ter PDF próprio).
13/10 — subi os PDFs/XMLs novos e ajustei o TransparenciaTributos_20261001.xml.
15/10 — revisei e atualizei o TransparenciaTributos_20261010.xml.

Pequeno no diff (+11/−8 linhas), mas é o tipo de caso real que só aparece quando o sistema está rodando em produção.

Por que inovação aberta importa?

Vou ser transparente (o projeto se chama assim, afinal): o modelo que uso hoje não é open-weight — é o Gemini via API. O que é aberto aqui é todo o resto: o código, as regras de geração do XML, os workflows e o histórico de cada XML mensal, públicos no GitHub, para qualquer posto ou software house auditar ou reaproveitar.

E justamente por estar tudo aberto e desacoplado, a IA é uma peça trocável: a extração é uma única chamada que devolve JSON, e a validação das contas é feita fora do modelo. O próximo passo natural é testar um modelo open-weight (como o Gemma) nessa etapa, para não depender do plano gratuito de um provedor e poder rodar localmente. Como o PDF da Fecombustíveis é público, privacidade não é o problema — custo e independência de fornecedor são.

Transparência de Tributos dos Combustíveis: do PDF da Fecombustíveis ao XML do PDV, sem servidor

Fabio Nobre — Fri, 16 Oct 2026 19:35:05 +0000

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle

O que eu construí

O Transparência de Tributos – Combustíveis automatiza isso:

a cada 8 horas um workflow do GitHub Actions procura o PDF novo no site da Fecombustíveis;
uma IA lê o PDF e devolve os valores por combustível e UF;
o sistema compara com o XML do mês anterior, destaca o que mudou e confere as contas (PMPF × alíquota = ICMS; PMPF × 9,25% = PIS/COFINS no GNV);
gera o XML novo — fechando o bloco antigo no dia anterior e abrindo um bloco novo de vigência só para os combustíveis que mudaram;
publica tudo e avisa por e-mail e Discord.

Demo

Gerador do XML: https://imextecnologia.github.io/tributacao/
Tributos por estado (atualiza sozinha a partir do XML mais recente): https://imextecnologia.github.io/tributacao/tributos.html

Código

imextecnologia / tributacao

tributacao

Transparência de Tributos – Combustíveis

Site estático (GitHub Pages) que gera todo mês o XML TransparenciaTributos a partir do PDF "Carga tributária estadual" da Fecombustíveis.

Site: https://imextecnologia.github.io/tributacao/ · Tributos por estado: https://imextecnologia.github.io/tributacao/tributos.html

Como funciona

Busca do PDF – a cada 8 horas um workflow procura o PDF novo na página da Fecombustíveis, salva em pdf/ e já gera o XML do mês em xml/ (veja Busca automática do PDF).
Leitura com IA – o site envia o PDF ao Google Gemini, que devolve os valores por combustível e UF.
Comparação – os valores são comparados com o XML do mês anterior (em xml/) e o que mudou fica destacado.
Geração – para cada combustível que mudou, o bloco antigo termina no dia anterior (ex.: 30/09/2026) e é criado um bloco novo (ex.: 01/10/2026 até 01/01/2050). Combustíveis sem mudança ficam como estão Também é possível baixar uma planilha…

View on GitHub

Como eu construí

Site 100% estático no GitHub Pages — HTML + JS puro, sem framework e sem servidor próprio. Tudo roda no navegador.
GitHub Actions — buscar-pdf.yml roda às 00:00, 08:00 e 16:00 UTC, baixa o PDF, gera o XML com scripts/gerar-xml.js (mesmas regras do site) e faz commit; pages.yml publica a cada push.
Leitura do PDF com IA — hoje o projeto usa o Google Gemini (plano gratuito), com fallback entre gemini-flash-latest, gemini-flash-lite-latest, gemini-2.5-flash e gemini-2.5-flash-lite.
Validação antes de confiar na IA — se algum valor não fecha a conta, o XML não é gravado automaticamente; ele fica para revisão humana no site (amarelo = mudou, borda vermelha = conta não fecha). O resultado da IA fica em cache no navegador e, se o XML do mês já existe, a IA nem é chamada.

O que fiz nesta semana (12 a 18 de outubro)

13/10 — corrigi index.html para usar o XML mais recente a partir da data do PDF, comparando-o com o XML anterior a ele, sem chamar a IA de novo. Em tributos.html, o link do PDF passou a apontar para o PDF mais recente até a data do XML (já que uma atualização no meio do mês pode não ter PDF próprio).
13/10 — subi os PDFs/XMLs novos e ajustei o TransparenciaTributos_20261001.xml.
15/10 — revisei e atualizei o TransparenciaTributos_20261010.xml.

Pequeno no diff (+11/−8 linhas), mas é o tipo de caso real que só aparece quando o sistema está rodando em produção.

Por que inovação aberta importa?

Transparência de Tributos dos Combustíveis: do PDF da Fecombustíveis ao XML do PDV, sem servidor

Fabio Nobre — Fri, 16 Oct 2026 19:35:04 +0000

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle

O que eu construí

O Transparência de Tributos – Combustíveis automatiza isso:

a cada 8 horas um workflow do GitHub Actions procura o PDF novo no site da Fecombustíveis;
uma IA lê o PDF e devolve os valores por combustível e UF;
o sistema compara com o XML do mês anterior, destaca o que mudou e confere as contas (PMPF × alíquota = ICMS; PMPF × 9,25% = PIS/COFINS no GNV);
gera o XML novo — fechando o bloco antigo no dia anterior e abrindo um bloco novo de vigência só para os combustíveis que mudaram;
publica tudo e avisa por e-mail e Discord.

Demo

Gerador do XML: https://imextecnologia.github.io/tributacao/
Tributos por estado (atualiza sozinha a partir do XML mais recente): https://imextecnologia.github.io/tributacao/tributos.html

Código

imextecnologia / tributacao

tributacao

Transparência de Tributos – Combustíveis

Site estático (GitHub Pages) que gera todo mês o XML TransparenciaTributos a partir do PDF "Carga tributária estadual" da Fecombustíveis.

Site: https://imextecnologia.github.io/tributacao/ · Tributos por estado: https://imextecnologia.github.io/tributacao/tributos.html

Como funciona

Busca do PDF – a cada 8 horas um workflow procura o PDF novo na página da Fecombustíveis, salva em pdf/ e já gera o XML do mês em xml/ (veja Busca automática do PDF).
Leitura com IA – o site envia o PDF ao Google Gemini, que devolve os valores por combustível e UF.
Comparação – os valores são comparados com o XML do mês anterior (em xml/) e o que mudou fica destacado.
Geração – para cada combustível que mudou, o bloco antigo termina no dia anterior (ex.: 30/09/2026) e é criado um bloco novo (ex.: 01/10/2026 até 01/01/2050). Combustíveis sem mudança ficam como estão Também é possível baixar uma planilha…

View on GitHub

Como eu construí

Site 100% estático no GitHub Pages — HTML + JS puro, sem framework e sem servidor próprio. Tudo roda no navegador.
GitHub Actions — buscar-pdf.yml roda às 00:00, 08:00 e 16:00 UTC, baixa o PDF, gera o XML com scripts/gerar-xml.js (mesmas regras do site) e faz commit; pages.yml publica a cada push.
Leitura do PDF com IA — hoje o projeto usa o Google Gemini (plano gratuito), com fallback entre gemini-flash-latest, gemini-flash-lite-latest, gemini-2.5-flash e gemini-2.5-flash-lite.
Validação antes de confiar na IA — se algum valor não fecha a conta, o XML não é gravado automaticamente; ele fica para revisão humana no site (amarelo = mudou, borda vermelha = conta não fecha). O resultado da IA fica em cache no navegador e, se o XML do mês já existe, a IA nem é chamada.

O que fiz nesta semana (12 a 18 de outubro)

13/10 — corrigi index.html para usar o XML mais recente a partir da data do PDF, comparando-o com o XML anterior a ele, sem chamar a IA de novo. Em tributos.html, o link do PDF passou a apontar para o PDF mais recente até a data do XML (já que uma atualização no meio do mês pode não ter PDF próprio).
13/10 — subi os PDFs/XMLs novos e ajustei o TransparenciaTributos_20261001.xml.
15/10 — revisei e atualizei o TransparenciaTributos_20261010.xml.

Pequeno no diff (+11/−8 linhas), mas é o tipo de caso real que só aparece quando o sistema está rodando em produção.

Por que inovação aberta importa?

Tributos de combustíveis no automático: do PDF da Fecombustíveis ao XML em minutos, com IA e GitHub Actions

Fabio Nobre — Fri, 09 Oct 2026 14:52:17 +0000

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass

What I Built

Todo mês, postos de combustível e sistemas de automação comercial no Brasil precisam atualizar a transparência de tributos (Lei 12.741/2012): quanto de ICMS, PIS/COFINS e CIDE está embutido no litro de cada combustível, em cada estado. A fonte é o PDF "Carga tributária estadual" da Fecombustíveis — e o trabalho era abrir o PDF, copiar valor por valor para 27 UFs e 6 combustíveis e montar o XML TransparenciaTributos à mão.

Construí um site estático (GitHub Pages) que faz isso sozinho:

Busca do PDF – um workflow do GitHub Actions procura o PDF novo a cada 12 horas e salva no repositório.
Leitura com IA – o PDF é enviado a um modelo de IA, que devolve os valores por combustível e por UF.
Comparação – os valores são comparados com o XML do mês anterior; o que mudou fica em amarelo, e contas que não fecham (PMPF × alíquota ≠ ICMS) ficam com borda vermelha.
Geração – para cada combustível que mudou, a vigência antiga é encerrada no dia anterior e um bloco novo é criado. Dá para baixar o XML e uma planilha Excel.

Também há uma página pública, tributos.html, com as tabelas por estado (Gasolina C, Gasolina Premium, Diesel S-500, Diesel S-10, Etanol hidratado e GNV) que se atualiza sozinha quando entra o XML do mês.

E o "Touch Grass"? O objetivo aqui é tirar uma pessoa de uma tarefa repetitiva de tela: o que levava horas de digitação e conferência todo mês virou alguns minutos de revisão. A tela passa a ser a parte mais curta do processo — o resto do dia fica livre.

Para quem é: desenvolvedores de sistemas de PDV/NF-e para postos, contadores e donos de posto que precisam manter a carga tributária correta no cupom.

Demo

Gerador do XML: https://imextecnologia.github.io/tributacao/
Tributos por estado: https://imextecnologia.github.io/tributacao/tributos.html

Code

imextecnologia / tributacao

tributacao

Transparência de Tributos – Combustíveis

Site estático (GitHub Pages) que gera todo mês o XML TransparenciaTributos a partir do PDF "Carga tributária estadual" da Fecombustíveis.

Site: https://imextecnologia.github.io/tributacao/ · Tributos por estado: https://imextecnologia.github.io/tributacao/tributos.html

Como funciona

Busca do PDF – a cada 12 horas um workflow procura o PDF novo na página da Fecombustíveis e salva em pdf/.
Leitura com IA – o site envia o PDF ao Google Gemini, que devolve os valores por combustível e UF.
Comparação – os valores são comparados com o XML do mês anterior (em xml/) e o que mudou fica destacado.
Geração – para cada combustível que mudou, o bloco antigo termina no dia anterior (ex.: 30/09/2026) e é criado um bloco novo (ex.: 01/10/2026 até 01/01/2050). Combustíveis sem mudança ficam como estão Também é possível baixar uma planilha Excel com os valores.

Tudo roda no navegador; não há servidor próprio.

Uso

…

View on GitHub

How I Built It

100% no navegador, sem servidor próprio: HTML + JavaScript puro, publicado no GitHub Pages.
IA para ler o PDF: o site envia o PDF e recebe JSON estruturado por UF/combustível. Hoje uso a API do Google com fallback entre modelos (gemini-flash-latest → gemini-flash-lite-latest → gemini-2.5-flash → gemini-2.5-flash-lite).
Validação determinística depois da IA: a IA não tem a palavra final. O site recalcula PMPF × alíquota e PMPF × 9,25% (PIS/COFINS no GNV) e marca qualquer divergência para revisão humana. Os valores podem ser corrigidos direto na tabela.
Economia de chamadas: se o XML do mês já existe em xml/, ele é carregado direto; o resultado da IA fica salvo no navegador, então recarregar a página não chama a IA de novo.
GitHub Actions:
- buscar-pdf.yml roda às 00:00 e 12:00 UTC, lê a página da Fecombustíveis, baixa o PDF novo, atualiza o painel.json com o quadro oficial de tributação (%) e publica o site;
- pages.yml gera a lista de arquivos, embute CSS/tema/logo e publica a cada push na main.
Mapeamento por código ANP (ex.: Gasolina C = 320102001/320102002; Diesel S-10 = 820101033/820101034). Produtos não mapeados são mantidos no XML sem alteração.
Plano B sem IA: "Preencher a partir do XML (edição manual)" para quando a API estiver indisponível.

Why Does Open Innovation Matter?

O projeto inteiro é aberto e não depende de nenhum servidor meu: o código está no GitHub, o site é estático e roda no navegador, os dados de entrada são públicos (PDF da Fecombustíveis) e o histórico de PDFs e XMLs fica versionado no próprio repositório — qualquer posto ou software house pode fazer um fork e usar.

Sendo transparente: a extração hoje usa um modelo fechado via API. Como toda a lógica de prompt, validação e geração do XML é independente do modelo (o site já troca de modelo automaticamente), o próximo passo é trocar por um modelo open-weight (por exemplo Gemma) — o que permitiria rodar a extração localmente, sem enviar nada a terceiros e sem custo nem limite de cota. A validação determinística (as contas que precisam fechar) é justamente o que torna seguro trocar de modelo: se um modelo menor errar, o erro aparece em vermelho na tela.

Prize Categories

Best Use of GitHub Copilot — o projeto é automatizado com GitHub Actions (busca do PDF a cada 12h, atualização do quadro de tributação e publicação no Pages).