TF Fiscal
Documentación

NFS-e

Consultar NFS-e recibida

Detalle de una NFS-e recibida: partes, valores, origen, enlaces y la manifestación de esta empresa.

GET/openapi/v2/empresas/{empresaId}/nfse/recebidas/{chaveAcesso}
Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

Devuelve una factura de servicio en la que esta empresa es tomadora o intermediaria, por la clave de acceso. La respuesta tiene la misma forma que los ítems de NFS-e recibidas y además trae el array eventos, que los ítems de la lista no traen. Para registrar una manifestación use Manifestar sobre NFS-e recibida. Una clave que no está entre las recibidas de esta empresa devuelve 404.

Parámetros de ruta

empresaId*
stringIdentificador de la empresa
chaveAcesso*
stringClave de acceso

* Campo obligatorio

200
Documento recibido encontrado.
chaveAcesso
stringClave de acceso
numero
intNúmero de la NFS-e
codigoVerificacao
stringCódigo de verificación
status
stringEstado del documento
papel
stringPapel de esta empresa
origem
stringOrigen de la fila
dataEmissao
stringFecha de emisión
dataAutorizacao
stringFecha de autorización
competencia
stringCompetencia
objectPrestador
objectTomador del servicio
objectIntermediario
codigoTributacaoNacional
stringCódigo nacional del servicio
discriminacao
stringDescripción del servicio
valorServico
numberValor del servicio
valorLiquido
numberValor líquido
valorIss
numberValor del ISS
issRetido
boolISS retenido
chaveSubstituida
stringClave de la nota sustituida
chaveSubstituta
stringClave de la nota sustituta
dataUltimoEvento
stringÚltimo evento
dataRecebimento
stringMomento de la recepción
objectManifestación de esta empresa
linkXml
stringEnlace del XML oficial
linkDanfse
stringEnlace de la DANFSe
arrayEventos de la nota

Las facturas recibidas llegan por la distribución nacional. Una empresa de São Paulo tiene una segunda fuente: después de cada sincronización la plataforma también busca en el sistema municipal de São Paulo las facturas que esta empresa recibió, y son visibles antes de que llegue la transcripción nacional. Una fila PrefeituraSP pasa a `ADN` por sí sola cuando llega la transcripción, sin generar una segunda fila; en ese momento chaveAcesso cambia la clave temporal por la oficial y los enlaces pasan a ser el original nacional y la DANFSe. Use prestador.cpfCnpj + numero como identificador estable entre sincronizaciones y nunca trate la clave temporal como clave primaria permanente.

Fila llegada por la distribución nacional

La forma definitiva: clave oficial, original en layout nacional y DANFSe disponibles.

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*
stringOrigen
chaveAcesso*
stringClave oficial

* Campo obligatorio

Fila traída directamente del sistema de São Paulo

Solo para empresas de São Paulo, antes de la fusión. La clave temporal es 3550308 + 0 + el CNPJ del prestador de 14 dígitos + el número de la nota rellenado con ceros a la izquierda hasta 28 dígitos, reconocible por el 0 en la posición 8; funciona en las rutas de detalle y de manifestación. linkXml apunta al original del sistema municipal y linkDanfse todavía es 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*
stringOrigen
chaveAcesso*
stringClave temporal
codigoVerificacao*
stringCódigo de verificación municipal

* Campo obligatorio

AnteriorListar NFS-e recibidasSiguienteManifestar sobre NFS-e recibida