Skip to main content
Glama

fiscal

by br.com.brasilnfe
OverviewDiscussionsAdmin

Emitir CT-e

cte_emitir
Destructive

Emite CT-e (Conhecimento de Transporte Eletrônico). Requer serviço CT-e habilitado no cadastro da empresa e certificado digital A1 ou A3 configurado.

Input Schema

NameRequiredDescriptionDefault
CfopYesCFOP de 4 dígitos. Primeiro dígito: 1/2/3 = entrada, 5/6/7 = saída.
LoteNo
CargaYesDados da carga transportada (produto predominante, lista de detalhes, documentos fiscais que acompanham). OBRIGATÓRIO. Para Tipo de serviço 0/1/2/6/7/8 também exige Carga.Documentos com ao menos 1 NF-e referenciada.
ModalYesModal de transporte (rodoviário, aéreo, aquaviário, ferroviário, dutoviário, multimodal). OBRIGATÓRIO. Tipo: 1=Rodoviário, 2=Aéreo, 3=Aquaviário, 4=Ferroviário, 5=Dutoviário, 6=Multimodal.
SerieNo
CodigoNo
NumeroNo
RetiraNo
ImpostoNo
ServicoYesDados do serviço prestado (Tipo, CodMunicipioInicio, CodMunicipioFim com 7 dígitos cada, MunicipioInicio/MunicipioFim, ValorPrestacao > 0, ValorReceber > 0). OBRIGATÓRIO. Tipo: 0=Normal, 1=Subcontratação, 2=Redespacho, 3=RedespachoIntermediario, 4=ServicoVinculadoMultimodal.
TipoCteYesTipo do CT-e.
TomadorNo
DtEmissaoNoData/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00)
ExpedidorNo
RemetenteNo
ObservacaoNo
DestinatarioNo
TipoAmbienteYesIdentificação do ambiente da SEFAZ. Valores: 1 - Produção (emissão real, irreversível); 2 - Homologação (teste, sem valor fiscal)
AlteraTomadorNoSó no CT-e substituto: indica alteração do tomador em relação ao CT-e substituído. (infCteSub/indAlteraToma = 1)
ModeloDocumentoYesModelo do Conhecimento de Transporte Eletrônico. Valores: 57 - CT-e (Conhecimento de Transporte Eletrônico); 67 - CT-e OS (Outros Serviços de transporte)
ChaveSubstituidaNoChave de acesso do CT-e substituído. Obrigatório quando TipoCte = 3 e não aceito nos demais tipos. (infCteSub/chCte)
NaturezaOperacaoYesDescrição da natureza da operação (ex: "Prestação de serviço de transporte").
ChavesComplementadasNoChaves de acesso dos CT-e complementados (1 a 10). Obrigatório quando TipoCte = 1 e não aceito nos demais tipos. (infCteComp/chCTe)
DocumentosAnterioresNoDocumentos de transporte anterior (docAnt), agrupados por emissor. Não aceito no CT-e complementar (TipoCte = 1).
IdentificadorInternoNo

Output Schema

NameRequiredDescriptionDefault
chaveNo
errosNoLista de erros quando a operação falha. Vazia em caso de sucesso. Cada item traz codigo, descricao e correcao.
serieNo
avisosNoAvisos não bloqueantes. Pode vir preenchida mesmo em sucesso.
numeroNo
statusNoStatus do resultado da operação: 1 = sucesso; 2 = erro (a lista erros é preenchida).
base64XmlNo
base64DACTeNo
tipoAmbienteNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / DocumentosAnteriores
      Added value: +{
+  "description": "Documentos de transporte anterior (docAnt), agrupados por emissor. Não aceito no CT-e complementar (TipoCte = 1).",
+  "items": {
+    "additionalProperties": false,
+    "description": "Documento de transporte anterior, agrupado pelo emissor (docAnt/emiDocAnt). Usado na subcontratação, no redespacho, no redespacho intermediário e no serviço vinculado ao multimodal para informar o CT-e (ou documento em papel) do transportador anterior. Informe ChavesCTe, DocumentosPapel ou os dois.",
+    "properties": {
+      "ChavesCTe": {
+        "description": "Chaves de acesso dos CT-e anteriores (44 dígitos, modelo 57). (idDocAntEle/chCTe)",
+        "items": {
+          "type": "string"
+        },
+        "type": [
+          "array",
+          "null"
+        ]
+      },
+      "CpfCnpj": {
+        "description": "CPF ou CNPJ do emissor do documento anterior.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "DocumentosPapel": {
+        "description": "Documentos anteriores em papel, quando o parceiro não tem CT-e. (idDocAntPap)",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "DtEmissao": {
+              "description": "Data de emissão do documento. (dEmi)",
+              "type": "string"
+            },
+            "Numero": {
+              "description": "Número do documento (até 30 caracteres). (nDoc)",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "Serie": {
+              "description": "Série do documento (1 a 3 caracteres). (serie)",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "Subserie": {
+              "description": "Subsérie do documento (opcional, até 2 dígitos). (subser)",
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "TipoDocumento": {
+              "description": "Tipo do documento de transporte anterior. (tpDoc) Valores: 7 - ATRE; 8 - DTA (Despacho de Trânsito Aduaneiro); 9 - Conhecimento Aéreo Internacional; 10 - Conhecimento - Carta de Porte Internacional; 11 - Conhecimento Avulso; 12 - TIF (Transporte Internacional Ferroviário); 13 - BL (Bill of Lading)",
+              "enum": [
+                7,
+                8,
+                9,
+                10,
+                11,
+                12,
+                13
+              ],
+              "type": "integer"
+            }
+          },
+          "type": "object"
+        },
+        "type": [
+          "array",
+          "null"
+        ]
+      },
+      "Ie": {
+        "description": "Inscrição estadual do emissor. Opcional; quando informada, Uf é obrigatória.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "Nome": {
+        "description": "Razão social ou nome do emissor.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "Uf": {
+        "description": "Sigla da UF do emissor. Vai no XML só junto com a Ie.",
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}
  2. Changed13 schema fields changed
    • addedInput schema / properties / AlteraTomador
      Added value: +{
+  "description": "Só no CT-e substituto: indica alteração do tomador em relação ao CT-e substituído. (infCteSub/indAlteraToma = 1)",
+  "type": "boolean"
+}
    • addedInput schema / properties / Carga / properties / ValorCargaAverbacao
      Added value: +{
+  "description": "Valor da carga para efeito de averbação do seguro. (vCargaAverb) Opcional: informe só quando for diferente do ValorTotal (ex.: 1,00 em CT-e emitido apenas para cobrança). Se informado, deve ser maior que zero. Existe só no CT-e normal: o CT-e complementar não tem o grupo de carga.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedInput schema / properties / ChaveSubstituida
      Added value: +{
+  "description": "Chave de acesso do CT-e substituído. Obrigatório quando TipoCte = 3 e não aceito nos demais tipos. (infCteSub/chCte)",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / ChavesComplementadas
      Added value: +{
+  "description": "Chaves de acesso dos CT-e complementados (1 a 10). Obrigatório quando TipoCte = 1 e não aceito nos demais tipos. (infCteComp/chCTe)",
+  "items": {
+    "type": "string"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}
    • changedInput schema / properties / Imposto / properties / ICMS / properties / Aliquota / description
      Previous value: -"Alíquota do ICMS (em percentual). (pICMS)"New value: +"Alíquota do ICMS (em percentual). (pICMS; no CST 60, pICMSSTRet)"
    • changedInput schema / properties / Imposto / properties / ICMS / properties / AliquotaOutraUF / description
      Previous value: -"Alíquota do ICMS devido a Outra UF. (pICMSOutraUF) Usado no CST OutraUF."New value: +"Alíquota do ICMS devido a Outra UF. (pICMSOutraUF) Usado no CST 90 quando o ICMS é devido a outra UF (grupo ICMSOutraUF), junto com ValorICMSOutraUF."
    • changedInput schema / properties / Imposto / properties / ICMS / properties / BaseCalculo / description
      Previous value: -"Base de Cálculo do ICMS. (vBC)"New value: +"Base de Cálculo do ICMS. (vBC; no CST 60, vBCSTRet; no CST 90 de outra UF, vBCOutraUF)"
    • changedInput schema / properties / Imposto / properties / ICMS / properties / CST / description
      Previous value: -"Código de Situação Tributária (CST) do ICMS. (Ex: 00, 20, 40, 41, 51, 60, 90, etc.) Para empresas do Simples Nacional, é usando o 90 automáticamente."New value: +"Código de Situação Tributária (CST) do ICMS: 00, 20, 40, 41, 51, 60 ou 90. 40 (isento), 41 (não tributado) e 51 (diferido) vão no grupo ICMS45, sem valores. Para empresas do Simples Nacional é usado o 90 automaticamente (grupo ICMSSN)."
    • changedInput schema / properties / Imposto / properties / ICMS / properties / PercentualReducaoBaseCalculo / description
      Previous value: -"Percentual de Redução da Base de Cálculo. (pRedBC) Usado nos CSTs 20 e 90."New value: +"Percentual de Redução da Base de Cálculo. (pRedBC) Obrigatório no CST 20; opcional no CST 90 (sem redução, não informe)."
    • changedInput schema / properties / Imposto / properties / ICMS / properties / Valor / description
      Previous value: -"Valor do ICMS. (vICMS)"New value: +"Valor do ICMS. (vICMS; no CST 60, vICMSSTRet)"
    • changedInput schema / properties / Imposto / properties / ICMS / properties / ValorICMSOutraUF / description
      Previous value: -"Valor do ICMS devido a Outra UF. (vICMSOutraUF) Usado no CST OutraUF."New value: +"Valor do ICMS devido a Outra UF. (vICMSOutraUF) Usado no CST 90 quando o ICMS é devido a outra UF (grupo ICMSOutraUF), junto com AliquotaOutraUF."
    • changedInput schema / properties / TipoCte / description
      Previous value: -"Tipo do CT-e. Valores: 0 - CT-e Normal (caso mais comum); 1 - CT-e de Complemento de Valores; 2 - CT-e de Anulação; 3 - CT-e Substituto"New value: +"Tipo do CT-e."
    • removedInput schema / properties / TipoCte / enum
      Removed value: -[
-  0,
-  1,
-  2,
-  3
-]
  3. Changed1 schema field changed
    • addedInput schema / properties / Imposto / properties / IBSCBS
      Added value: +{
+  "additionalProperties": false,
+  "description": "Informações do IBS/CBS (Reforma Tributária - NT 2025.001). Quando preenchido, gera o grupo imp/IBSCBS no XML do CT-e.",
+  "properties": {
+    "AliquotaCBS": {
+      "description": "Alíquota da CBS (pCBS).",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "AliquotaIBSMun": {
+      "description": "Alíquota do IBS de competência do Município (pIBSMun).",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "AliquotaIBSUF": {
+      "description": "Alíquota do IBS de competência das UF (pIBSUF).",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "BaseCalculo": {
+      "description": "Base de cálculo do IBS/CBS (vBC). Quando null, usa o valor total da prestação.",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "CodClassificacaoTributaria": {
+      "description": "Código de Classificação Tributária do IBS/CBS (cClassTrib). O CST é derivado dos 3 primeiros dígitos. Quando vazio, assume \"000001\".",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "PercentualDiferimento": {
+      "description": "Percentual de diferimento (pDif de gDif), usado nos CST 510/515.",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "PercentualReducaoCBS": {
+      "description": "Percentual de redução da alíquota da CBS (pRedAliq de gRed). Pode divergir de PercentualReducaoIBS.",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "PercentualReducaoIBS": {
+      "description": "Percentual de redução da alíquota do IBS (pRedAliq de gRed), usado nos CST 011/200/515. Quando null, não aplica redução.",
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}
  4. Changed138 schema fields changed
    • changedInput schema / properties / Carga / properties / Detalhes / items / properties / TipoMedida / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Carga / properties / Detalhes / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Carga / properties / Documentos / items / properties / Chave / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Carga / properties / Documentos / items / properties / PIN / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Carga / properties / Documentos / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Carga / properties / OutrosDocumentos / items / properties / Descricao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • removedInput schema / properties / Carga / properties / OutrosDocumentos / items / properties / DtEmissao / format
      Removed value: -"date-time"
    • changedInput schema / properties / Carga / properties / OutrosDocumentos / items / properties / DtEmissao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • removedInput schema / properties / Carga / properties / OutrosDocumentos / items / properties / DtPrevisao / format
      Removed value: -"date-time"
    • changedInput schema / properties / Carga / properties / OutrosDocumentos / items / properties / DtPrevisao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Carga / properties / OutrosDocumentos / items / properties / Numero / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Carga / properties / OutrosDocumentos / items / properties / Valor / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Carga / properties / OutrosDocumentos / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Carga / properties / ProdutoPredominante / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Codigo / type
      Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Contato / properties / Email / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Contato / properties / Fax / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Contato / properties / Telefone / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Contato / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / CpfCnpj / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Endereco / properties / Bairro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Endereco / properties / Cep / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Endereco / properties / CodMunicipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Endereco / properties / Complemento / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Endereco / properties / Logradouro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Endereco / properties / Municipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Endereco / properties / Numero / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Endereco / properties / Pais / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Endereco / properties / Uf / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Endereco / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Ie / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / Nome / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / properties / NomeFantasia / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Destinatario / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • addedInput schema / properties / DtEmissao / description
      Added value: +"Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00)"
    • removedInput schema / properties / DtEmissao / format
      Removed value: -"date-time"
    • changedInput schema / properties / DtEmissao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Contato / properties / Email / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Contato / properties / Fax / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Contato / properties / Telefone / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Contato / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / CpfCnpj / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Endereco / properties / Bairro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Endereco / properties / Cep / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Endereco / properties / CodMunicipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Endereco / properties / Complemento / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Endereco / properties / Logradouro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Endereco / properties / Municipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Endereco / properties / Numero / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Endereco / properties / Pais / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Endereco / properties / Uf / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Endereco / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Ie / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / Nome / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / properties / NomeFantasia / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Expedidor / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / IdentificadorInterno / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / Difal / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / ICMS / properties / AliquotaOutraUF / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / ICMS / properties / CST / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / ICMS / properties / PercentualReducaoBaseCalculo / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / ICMS / properties / ValorICMSOutraUF / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / ICMS / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / InformacoesAdicionaisFisco / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / TributosFederal / properties / ValorCofins / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / TributosFederal / properties / ValorCsll / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / TributosFederal / properties / ValorInss / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / TributosFederal / properties / ValorIr / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / TributosFederal / properties / ValorPis / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / TributosFederal / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Imposto / properties / ValorTotalTributos / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Imposto / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Lote / type
      Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
    • addedInput schema / properties / Modal / properties / Rodoviario / properties / OCCs / items / properties / DtEmissaoColeta / description
      Added value: +"Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00)"
    • removedInput schema / properties / Modal / properties / Rodoviario / properties / OCCs / items / properties / DtEmissaoColeta / format
      Removed value: -"date-time"
    • changedInput schema / properties / Modal / properties / Rodoviario / properties / OCCs / items / properties / Emissor / properties / Cnpj / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Modal / properties / Rodoviario / properties / OCCs / items / properties / Emissor / properties / CodigoInternoOCC / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Modal / properties / Rodoviario / properties / OCCs / items / properties / Emissor / properties / Ie / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Modal / properties / Rodoviario / properties / OCCs / items / properties / Emissor / properties / Telefone / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Modal / properties / Rodoviario / properties / OCCs / items / properties / Emissor / properties / Uf / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Modal / properties / Rodoviario / properties / OCCs / items / properties / Emissor / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Modal / properties / Rodoviario / properties / OCCs / items / properties / Serie / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Modal / properties / Rodoviario / properties / OCCs / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Modal / properties / Rodoviario / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Numero / type
      Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
    • changedInput schema / properties / Observacao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Contato / properties / Email / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Contato / properties / Fax / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Contato / properties / Telefone / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Contato / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / CpfCnpj / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Endereco / properties / Bairro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Endereco / properties / Cep / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Endereco / properties / CodMunicipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Endereco / properties / Complemento / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Endereco / properties / Logradouro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Endereco / properties / Municipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Endereco / properties / Numero / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Endereco / properties / Pais / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Endereco / properties / Uf / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Endereco / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Ie / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / Nome / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / properties / NomeFantasia / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Remetente / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Serie / type
      Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
    • changedInput schema / properties / Servico / properties / Componentes / items / properties / Nome / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Servico / properties / Componentes / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Servico / properties / MunicipioFim / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Servico / properties / MunicipioInicio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Contato / properties / Email / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Contato / properties / Fax / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Contato / properties / Telefone / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Contato / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / CpfCnpj / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Endereco / properties / Bairro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Endereco / properties / Cep / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Endereco / properties / CodMunicipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Endereco / properties / Complemento / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Endereco / properties / Logradouro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Endereco / properties / Municipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Endereco / properties / Numero / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Endereco / properties / Pais / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Endereco / properties / Uf / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Endereco / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Ie / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / Nome / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / properties / NomeFantasia / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Tomador / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedOutput schema / properties / avisos / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedOutput schema / properties / base64DACTe / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / base64Xml / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / chave / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / erros / items / properties / codigo / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / erros / items / properties / correcao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / erros / items / properties / descricao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / erros / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedOutput schema / properties / tipoAmbiente / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
  5. Changed1 schema field changed
    • addedInput schema / properties / Carga / properties / OutrosDocumentos
      Added value: +{
+  "description": "Outros documentos que acompanham a carga quando não há NF-e (ex.: declaração de mudança, C2C). (infOutros)",
+  "items": {
+    "additionalProperties": false,
+    "description": "Outros documentos que acompanham a carga, quando não há NF/NF-e (ex.: mudança, C2C). Mapeia para infDoc/infOutros do CT-e.",
+    "properties": {
+      "Descricao": {
+        "description": "Descrição do documento. Obrigatória quando TipoDocumento = 99. (descOutros)",
+        "type": "string"
+      },
+      "DtEmissao": {
+        "description": "Data de emissão do documento. (dEmi)",
+        "format": "date-time",
+        "type": "string"
+      },
+      "DtPrevisao": {
+        "description": "Data prevista de entrega. (dPrev)",
+        "format": "date-time",
+        "type": "string"
+      },
+      "Numero": {
+        "description": "Número do documento. (nDoc)",
+        "type": "string"
+      },
+      "TipoDocumento": {
+        "description": "Tipo do documento originário. (tpDoc) Valores: 0 - Declaração; 10 - Dutoviário; 59 - CF-e SAT; 65 - NFC-e; 99 - Outros (exige Descricao)",
+        "enum": [
+          0,
+          10,
+          59,
+          65,
+          99
+        ],
+        "type": "integer"
+      },
+      "Valor": {
+        "description": "Valor do documento fiscal. (vDocFisc)",
+        "type": "number"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}
  6. First observed

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructiveHint=true and openWorldHint=true, so the safety profile is largely covered. The description adds useful prerequisite context (enabled service, digital certificate) but does not warn that TipoAmbiente=1 issues a legally binding document or describe what a failed SEFAZ response looks like — a notable omission for an irreversible emission.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two compact sentences with no filler; the operation comes first and the prerequisites second. It is efficiently written, though efficient in this case partly because so much is left out.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 25-parameter, nested, destructive fiscal emission tool, the description covers only the name and prerequisites. It omits the TipoCte taxonomy (normal/complementar/substituto), the production-vs-homologação consequence, and any note that an output schema exists carrying the authorization result. Far too thin for this complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 25 parameters, only 8 required and 52% schema description coverage, the description contributes nothing about parameters. It leaves the agent to discover from the schema which 8 are mandatory, that TipoCte=1 needs ChavesComplementadas and TipoCte=3 needs ChaveSubstituida, or that TipoCte has no documented enum in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ("Emite CT-e") with the acronym spelled out, so an agent can tell it apart from nfe_emitir, mdfe_emitir, dce_emitir and the other cte-prefixed tools. It stops short of differentiating from sub-variants like cte_desacordo or evento_* tools, but the core purpose is unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives prerequisites (CT-e service enabled on the company record, A1/A3 certificate configured) which imply when the call will succeed. However it never says when to use this versus siblings such as nfe_emitir or the event tools, nor what TipoCte values exist or how they change the required payload.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All fiscal toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources