São Paulo NFSe: UI-API field mapping

Egon Hilgenstieler

If you just want to manually send an NFSe please check this post. In this article you can see the corresponce between the interface fields (in english) and API fields (in portuguese).

Conteúdo

If you just want to manually send an NFSe please check this post. In this article you can see the corresponce between the interface fields (in english) and API fields (in portuguese).

Customer fields

Identification tab:

Interface fieldAPI field
Nametomador > razao_social
CNPJtomador > cnpj
CPFtomador > cpf
State tax idtomador > inscricao_estadual
Municipal tax idtomador > inscricao_municipal (only used if the customer resides in São Paulo)
SUFRAMA tax idnot used

Address tab:

Interface fieldAPI field
Street nametomador > endereco > logradouro
Numbertomador > endereco > numero
Complementtomador > endereco > complemento
Zip codetomador > endereco > cep
Countrynot used
Citytomador > endereco > codigo_municipio (IBGE equivalent code)
Neighborhoodtomador > endereco > bairro

Contacts tab:

Interface fieldAPI field
Phonetomador > telefone
E-mailtomador > email

NFSe fields

Interface fieldAPI field
Issuerprestador and all of it’s fields (filled automatically)
Customertomador and all of it’s fields
Issued atdata_emissao
Fiscal naturenatureza_operacao
Service codeservico > item_lista_servico
tax rateservico > aliquota
Descriptionservico > discriminacao
Withheld ISS taxservico > iss_retido
Service valueservico > valor_servicos
Value of all deductionsservico > valor_deducoes
Picture of Egon Hilgenstieler

Egon Hilgenstieler

CTO e cofundador do Focus NFe, desenvolvedor, professor de yoga e praticante de meditação. Enquanto não está programando, procura a resposta para a vida, para o universo e para tudo mais.

Inscreva-se em nossa newsletter​

Receba nossos conteúdos exclusivos em primeira mão.

Explore outros conteúdos:

decreto-n-599-2023
Nota Fiscal
Ludmila Ferreira

Decreto n° 599/2023: novas regras de pagamento da NFe e NFCe

O Decreto n.º 599/2023, publicado em 28 de novembro de 2023 no Diário Oficial do Mato Grosso, introduz na legislação estadual a obrigatoriedade de vinculação dos pagamentos eletrônicos ao programa emissor da Nota Fiscal Eletrônica (NF-e) e Nota Fiscal do Consumidor Eletrônica (NFC-e).

Conforme o Portal da Transparência de Mato Grosso, com o avanço das tecnologias aplicadas ao comércio, principalmente aquelas que concernem aos pagamentos eletrônicos, permite-se que os sistemas emissores e APIs de documentos fiscais (NF-e) possam se integrar a diversos meios de pagamento eletrônico.

Por este motivo, trazemos explicações sobre o Decreto n.º 599/2023, suas alterações, quem deve aderir às suas regras e prazo de se adequar à obrigatoriedade disposta no Decreto.

Leia mais »
O que é GNRE? Saiba quem precisa emitir e como gerar!
Nota Fiscal
Douglas Pinheiro

GNR-e: o que é, quem precisa emitir e como gerar

Durante operações de transporte interestaduais, determinados documentos são necessários, e a GNRE é um deles.
Assim como outros documentos, a exemplo do Conhecimento de Transporte Eletrônico (CTe), a Guia Nacional de Recolhimento de Tributos Estaduais (GNRE) deve estar presente junto à mercadoria durante o processo de carga, pois a ausência dela pode gerar complicações para a empresa transportadora.
Quer saber mais? Confira o artigo de hoje! Nele, falamos o que é a GNRE, qual a sua importância, como gerá-la e outras informações relevantes.

Leia mais »