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
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:

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 »
calculadora sob uma mesa com papéis com anotações.
Nota Fiscal
Welker Zigante

O que é DIFAL do ICMS? Entenda como funciona e quem paga!

O termo Diferencial de Alíquota (DIFAL) se refere ao recolhimento do ICMS (Imposto sobre Circulação de Mercadorias e Serviços) e busca promover equidade tributária entre os estados brasileiros.

Empreendedores como proprietários de e-commerces que realizam compras fora do estado e vendem para consumidores finais, precisam considerar as variações nas alíquotas do ICMS entre os estados.

Logo, dada a complexidade dessa legislação, compreender o que é e como funciona o DIFAL pode ser desafiador, especialmente devido às diferentes alíquotas e leis em cada um dos 26 estados e no Distrito Federal relacionadas ao ICMS e aos produtos e serviços tributados.

Acompanhe o nosso post de hoje e compreenda melhor esse processo.

Leia mais »