DEV Community: Fabio Nobre

O fantasma que assombra o PDF da Fecombustíveis: um robô que transforma a tributação dos combustíveis em XML

Fabio Nobre — Tue, 27 Oct 2026 12:43:22 +0000

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 4: Ghost in the Machine

Transparência antes de tudo: este projeto usa o Google Gemini (API fechada) para ler o PDF — não um modelo open-weight. Conto abaixo por que fiz essa escolha, onde o código é aberto e o que falta para trocar por um modelo aberto.

What I Built

Todo mês, sem aviso de horário, aparece um PDF no site da Fecombustíveis: a "Carga tributária estadual" dos combustíveis. Ali estão o PMPF, a alíquota de ICMS, o tributo estadual e o federal de gasolina, diesel, etanol e GNV para as 27 UFs.

Quem emite nota fiscal de combustível no Brasil precisa desses números para a Lei da Transparência (o "valor aproximado dos tributos" no cupom). No nosso caso, eles alimentam o XML TransparenciaTributos usado no nosso sistema de emissão fiscal. Antes, alguém abria o PDF — com as tabelas em imagem — e digitava dezenas de valores à mão.

O Transparência de Tributos – Combustíveis é o "fantasma na máquina" que faz isso sozinho:

👻 Assombra a página da Fecombustíveis a cada 8 horas procurando o PDF novo;
📄 Lê o PDF com IA e devolve os valores por combustível e UF;
🧮 Confere as contas (PMPF × alíquota = ICMS; no GNV, PMPF × 9,25% = PIS/COFINS) e se recusa a gravar se algo não fechar;
🕯️ Honra o passado: o bloco de vigência antigo não é apagado — ele "termina" no dia anterior (ex.: até 30/09/2026) e nasce um bloco novo (01/10/2026 até 2050). O histórico de cada tributo fica preservado no XML;
🔔 Avisa por e-mail e no Discord quando a tributação muda;
🌐 Publica uma página pública com os tributos por estado.

Minha leitura do tema: o PDF mensal é um fantasma que aparece quando quer, e a ideia foi deixar a máquina vigiando por mim — sem perder a memória dos meses anteriores, que é o que o fisco pede quando confere uma nota antiga.

Demo

Gerador (passos 1–3): https://imextecnologia.github.io/tributacao/
Tributos por estado: https://imextecnologia.github.io/tributacao/tributos.html

Fluxo no site:

Passo 1 – o PDF mais recente já vem selecionado, com o XML do mês anterior como base.
Passo 2 – a IA extrai os valores; o que mudou fica amarelo (com o valor antigo embaixo) e conta que não fecha ganha borda vermelha. Tudo é editável na tabela.
Passo 3 – Gerar XML, Baixar XML e, se quiser, Baixar Excel.

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

How I Built It

Sem servidor. É um site estático no GitHub Pages; tudo roda no navegador ou num job do GitHub Actions.

Busca automática (.github/workflows/buscar-pdf.yml, cron 0 */8 * * *):

scripts/buscar-pdf.js lê a página da Fecombustíveis e pega o link do PDF mais recente pela data no nome ("10 OUTUBRO 2026" vem antes de "01 OUTUBRO 2026"). Se a página falhar, tenta o link no padrão do mês atual e do próximo.
scripts/gerar-xml.js gera o XML do PDF novo usando o mesmo prompt, produtos e UFs do index.html — o script extrai essas constantes direto do HTML, então site e robô nunca divergem.
scripts/buscar-painel.js relê o quadro oficial de percentuais e atualiza painel.json.
Se algo mudou: commit, publicação do site e aviso por e-mail/Discord com o diff.

A IA. O PDF vai para o Gemini com um prompt que pede somente JSON num formato fixo (gasolina/diesel com valor único; etanol e GNV por UF). O site tenta uma lista de modelos em ordem (gemini-flash-latest → gemini-flash-lite-latest → gemini-2.5-flash → gemini-2.5-flash-lite), com nova tentativa em 429/503.

A rede de segurança importa mais que o modelo. IA lendo tabela em imagem erra dígito. Por isso:

// PMPF × alíquota precisa bater com o ICMS (etanol no MT usa base de 50%)
const base = (p.key === "etanol" && row.uf === "MT") ? row.pmpf * 0.5 : row.pmpf;
if (Math.abs(base * row.aliquota / 100 - row.estadual) > 0.0015) err.estadual = true;
// GNV: PIS/COFINS = PMPF × 9,25%
if (p.key === "gnv" && Math.abs(row.pmpf * 0.0925 - row.federal) > 0.0015) err.federal = true;

No Actions, se qualquer conta não fecha, o XML não é gravado — o aviso pede revisão humana no site, e as execuções seguintes tentam de novo. Uma alucinação nunca vira nota fiscal.

Economia de chamadas: se o XML do mês já existe em xml/, o site carrega direto; o resultado da IA fica salvo no navegador, então recarregar a página não chama o modelo de novo.

Why Does Open Innovation Matter?

Sendo honesto: a parte de IA aqui não é aberta. Escolhi o Gemini porque o plano gratuito lê PDF com tabela em imagem de forma confiável, não exige cartão e o volume é mínimo (uma leitura por mês). Para um site estático sem servidor, isso resolveu.

Mas o projeto mostra exatamente onde um caminho fechado incomoda:

A chave fica exposta no index.html publicado (restrita por referenciador e API, mas ainda assim pública). Um modelo local não teria chave nenhuma.
Dependência de fornecedor: precisei de uma lista de fallbacks porque modelos somem ou mudam de nome. Um modelo open-weight com versão fixa daria a mesma resposta amanhã — algo valioso quando o resultado vai para documento fiscal.
Dados: no plano gratuito o Google pode usar o conteúdo enviado. Hoje só vai o PDF público da Fecombustíveis, então não há problema — mas eu não poderia fazer o mesmo com documentos de clientes.

O que é aberto: todo o código, o workflow, as regras de validação e o histórico de XMLs estão no GitHub, públicos. Qualquer posto, contador ou software fiscal pode copiar, auditar as contas ou usar os XMLs.

Próximo passo: como o prompt já pede JSON estrito e a validação aritmética independe do modelo, a troca é isolada numa função (chamarGemini). O plano é testar um modelo de visão open-weight (por exemplo, Gemma) rodando dentro do próprio GitHub Actions ou localmente e comparar a taxa de "contas que não fecham" com o Gemini.

The Spirit of It

No Día de los Muertos a gente lembra quem veio antes. No XML de tributos, nada é apagado: cada mês que passa vira um bloco com data de fim, e o novo começa no dia seguinte. Quando alguém abrir uma nota de setembro daqui a cinco anos, os valores de setembro ainda estarão lá.

E o fantasma? Ele aparece às 21h, 5h e 13h (horário de Brasília), olha a página, e na maioria das vezes vai embora em silêncio. Quando a tributação muda, ele deixa um recado no Discord. 👻

Prize Categories

Best Use of GitHub Copilot — a automação inteira (busca, geração do XML, publicação e avisos) roda em GitHub Actions.

Deixei a IA ler o PDF de tributos dos combustíveis por mim todo mês

Fabio Nobre — Wed, 21 Oct 2026 16:07:24 +0000

Esta é uma submissão para o Hacktoberfest Open-Source AI Challenge: Week 3, "Slow and Steady".

O que eu construí

Todo mês a Fecombustíveis publica um PDF com a carga tributária estadual dos combustíveis: PMPF, alíquota de ICMS, PIS/COFINS, por produto e por estado. E todo mês alguém precisa abrir esse PDF, conferir número por número e transformar aquilo no XML TransparenciaTributos que o sistema de emissão fiscal consome.

Esse "alguém" era eu. Então construí o tributacao: um site estático que pega o PDF do mês, usa IA para extrair os valores por combustível e UF, compara com o XML do mês anterior e gera novos blocos de vigência só para os combustíveis cujos valores mudaram.

Além do XML, ele oferece:

Exportação para Excel, para quem prefere conferir em planilha;
Uma página pública com os tributos por estado, para consulta rápida;
Checagens de consistência: o site sinaliza valores que não fecham (PMPF × alíquota vs. ICMS, e PMPF × 9,25% vs. PIS/COFINS no caso do GNV), para a revisão humana focar onde importa.

Os produtos ANP mapeados são gasolina C, gasolina premium, etanol hidratado, diesel S-500, diesel S-10 e GNV. O que não está mapeado fica intocado no XML.

Demo

Gerador de XML: https://imextecnologia.github.io/tributacao/
Painel de tributos por estado: 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í

A arquitetura é propositalmente simples, para não ter servidor para manter:

Front-end estático (HTML, CSS e JavaScript) hospedado no GitHub Pages.
Extração com IA: o PDF é enviado ao Google Gemini, que devolve os valores estruturados por combustível e estado. PDF tabular de órgão público é exatamente o tipo de documento em que regex quebra a cada mudança de layout, e um modelo multimodal lida bem com isso.
Diff inteligente: em vez de regerar tudo, o script compara com o XML do mês anterior e cria vigências novas apenas onde houve alteração. Isso mantém o histórico limpo e facilita a auditoria.
Automação com GitHub Actions: um workflow roda a cada 8 horas, verifica se saiu PDF novo, gera o XML, atualiza os dados do painel e manda alerta por e-mail e Discord quando algo muda. Os segredos de alerta são opcionais; sem eles o workflow roda do mesmo jeito.
Scripts Node em scripts/ para buscar o PDF, gerar o XML e montar os assets. PDFs e XMLs de cada mês ficam versionados em pdf/ e xml/, e exemplos/ traz um par de referência.

Para rodar localmente:

node scripts/gerar-arquivos.js
npx http-server -p 5500

Uma lição sobre chave de API em site estático

Num site 100% estático, a chave do Gemini acaba visível no código-fonte da página. A mitigação que adotei e documentei no README é restringir a chave por HTTP referrer e somente à Generative Language API. Se você for copiar a ideia, faça isso antes de publicar.

Por que a inovação aberta importa?

Sendo transparente: o modelo que uso hoje (Gemini) é fechado. O que é aberto aqui é todo o resto, e é justamente isso que torna o projeto útil:

O código é público. Qualquer posto, distribuidora ou software house que precise do mesmo XML pode usar, auditar ou adaptar.
Os dados são públicos e versionados. Cada PDF e cada XML gerado ficam no repositório, então dá para ver exatamente o que mudou de um mês para o outro e quando.
A camada de IA é substituível. A extração é uma etapa isolada do pipeline. Trocar o Gemini por um modelo open-weight rodando localmente é o próximo passo natural, e eliminaria de vez o problema da chave exposta.

Tributação é assunto de interesse público. Uma ferramenta que traduz um PDF oficial em dados estruturados deveria ser aberta, verificável e fácil de reproduzir.

A recompensa da preguiça

Antes: baixar o PDF, abrir lado a lado com o XML do mês passado, conferir estado por estado, editar vigências na mão e torcer para não ter errado uma casa decimal.

Agora: o GitHub Actions percebe o PDF novo sozinho, gera o XML, e eu só recebo um aviso no Discord. Minha parte é revisar os valores que o próprio site destacou como inconsistentes. A IA faz o trabalho chato; eu fico com a decisã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: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).