Campos mantidos e correspondências gerais no layout Nacional

Com a adoção do layout Nacional da NFS-e, a invoiSys alinhou o JSON de envio às novas estruturas XML da Receita. Este comparativo destaca os campos que se mantiveram inalterados frente aos layouts municipais — além de apresentar um resumo geral das correspondências JSON → XML que orientam o novo modelo de integração.

Os campos abaixo permanecem com a mesma estrutura e finalidade, sendo comuns ao layout Nacional e aos layouts locais:

Dados do tomador (CPF/CNPJ, razão social, endereço e contatos);
Código de tributação municipal (codigoTributacaoMunicipio);
Valor do serviço (servico.valor);
Alíquota do serviço (ISS) (servico.aliquotaServicos e servico.valorISS);
Alíquotas dos tributos federais (PIS, COFINS, IR, CSLL, INSS);
Identificação do intermediário (intermediario);
Dados de construção civil (construcaoCivil).

🧩 De-Para JSON × XML — NFS-e Nacional (DPS)

JSON

XML (tag)

Descrição / Observação

_ambiente

_<tpAmb>

_{Tipo de ambiente (1 = Produção, 2 = Homologação).}

_dhEmissao

_<dhEmi>

_{Data/hora de emissão da NFS-e.}

_serieRPS

_<serie>

_{Série do RPS (referência do documento).}

_numeroRPS

_<nDPS>

_{Número do DPS (RPS).}

_{dhCompetencia}

_<dCompet>

_{Data de competência da prestação.}

_cnpjEmitente

_{<prest><CNPJ>}

_{CNPJ do prestador do serviço.}

_imEmitente

_<prest><IM>

_{Inscrição municipal do prestador.}

_{regimeEspecialTributacao}

_{<prest><regTrib><regEspTrib>}

_{Regime especial de tributação do prestador.}

_regApTribSN

_{<prest><regTrib><regApTribSN>}

_{Regime de apuração no Simples Nacional (quando aplicável).}

_{regimeEspecialTributacaoInvoisys}_/_{tipoDeTributacaoInvoisys}

_{<prest><regTrib><opSimpNac>}

_{Situação do prestador quanto ao Simples Nacional (1 = Reg. Normal, 2 = MEI, 3 = SN não-MEI).}

_cpfTomador_/_cnpjTomador

_<toma><CNPJ>

_{CPF/CNPJ do tomador (dependendo do tipo).}

_imTomador

_<toma><IM>

_{Inscrição municipal do tomador.}

_{nomeRazaoSocialTomador}

_{<toma><xNome>}

_{Razão social / nome do tomador.}

_{codigoMunicipioTomador}

_{<toma><end><endNac><cMun>}

_{Código do município do tomador.}

_cepTomador

_{<toma><end><endNac><CEP>}

_{CEP do tomador.}

_{logradouroTomador}

_{<toma><end><xLgr>}

_{Logradouro do tomador.}

_{numeroEnderecoTomador}

_{<toma><end><nro>}

_{Número do endereço do tomador.}

_{complementoEnderecoTomador}

_{<toma><end><xCpl>}

_{Complemento do endereço.}

_{bairroTomador}

_{<toma><end><xBairro>}

_{Bairro do tomador.}

_{telefoneTomador}

_<toma><fone>

_{Telefone do tomador.}

_emailTomador

_{<toma><email>}

_{E-mail do tomador.}

_{intermediario.cpfCnpj.cnpj}

_{<interm><CNPJ>}

_{CNPJ do intermediário do serviço.}

_{intermediario.inscricaoMunicipal}

_<interm><IM>

_{Inscrição municipal do intermediário.}

_{intermediario.razaoSocial}

_{<interm><xNome>}

_{Nome/Razão social do intermediário.}

_{codigoMunicipioIncidencia}

_{<serv><locPrest><cLocPrestacao>}

_{Código do município de incidência.}

_{cPaisPrestacao}

_{<serv><locPrest><cPaisPrestacao>}

_{Código do país de prestação (quando fora do Brasil).}

_{servico.codigo}

_{<serv><cServ><cTribNac>}

_{Código nacional de tributação do serviço.}

_{codigoTributacaoMunicipio}

_{<serv><cServ><cTribMun>}

_{Código de tributação municipal do serviço. (Enviar o código com 6 números)}

_{discriminacao}

_{<serv><cServ><xDescServ>}

_{Descrição do serviço prestado.}

_servico.cnbs

_{<serv><cServ><cNBS>}

_{Código NBS do serviço.}

_{construcaoCivil.codigoObra}

_{<serv><obra><cObra>}

_{Código da obra (quando aplicável).}

_{construcaoCivil.art}

_{<serv><infoCompl><idDocTec>}

_{ART (Anotação de Responsabilidade Técnica) da obra.}

_docRef

_{<serv><infoCompl><docRef>}

_{Documento de referência (nota anterior, contrato, etc.).}

_observacao

_{<serv><infoCompl><xInfComp>}

_{Observações adicionais da nota.}

_{servico.valor}

_{<valores><vServPrest><vServ>}

_{Valor total dos serviços prestados.}

_{descontoIncondicional}

_{<valores><vDescCondIncond><vDescIncond>}

_{Desconto incondicional sobre o serviço.}

_{descontoCondicional}

_{<valores><vDescCondIncond><vDescCond>}

_{Desconto condicional sobre o serviço.}

_{tipoDeTributacao}_/_{tipoDeTributacaoInvoisys}

_{<valores><trib><tribMun><tribISSQN>}

_{Tipo de tributação municipal (ISS).}

_bm.nbm

_{<valores><trib><tribMun><BM><nBM>}

_{Código NBM do serviço (quando aplicável).}

_bm.vRedBCBM

_{<valores><trib><tribMun><BM><vRedBCBM>}

_{Valor reduzido de base (benefício municipal).}

_issRetido

_{<valores><trib><tribMun><tpRetISSQN>}

_{Tipo de retenção do ISS (1 = não retido, 2 = retido).}

_{servico.cstPisCofins}

_{<valores><trib><tribFed><piscofins><CST>}

_{CST do PIS/COFINS.}

_{servico.valor}

_{<valores><trib><tribFed><piscofins><vBCPisCofins>}

_{Base de cálculo para PIS/COFINS.}

_{servico.aliquotaPIS}

_{<valores><trib><tribFed><piscofins><pAliqPis>}

_{Alíquota do PIS.}

_{servico.aliquotaCOFINS}

_{<valores><trib><tribFed><piscofins><pAliqCofins>}

_{Alíquota do COFINS.}

_{servico.retPisCofins}

_{<valores><trib><tribFed><piscofins><tpRetPisCofins>}

_{Tipo de retenção de PIS/COFINS.}

_{servico.aliquotaINSS}

_{<valores><trib><tribFed><vRetCP>}

_{Percentual de retenção previdenciária (INSS).}

_{servico.aliquotaIR}

_{<valores><trib><tribFed><vRetIRRF>}

_{Percentual de retenção de IRRF.}

_{servico.aliquotaCSLL}

_{<valores><trib><tribFed><vRetCSLL>}

_{Percentual de retenção de CSLL.}

_{totTrib.indTotTrib}

_{<valores><trib><totTrib><indTotTrib>}

_{Indicador de totalização de tributos.}

_{totTrib.pTotTribSN}

_{<valores><trib><totTrib><pTotTribSN>}

_{Percentual total de tributos no Simples Nacional.}

_{totTrib.vTotTrib.vTotTribFed}

_{<valores><trib><totTrib><vTotTrib><vTotTribFed>}

_{Valor total de tributos federais.}

_{totTrib.vTotTrib.vTotTribEst}

_{<valores><trib><totTrib><vTotTrib><vTotTribEst>}

_{Valor total de tributos estaduais.}

_{totTrib.vTotTrib.vTotTribMun}

_{<valores><trib><totTrib><vTotTrib><vTotTribMun>}

_{Valor total de tributos municipais.}

O de-para acima não contempla os campos do grupo ibscbs, embora o schema oficial da NFS-e Nacional já tenha incorporado essas estruturas. Todavia, é imprescindível realizar o mapeamento prévio desses campos, de modo que o payload esteja preparado para o envio assim que o ambiente restrito (teste) for disponibilizado, e de forma obrigatória a partir de janeiro de 2026, quando o envio em produção passará a ser exigido.

Os campos correspondentes ao grupo ibscbs no JSON de envio da invoiSys serão detalhados no próximo tópico.

PreviousNovo grupo referente a tributação do IBS e CBS NextRecebimento 🚚

Last updated 3 days ago

Was this helpful?