Br Consult Cte
br__consult_cteCheck the status of a CT-e by its 44-character access key through a specified SEFAZ endpoint. Returns the official response code, reason, and protocol when available.
Instructions
Consulta a situação de um CT-e por chave de acesso (CTeConsultaV4).
Read-only — não requer confirmação (consulta um CT-e específico e já
conhecido pela chave de acesso, não um lote de dados fiscais de
terceiros — diferente de br__distribute_dfe no NF-e). Nenhuma URL de
endpoint CT-e está embutida/verificada nesta versão —
endpoint_override é obrigatório.
Retorna cStat/xMotivo/protCTe (quando aplicável) ou error.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ch_cte": "<ch_cte>",
"c_uf": "<c_uf>",
"cert_path": "<cert_path>",
"endpoint_override": "<endpoint_override>"
},
"name": "br__consult_cte"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| c_uf | Yes | Código IBGE da UF do autorizador (cUF), 2 dígitos | |
| ch_cte | Yes | Chave de acesso do CT-e (chCTe), 44 caracteres | |
| tp_amb | No | Identificação do Ambiente (tpAmb): '1' = produção, '2' = homologação | 2 |
| cert_path | Yes | Caminho local para o certificado ICP-Brasil A1 (.p12/.pfx) | |
| cert_password | No | Senha do certificado A1, se houver | |
| endpoint_override | Yes | URL completa do webservice CTeConsultaV4 — obrigatório, ver docstring do módulo. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||