Skip to main content
Glama

fiscal

by br.com.brasilnfe

Emitir NF-e complementar

nfe_emitir_complementar

Emite uma NF-e complementar referenciando uma NF-e já autorizada. Usado para complementar valores, impostos ou itens (finalidade=2). Informe a chave da nota original em NFReferencia.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
CFOPNoCFOP
LoteNoLote da Nota Fiscal
SerieNoSérie da nota Fiscal
CodigoNoCódigo numérico que compõe a Chave de Acesso. Número aleatório gerado pelo emitente para cada NF-e.
NumeroNoNúmero da nota fiscal
ClienteNo
CobrancaNo
ProdutosNo
ObservacaoNo
TransporteNo
NFReferenciaNoNotas fiscal de Referência
TipoAmbienteNoIdentificação do Ambiente Valores: 1 - Produção; 2 - Homologação
ObservacaoFiscoNo
TipoComplementoNoTipo de complemento Valores: 0 - Complementar quantidade ou valor; 1 - Complementar impostos
NaturezaOperacaoNoDescrição da Natureza da Operação
ImpostoComplementarNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
ErrorNoMensagem de erro da operação. Vazia ("") quando foi bem-sucedida.
AvisosNoAvisos não bloqueantes. Pode vir preenchida mesmo em emissão bem-sucedida.
ReturnNFNo
Base64XmlNo
Base64FileNo

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed1 schema field changed
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / motivoDesoneracaoIcms / description
      Previous value: -"1 - Táxi;; 2 - Deficiente Físico;; 3 - Produtor Agropecuário;; 4 - Frotista / Locadora;; 5 - Diplomático / Consular;; 6 - Utilitários e Motocicletas da Amazônia Ocidental e Áreas de Livre Comércio (Resolução 714/88 e 790/94 – CONTRAN e suas alterações);; 7 - SUFRAMA; 8 - Venda a Orgãos Publicos; 9 - Outros. (v2.0); 10 - Deficiente Condutor (Convênio ICMS 38/12). (v3.1); 11 - Deficiente não Condutor (Convênio ICMS 38/12). (v3.1); 16 - Olimpíadas Rio 2016"New value: +"1 - Táxi;; 2 - Deficiente Físico;; 3 - Produtor Agropecuário;; 4 - Frotista / Locadora;; 5 - Diplomático / Consular;; 6 - Utilitários e Motocicletas da Amazônia Ocidental e Áreas de Livre Comércio (Resolução 714/88 e 790/94 - CONTRAN e suas alterações);; 7 - SUFRAMA; 8 - Venda a Orgãos Publicos; 9 - Outros. (v2.0); 10 - Deficiente Condutor (Convênio ICMS 38/12). (v3.1); 11 - Deficiente não Condutor (Convênio ICMS 38/12). (v3.1); 16 - Olimpíadas Rio 2016"
  2. Changed2 schema fields changed
    • addedInput schema / properties / Produtos / items / properties / ChaveAcessoReferenciada
      Added value: +{
+  "description": "Chave de acesso (44 dígitos) da NF-e ORIGINAL que este item está devolvendo. Usado apenas em NF-e de devolução (Finalidade = 4, Reforma Tributária / NT 2025.002). Quando preenchida, o item é referenciado pelo grupo DFeReferenciado (por item) em vez do NFReferencia (nível nota) - os dois não podem coexistir.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / Produtos / items / properties / NItemReferenciado
      Added value: +{
+  "description": "Número do item (nItem) na NF-e ORIGINAL a que este item de devolução corresponde. É o número do item na nota de venda original, NÃO o número do item nesta devolução. Opcional; acompanha ChaveAcessoReferenciada.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}
  3. Changed146 schema fields changed
    • changedInput schema / properties / Cliente / properties / Contato / properties / Email / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Contato / properties / Fax / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Contato / properties / Telefone / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Contato / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Endereco / properties / Bairro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Endereco / properties / Cep / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Endereco / properties / CodMunicipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Endereco / properties / Complemento / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Endereco / properties / Logradouro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Endereco / properties / Municipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Endereco / properties / Numero / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Endereco / properties / Pais / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Endereco / properties / Uf / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Endereco / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / Ie / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / properties / IsUf / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cliente / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Cobranca / properties / Fatura / properties / Numero / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cobranca / properties / Fatura / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • addedInput schema / properties / Cobranca / properties / Parcelas / items / properties / Vencimento / description
      Added value: +"Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00)"
    • removedInput schema / properties / Cobranca / properties / Parcelas / items / properties / Vencimento / format
      Removed value: -"date-time"
    • changedInput schema / properties / Cobranca / properties / Parcelas / items / properties / Vencimento / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Cobranca / properties / Parcelas / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Cobranca / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Codigo / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / ImpostoComplementar / properties / CodSituacaoTributaria / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / ImpostoComplementar / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Lote / type
      Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
    • changedInput schema / properties / NFReferencia / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / NaturezaOperacao / type
      Previous value: -"string"New value: +[
+  "string",
+  "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 / ObservacaoFisco / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Agropecuaria / properties / Defensivos / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Agropecuaria / properties / GuiaTransito / properties / SerieGuia / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Agropecuaria / properties / GuiaTransito / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Agropecuaria / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / CEST / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / CodTributacao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Combustivel / properties / CodProdutoANP / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Combustivel / properties / DescricaoProdutoANP / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Combustivel / properties / UFConsumo / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Combustivel / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / Cnpj / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / CodExportador / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / CodFabricante / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • removedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / DataDesenbaraco / format
      Removed value: -"date-time"
    • removedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / DataRegistro / format
      Removed value: -"date-time"
    • changedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / LocalDesenbaraco / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / Numero / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / Uf / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / UfDesenbaraco / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / ValorAFRMM / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / EAN / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / COFINS / properties / BaseCalculo / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / COFINS / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / AliquotaCBS / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / AliquotaIBSMun / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / AliquotaIBSUF / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / BaseCalculo / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / CodClassificacaoTributaria / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / PercentualDiferimento / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / PercentualReducaoCBS / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / PercentualReducaoIBS / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / AliquotaAdRemRetido / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / AliquotaCredito / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / AliquotaICMS / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / AliquotaICMSST / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / AliquotaMVA / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / BaseCalculo / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / QuantidadeMonoRetido / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / RedICMS / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / RedICMSST / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / STRetido / properties / AliquotaConsumidorFinal / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / STRetido / properties / AliquotaEfetiva / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / STRetido / properties / AliquotaFCP / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / STRetido / properties / BaseCalculo / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / STRetido / properties / BaseCalculoEfetiva / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / STRetido / properties / BaseCalculoFCP / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / STRetido / properties / PercentualReducaoBaseEfetiva / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / STRetido / properties / ValorICMSST / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / STRetido / properties / ValorICMSSubstituto / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / STRetido / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / ValorIcms / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / ValorIcmsMonoRetido / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / aliquotaDiferimento / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / motivoDesoneracaoIcms / enum
      Previous value: -[
-  1,
-  2,
-  3,
-  4,
-  5,
-  6,
-  7,
-  8,
-  9,
-  10,
-  11,
-  16
-]New value: +[
+  1,
+  2,
+  3,
+  4,
+  5,
+  6,
+  7,
+  8,
+  9,
+  10,
+  11,
+  16,
+  null
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / motivoDesoneracaoIcms / type
      Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / valorDesoneracaoIcms / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / IPI / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / Importacao / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / PIS / properties / BaseCalculo / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / PIS / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / InformacaoAdicional / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / NItemPed / type
      Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / QuantidadeTributavel / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Rastros / items / properties / CodigoAgregacao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • removedInput schema / properties / Produtos / items / properties / Rastros / items / properties / DataFabricacao / format
      Removed value: -"date-time"
    • removedInput schema / properties / Produtos / items / properties / Rastros / items / properties / DataValidade / format
      Removed value: -"date-time"
    • changedInput schema / properties / Produtos / items / properties / Rastros / items / properties / NumeroLote / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / Rastros / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / UnidadeComercialTributavel / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / ValorFrete / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / ValorOutrasDespesas / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / ValorSeguro / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / ValorUnitarioTributavel / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / cBenef / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / nFCI / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / items / properties / xPed / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Produtos / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Serie / type
      Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Balsa / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / CNPJ / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / DsEndereco / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / IE / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / NmMunicipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / NmTransportador / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Reboque / items / properties / Placa / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Reboque / items / properties / RNTC / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Reboque / items / properties / UF / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Reboque / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / UF / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Vagao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Veiculo / properties / Placa / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Veiculo / properties / RNTC / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Veiculo / properties / UF / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Veiculo / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Volumes / items / properties / Especie / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Volumes / items / properties / Lacres / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Volumes / items / properties / Marca / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Volumes / items / properties / Numero / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Transporte / properties / Volumes / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedInput schema / properties / Transporte / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedOutput schema / properties / Avisos / type
      Previous value: -"array"New value: +[
+  "array",
+  "null"
+]
    • changedOutput schema / properties / Base64File / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / Base64Xml / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / Error / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / ReturnNF / properties / ChaveNF / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / ReturnNF / properties / Detalhes / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedOutput schema / properties / ReturnNF / properties / DsStatusRespostaSefaz / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / ReturnNF / properties / DsTipoAmbiente / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / ReturnNF / properties / NumeroProtocolo / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedOutput schema / properties / ReturnNF / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
  4. Changed3 schema fields changed
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / AliquotaAdRemRetido
      Added value: +{
+  "description": "adRemICMSRet - Alíquota ad rem do ICMS retido anteriormente. Obrigatório no CST 61 (tributação monofásica sobre combustíveis cobrada anteriormente).",
+  "type": "number"
+}
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / QuantidadeMonoRetido
      Added value: +{
+  "description": "qBCMonoRet - Quantidade tributada retida anteriormente (em unidade de medida da legislação). Opcional no CST 61. Quando não informada, assume a quantidade comercial do item.",
+  "type": "number"
+}
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / ValorIcmsMonoRetido
      Added value: +{
+  "description": "vICMSMonoRet - Valor do ICMS retido anteriormente no CST 61. Opcional: quando não informado, é calculado por QuantidadeMonoRetido x AliquotaAdRemRetido.",
+  "type": "number"
+}
  5. Changed3 schema fields changed
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / PercentualDiferimento
      Added value: +{
+  "description": "Percentual de diferimento (pDif do grupo gDif), usado nos CST 510/515. Informado pelo contribuinte - NÃO é fixo por cClassTrib. O valor diferido (vDif) é deduzido do IBS/CBS devido.",
+  "type": "number"
+}
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / PercentualReducaoCBS
      Added value: +{
+  "description": "Percentual de redução da alíquota da CBS (pRedAliq de gCBS). Pode divergir de PercentualReducaoIBS (ex.: 200025 = IBS 60 / CBS 100). Quando null, é preenchido automaticamente pela tabela oficial.",
+  "type": "number"
+}
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / IBSCBS / properties / PercentualReducaoIBS
      Added value: +{
+  "description": "Percentual de redução da alíquota do IBS (pRedAliq de gIBSUF/gIBSMun), usado no grupo gRed dos CST 011/200/515. Fixo por cClassTrib na tabela oficial (ex.: 100 para 200003 alimentação/Anexo I, 60 para educação/saúde). Quando null, é preenchido automaticamente pela tabela oficial (TabelaReducaoIbsCbs).",
+  "type": "number"
+}
  6. First observed

TDQS

A4.3/5.0
Behavior4/5

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

With only openWorldHint annotation, the description carries the burden of explaining the tool's behavior. It discloses that the tool requires an already authorized NF-e and directs the user to provide the original key in NFReferencia, adding meaningful behavioral context beyond the annotation. It does not enumerate all technical side effects (e.g., SEFAZ submission), but the essential behavior is transparent.

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

Conciseness5/5

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

Two sentences with no fluff. The first states the core action, the second gives the use case and the key parameter. Information is front-loaded and every word earns its place.

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

Completeness3/5

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

Given the tool has 16 parameters and a complex fiscal domain, the description is minimal. It omits guidance on TipoComplemento, ImpostoComplementar, and how to handle item-level complements. The output schema may cover return values, but an agent would struggle to know the full set of considerations for correct usage, so the description is merely adequate.

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

Parameters4/5

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

The description explicitly instructs to pass the original invoice key in NFReferencia, adding meaningful value beyond the schema's vague 'Notas fiscal de Referência'. With schema coverage at 56%, highlighting this critical parameter helps agents avoid misusing the tool. However, it does not clarify the distinction between TipoComplemento values or the ImpostoComplementar structure, so it's not a 5.

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

Purpose5/5

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

The description clearly states the tool emits a complementary NF-e referencing an already authorized NF-e, using the specific verb 'Emite' and the resource 'NF-e complementar'. It distinguishes itself from sibling tools like nfe_emitir through the qualifier 'complementar' and the explicit finalidade=2 context.

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

Usage Guidelines4/5

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

It provides clear usage context: for complementing values, taxes, or items of an already authorized invoice. It does not explicitly name alternative tools (e.g., nfe_emitir for normal invoices), but the reference to a previously authorized NF-e and finalidade=2 gives an agent enough context to select this over a regular emission.

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
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A3.6/5.0
Disambiguation5/5

Each tool has a clearly distinct purpose, with thorough descriptions that clarify overlaps (e.g., cliente_consultar vs cadastro_consultar). Even similar operations like arquivo_baixar variants have explicit scope differences.

Naming Consistency4/5

Most tools follow a noun_verb pattern (e.g., cliente_consultar, evento_cancelar, produto_criar), but a few deviate (e.g., 'health', 'cte_desacordo'). Overall consistent enough for easy recognition.

Tool Count4/5

34 tools is high but justified given the complexity of fiscal document management across multiple document types (NF-e, NFS-e, CT-e, MDF-e, etc.) and required CRUD, events, and auxiliary operations.

Completeness4/5

The tool set covers create/read/update/delete for clients, products, and tax rules, plus emission, cancellation, correction, and status checks for various documents. Minor gaps like dedicated NFS-e cancellation are handled by generic event tools.

Resources