FiscalFlow

Plataforma de automação para processamento de notas fiscais recebidas por e-mail. O sistema localiza anexos XML, extrai dados fiscais, identifica a filial destinatária, controla duplicidades e apresenta os resultados em um dashboard interativo.

Google Apps Script JavaScript Gmail Google Sheets XML Google Charts
Testar demonstração Ver repositório
4 Filiais identificadas automaticamente
XML Extração estruturada de dados fiscais
100% Controle por chave de acesso
Tempo real Indicadores e dashboard gerencial

Clone interativo

Explore uma simulação do FiscalFlow com dados fictícios. Navegue pelo dashboard, filtre notas por filial e status, pesquise fornecedores e acompanhe os principais indicadores.

Apresentação do projeto

Objetivo

Reduzir o trabalho manual necessário para localizar e registrar notas fiscais recebidas por e-mail, centralizando as informações em uma base estruturada.

Automação

O Google Apps Script consulta o Gmail, identifica anexos XML, processa os documentos e grava automaticamente os dados na planilha.

Confiabilidade

Cada nota é validada pela chave de acesso, reduzindo registros duplicados e garantindo rastreabilidade durante o processamento.

Visão gerencial

Os registros alimentam um dashboard com KPIs, gráficos, ranking de fornecedores, filtros e acompanhamento dos vencimentos.

Como funciona

Gmail Localiza mensagens com anexos XML.
Leitura do XML Abre e interpreta o documento fiscal.
Parser Extrai fornecedor, NF, datas e valor.
Filial Identifica o destino pelo CNPJ.
Google Sheets Registra e organiza os dados extraídos.
Dashboard Atualiza indicadores e análises.

Arquitetura da solução

Entrada

Gmail, assunto da mensagem e anexos XML de notas fiscais.

→

Processamento

Apps Script, parser XML, validação da chave e identificação da filial.

→

Saída

Google Sheets, histórico de controle, logs e dashboard.

Tecnologias

Google Apps Script JavaScript HTML5 CSS3 Gmail Service Google Sheets Google Charts XML Parser HTMLService

Funcionalidades

Busca automática de e-mails com anexos XML no Gmail.
Leitura estruturada de documentos fiscais eletrônicos.
Cadastro automático das informações no Google Sheets.
Identificação automática da filial destinatária pelo CNPJ.
Prevenção de duplicidades utilizando a chave de acesso da NF-e.
Controle de emissão, vencimento e prazo de pagamento.
KPIs, gráficos e ranking dos principais fornecedores.
Pesquisa e filtros por filial, fornecedor, status e período.
Registro de logs e acompanhamento das mensagens processadas.

Aprendizados

Durante o desenvolvimento do FiscalFlow foram aplicados conceitos de automação de processos, integração entre serviços Google, tratamento de dados estruturados, arquitetura modular e desenvolvimento de interfaces para sistemas internos.

Automação de rotinas operacionais com Apps Script.
Integração entre Gmail, Google Sheets e HTMLService.
Leitura e manipulação de documentos XML.
Validação, deduplicação e rastreabilidade de registros.
Construção de dashboards responsivos e interativos.
Organização do código em serviços e responsabilidades.

Código e documentação

O repositório apresenta a estrutura do projeto, os serviços do Google Apps Script, o dashboard, a documentação da arquitetura e instruções para configuração com dados fictícios.

Abrir GitHub