CTe

Endpoint para consulta de distribuição de CTes destinados ao CNPJ informado.

POST /api/v1/cte/consultar-notas

Consulta a distribuição de CTes usando o WebService da SEFAZ. A API usa produção por padrão nessa consulta. Use o ultimoNsu retornado para buscar os próximos lotes.

Campos obrigatórios no corpo

cnpj — CNPJ interessado na distribuição
certificadoDigital — conteúdo do certificado A1 em hexadecimal
senhaCertificadoDigital — senha do certificado
ufAutor — UF autora da consulta (ex.: "TO")
ultimoNsu — opcional; informe "0" na primeira consulta

Exemplo de payload

{
    "cnpj": "00000000000191",
    "certificadoDigital": "conteudo_do_certificado_a1_em_hexadecimal",
    "senhaCertificadoDigital": "sua_senha",
    "ufAutor": "TO",
    "ultimoNsu": "0"
}

Exemplos de código

curl -X POST "https://nfe.geranet.net/api/v1/cte/consultar-notas" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cnpj":"00000000000191","certificadoDigital":"...","senhaCertificadoDigital":"...","ufAutor":"TO","ultimoNsu":"0"}'

$payload = [
    'cnpj' => '00000000000191',
    'certificadoDigital' => $certHex,
    'senhaCertificadoDigital' => $senha,
    'ufAutor' => 'TO',
    'ultimoNsu' => '0',
];
$ch = curl_init('https://nfe.geranet.net/api/v1/cte/consultar-notas');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $apiKey, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
$response = curl_exec($ch);
curl_close($ch);
$dados = json_decode($response, true);

payload = {
    'cnpj': '00000000000191',
    'certificadoDigital': cert_hex,
    'senhaCertificadoDigital': senha,
    'ufAutor': 'TO',
    'ultimoNsu': '0',
}
response = requests.post('https://nfe.geranet.net/api/v1/cte/consultar-notas', headers={'Authorization': f'Bearer {api_key}', 'Content-Type': 'application/json'}, json=payload)
dados = response.json()

Respostas

A API devolve todos os documentos distribuídos pela SEFAZ, incluindo resumos, XMLs completos e eventos, sem filtrar o conteúdo.

Sucesso com documentos (HTTP 200)

{
  "situacao": "sucesso",
  "mensagem": "Documento(s) localizado(s)",
  "xml": "(retorno bruto da SEFAZ em hexadecimal)",
  "pdf": "",
  "cstat": "138",
  "ultimoNsu": "000000000000123",
  "maximoNsu": "000000000000125",
  "quantidadeDocumentos": 2,
  "registros": [
    {
      "nsu": "000000000000124",
      "schema": "resCTe",
      "modelo": "57",
      "tipoXml": "resumo",
      "chave": "35260218612608000132570020000000031369409922",
      "cnpjCpfEmitente": "12345678000199",
      "nomeEmitente": "TRANSPORTADORA EXEMPLO LTDA",
      "inscricaoEstadualEmitente": "123456789",
      "dataEmissao": "2026-03-20 09:12:00",
      "valor": "1500.45",
      "xml": "(xml em hexadecimal)",
      "identificadorEvento": "",
      "tipoEvento": "",
      "situacaoManifestacao": ""
    }
  ]
}

Sucesso sem novos documentos (HTTP 200)

{
  "situacao": "sucesso",
  "mensagem": "Nenhum documento localizado.",
  "xml": "(retorno bruto da SEFAZ em hexadecimal)",
  "pdf": "",
  "cstat": "137",
  "ultimoNsu": "000000000000125",
  "maximoNsu": "000000000000125",
  "quantidadeDocumentos": 0,
  "registros": []
}

← NFe • NFSe →