TF Fiscal
Documentação

NFS-e

Consultar NFS-e recebida

Detalhe de uma NFS-e recebida: partes, valores, origem, links e a manifestação desta empresa.

GET/openapi/v2/empresas/{empresaId}/nfse/recebidas/{chaveAcesso}
Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

Devolve uma nota de serviço em que esta empresa é tomadora ou intermediária, pela chave de acesso. A resposta tem a mesma forma dos itens de NFS-e recebidas e ainda traz o array eventos, que os itens da lista não trazem. Para registrar uma manifestação use Manifestar sobre NFS-e recebida. Uma chave que não está entre as recebidas desta empresa devolve 404.

Parâmetros de caminho

empresaId*
stringIdentificador da empresa
chaveAcesso*
stringChave de acesso

* Campo obrigatório

200
Documento recebido encontrado.
chaveAcesso
stringChave de acesso
numero
intNúmero da NFS-e
codigoVerificacao
stringCódigo de verificação
status
stringStatus do documento
papel
stringPapel desta empresa
origem
stringOrigem da linha
dataEmissao
stringData de emissão
dataAutorizacao
stringData de autorização
competencia
stringCompetência
objectPrestador
objectTomador do serviço
objectIntermediário
codigoTributacaoNacional
stringCódigo nacional do serviço
discriminacao
stringDescrição do serviço
valorServico
numberValor do serviço
valorLiquido
numberValor líquido
valorIss
numberValor do ISS
issRetido
boolISS retido
chaveSubstituida
stringChave da nota substituída
chaveSubstituta
stringChave da nota substituta
dataUltimoEvento
stringÚltimo evento
dataRecebimento
stringMomento do recebimento
objectManifestação desta empresa
linkXml
stringLink do XML oficial
linkDanfse
stringLink da DANFSe
arrayEventos da nota

As notas recebidas chegam pela distribuição nacional. Uma empresa de São Paulo tem uma segunda fonte: depois de cada sincronização a plataforma também busca no sistema municipal de São Paulo as notas que esta empresa recebeu, e elas ficam visíveis antes de a transcrição nacional chegar. Uma linha PrefeituraSP vira `ADN` sozinha quando a transcrição chega, sem gerar uma segunda linha; nesse momento chaveAcesso troca a chave temporária pela oficial e os links passam a ser o original nacional e a DANFSe. Use prestador.cpfCnpj + numero como identificador estável entre sincronizações e nunca trate a chave temporária como chave primária permanente.

Linha vinda da distribuição nacional

A forma definitiva: chave oficial, original em layout nacional e DANFSe disponíveis.

json
{
  "chaveAcesso": "35503082406730610001340000000000000000000000000077",
  "numero": 77,
  "codigoVerificacao": null,
  "origem": "ADN",
  "prestador": { "cpfCnpj": "40673061000134" },
  "linkXml": "https://api.v2.tffiscal.com/openapi/files/xml/9101?token=...",
  "linkDanfse": "https://api.v2.tffiscal.com/openapi/files/danfse/35503082406730610001340000000000000000000000000077?token=..."
}
origem*
stringOrigem
chaveAcesso*
stringChave oficial

* Campo obrigatório

Linha vinda direto do sistema de São Paulo

Só para empresas de São Paulo, antes da fusão. A chave temporária é 3550308 + 0 + o CNPJ do prestador com 14 dígitos + o número da nota preenchido com zeros à esquerda até 28 dígitos, reconhecível pelo 0 na posição 8; ela funciona nos caminhos de detalhe e de manifestação. linkXml aponta para o original do sistema municipal e linkDanfse ainda é null.

json
{
  "chaveAcesso": "35503080406730610001340000000000000000000000000077",
  "numero": 77,
  "codigoVerificacao": "A1B2C3D4",
  "origem": "PrefeituraSP",
  "prestador": { "cpfCnpj": "40673061000134" },
  "linkXml": "https://api.v2.tffiscal.com/openapi/files/xml/9099?token=...",
  "linkDanfse": null
}
origem*
stringOrigem
chaveAcesso*
stringChave temporária
codigoVerificacao*
stringCódigo de verificação municipal

* Campo obrigatório

AnteriorListar NFS-e recebidasPróximoManifestar sobre NFS-e recebida