Skip to main content
Key: br-nfse-v1 Module: github.com/invopop/gobl.br.nfse

Extensions

CNAE code

The CNAE (National Classification of Economic Activities) code for a service. List of codes from the IBGE (Brazilian Institute of Geography and Statistics):
Pattern: ^\d{2}[\s\.\-\/]?\d{2}[\s\.\-\/]?\d[\s\.\-\/]?\d{2}$

NBS code

The NBS (Nomenclatura Brasileira de Serviços, Intangíveis e outras Operações que produzam Variações no Patrimônio) code for a service. NBS is the Brazilian classification system for services and intangibles, established by Decreto No. 7.708/2012 and maintained by the MDIC (Ministério do Desenvolvimento, Indústria, Comércio e Serviços). Official list of codes from the MDIC:
Pattern: ^\d[\.\s]?\d{4}[\.\s]?\d{2}[\.\s]?\d{2}$

Fiscal Incentive

Indicates whether a party benefits from a fiscal incentive.

ISS Liability

Indicates the ISS liability status, i.e., whether the ISS tax is due or not and why. List of codes from the national NFSe ABRASF (v2.04) model:

ISS Immunity

The constitutional immunity that applies when the ISS of a service is immune, that is, when the ISS tax combo has the br-nfse-iss-liability code 5. Maps to the tpImunidade field in the NFS-e national layout.

Service Code

The service code as defined by the municipality. Typically, one of the codes listed in the Lei Complementar 116/2003, but municipalities can make their own changes. For further details on the list of possible codes, see: For suppliers issuing through the NFS-e Nacional, the 6-digit national service code instead, which maps to the cTribNac field in the national layout. List of possible values:

Opting for “Simples Nacional” regime

Indicates whether a party is opting for the “Simples Nacional” (Regime Especial Unificado de Arrecadação de Tributos e Contribuições devidos pelas Microempresas e Empresas de Pequeno Porte) tax regime

Simples Nacional Tax Assessment Regime

How a supplier opting for the Simples Nacional as ME/EPP pays its federal taxes and ISS, which changes when it exceeds a Simples Nacional sublimit or limit. On the national system, required for ME/EPP suppliers and not allowed for any other. Maps to the regApTribSN field in the NFS-e national layout.

Special Tax Regime

Indicates a special tax regime that a party is subject to.

Operation Indicator

Indicates the operation type for the determination of the IBS and CBS taxes by the tax authorities. Maps to the cIndOp field in the NFS-e national layout. List of possible values:
Pattern: ^\d{6}$

Tax Status Code (CST)

Indicates the tax status of the operation for the determination of the IBS and CBS taxes by the tax authorities. Maps to the CST field in the NFS-e national layout. List of possible values:
Pattern: ^\d{3}$

Tax Classification Code

Indicates the tax classification code for the determination of the IBS and CBS taxes by the tax authorities. Maps to the cClassTrib field in the NFS-e national layout. List of possible values:
Pattern: ^\d{6}$

Supply Mode

How a service exported or imported was supplied. Maps to the mdPrestacao field in the NFS-e national layout.

Relationship Between Parties

Relationship between the supplier and the foreign customer, as defined in art. 23 of Law 9.430/1996. Maps to the vincPrest field in the NFS-e national layout.

Total Tax Estimate

Identifies an informative charge holding the approximate percentage of the taxes included in the price, as required by Law 12.741/2012. Either the Simples Nacional one or the federal, state and municipal ones. Maps to the totTrib group in the NFS-e national layout.

Validation Rules

Validation rules check each struct against a set of assertions and report any failures with a unique code and message. Read more about validation.