v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB
NFSe Nacional Recebidas

Consulta em formato JSON

Este endpoint retorna os dados de uma nota fiscal específica em formato json. Como retorno você receberá os campos descritos nos exemplos, de acordo com o status da nota.

get/nfsens_recebidas/{chave}.json

Path parameters

chavestring required

Chave de acesso da NFS-e Nacional

Example:10690212345678000123000000000023025115480913123

Response

Requisição processada com sucesso

versao_nfsestring

Versão do layout da NFS-e

id_tagstring

Identificador interno da tag da NFS-e

descricao_municipio_emissorstring

Nome do município emissor da NFS-e

descricao_municipio_prestacaostring

Nome do município onde o serviço foi prestado

numerostring

Número identificador da NFS-e

codigo_municipio_incidenciastring

Código IBGE do município de incidência do ISS

descricao_municipio_incidenciastring

Nome do município de incidência do ISS

descricao_tributacao_nacionalstring

Descrição da tributação nacional aplicada

descricao_tributacao_municipalstring

Descrição da tributação municipal aplicada

descricao_nbsstring

Descrição do código NBS do serviço

versao_aplicacao_nfsestring

Versão da aplicação emissora da NFS-e

ambiente_geradorstring

Ambiente de geração da NFS-e

tipo_emissaostring

Tipo de emissão da NFS-e

processo_emissaostring

Processo utilizado para emissão da NFS-e

status_mensagemstring

Status da mensagem de processamento da NFS-e

data_processostring date-time

Data e hora do processamento da NFS-e

numero_dfsestring

Número do documento fiscal de serviços eletrônicos

cnpj_emitentestring

CNPJ do emitente da NFS-e

cpf_emitentestring

CPF do emitente quando pessoa física

inscricao_municipal_emitentestring

Inscrição municipal do emitente

razao_social_emitentestring

Razão social do emitente

nome_fantasia_emitentestring

Nome fantasia do emitente

logradouro_emitentestring

Logradouro do endereço do emitente

numero_emitentestring

Número do endereço do emitente

complemento_emitentestring

Complemento do endereço do emitente

bairro_emitentestring

Bairro do emitente

codigo_municipio_emitentestring

Código IBGE do município do emitente

uf_emitentestring

Unidade federativa do emitente

cep_emitentestring

CEP do emitente

telefone_emitentestring

Telefone de contato do emitente

email_emitentestring email

E-mail do emitente

outras_informacoesstring

Outras informações adicionais da NFS-e

valor_deducao_issnumber double

Valor de dedução aplicado ao ISS

tipo_beneficio_municipalstring

Tipo de benefício fiscal municipal aplicado

valor_deducao_beneficio_municipalnumber double

Valor da dedução referente ao benefício municipal

iss_base_calculonumber double

Base de cálculo do ISS

iss_aliquotanumber double

Alíquota do ISS aplicada

iss_valornumber double

Valor do ISS calculado

valor_total_retencaonumber double

Valor total das retenções

valor_liquidonumber double

Valor líquido da NFS-e

ibs_cbs_codigo_municipio_incidenciastring

Código IBGE da localidade de incidência do IBS/CBS (local da operação)

ibs_cbs_descricao_municipio_incidenciastring

Nome da localidade de incidência do IBS/CBS

perc_reducao_aliquota_compra_governamentalnumber double

Percentual de redução de alíquota em compra governamental

ibs_cbs_base_calculonumber double

Base de cálculo do IBS/CBS antes das reduções para cálculo do tributo bruto

valor_repassenumber double

Valor monetário (R$) total relativo ao fornecimento próprio de bens materiais ou relacionados a operações de terceiros, objeto de reembolso, repasse ou ressarcimento pelo recebedor

ibs_uf_aliquotanumber double

Alíquota da UF para IBS da localidade de incidência parametrizada no sistema

ibs_uf_percentual_reducao_aliquotanumber double

Percentual de redução de alíquota municipal

ibs_uf_aliquota_efetivanumber double

Alíquota Efetiva do IBS de competência das UF que será aplicada a base de cálculo

ibs_mun_aliquotanumber double

Alíquota do Município para IBS da localidade de incidência parametrizada no sistema

ibs_mun_percentual_reducao_aliquotanumber double

Percentual de redução de alíquota municipal

ibs_mun_aliquota_efetivanumber double

Alíquota Efetiva do IBS de competência das UF que será aplicada a base de cálculo

cbs_aliquotanumber double

Alíquota da União para CBS parametrizada no sistema

cbs_percentual_reducao_aliquotanumber double

Percentual de redução de alíquota da CBS

cbs_aliquota_efetivanumber double

Alíquota Efetiva da CBS que será aplicada a base de cálculo

ibs_cbs_valor_totalnumber double

Valor Total da NF considerando os impostos por fora IBS e CBS

ibs_valor_totalnumber double

Valor total do IBS

ibs_percentual_credito_presumidonumber double

Percentual de crédito presumido para o IBS

ibs_valor_credito_presumidonumber double

Valor do crédito presumido para o IBS

ibs_uf_valor_diferimentonumber double

Total do Diferimento do IBS estadual

ibs_uf_valornumber double

Total valor do IBS estadual

ibs_mun_valor_diferimentonumber double

Total do Diferimento do IBS municipal

ibs_mun_valornumber double

Total valor do IBS municipal

cbs_percentual_credito_presumidonumber double

Alíquota do crédito presumido para a CBS

cbs_valor_credito_presumidonumber double

Valor do crédito presumido para a CBS

cbs_valor_diferimentonumber double

Total do Diferimento da CBS

cbs_valornumber double

Total valor da CBS da União

ibs_uf_aliquota_efetiva_regularnumber double

Alíquota efetiva de tributação regular do IBS estadual

ibs_uf_valor_regularnumber double

Valor da tributação regular do IBS estadual

ibs_mun_aliquota_efetiva_regularnumber double

Alíquota efetiva de tributação regular do IBS municipal

ibs_mun_valor_regularnumber double

Valor da tributação regular do IBS municipal

cbs_aliquota_efetiva_regularnumber double

Alíquota efetiva de tributação regular da CBS

cbs_valor_regularnumber double

Valor da tributação regular da CBS

ibs_uf_aliquota_governamentalnumber double

(Compras Governamentais) Alíquota do IBS de competência do Estado

ibs_uf_valor_governamentalnumber double

(Compras Governamentais) Valor do Tributo do IBS da UF calculado

ibs_mun_aliquota_governamentalnumber double

(Compras Governamentais) Alíquota do IBS de competência do Município

ibs_mun_valor_governamentalnumber double

(Compras Governamentais) Valor do Tributo do IBS do Município calculado

cbs_aliquota_governamentalnumber double

(Compras Governamentais) Alíquota da CBS

cbs_valor_governamentalnumber double

(Compras Governamentais) Valor do Tributo da CBS calculado

versao_dpsstring

Versão do layout do DPS (Documento de Prestação de Serviço)

id_dpsstring

Identificador do DPS

ambientestring

Ambiente de emissão do DPS

data_emissaostring date-time

Data e hora de emissão da NFS-e

versao_aplicacao_dpsstring

Versão da aplicação emissora do DPS

serie_dpsstring

Série do DPS

numero_dpsstring

Número do DPS

data_competenciastring date

Data de competência da prestação do serviço

emitente_dpsstring

Identificação do emitente do DPS

codigo_municipio_emissorastring

Código IBGE do município emissor

chave_nfse_substituidastring

Chave da NFS-e substituída

codigo_justificativa_substituicaostring

Código da justificativa da substituição

motivo_substituicaostring

Motivo da substituição da NFS-e

cnpj_prestadorstring

CNPJ do prestador do serviço

cpf_prestadorstring

CPF do prestador quando pessoa física

nif_prestadorstring

Número de Identificação Fiscal fornecido por órgão de administração tributária no exterior

motivo_ausencia_nif_prestadorstring

Motivo da ausência de NIF do prestador

caepf_prestadorstring

Número do Cadastro de Atividade Econômica da Pessoa Física (CAEPF) do prestador do serviço

inscricao_municipal_prestadorstring

Inscrição municipal do prestador

razao_social_prestadorstring

Razão social do prestador

codigo_municipio_prestadorstring

Código IBGE do município do prestador

cep_prestadorstring

CEP do prestador

codigo_pais_ext_prestadorstring

Código do país do endereço do prestador do serviço (Tabela de Países ISO)

cep_ext_prestadorstring

Código alfanumérico do Endereçamento Postal no exterior do prestador do serviço

nome_cidade_ext_prestadorstring

Cidade do prestador no exterior

regiao_ext_prestadorstring

Estado, província ou região da cidade no exterior do prestador do serviço

logradouro_prestadorstring

Tipo e nome do logradouro do endereço do prestador do serviço

numero_prestadorstring

Número do endereço do prestador

complemento_prestadorstring

Complemento do endereço do prestador

bairro_prestadorstring

Bairro do prestador

telefone_prestadorstring

Telefone do prestador

email_prestadorstring email

E-mail do prestador

codigo_opcao_simples_nacionalstring

Código de opção pelo Simples Nacional

regime_tributario_simples_nacionalstring

Regime tributário do Simples Nacional

regime_especial_tributacaostring

Regime especial de tributação

cnpj_tomadorstring

CNPJ do tomador do serviço

cpf_tomadorstring

CPF do tomador quando pessoa física

nif_tomadorstring

Número de Identificação Fiscal fornecido por órgão de administração tributária no exterior

motivo_ausencia_nif_tomadorstring

Motivo da ausência de NIF do tomador

caepf_tomadorstring

Número do Cadastro de Atividade Econômica da Pessoa Física (CAEPF) do tomador do serviço

inscricao_municipal_tomadorstring

Inscrição municipal do tomador

razao_social_tomadorstring

Nome / Razão Social do tomador

codigo_municipio_tomadorstring

Código IBGE do município do tomador

cep_tomadorstring

CEP do tomador

codigo_pais_ext_tomadorstring

Código do país do endereço do tomador do serviço (Tabela de Países ISO)

cep_ext_tomadorstring

Código alfanumérico do Endereçamento Postal no exterior do tomador do serviço

nome_cidade_ext_tomadorstring

Nome da cidade do tomador no exterior

regiao_ext_tomadorstring

Estado, província ou região da cidade no exterior do tomador do serviço

logradouro_tomadorstring

Tipo e nome do logradouro do endereço do tomador do serviço

numero_tomadorstring

Número do endereço do tomador

complemento_tomadorstring

Complemento do endereço do tomador

bairro_tomadorstring

Bairro do tomador do serviço

telefone_tomadorstring

Telefone de contato do tomador

email_tomadorstring email

Endereço de e-mail do tomador

cnpj_intermediariostring

CNPJ do intermediário do serviço

cpf_intermediariostring

CPF do intermediário quando pessoa física

nif_intermediariostring

Número de Identificação Fiscal fornecido por órgão de administração tributária no exterior

motivo_ausencia_nif_intermediariostring

Motivo da ausência do NIF do intermediário

caepf_intermediariostring

Número do Cadastro de Atividade Econômica da Pessoa Física (CAEPF) do intermediario do serviço

inscricao_municipal_intermediariostring

Inscrição municipal do intermediário

razao_social_intermediariostring

Nome / Razão Social do intermediario

codigo_municipio_intermediariostring

Código IBGE do município do intermediário

cep_intermediariostring

CEP do endereço do intermediário

codigo_pais_ext_intermediariostring

Código do país do endereço do intermediario do serviço (Tabela de Países ISO)

cep_ext_intermediariostring

Código alfanumérico do Endereçamento Postal no exterior do intermediario do serviço

nome_cidade_ext_intermediariostring

Nome da cidade do intermediário no exterior

regiao_ext_intermediariostring

Estado, província ou região da cidade no exterior do intermediario do serviço

logradouro_intermediariostring

Tipo e nome dogradouro do endereço do intermediário

numero_intermediariostring

Número do endereço do intermediário

complemento_intermediariostring

Complemento do endereço do intermediário

bairro_intermediariostring

Bairro do intermediário

telefone_intermediariostring

Telefone de contato do intermediário

email_intermediariostring email

Endereço de e-mail do intermediário

codigo_municipio_prestacaostring

Código IBGE do município onde o serviço foi prestado

codigo_pais_prestacaostring

Código do país onde o serviço foi prestado

codigo_pais_consumo_servicostring

Código do país onde ocorreu a prestação do serviço(Tabela de Países ISO)

codigo_tributacao_nacional_issstring

Código de tributação nacional do ISSQN

codigo_tributacao_municipal_issstring

Código de tributação municipal do ISSQN

descricao_servicostring

Descrição detalhada do serviço prestado

codigo_nbsstring

Código NBS (Nomenclatura Brasileira de Serviços)

codigo_interno_contribuintestring

Código interno do contribuinte

modo_prestacaostring

Modo de Prestação

vinculo_negociostring

Vínculo entre as partes no negócio

codigo_moedastring

Identifica a moeda da transação comercial

valor_servico_extnumber double

Valor do serviço prestado expresso em moeda estrangeira

mecanismo_comercio_ext_prestadorstring

Mecanismo de comércio exterior aplicado ao prestador

mecanismo_comercio_ext_tomadorstring

Mecanismo de comércio exterior aplicado ao tomador

movimentacao_temporaria_bensstring

Vínculo da Operação à Movimentação Temporária de Bens

numero_declaracao_importacaostring

Número da Declaração de Importação (DI/DSI/DA/DRI-E) averbado

numero_registro_exportacaostring

Número do Registro de Exportação (RE) averbado

mdicstring

Indicador se a NFS-e deverá ser disponibilizada ao MDIC

inscricao_imobiliariastring

Inscrição imobiliária fiscal (código fornecido pela Prefeitura Municipal para a identificação da obra ou para fins de recolhimento do IPTU)

codigo_obrastring

Número de identificação da obra. Cadastro Nacional de Obras (CNO) ou Cadastro Específico do INSS (CEI)

cep_obrastring

Código de Endereçamento Postal numérico do endereço nacional da obra

cep_ext_obrastring

Código de Endereçamento Postal alfanumérico do endereço no exterior da obra

nome_cidade_ext_obrastring

Nome da cidade no exterior, local da obra

regiao_ext_obrastring

Estado, província ou região da cidade no exterior, local da obra

logradouro_obrastring

Tipo e nome do logradouro do endereço da obra

numero_obrastring

Número do endereço da obra

complemento_obrastring

Complemento do endereço da obra

bairro_obrastring

Bairro da localização da obra

nome_eventostring

Nome do evento Artístico, Cultural, Esportivo, ...

data_inicio_eventostring date

Data de início do evento

data_fim_eventostring date

Data de término do evento

codigo_eventostring

Código identificador do evento

cep_eventostring

Código de Endereçamento Postal numérico do endereço nacional da atividade de evento

cep_ext_eventostring

Código de Endereçamento Postal alfanumérico do endereço no exterior da atividade de evento

nome_cidade_ext_eventostring

Nome da cidade no exterior, local da atividade de evento

regiao_ext_eventostring

Estado, província ou região da cidade no exterior, local da atividade de evento

logradouro_eventostring

Tipo e nome do logradouro do endereço da atividade de evento

numero_eventostring

Número no logradouro do endereço da atividade de evento

complemento_eventostring

Complemento do endereço da atividade de evento

bairro_eventostring

Bairro do endereço da atividade de evento

codigo_documento_tecnicostring

Identificador de Documento de Responsabilidade Técnica - ART, RRT, DRT, Outros.

documento_referenciastring

Chave da nota, número identificador da nota, número do contrato ou outro identificador de documento emitido pelo prestador de serviços, que subsidia a emissão dessa nota pelo tomador do serviço ou intermediário (preenchimento obrigatório caso a nota esteja sendo emitida pelo Tomador ou intermediário do serviço)

informacoes_complementaresstring

Campo livre para preenchimento pelo contribuinte

valor_recebido_intermediarionumber double

Valor monetário recebido pelo intermediário do serviço (R$)

valor_serviconumber double

Valor monetário do serviço (R$)

desconto_incondicionadonumber double

Valor monetário do desconto incondicionado (R$)

desconto_condicionadonumber double

Valor monetário do desconto condicionado (R$)

percentual_deducao_serviconumber double

Valor percentual padrão para dedução/redução do valor do serviço

valor_deducao_serviconumber double

Valor monetário padrão para dedução/redução do valor do serviço

tributacao_issstring

Tipo de tributação do ISS aplicada ao serviço

codigo_pais_exportacaostring

Código do país onde se verficou o resultado da prestação do serviço para o caso de Exportação de Serviço(Tabela de Países ISO)

numero_beneficio_municipalstring

Identificador do benefício municipal parametrizado pelo município

valor_reducao_base_calculonumber double

Valor monetário (R$) informado pelo emitente para redução da base de cálculo (BC) do ISSQN devido a um Benefício Municipal (BM)

percentual_reducao_base_calculonumber double

Valor percentual (%) informado pelo emitente para redução da base de cálculo (BC) do ISSQN devido a um Benefício Municipal (BM)

tipo_exigibilidade_suspensaostring

Opção para Exigibilidade Suspensa

numero_processo_suspensaostring

Número do processo judicial ou administrativo de suspensão da exigibilidade

tipo_imunidadestring

Tipos de Imunidades

tipo_retencao_issstring

Tipo de retencao do ISSQN

percentual_aliquota_relativa_municipionumber double

Valor da alíquota (%) do serviço prestado relativo ao município sujeito ativo (município de incidência) do ISSQN. Se o município de incidência pertence ao Sistema Nacional NFS-e a alíquota estará parametrizada e, portanto, será fornecida pelo sistema. Se o município de incidência não pertence ao Sistema Nacional NFS-e a alíquota não estará parametrizada e, por isso, deverá ser fornecida pelo emitente

situacao_tributaria_pis_cofinsstring

Código de Situação Tributária do PIS/COFINS (CST)

base_calculo_pis_cofinsnumber double

Valor da Base de Cálculo do PIS/COFINS (R$)

aliquota_pisnumber double

Valor da Alíquota do PIS (%)

aliquota_cofinsnumber double

Valor da Alíquota da COFINS (%)

valor_pisnumber double

Valor monetário do PIS (R$)

valor_cofinsnumber double

Valor monetário do COFINS (R$)

tipo_retencao_pis_cofinsstring

Tipo de retencao do Pis/Cofins

valor_cpnumber double

Valor monetário do CP(R$)

valor_irrfnumber double

Valor monetário do IRRF (R$)

valor_csllnumber double

Valor monetário do CSLL (R$)

valor_total_tributos_federaisnumber double

Valor monetário total aproximado dos tributos federais (R$)

valor_total_tributos_estaduaisnumber double

Valor monetário total aproximado dos tributos estaduais (R$)

valor_total_tributos_municipaisnumber double

Valor monetário total aproximado dos tributos municipais (R$)

percentual_total_tributos_federaisnumber double

Valor percentual total aproximado dos tributos federais (%)

percentual_total_tributos_estaduaisnumber double

Valor percentual total aproximado dos tributos estaduais (%)

percentual_total_tributos_municipaisnumber double

Valor percentual total aproximado dos tributos municipais (%)

indicador_total_tributacaostring

Indicador de informação de valor total de tributos

percentual_total_tributos_simples_nacionalnumber double

Valor percentual aproximado do total dos tributos da alíquota do Simples Nacional (%)

finalidade_emissaostring

Indicador da finalidade da emissão de NFS-e

consumidor_finalstring

Indica operação de uso ou consumo pessoal

codigo_indicador_operacaostring

Código indicador da operação de fornecimento, conforme tabela código indicador de operação

tipo_operacao_governamentalstring

Tipo de Operação com Entes Governamentais ou outros serviços sobre bens imóveis

tipo_ente_governamentalstring

Tipo de ente governamental

indicador_destinatariostring

A respeito do Destinatário dos serviços

cnpj_destinatariostring

Número da inscrição no Cadastro Nacional de Pessoa Jurídica (CNPJ) do destinatário de serviço

cpf_destinatariostring

Número da inscrição no Cadastro Nacional de Pessoa Física (CPF) do destinatário do serviço

nif_destinatariostring

Número de identificação fiscal fornecido por órgão de administração tributária no exterior

motivo_ausencia_nif_destinatariostring

Motivo para não informação do NIF

razao_social_destinatariostring

Nome / Nome Empresarial do destinatário

codigo_municipio_destinatariostring

Código do município do endereço do destinatário do serviço (Tabela do IBGE)

cep_destinatariostring

Código numérico do Endereçamento Postal nacional (CEP) do endereço do destinatário do serviço

codigo_pais_ext_destinatariostring

Código do país do endereço do destinatário do serviço (Tabela de Países ISO)

cep_ext_destinatariostring

Código alfanumérico do Endereçamento Postal no exterior do destinatário do serviço

nome_cidade_ext_destinatariostring

Nome da cidade no exterior do destinatário do serviço

regiao_ext_destinatariostring

Estado, província ou região da cidade no exterior do destinatário do serviço

logradouro_destinatariostring

Tipo e nome do logradouro do endereço do destinatário do serviço

numero_destinatariostring

Número no logradouro do endereço do destinatário do serviço

complemento_destinatariostring

Complemento do endereço do destinatário do serviço

bairro_destinatariostring

Bairro do endereço do destinatário do serviço

telefone_destinatariostring

Número do telefone do destinatário

email_destinatariostring

E-mail do destinatário

inscricao_imobiliaria_imovelstring

Inscrição imobiliária fiscal do imóvel

codigo_cib_imovelstring

Código do Cadastro Imobiliário Brasileiro - CIB

cep_imovelstring

Código de Endereçamento Postal numérico do endereço nacional do imóvel

cep_ext_imovelstring

Código de Endereçamento Postal alfanumérico do endereço no exterior do imóvel

nome_cidade_ext_imovelstring

Nome da cidade no exterior, local do imóvel

regiao_ext_imovelstring

Estado, província ou região da cidade no exterior, local do imóvel

logradouro_imovelstring

Tipo e nome do logradouro do endereço do imóvel

numero_imovelstring

Número no logradouro do endereço do imóvel

complemento_imovelstring

Complemento do endereço do imóvel

bairro_imovelstring

Bairro do endereço do imóvel

ibs_cbs_situacao_tributariastring

Código da Situação Tributária do IBS/CBS

ibs_cbs_classificacao_tributariastring

Código de Classificação Tributária do IBS/CBS

ibs_cbs_credito_codigo_classificacaostring

Código de Classificação do Crédito Presumido

ibs_cbs_situacao_tributaria_regularstring

Código da Situação Tributária do IBS e CBS

ibs_cbs_classificacao_tributaria_regularstring

Código de Classificação Tributária do IBS e CBS

ibs_uf_percentual_diferimentonumber double

Percentual de diferimento para o IBS estadual

ibs_mun_percentual_diferimentonumber double

Percentual de diferimento para o IBS municipal

cbs_percentual_diferimentonumber double

Percentual de diferimento para a CBS