NFC-e

Consultar NFC-e

Devuelve estado, QR Code, enlaces del cupón y del XML y el eco de la emisión.

GET/openapi/v2/empresas/{empresaId}/nfce/{nfceId}

Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

Consulta por el id enviado en la emisión. Los enlaces de descarga no requieren firma y se vuelven a generar en cada consulta; vea Descarga de archivos. El cupón se genera en la primera descarga; si el servicio de renderizado está ocupado, el enlace devuelve 503 y basta reintentar.

Parámetros de ruta

`empresaId*`	string	Identificador de la empresa emisora
`nfceId*`	string	Identificador de la NFC-e

* Campo obligatorio

200

Nota encontrada.

`id`	string	Identificador de la solicitud
`tipo`	string	Tipo de documento
`status`	string	Estado
`motivoStatus`	string	Motivo
`ambienteEmissao`	string	Ambiente de emisión
`dataCriacao`	string	Fecha de creación
`dataUltimaAlteracao`	string	Última modificación
	object	Pedido
	object	Consumidor
`transporte`	object	Transporte
`numero`	string	Número de la nota
`serie`	string	Serie
`dataEmissao`	string	Fecha de emisión
`chaveAcesso`	string	Clave de acceso
`dataAutorizacao`	string	Fecha de autorización
	object	Protocolo de autorización
`qrCode`	string	Contenido del QR Code
`urlConsulta`	string	URL de consulta por la clave
`linkDanfe`	string	Enlace del cupón en PDF
`linkDownloadXml`	string	Enlace del XML
`emitidaEmContingencia`	bool	Emitida en contingencia
`alertas`	array	Alertas de la autorización
	array	Ítems
`valorTotal`	number	Valor total de la nota

`status`Estado

Durante una cancelación en curso la nota sigue Autorizada.

Valores	Significado
AguardandoAutorizacao	Aceptada, esperando a la SEFAZ
Autorizada	Autorizada por la SEFAZ
Negada	Rechazada por la SEFAZ, o falló en el procesamiento de la plataforma; motivo en `motivoStatus`
Cancelada	Cancelada
ContingenciaPendente	Emitida offline con la SEFAZ caída; la plataforma la transmite cuando vuelva

Código	HTTP
10022006	404	`nfceId` no encontrado en esta empresa.
10003000	404	`empresaId` no encontrado.

APP_SECRET='<APP_SECRET>'

API_PATH='/openapi/v2/empresas/{empresaId}/nfce/{nfceId}'

TIMESTAMP=$(date +%s)

SIGN=$(printf '%s%s%s' "$APP_SECRET" "$API_PATH" "$TIMESTAMP" | md5sum | cut -d' ' -f1)

curl -sS -X GET "https://api.v2.tffiscal.com${API_PATH}" \

-H "token: $APP_SECRET" -H "timestamp: $TIMESTAMP" -H "sign: $SIGN"

{

"id": "PDV01-000123",

"tipo": "NFC-e",

"status": "Autorizada",

"motivoStatus": null,

"ambienteEmissao": "Homologacao",

"dataCriacao": "2026-11-04T15:20:01Z",

"dataUltimaAlteracao": "2026-11-04T15:20:02Z",

"pedido": {

"presencaConsumidor": "OperacaoPresencial",

"pagamento": {

"formas": [

{ "tipo": "Dinheiro", "valor": 50.00 },

{ "tipo": "CartaoDeDebito", "valor": 10.30 }

"troco": 0.00

}

"cliente": null,

"transporte": null,

"numero": "123",

"serie": "1",

"dataEmissao": "2026-11-04T15:20:01Z",

"chaveAcesso": "35261111222333000181650010000001231123456780",

"dataAutorizacao": "2026-11-04T15:20:02Z",

"protocolo": { "numero": "135261234567890" },

"qrCode": "https://www.homologacao.nfce.fazenda.sp.gov.br/qrcode?p=35261111222333000181650010000001231123456780|3|2",

"urlConsulta": "https://www.homologacao.nfce.fazenda.sp.gov.br/consulta",

"linkDanfe": "https://api.v2.tffiscal.com/openapi/files/danfce/35261111222333000181650010000001231123456780?token=MXw3fDEwMXwxNzU4...",

"linkDownloadXml": "https://api.v2.tffiscal.com/openapi/files/xml/9901?token=MXw3fDEwMXwxNzU4...",

"emitidaEmContingencia": false,

"alertas": [],

"itens": [

{ "cfop": "5102", "codigo": "7891000100103", "descricao": "ARROZ TIPO 1 5KG", "quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 25.15, "valorTotal": 50.30 },

{ "cfop": "5405", "codigo": "7894900011517", "descricao": "REFRIGERANTE COLA 2L", "quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 10.00, "valorTotal": 10.00 }

"valorTotal": 60.30

}

Consultar NFC-e

Parámetros

Parámetros de ruta

Respuestas

Enumeraciones1 tablas

statusEstado

Errores2 ítems

`status`Estado