Regimes & Operações

Defaults Automáticos

A Brasil NFe preenche automaticamente vários campos que o integrador pode omitir. Entender esses defaults evita retrabalho e inconsistências.

Campos derivados

Campo	Default quando omitido
`DataEmissao` / `dhEmi`	Data/hora atual do servidor (timezone Brasília −03:00).
`DataEntradaSaida`	Igual a `DataEmissao`.
`procEmi`	Fixo em `0` (aplicativo do contribuinte).
`verProc`	Preenchido pela API com o identificador da Brasil NFe como software emissor (`"BrasilNFe x.y.z"`, onde `x.y.z` é a versão atual da plataforma).
`Serie`, `Numero`, `Lote`	Quando omitidos, a API usa a numeração configurada no cadastro da empresa. Quando informados na requisição, a API respeita os valores enviados.
`Transporte` / `ModalidadeFrete`	Quando o bloco `Transporte` não é enviado, a API materializa um `Transporte { ModalidadeFrete = 9 }` (sem frete).
`DataCompetencia` (NFS-e)	Igual a `DataEmissao`.
`TipoAmbiente`	Configuração do cadastro (homologação/produção).
`IEST` (Inscrição Estadual ST do emitente)	Anexada automaticamente quando há IE-ST cadastrada para a UF destino no cadastro da empresa - útil em DIFAL e operações sujeitas a ST interestadual.

Cálculos automáticos

DIFAL (vICMSUFDest, vFCPUFDest, vICMSUFRemet) - calculados automaticamente em operações interestaduais para consumidor final não contribuinte, somente se o emitente está em CRT = 3 e o modo de cálculo do DIFAL configurado para a empresa não estiver em "desabilitado". Veja DIFAL.
IBPT (vTotTrib) - calculado automaticamente pela API a partir da tabela IBPT por NCM quando CalcularIBPT = true na nota e ConsumidorFinal = true. Não é um imposto adicional nem é cobrado do consumidor - é apenas a estimativa do total de tributos (federais, estaduais e municipais) já embutidos no preço, exibida na nota em cumprimento à Lei 12.741/2012 (Lei da Transparência Fiscal). Confusão comum: muitos integradores acham que vTotTrib é um valor a recolher - não é; nada altera no vNF, é apenas informativo.
Totais da nota (vProd, vNF, vBC consolidado) - calculados a partir dos itens.
FCP - aplicado automaticamente para UFs que têm adicional, conforme cadastro de mercadoria.
PIS/COFINS com base no ICMS - apenas para CRT = 3 (Lucro Real/Presumido). Simples e MEI mantêm os valores zerados.

Cuidado

Se precisa de backdating (emitir com data anterior), envie DataEmissao explicitamente - aceita até 30 dias antes da transmissão.
Em emissão manual de séries/numeração, basta enviar Serie, Numero e Lote na requisição - a API usa exatamente o que você manda. Se você omitir, ela cai no que está configurado no cadastro da empresa. Não há nada a "desativar": o comportamento é por chamada.

Ver também

Last modified on April 28, 2026

Numeração e Séries Retenções em NFS-e

Campos derivados

Campo

Default quando omitido

DataEmissao / dhEmi

Data/hora atual do servidor (timezone Brasília −03:00).

DataEntradaSaida

Igual a DataEmissao.

procEmi

Fixo em 0 (aplicativo do contribuinte).

verProc

Preenchido pela API com o identificador da Brasil NFe como software emissor ("BrasilNFe x.y.z", onde x.y.z é a versão atual da plataforma).

Serie, Numero, Lote

Quando omitidos, a API usa a numeração configurada no cadastro da empresa. Quando informados na requisição, a API respeita os valores enviados.

Transporte / ModalidadeFrete

Quando o bloco Transporte não é enviado, a API materializa um Transporte { ModalidadeFrete = 9 } (sem frete).

DataCompetencia (NFS-e)

Igual a DataEmissao.

TipoAmbiente

Configuração do cadastro (homologação/produção).

IEST (Inscrição Estadual ST do emitente)

Anexada automaticamente quando há IE-ST cadastrada para a UF destino no cadastro da empresa - útil em DIFAL e operações sujeitas a ST interestadual.

Cálculos automáticos

DIFAL (vICMSUFDest, vFCPUFDest, vICMSUFRemet) - calculados automaticamente em operações interestaduais para consumidor final não contribuinte, somente se o emitente está em CRT = 3 e o modo de cálculo do DIFAL configurado para a empresa não estiver em "desabilitado". Veja DIFAL.

IBPT (vTotTrib) - calculado automaticamente pela API a partir da tabela IBPT por NCM quando CalcularIBPT = true na nota e ConsumidorFinal = true. Não é um imposto adicional nem é cobrado do consumidor - é apenas a estimativa do total de tributos (federais, estaduais e municipais) já embutidos no preço, exibida na nota em cumprimento à Lei 12.741/2012 (Lei da Transparência Fiscal). Confusão comum: muitos integradores acham que vTotTrib é um valor a recolher - não é; nada altera no vNF, é apenas informativo.

Totais da nota (vProd, vNF, vBC consolidado) - calculados a partir dos itens.

FCP - aplicado automaticamente para UFs que têm adicional, conforme cadastro de mercadoria.

PIS/COFINS com base no ICMS - apenas para CRT = 3 (Lucro Real/Presumido). Simples e MEI mantêm os valores zerados.

Cuidado

Se precisa de backdating (emitir com data anterior), envie DataEmissao explicitamente - aceita até 30 dias antes da transmissão.

Em emissão manual de séries/numeração, basta enviar Serie, Numero e Lote na requisição - a API usa exatamente o que você manda. Se você omitir, ela cai no que está configurado no cadastro da empresa. Não há nada a "desativar": o comportamento é por chamada.