Nota Fiscal Paulistana

What This Skill Does

The Nota Fiscal Paulistana skill provides OpenClaw agents with the capability to manage the full lifecycle of electronic service invoices (NFS-e) for the municipality of São Paulo. It acts as an automated bridge between the user's business operations and the city hall's tax web services. By managing XML SOAP communication, certificate encryption, and RPS (Recibo Provisório de Serviço) sequencing, the skill automates repetitive financial tasks like issuing invoices, canceling erroneous entries, and paginated report extraction for accounting balance sheets.

Installation

To integrate this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/blackcoffee111/nota-fiscal-paulistana. Once installed, the system will initialize a directory structure in workspace/skills/nfse-sp/. Upon the first execution, the agent triggers a built-in Wizard that automates the initial configuration of tax IDs, municipal registration, and environment preparation, ensuring even non-technical users can reach operational status safely.

Use Cases

This skill is ideal for service providers, clinics, and freelancers based in São Paulo who need to maintain tax compliance without manual portal entry. Use it to automatically issue invoices following appointments, batch-cancel incorrect invoices within the legal window, and maintain a historical audit trail of all financial transactions stored within the local workspace.

Example Prompts

1. "Emita uma nota fiscal para o cliente João Silva no valor de 250 reais referente à consulta de hoje usando o tomador salvo no arquivo tomadores.json."
2. "Preciso cancelar a última nota emitida porque o valor estava incorreto, por favor, realize o procedimento de cancelamento."
3. "Gere um relatório consolidado de todas as notas emitidas no último mês para enviar ao meu contador."

Tips & Limitations

Security is paramount; never share your .p12 certificate or the .env password file. Ensure the contador_rps.txt is never manually modified to prevent sequence gaps with the municipality. Remember that the skill requires local network access to communicate with the SOAP API. If you encounter connectivity issues, verify that your certificate has not expired. The skill is designed specifically for São Paulo's municipal system and is not compatible with other cities' NFS-e standards.