NFC-e

Query NFC-e

Returns status, QR Code, receipt and XML links and the echo of the issuance.

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

Requires the token, timestamp and sign signature headers, see Authentication.

Queries by the id sent at issuance. Download links need no signature and are re-issued on every query; see File download. The receipt is rendered on the first download; if the rendering service is busy the link returns 503 and a retry is enough.

Path parameters

`empresaId*`	string	Issuing company identifier
`nfceId*`	string	NFC-e identifier

* Required field

200

Invoice found.

`id`	string	Request identifier
`tipo`	string	Document type
`status`	string	Status
`motivoStatus`	string	Reason
`ambienteEmissao`	string	Issuing environment
`dataCriacao`	string	Creation time
`dataUltimaAlteracao`	string	Last change
	object	Order
	object	Consumer
`transporte`	object	Transport
`numero`	string	Invoice number
`serie`	string	Series
`dataEmissao`	string	Issue time
`chaveAcesso`	string	Access key
`dataAutorizacao`	string	Authorization time
	object	Authorization protocol
`qrCode`	string	QR Code content
`urlConsulta`	string	Lookup URL by access key
`linkDanfe`	string	Receipt PDF link
`linkDownloadXml`	string	XML link
`emitidaEmContingencia`	bool	Issued in contingency
`alertas`	array	Authorization warnings
	array	Items
`valorTotal`	number	Invoice total

`status`Status

While a cancellation is in progress the invoice stays Autorizada.

Values	Meaning
AguardandoAutorizacao	Accepted, waiting for SEFAZ
Autorizada	Authorized by SEFAZ
Negada	Rejected by SEFAZ, or failed during platform processing; reason in `motivoStatus`
Cancelada	Cancelled
ContingenciaPendente	Issued offline while SEFAZ was down; the platform transmits it once SEFAZ is back

Code	HTTP
10022006	404	`nfceId` not found for this company.
10003000	404	`empresaId` not found.

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

}

Query NFC-e

Parameters

Path parameters

Responses

Enumerations1 tables

statusStatus

Errors2 items

`status`Status