{"id":31740356,"url":"https://github.com/gnneto/nf-analyzer","last_synced_at":"2026-04-16T01:33:26.954Z","repository":{"id":318074839,"uuid":"1069909690","full_name":"gnneto/nf-analyzer","owner":"gnneto","description":"Script Python para extrair dados de Notas Fiscais Eletrônicas (XML) e gerar Excel consolidado, com foco na extração de informações financeiras, como vencimentos e valores, para uma análise mais detalhada e eficiente. mantendo formatação numérica.","archived":false,"fork":false,"pushed_at":"2025-10-04T21:40:15.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-13T11:52:50.947Z","etag":null,"topics":["data-analysis","excel","finance","nf-analyzer","pandas","python","xlm"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gnneto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-04T21:29:58.000Z","updated_at":"2025-10-04T21:40:18.000Z","dependencies_parsed_at":"2025-10-04T23:31:05.286Z","dependency_job_id":"e9c5d658-54bb-4d2c-a0d3-da926e162ded","html_url":"https://github.com/gnneto/nf-analyzer","commit_stats":null,"previous_names":["gnneto/nf-analyzer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gnneto/nf-analyzer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnneto%2Fnf-analyzer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnneto%2Fnf-analyzer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnneto%2Fnf-analyzer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnneto%2Fnf-analyzer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gnneto","download_url":"https://codeload.github.com/gnneto/nf-analyzer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnneto%2Fnf-analyzer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31867711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-analysis","excel","finance","nf-analyzer","pandas","python","xlm"],"created_at":"2025-10-09T10:18:09.604Z","updated_at":"2026-04-16T01:33:26.927Z","avatar_url":"https://github.com/gnneto.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Análise Financeira de Notas Fiscais Eletrônicas (NF-e)\n\nEste projeto realiza a leitura e análise de arquivos XML de Notas Fiscais Eletrônicas (NF-e), com foco na extração de informações financeiras, como vencimentos e valores, para uma análise mais detalhada e eficiente.\n\n## Funcionalidades\n\n- Leitura de arquivos XML de NF-e em uma pasta específica.\n- Extração de informações financeiras, como parcelas, vencimentos e valores.\n- Consolidação dos dados em um arquivo Excel (`notas.xlsx`) para facilitar a análise.\n- Formatação de datas e valores monetários no padrão brasileiro.\n- Evita duplicação de registros com base no número da nota e parcela.\n\n## Como usar\n\n1. **Pré-requisitos**:\n   - Python 3.7 ou superior.\n   - Bibliotecas necessárias: `pandas`, `openpyxl`.\n\n   Para instalar as dependências, execute:\n   ```bash\n   pip install pandas openpyxl\n   ```\n\n2. **Estrutura do projeto**:\n   - Certifique-se de que os arquivos XML das NF-e estão em uma pasta chamada `nfs` no mesmo diretório do script.\n   - O script gera ou atualiza o arquivo `notas.xlsx` no mesmo diretório.\n\n3. **Execução**:\n   - Execute o script `NF_Vendas.py`:\n     ```bash\n     python NF_Vendas.py\n     ```\n   - O arquivo `notas.xlsx` será gerado ou atualizado com os dados extraídos.\n\n## Observações\n\n- **Foco financeiro**: O projeto prioriza a análise de vencimentos e valores das parcelas, permitindo uma visão detalhada das obrigações financeiras.\n- **Namespace**: O script trata namespaces nos arquivos XML (NFe) automaticamente.\n- **Formatação**: Datas são formatadas no padrão `DD/MM/AAAA` e valores monetários no formato brasileiro `1.234,56`.\n\n## Estrutura do Arquivo Excel\n\nO arquivo gerado (`notas.xlsx`) contém as seguintes colunas:\n\n- **Numero NF**: Número da nota fiscal.\n- **Data Emissao**: Data de emissão da nota.\n- **Destinatario**: Nome do destinatário.\n- **Parcela**: Número da parcela (se aplicável).\n- **Vencimento**: Data de vencimento da parcela (se aplicável).\n- **Valor parcela**: Valor da parcela (se aplicável).\n- **Valor total NF**: Valor total da nota fiscal.\n- **Forma pgto**: Forma de pagamento.\n- **Emitente**: Nome do emitente.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnneto%2Fnf-analyzer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgnneto%2Fnf-analyzer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnneto%2Fnf-analyzer/lists"}