OdooWiki OCA HUB

NFS-e (Nota Paulistana)

l10n_br_nfse_paulistana folder_open OCA/l10n-brazil open_in_new
Uncategorised License: AGPL-3

Esse módulo completa o documento criado pelo l10n_br_nfse para permite a criação e transmissão de Notas Fiscais de Serviço Eletrônicas (NFS-e) pelo sistema Nota Paulistana.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Lets companies in São Paulo issue and transmit electronic service invoices (NFS-e) through the city's Nota Paulistana system, and adds a button to open the official city PDF of the invoice.

This module connects Odoo's fiscal documents to the São Paulo city hall electronic service invoice system (Nota Paulistana). It is meant for companies registered in the city of São Paulo that issue service invoices.

What users can do: - Send service invoices (NFS-e) electronically to the city system and receive the invoice number, authorization date and verification code back into Odoo. - Check the status of a sent invoice by querying the city system, which can update the document to authorized or rejected and record error messages returned by the city. - Cancel an authorized invoice directly from Odoo; the cancellation is sent to the city and a cancellation event with the returned file is stored on the document. - Open the official invoice PDF on the São Paulo city hall website from a button on the fiscal document form, shown only for authorized or cancelled Paulistana invoices.

Where it appears: - On the fiscal document form, a button "Visualizar NFSe Paulistana" opens the city PDF. The standard PDF button is hidden for these invoices when the company is set to use the city hall PDF. - In company settings, a new provider option "Paulistana" for NFS-e and a checkbox to use the city hall PDF instead of Odoo's own PDF.

Business rules and automation: - The module only acts on service invoices processed by Odoo's own fiscal processor and when the company's NFS-e provider is set to Paulistana. - The city PDF link is built only when the invoice has a number, the company's municipal registration and a verification code. - The invoice is treated as a Paulistana invoice when it is a service document, the company is located in São Paulo and the city PDF option is enabled.

It extends the fiscal document (l10n_br_fiscal.document) and company (res.company) models.

Depends on

Models and fields (2)
  • res.company · extends an existing modelprovedor_nfse, nfse_use_city_pdf (Use City Hall PDF for NFSe Paulistana)
  • l10n_br_fiscal.document · extends an existing modelis_nfse_paulistana (Is NFSe Paulistana?), url_nfse_paulistana (URL of NFSe Paulistana)

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 6 confirmed, 3 with no information of 9 versions.

Sources · Odoo 17.0

Confirmed on 2026-11-03 in branch 17.0 of OCA/l10n-brazil.

terminal Installation and usage

OCA documentation · Odoo 18.0
  • Este módulo tem uma depedencia do pacote python erpbrasil.edoc
  • Este módulo tem uma depedencia do pacote python erpbrasil.assinatura
  • Este módulo tem uma depedencia do pacote python erpbrasil.transmissao
  • Este módulo tem uma depedencia do pacote python erpbrasil.base
  • Este módulo tem uma depedencia do pacote python nfselib.paulistana
  • Este módulo tem uma depedencia do pacote python unidecode

Após a instalação do módulo deve ser configurado na empresa o processador de documentos eletrônicos como erpbrasil.edoc.

Após ser criado uma Nota Fiscal de Serviço Eletrônicas (NFS-e) é possível confirmá-la e transmiti-la.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.