Skip to main content
Glama

fiscal

by br.com.brasilnfe
OverviewDiscussionsAdmin

Emitir NF-e complementar

nfe_emitir_complementar
Destructive

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

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

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.

  1. Changed4 schema fields changed
    • addedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / NumeroAdicao
      Added value: +{
+  "description": "nAdicao - Número da adição do item na DI (1 a 999). Quando não informado, vai 1.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}
    • addedInput schema / properties / Produtos / items / properties / DeclaracaoImportacao / properties / NumeroSequencialAdicao
      Added value: +{
+  "description": "nSeqAdic - Número sequencial do item dentro da adição (1 a 99999). Quando não informado, vai 1.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / IPI / properties / BaseCalculo
      Added value: +{
+  "description": "Base de Cálculo (Quando não informado, é o valor dos produtos + frete + seguro + outras despesas - desconto). Na importação informe o valor aduaneiro + II, como na DI/DUIMP.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / IPI / properties / ValorIpi
      Added value: +{
+  "description": "Valor do IPI (Calculado automaticamente pela base x alíquota quando não informado)",
+  "type": [
+    "number",
+    "null"
+  ]
+}
  2. Changed1 schema field changed
    • addedInput schema / properties / Produtos / items / properties / VeiculoNovo
      Added value: +{
+  "additionalProperties": false,
+  "description": "Veículo novo (grupo veicProd: chassi, cor, motor, cilindrada, combustível, ano etc.), só na NF-e modelo 55, com Quantidade = 1.",
+  "properties": {
+    "AnoFabricacao": {
+      "description": "Ano de fabricação (anoFab).",
+      "type": "integer"
+    },
+    "AnoModelo": {
+      "description": "Ano modelo (anoMod): o ano de fabricação ou o seguinte.",
+      "type": "integer"
+    },
+    "CapacidadeMaximaTracaoKg": {
+      "description": "Capacidade máxima de tração em kg. Vai no XML em toneladas com 4 casas (CMT). Se não informada, vai o peso bruto (veículo que não traciona reboque).",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "Chassi": {
+      "description": "Chassi (VIN): 17 letras maiúsculas e números, sem espaços ou separadores. (chassi)",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "ChassiRemarcado": {
+      "description": "Chassi remarcado (VIN).",
+      "type": "boolean"
+    },
+    "Cilindradas": {
+      "description": "Cilindrada em cm³ (cilin), até 4 dígitos. Veículo 100% elétrico: 0.",
+      "type": "integer"
+    },
+    "CodigoCor": {
+      "description": "Código da cor na montadora, até 4 caracteres (cCor). Se não informado, vai o código da cor DENATRAN.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "CodigoMarcaModelo": {
+      "description": "Código marca/modelo da tabela RENAVAM, até 6 dígitos (cMod).",
+      "type": "integer"
+    },
+    "CondicaoVeiculo": {
+      "description": "Condição do veículo (condVeic). Se não informada, vai 1. Valores: 1 - Acabado; 2 - Inacabado; 3 - Semiacabado",
+      "enum": [
+        1,
+        2,
+        3,
+        null
+      ],
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "CorDenatran": {
+      "description": "Cor DENATRAN (cCorDENATRAN). Valores: 1 - Amarelo; 2 - Azul; 3 - Bege; 4 - Branca; 5 - Cinza; 6 - Dourada; 7 - Grená; 8 - Laranja; 9 - Marrom; 10 - Prata; 11 - Preta; 12 - Rosa; 13 - Roxa; 14 - Verde; 15 - Vermelha; 16 - Fantasia",
+      "enum": [
+        1,
+        2,
+        3,
+        4,
+        5,
+        6,
+        7,
+        8,
+        9,
+        10,
+        11,
+        12,
+        13,
+        14,
+        15,
+        16
+      ],
+      "type": "integer"
+    },
+    "DescricaoCor": {
+      "description": "Descrição da cor, até 40 caracteres (xCor). Ex.: \"VERMELHO PERSEU\".",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "DistanciaEixos": {
+      "description": "Distância entre eixos, até 4 caracteres, como na ficha da montadora (dist).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "EspecieVeiculo": {
+      "description": "Espécie, tabela RENAVAM (espVeic). Valores: 1 - Passageiro; 2 - Carga; 3 - Misto; 4 - Corrida; 5 - Tração; 6 - Especial",
+      "enum": [
+        1,
+        2,
+        3,
+        4,
+        5,
+        6
+      ],
+      "type": "integer"
+    },
+    "Lotacao": {
+      "description": "Lotação: passageiros sentados, incluindo o motorista (lota). Motocicleta: normalmente 2.",
+      "type": "integer"
+    },
+    "NumeroMotor": {
+      "description": "Número do motor, até 21 caracteres (nMotor).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "NumeroSerie": {
+      "description": "Número de série, até 9 caracteres (nSerie).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "PesoBrutoKg": {
+      "description": "Peso bruto total em kg. Vai no XML em toneladas com 4 casas (pesoB).",
+      "type": "number"
+    },
+    "PesoLiquidoKg": {
+      "description": "Peso líquido em kg. Vai no XML em toneladas com 4 casas (pesoL): 128 kg = 0.1280.",
+      "type": "number"
+    },
+    "Potencia": {
+      "description": "Potência máxima do motor em CV (pot), até 4 caracteres com o ponto (ex.: 15 ou 14.9).",
+      "type": "number"
+    },
+    "TipoCombustivel": {
+      "description": "Tipo de combustível, tabela RENAVAM (tpComb). Exemplos:",
+      "type": "integer"
+    },
+    "TipoOperacao": {
+      "description": "Tipo da operação (tpOp). Se não informado, vai 0. Valores: 0 - Outros (concessionária ou revenda); 1 - Venda concessionária (fabricante/importador); 2 - Faturamento direto para consumidor final (fabricante/importador); 3 - Venda direta para grandes consumidores (fabricante/importador)",
+      "enum": [
+        0,
+        1,
+        2,
+        3,
+        null
+      ],
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "TipoPintura": {
+      "description": "Tipo de pintura, 1 caractere, conforme a montadora (tpPint).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "TipoRestricao": {
+      "description": "Restrição (tpRest). Se não informada, vai 0. Valores: 0 - Não há; 1 - Alienação fiduciária; 2 - Arrendamento mercantil; 3 - Reserva de domínio; 4 - Penhor de veículos; 9 - Outras",
+      "enum": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        9,
+        null
+      ],
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "TipoVeiculo": {
+      "description": "Tipo de veículo, tabela RENAVAM (tpVeic). Exemplos:",
+      "type": "integer"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}
  3. Changed1 schema field changed
    • addedInput schema / properties / Produtos / items / properties / Exportacoes
      Added value: +{
+  "description": "Exportação do item (grupo detExport, até 500 por item): drawback e/ou exportação indireta. Na exportação indireta (CFOP 7501 ou 3503) informar a chave da NF-e recebida com fim específico de exportação; várias UFs rejeitam sem ela (340 - Não informado o grupo de exportação indireta no item).",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "ChaveAcessoNFe": {
+        "description": "Chave de acesso (44 dígitos) da NF-e recebida com fim específico de exportação. Obrigatória na exportação indireta (CFOP 7501 ou 3503).",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "NumeroDrawback": {
+        "description": "Número do ato concessório de Drawback (1-20 caracteres). Opcional.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "NumeroRegistroExportacao": {
+        "description": "Número do Registro de Exportação (até 12 dígitos). Opcional: desde a DU-E pode ficar vazio.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "QuantidadeExportada": {
+        "description": "Quantidade do item realmente exportada (até 4 casas decimais). Se não informada, usa a Quantidade do item.",
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}
  4. Changed1 schema field changed
    • changedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / RedICMSST / description
      Previous value: -"Redução ICMS ST"New value: +"Percentual de redução da base de cálculo do ICMS ST (pRedBCST). Informado (inclusive 0): a base do ST parte do valor da operação sem a redução própria (RedICMS) e aplica só este percentual. Não informado: a redução própria (RedICMS) também reduz a base do ST."
  5. Changed4 schema fields changed
    • addedInput schema / properties / Produtos / items / properties / Combustivel / properties / PercentualGLP
      Added value: +{
+  "description": "GLP (ANP 210203001): percentuais de GLP derivado do petróleo, gás natural nacional e importado; a soma deve ser 100",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedInput schema / properties / Produtos / items / properties / Combustivel / properties / PercentualGasNaturalImportado
      Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedInput schema / properties / Produtos / items / properties / Combustivel / properties / PercentualGasNaturalNacional
      Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedInput schema / properties / Produtos / items / properties / Combustivel / properties / ValorPartida
      Added value: +{
+  "description": "GLP (ANP 210203001): valor de partida por quilograma, sem ICMS",
+  "type": [
+    "number",
+    "null"
+  ]
+}
  6. Changed4 schema fields changed
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / AliquotaFCP
      Added value: +{
+  "description": "pFCP - Percentual do Fundo de Combate à Pobreza (FCP) da operação própria. Aceito nos CST 00, 10, 20, 51, 70 e 90. O valor (vFCP) é calculado por BaseCalculoFCP x AliquotaFCP / 100 e somado no total vFCP da nota (não soma no vNF). Quando não informado (null), é preenchido pelo FCP geral da UF do emitente (RJ 2%, AL 1%, SE 1%) em NF-e/NFC-e de saída normal interna, CST 00 ou 10, sem redução de base e com AliquotaICMS igual à alíquota modal da UF. Informe 0 para não destacar o FCP. Não informe em venda interestadual para consumidor final não contribuinte: lá o FCP da UF de destino vai no grupo do DIFAL (vFCPUFDest), calculado automaticamente (rejeição 876).",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / AliquotaFCPST
      Added value: +{
+  "description": "pFCPST - Percentual do FCP retido por substituição tributária. Aceito nos CST 10, 30, 70 e 90 e nos CSOSN 201, 202, 203 e 900. O valor (vFCPST) é BaseCalculoFCPST x AliquotaFCPST / 100 - vFCP (regra N23d-10 da SEFAZ) e soma no total da nota (vNF), como o ICMS-ST. Informe em AliquotaICMSST só a alíquota do ICMS, sem o FCP.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / BaseCalculoFCP
      Added value: +{
+  "description": "vBCFCP - Base de cálculo do FCP da operação própria. Quando não informada, é a base do ICMS (vBC). No CST 00 o schema não tem vBCFCP: o FCP é sempre calculado sobre a base do ICMS.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedInput schema / properties / Produtos / items / properties / Imposto / properties / ICMS / properties / BaseCalculoFCPST
      Added value: +{
+  "description": "vBCFCPST - Base de cálculo do FCP-ST. Quando não informada, é a base do ICMS-ST (vBCST).",
+  "type": [
+    "number",
+    "null"
+  ]
+}
  7. 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"
  8. 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"
+  ]
+}
  9. 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"
+]
  10. 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"
+}
  11. 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"
+}
  12. First observed

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare destructiveHint=true and openWorldHint=true, so the agent knows this is an irreversible external fiscal transmission. The description adds the finalidade=2 reference behavior, but says nothing about numbering/series consumption, authorization prerequisites per environment, or the consequences of a rejected emission.

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 short sentences with zero waste; the reference requirement is front-loaded right after the purpose statement.

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 16-parameter, deeply nested fiscal emission tool with no required parameters declared, the description does not explain the two emission paths (inform Produtos/Imposto versus ImpostoComplementar), the TipoComplemento semantics, or what is mandatory in practice. An output schema exists, so return values need not be covered, but the input-side guidance is far too thin.

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

Parameters3/5

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

Schema coverage is only 56% and several top-level parameters (Lote, Serie, Numero, CFOP, Observacao, Transporte fields) have no meaningful description. The description does add real meaning for NFReferencia (the original note's access key), but ignores key structural choices such as TipoComplemento and Produtos vs ImpostoComplementar.

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 (emit a complementary NF-e) and the distinguishing condition (referencing an already authorized NF-e, finalidade=2). This separates it from nfe_emitir without naming the sibling, so it is clear but not fully differentiated.

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?

Gives clear context for when the tool applies (complementing values, taxes or items) and a prerequisite (the original note must already be authorized). It does not state when NOT to use it, e.g. devolução via ChaveAcessoReferenciada or a normal emission via nfe_emitir.

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