NFC-e

Consultar NFC-e

Devolve status, QR Code, links do cupom e do XML e o eco da emissão.

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

Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

Consulta pelo id enviado na emissão. Os links de download não exigem assinatura e são gerados de novo a cada consulta; veja Download de arquivos. O cupom é gerado no primeiro download; se o serviço de renderização estiver ocupado, o link devolve 503 e basta tentar de novo.

Parâmetros de caminho

`empresaId*`	string	Identificador da empresa emitente
`nfceId*`	string	Identificador da NFC-e

* Campo obrigatório

200

Nota encontrada.

`id`	string	Identificador da requisição
`tipo`	string	Tipo de documento
`status`	string	Status
`motivoStatus`	string	Motivo
`ambienteEmissao`	string	Ambiente de emissão
`dataCriacao`	string	Data de criação
`dataUltimaAlteracao`	string	Última alteração
	object	Pedido
	object	Consumidor
`transporte`	object	Transporte
`numero`	string	Número da nota
`serie`	string	Série
`dataEmissao`	string	Data de emissão
`chaveAcesso`	string	Chave de acesso
`dataAutorizacao`	string	Data de autorização
	object	Protocolo de autorização
`qrCode`	string	Conteúdo do QR Code
`urlConsulta`	string	URL de consulta pela chave
`linkDanfe`	string	Link do cupom em PDF
`linkDownloadXml`	string	Link do XML
`emitidaEmContingencia`	bool	Emitida em contingência
`alertas`	array	Alertas da autorização
	array	Itens
`valorTotal`	number	Valor total da nota

`status`Status

Durante um cancelamento em andamento a nota continua Autorizada.

Valores	Significado
AguardandoAutorizacao	Aceita, aguardando a SEFAZ
Autorizada	Autorizada pela SEFAZ
Negada	Rejeitada pela SEFAZ, ou falhou no processamento da plataforma; motivo em `motivoStatus`
Cancelada	Cancelada
ContingenciaPendente	Emitida offline com a SEFAZ indisponível; a plataforma transmite quando ela voltar

Código	HTTP
10022006	404	`nfceId` não encontrado nesta empresa.
10003000	404	`empresaId` não 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 caminho

Respostas

Enumerações1 tabelas

statusStatus

Erros2 itens

`status`Status