cleitonleonel

cleitonleonel / nfse_manager

Public

Sistema de gestão de NFSe em Python (FastAPI + SQLAlchemy + SQLite), com dashboard, downloads XML/PDF, analytics e relatórios JSON/CSV/XLSX.

10
3
85% credibility
Found May 22, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

NFSe Manager is a Brazilian fiscal document management application that helps businesses automatically sync their electronic service invoices (NFSe) from government portals, download XML and PDF files, and generate financial reports. It works as either a web application or a native desktop program, storing client credentials locally to access portals on the user's behalf. The system tracks both invoices issued by the company and received from suppliers, provides visual dashboards with charts and rankings, and exports data in multiple formats for accounting purposes.

How It Works

1
🔍 You discover a tool for managing Brazilian service invoices

You find NFSe Manager on GitHub — a way to automatically sync, download, and organize your company's fiscal documents.

2
💻 You choose how to run it

You can open it in your browser like any website, or install it as a desktop app that sits in your system tray.

3
👥 You add your company to the system

You enter your company's tax ID (CNPJ), business name, and portal login credentials so the app can connect on your behalf.

4
🔄 Your invoices sync automatically from the government portal

Pick a date range, click sync, and watch as all your issued and received invoices appear — complete with amounts, dates, and status.

5
📥 You download XML and PDF files with one click

Missing a file? The app finds it on the portal and saves it to your computer in your preferred folder structure.

6
You explore your financial data
📈
Dashboard with charts

See your total revenues, expenses, and net balance displayed as a timeline graph.

🏆
Rankings by client

View your top billing clients and top suppliers ranked by transaction volume.

7
📤 You export reports for your accountant

Download a summary as a spreadsheet, CSV file, or JSON — whatever format your accounting software needs.

✅ Your fiscal life is organized

All your invoices are synced, files are saved, and reports are ready — no more hunting through government portals.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is nfse_manager?

This is a Brazilian invoicing management system for NFS-e (Nota Fiscal de Serviços Eletrônica). It automates the tedious process of syncing electronic service invoices from government portals, downloading XML and PDF files, and generating financial reports. The system runs as a web application served by a Python API, with a separate desktop packaging option using Tauri for native desktop deployment. Users manage multiple client accounts, each with their own portal credentials, and the system handles background synchronization of invoices by date range. The dashboard displays financial summaries, charts showing invoice trends, and client rankings. Reports export to JSON, CSV, or Excel formats for accounting workflows.

Why is it gaining traction?

The hook here is automation for Brazilian businesses dealing with NFS-e compliance. Manual portal access is error-prone and time-consuming. This tool centralizes everything: client credentials, invoice sync, file downloads, and financial reporting in one interface. The background task system means users can trigger large syncs without blocking the UI. The export functionality directly addresses accounting and analytics needs. The desktop packaging via Tauri makes it feel like a native application rather than a web tool, which appeals to non-technical users who want a simple installation experience.

Who should use this?

Accounting firms managing multiple client NFS-e accounts will find the multi-client sync and batch download features most valuable. Small to medium Brazilian service businesses that issue high volumes of NFS-e can automate their document retrieval. Developers building integration workflows around Brazilian invoicing could use the API directly. It is less suited for one-off invoice lookups or users outside Brazil due to portal-specific integration.

Verdict

At 10 stars with a 0.85% credibility score, this project shows promise but lacks the community validation that inspires confidence in long-term maintenance. The documentation is thorough and the feature set is practical, but the low star count and minimal test coverage suggest caution for mission-critical production use. Start with the web version, validate against your specific NFS-e portal structure, and consider contributing tests if the workflow fits your needs.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.