← Back to Skills Marketplace
blackcoffee111

Emissor de Nota Fiscal Paulistana

by Blackcoffee111 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
363
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install nota-fiscal-paulistana
Description
Faturamento NFS-e SP (Emissão e Cancelamento de Notas Fiscais em São Paulo)
Usage Guidance
This package appears to implement the advertised São Paulo NFS-e flows, but review these points before installing or using it with real certificates: 1) The code expects a municipal certificate (.p12) and the NFSE_CERT_PASSWORD env var, but the skill metadata does not declare those — expect to provide a certificate file and a password. 2) SKILL.md instructs the agent to create/modify files (config.json, .env, tomadores.json, contador_rps.txt). If you don't want the agent writing files, do not allow the automated wizard; instead configure files manually. 3) The README advises putting the certificate password into a plaintext .env file — store secrets securely (restrict file permissions, or use a secrets manager) and remove the .env from backups/version control. 4) The SKILL.md references env.example which is not included; verify the setup steps and supply your own .env if needed. 5) The scripts create temp PEM files and write debug/response XML to disk — audit those files for sensitive content and ensure temporary files are removed and access-restricted. 6) Verify dependencies (requests, lxml, signxml, cryptography, python-dotenv) are installed in a controlled environment. Recommended safe steps: test in an isolated environment with a revoked/test certificate; inspect the code yourself (or with a developer) before adding a production certificate; restrict file permissions on the certificate and .env; and avoid letting the agent perform automatic writes if you prefer manual control. If you want, provide me with specific lines or behaviors to inspect further (e.g., confirm absence of external, unexpected network endpoints or detect any code paths that upload files to non-official hosts).
Capability Analysis
Type: OpenClaw Skill Name: nota-fiscal-paulistana Version: 1.0.0 The skill bundle is a legitimate tool designed for managing São Paulo municipal service invoices (NFS-e). It contains Python scripts (emitir_nfse.py, baixar_notas.py, etc.) that interact with the official government API (nfews.prefeitura.sp.gov.br) using standard SOAP and XMLDSig protocols. The SKILL.md instructions implement a user-friendly 'Wizard' for initial setup, which correctly emphasizes security by directing the user to store sensitive certificate passwords in a local .env file rather than sharing them in the chat. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found; the inclusion of ISSSaoPaulo.txt appears to be a non-executable reference to the ACBr open-source library.
Capability Assessment
Purpose & Capability
The code and SKILL.md implement São Paulo NFS-e operations (issue, cancel, download) and call official prefeitura endpoints — this matches the name/description. However the registry metadata declares no required env vars or config paths while the code and docs clearly expect a certificate file (a .p12) and the NFSE_CERT_PASSWORD environment variable / .env file. Also SKILL.md references an env.example template that is not present in the file manifest. These mismatches are disproportionate to the stated metadata and may lead to unexpected behavior.
Instruction Scope
SKILL.md instructs the agent to read and write workspace files (config.json, tomadores.json, contador_rps.txt), create/rename a hidden .env, and autonomously populate config.json after an interactive wizard. Asking the agent to create hidden files and write configuration and to instruct the user how to paste secret passwords into .env is within the functional scope of setup, but grants the agent broad filesystem-write actions and handling of secrets — more scope than what the registry metadata declares and something users should explicitly consent to.
Install Mechanism
This is an instruction-and-code bundle with no install spec (lowest installation risk). The Python scripts require third-party libraries (requests, signxml, cryptography, lxml, python-dotenv) but the package makes no installation or dependency instructions in the registry metadata — the absence of an install spec is plausible but incomplete; the user must ensure the runtime has the required packages.
Credentials
The skill requests/uses sensitive artefacts: a municipal certificate file (.p12) and the NFSE_CERT_PASSWORD environment variable (read via dotenv and os.environ). Yet the registry metadata lists no required environment variables or config paths. Storing the password in a plaintext .env file (as instructed) is insecure unless file permissions are hardened. The number and sensitivity of required secrets are proportionate to the functionality, but the missing declarations and the plaintext .env guidance are concerning.
Persistence & Privilege
always is false and the skill is user-invocable; autonomous invocation is allowed and used by the SKILL.md (e.g., the wizard that writes config.json). The skill modifies files within its own workspace (normal) and creates temporary PEM files when making TLS client-authenticated requests (expected). This is acceptable for the purpose but the combination of autonomous file writes + secret handling + invoking other skills (e.g., the 'GOG' e-mail skill) increases the blast radius and should be considered by the user.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install nota-fiscal-paulistana
  3. After installation, invoke the skill by name or use /nota-fiscal-paulistana
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Lançamento Oficial v1.0.0: Módulo completo de faturamento financeiro para a cidade de São Paulo. Inclui assistente de instalação (Auto-Wizard interativo), emissor, cancelamento autônomo via API e motor de paginação inteligente de relatórios contábeis para fechamento do mês.
Metadata
Slug nota-fiscal-paulistana
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Emissor de Nota Fiscal Paulistana?

Faturamento NFS-e SP (Emissão e Cancelamento de Notas Fiscais em São Paulo). It is an AI Agent Skill for Claude Code / OpenClaw, with 363 downloads so far.

How do I install Emissor de Nota Fiscal Paulistana?

Run "/install nota-fiscal-paulistana" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Emissor de Nota Fiscal Paulistana free?

Yes, Emissor de Nota Fiscal Paulistana is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Emissor de Nota Fiscal Paulistana support?

Emissor de Nota Fiscal Paulistana is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Emissor de Nota Fiscal Paulistana?

It is built and maintained by Blackcoffee111 (@blackcoffee111); the current version is v1.0.0.

💬 Comments