Consulta das NF-e e CT-e emitidas e recebidas pelo CNPJ da filial (chaves, situação e manifesto), resumo por situação/modal e andamento da captura das NF-e recebidas.
Autenticação em todos os exemplos: veja Autenticação. Teste no navegador pelo Swagger ou importe a coleção do Postman.
| Endpoint | Métodos | Para que serve |
|---|---|---|
nfeChave |
GET | NF-e emitidas e recebidas pelo CNPJ da filial |
nfeResumo |
GET | Resumo das NF-e da filial por situação, manifesto e modal |
nfeRecebidaStatus |
GET | Andamento da captura das NF-e recebidas |
cteChave |
GET | CT-e em que o CNPJ da filial é parte |
NF-e emitidas e recebidas pelo CNPJ da filial. Lista as NF-e capturadas para o CNPJ da filial (como emitente ou destinatário), com situação, manifesto e modal. Só GET. A lista não é paginada.
/v1/terceiro/nfeChaveLista de NF-e
Perfis: App, Rede, Estabelecimento, Cliente, Pessoa
Parâmetros (query)
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id_tx_estabelecimento |
integer | não | Filial cujo CNPJ (parâmetro CNPJ_NFE) é consultado. Fixo no perfil Filial; nos outros perfis, informe. |
data_inicial |
date | não | Data inicial: vale a data de emissão OU a data de cadastro no ZP (AAAA-MM-DD; aceita também data_inicio e data_ini). |
data_final |
date | não | Data final (AAAA-MM-DD; aceita também data_fim). |
chave |
string | não | Chave de acesso (44 dígitos); * ou ausente = todas. |
situacao |
string | não | AUTORIZADA, CANCELADA…; * = todas. |
manifesto |
string | não | CONFIRMADA, CIÊNCIA, DESCONHECIDA, NÃO REALIZADA; * = todos. |
modal |
string | não | RODOVIÁRIO, FERROVIÁRIO, AEROVIÁRIO, DUTOVIÁRIO, HIDROVIÁRIO; * = todos. |
xml |
string | não | S = só as que já têm XML; N = sem XML; * = todas. |
curl -s -X GET "$BASE/v1/terceiro/nfeChave?$AUTH"
Resposta:
{
"status": "ok",
"data": [
{
"chave": "41261111222333000181550010000012341000012345",
"numero": 1234,
"serie": 1,
"emit_cnpj": "11222333000181",
"dest_cnpj": "44555666000199",
"data_emissao": "2026-11-10",
"xml": "S",
"situacao": "AUTORIZADA",
"manifesto": "CIÊNCIA",
"modal": "RODOVIÁRIO"
}
]
}
Erros específicos: 200 — sem data quando o CNPJ_NFE da filial não está configurado ou não há notas..
Resumo das NF-e da filial por situação, manifesto e modal. Contagens das NF-e de saída (emitidas pelo CNPJ da filial) e de entrada (recebidas) no período de emissão. Só GET.
/v1/terceiro/nfeResumoTotais do período
Perfis: App, Rede, Estabelecimento, Cliente, Pessoa
Parâmetros (query)
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id_tx_estabelecimento |
integer | não | Filial cujo CNPJ (parâmetro CNPJ_NFE) é consultado. Fixo no perfil Filial; nos outros perfis, informe. |
data_inicial |
date | não | Emissão inicial (AAAA-MM-DD). |
data_final |
date | não | Emissão final (AAAA-MM-DD). |
curl -s -X GET "$BASE/v1/terceiro/nfeResumo?$AUTH"
Resposta:
{
"status": "ok",
"data": [
{
"total_notas_de_saida": 120,
"total_notas_de_entrada": 340,
"notas_de_saida_autorizada": 118,
"notas_de_entrada_autorizada": 335,
"notas_de_saida_cancelada": 2,
"notas_de_entrada_cancelada": 5,
"notas_de_entrada_confirmada": 300,
"notas_de_entrada_ciencia": 30,
"...": "(demais contagens)"
}
]
}
Andamento da captura das NF-e recebidas. Percentual das NF-e recebidas pelo CNPJ da filial que já têm XML, JSON, PDF e manifesto confirmado no ZP. Sem filtro de data. Só GET.
/v1/terceiro/nfeRecebidaStatusTotais e percentuais
Perfis: App, Rede, Estabelecimento, Cliente, Pessoa
Parâmetros (query)
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id_tx_estabelecimento |
integer | não | Filial cujo CNPJ (parâmetro CNPJ_NFE) é consultado. Fixo no perfil Filial; nos outros perfis, informe. |
curl -s -X GET "$BASE/v1/terceiro/nfeRecebidaStatus?$AUTH"
Resposta:
{
"status": "ok",
"recebida_status": {
"total": 340,
"xml": 330,
"perc_xml": 97.1,
"json": 330,
"perc_json": 97.1,
"pdf": 300,
"perc_pdf": 88.2,
"confirmada": 300,
"perc_confirmada": 88.2
}
}
CT-e em que o CNPJ da filial é parte. Lista os CT-e capturados para o CNPJ da filial (como interessado ou emitente), por data de emissão. Só GET. A lista não é paginada.
/v1/terceiro/cteChaveLista de CT-e
Perfis: App, Rede, Estabelecimento, Cliente, Pessoa
Parâmetros (query)
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id_tx_estabelecimento |
integer | não | Filial cujo CNPJ (parâmetro CNPJ_NFE) é consultado. Fixo no perfil Filial; nos outros perfis, informe. |
data_inicial |
date | não | Emissão inicial (AAAA-MM-DD; aceita também data_inicio e data_ini). |
data_final |
date | não | Emissão final (AAAA-MM-DD; aceita também data_fim). |
chave |
string | não | Chave de acesso; * ou ausente = todas. |
situacao |
string | não | Situação; * = todas. |
manifesto |
string | não | Manifesto; * = todos. |
xml |
string | não | S = com XML; N = sem; * = todos. |
curl -s -X GET "$BASE/v1/terceiro/cteChave?$AUTH"
Resposta:
{
"status": "ok",
"data": [
{
"key": "41261111222333000181570010000004561000004567",
"cnpj": "11222333000181",
"id": "<id na captura>",
"mod": "57",
"environment": "<ambiente>",
"serie": "1",
"cnpj_emitter": "44555666000199",
"razao_social": "TRANSPORTADORA EXEMPLO LTDA",
"cnpj_addressee": "11222333000181",
"date_emission": "2026-11-10",
"number": 456,
"value": 1500.0,
"situacao": "AUTORIZADA",
"manifesto": "-",
"tomador": "<tomador>",
"xml": "S"
}
]
}