# ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google architecture

> Architecture diagram of the GitHub repository ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google
- Repository: https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google

## Overview

O produto é uma automação fiscal para Google Planilhas: recebe XMLs do Drive ou do Gmail, identifica o tipo de nota, extrai os dados e consolida os resultados, com deduplicação, logs e tratamento de falhas. O README descreve as principais etapas e integrações, mas não há trechos de código disponíveis; por isso, as relações abaixo se limitam ao que está documentado. Os caminhos dos componentes de código apontam para o arquivo .gs listado na árvore.

Main entry points: [`automacao_fiscal_codigo_font.gs`](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs) (Orquestrador de processamento)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entrada["Entrada e configuração"]
  node_menu["Menu personalizado"]
  node_config["Configuração de pastas"]
  node_gmail_ingest["Busca de XML no Gmail"]
end

subgraph group_processamento["Processamento fiscal"]
  node_processar["Orquestrador de processamento"]
  node_roteador["Roteador de XML"]
  node_nfe["Parser NF-e"]
  node_nfse["Parser NFS-e"]
  node_dedup["Verificação de duplicidade"]
end

subgraph group_persistencia["Planilha e arquivos"]
  node_fiscais[("Dados fiscais")]
  node_itens[("Detalhes de itens")]
  node_arquivos["Pastas de origem e destino"]
end

subgraph group_operacao["Automação e observabilidade"]
  node_agendamento["Gatilho diário"]
  node_logs[("Log de processamento")]
  node_erros["Isolamento de erros"]
  node_alertas["Alertas por e-mail"]
end

node_usuario(("Usuário da planilha"))
node_sheets[("Google Planilhas")]
node_gmail["Gmail"]
node_drive["Google Drive"]
node_sefaz["Consulta pública SEFAZ"]

node_usuario -->|"acessa"| node_menu
node_menu -->|"configura"| node_config
node_menu -->|"inicia"| node_processar
node_menu -->|"solicita busca"| node_gmail_ingest
node_menu -->|"ativa ou remove"| node_agendamento
node_config -->|"salva parâmetros"| node_sheets
node_gmail_ingest -->|"busca anexos"| node_gmail
node_gmail_ingest -->|"salva XMLs"| node_drive
node_agendamento -->|"agenda busca"| node_gmail_ingest
node_agendamento -->|"agenda processamento"| node_processar
node_processar -->|"lê XMLs"| node_arquivos
node_processar -->|"encaminha XML"| node_roteador
node_roteador -->|"aciona parser"| node_nfe
node_roteador -->|"aciona parser"| node_nfse
node_processar -->|"verifica chaves"| node_dedup
node_processar -->|"consolida dados"| node_fiscais
node_processar -->|"registra itens"| node_itens
node_processar -->|"move processados"| node_arquivos
node_processar -->|"registra execução"| node_logs
node_processar -->|"isola falhas"| node_erros
node_erros -->|"move inválidos"| node_arquivos
node_erros -->|"aciona notificação"| node_alertas
node_alertas -->|"envia e-mail"| node_gmail
node_fiscais -->|"oferece consulta"| node_sefaz

click node_menu "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_config "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_gmail_ingest "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_agendamento "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_processar "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_roteador "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_nfe "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_nfse "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_dedup "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_fiscais "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_itens "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_arquivos "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_logs "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_erros "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"
click node_alertas "https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_menu,node_config,node_gmail_ingest toneBlue
class node_processar,node_roteador,node_nfe,node_nfse,node_dedup,node_sheets toneAmber
class node_fiscais,node_itens,node_arquivos toneMint
class node_agendamento,node_logs,node_erros,node_alertas toneRose
class node_usuario,node_gmail,node_drive,node_sefaz toneIndigo
```

## Components

### Entrada e configuração

- [Menu personalizado](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Configuração de pastas](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Busca de XML no Gmail](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`

### Processamento fiscal

- [Orquestrador de processamento](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Roteador de XML](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Parser NF-e](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Parser NFS-e](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Verificação de duplicidade](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`

### Planilha e arquivos

- [Dados fiscais](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Detalhes de itens](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Pastas de origem e destino](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`

### Automação e observabilidade

- [Gatilho diário](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Log de processamento](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Isolamento de erros](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`
- [Alertas por e-mail](https://github.com/ildem96/automacao-fiscal-e-leitura-de-xml---spreadsheet-google/blob/main/automacao_fiscal_codigo_font.gs): `automacao_fiscal_codigo_font.gs`

### Other components

- **Usuário da planilha**
- **Google Planilhas**
- **Gmail**
- **Google Drive**
- **Consulta pública SEFAZ**

## Connections

- Usuário da planilha → Menu personalizado: acessa (evidence: `readME.md`)
- Menu personalizado → Configuração de pastas: configura (evidence: `readME.md`)
- Menu personalizado → Orquestrador de processamento: inicia (evidence: `readME.md`)
- Menu personalizado → Busca de XML no Gmail: solicita busca (evidence: `readME.md`)
- Menu personalizado → Gatilho diário: ativa ou remove (evidence: `readME.md`)
- Configuração de pastas → Google Planilhas: salva parâmetros (evidence: `readME.md`)
- Busca de XML no Gmail → Gmail: busca anexos (evidence: `readME.md`)
- Busca de XML no Gmail → Google Drive: salva XMLs (evidence: `readME.md`)
- Gatilho diário → Busca de XML no Gmail: agenda busca (evidence: `readME.md`)
- Gatilho diário → Orquestrador de processamento: agenda processamento (evidence: `readME.md`)
- Orquestrador de processamento → Pastas de origem e destino: lê XMLs (evidence: `readME.md`)
- Orquestrador de processamento → Roteador de XML: encaminha XML (evidence: `readME.md`)
- Roteador de XML → Parser NF-e: aciona parser (evidence: `readME.md`)
- Roteador de XML → Parser NFS-e: aciona parser (evidence: `readME.md`)
- Orquestrador de processamento → Verificação de duplicidade: verifica chaves (evidence: `readME.md`)
- Orquestrador de processamento → Dados fiscais: consolida dados (evidence: `readME.md`)
- Orquestrador de processamento → Detalhes de itens: registra itens (evidence: `readME.md`)
- Orquestrador de processamento → Pastas de origem e destino: move processados (evidence: `readME.md`)
- Orquestrador de processamento → Log de processamento: registra execução (evidence: `readME.md`)
- Orquestrador de processamento → Isolamento de erros: isola falhas (evidence: `readME.md`)
- Isolamento de erros → Pastas de origem e destino: move inválidos (evidence: `readME.md`)
- Isolamento de erros → Alertas por e-mail: aciona notificação (evidence: `readME.md`)
- Alertas por e-mail → Gmail: envia e-mail (evidence: `readME.md`)
- Dados fiscais → Consulta pública SEFAZ: oferece consulta (evidence: `readME.md`)
