NFS-e

Machine translation, not yet reviewed.

NFS-e São Paulo municipal — unmapped fields

Fields of the national NFS-e JSON that are always null in inbound documents from the São Paulo City Hall, because the municipal layout does not provide the equivalent information…

Fields of the national NFS-e JSON that are always null in inbound documents from the São Paulo City Hall (Prefeitura de São Paulo), because the municipal layout does not provide the equivalent information.


1. Root (infNFSe)

FieldDescription
xTribNacDescription of the national ISSQN taxation code
xOutInfAdditional information for use by the municipal tax administration

2. Issuer

FieldDescription
emit.xFantIssuer's trade name
emit.foneIssuer's phone number

3. NFS-e values

FieldDescription
valores.tpBMMunicipal benefit type
valores.vCalcBMMunicipal benefit calculation amount

4. IBS/CBS (Complementary Return)

FieldDescription
ibscbs.pRedutorRate reduction percentage in government purchases

5. DPS

FieldDescription
cMotivoEmisTIReason for issuance at the initiative of the recipient/intermediary
chNFSeRejKey of the rejected NFS-e being replaced
substSubstitution group (key, reason and description)

5.1. Provider

FieldDescription
prest.caepfCadastro de Atividade Econômica da Pessoa Física (Individual Economic Activity Registry)
prest.foneProvider's phone number
prest.regTrib.regApTribSNSimples Nacional tax assessment regime

5.2. Recipient / Intermediary

FieldDescription
toma.caepf / interm.caepfCadastro de Atividade Econômica da Pessoa Física (Individual Economic Activity Registry)
toma.fone / interm.fonePhone number
interm.endIntermediary's address (SP does not provide it)

5.3. Service

FieldDescription
serv.cServ.cTribNacNational taxation code
serv.cServ.cIntContribTaxpayer's internal code
serv.comExtForeign trade group (mode of provision, currency, MDIC, etc.)
serv.atvEventoEvent activity group (name, dates, address)
serv.infoComplAdditional information group (DRT, order, reference)
serv.obra.inscImobFiscFiscal real estate registration of the construction project
serv.obra.endConstruction site address

5.4. Values

FieldDescription
valores.vDescCondIncondConditional and unconditional discounts group
valores.vDedRed.documentosSupporting documents for deduction/reduction

5.5. Municipal Taxation

FieldDescription
valores.trib.tribMun.cPaisResultCode of the country where the service result occurs
valores.trib.tribMun.bmMunicipal benefit group (number, reduction)

5.6. Federal Taxation — Complementary PIS/COFINS fields

The values pisCofins.cst, pisCofins.vPis and pisCofins.vCofins are mapped. The fields below are not filled in because SP does not provide the complementary data:

FieldDescription
valores.trib.tribFed.pisCofins.vBCPisCofinsPIS/COFINS tax base
valores.trib.tribFed.pisCofins.pAliqPisPIS rate
valores.trib.tribFed.pisCofins.pAliqCofinsCOFINS rate
valores.trib.tribFed.pisCofins.tpRetPisCofinsPIS/COFINS withholding type

5.7. Total Tax Burden

FieldDescription
valores.trib.totTrib.pTotTribTotal tax burden as a percentage (federal, state, municipal)
valores.trib.totTrib.pTotTribSNSimples Nacional tax burden percentage

5.8. IBS/CBS (DPS)

FieldDescription
ibscbs.gRefNFSeReferenced NFS-e keys
ibscbs.destRecipient group (CNPJ/CPF, name, address)
ibscbs.imovelProperty/construction project group (registration, CCIB, address)

5.8.1. IBS/CBS values

FieldDescription
ibscbs.valores.gReeRepResReimbursement/pass-through/refund documents group
ibscbs.valores.trib.gIBSCBS.cstIBS/CBS Tax Situation Code
ibscbs.valores.trib.gIBSCBS.cCredPresPresumed credit code
ibscbs.valores.trib.gIBSCBS.gTribRegularRegular taxation group (CST and classification)
ibscbs.valores.trib.gIBSCBS.gDifDeferral group (UF, Mun and CBS percentages)

On this page