Skip to main content
Glama

fiscal

by br.com.brasilnfe
OverviewDiscussionsAdmin

Emitir NF-e ou NFC-e

nfe_emitir
Destructive

Emite uma NF-e (modelo 55) ou NFC-e (modelo 65) na SEFAZ. Use modeloDocumento=55 para NF-e (B2B com destinatário CPF/CNPJ) ou modeloDocumento=65 para NFC-e (consumidor final). Retorna chave de acesso (44 dígitos), número, protocolo, status e XML/DANFE em base64. Operação síncrona (pode levar 5-30s). Use tipoAmbiente=2 (homologação) para testes. TRANSMITE DE VERDADE: só chame depois que o usuário aprovou a pré-visualização final (nfe_previsualizar) e confirmou a emissão; envie confirmacaoUsuario=true (conexões OAuth são recusadas sem ele).

Input Schema

NameRequiredDescriptionDefault
LoteNoLote da Nota Fiscal
SerieNoSérie da nota Fiscal
CodigoNoB03 - Có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
ClienteNoDestinatário da nota. OBRIGATÓRIO para NF-e (modelo 55). Para NFC-e (modelo 65) só é obrigatório quando IndicadorPresenca = 4 (entrega a domicílio). Quando informado para NF-e mod 55, exige: CpfCnpj, NmCliente, IndicadorIe (1/2/9), Endereco com Logradouro e UF (e CEP/Município/Bairro quando não exportação).
EntregaNo
ExportaNo
CobrancaNo
ProdutosYesItens da nota fiscal. Mínimo 1 item.
RetencoesNoRetenções federais totais da nota (IRRF, PIS/COFINS/CSLL retidos, Previdência). Gera a tag retTrib no XML.
TipoDanfeNoFormato de impressão do DANFE (tag tpImp da NF-e). Não informado = padrão atual (1-Retrato para NF-e, 4 para NFC-e). Valores: 0 - Sem geração de DANFE; 1 - DANFE normal, Retrato (padrão NF-e); 2 - DANFE normal, Paisagem; 3 - DANFE Simplificado; 4 - DANFE NFC-e (padrão NFC-e; somente modelo 65); 5 - DANFE NFC-e em mensagem eletrônica (somente modelo 65); 6 - DANFE Simplificado Tipo 2 (NT 2026.002/2026.003, Ajuste SINIEF 13/26; somente modelo 55) - NF-e de varejo em operação típica de NFC-e, impressa em bobina com QR Code. Exige operação interna (CFOP 5xxx), consumidor final, finalidade 1-Normal, saída, sem notas referenciadas e IndicadorPresenca 1, 4 ou 5.
FinalidadeYesFinalidade da emissão da NF. Valores: 1 - Normal (caso mais comum); 2 - Complementar (referenciando NF anterior em NFReferencia); 3 - Ajuste; 4 - Devolução; 5 - Nota de crédito; 6 - Nota de débito
ObservacaoNo
PagamentosNoFormas de pagamento. OBRIGATÓRIO quando Finalidade = 1 (Normal). Para finalidades 2/3/4/5/6 pode ficar vazio. Para NFC-e (mod 65) deve haver pelo menos um pagamento com FormaPagamento diferente de "90" (sem pagamento).
TpNFDebitoNoTipo de Nota de Débito. Obrigatório quando Finalidade = 6. Código SEFAZ: Valores: 1 - Transferência de créditos para Cooperativas; 2 - Anulação de Crédito por Saídas Imunes/Isentas; 3 - Débitos de notas fiscais não processadas na apuração; 4 - Multa e juros; 5 - Transferência de crédito de sucessão; 6 - Pagamento antecipado; 7 - Perda em estoque
TransporteNo
ValorFreteNoValor total do frete da nota. Quando informado, é distribuído proporcionalmente entre os itens (proporção pelo ValorTotal de cada item), SUBSTITUINDO o ValorFrete informado em cada produto. Não informado (nulo) = o frete de cada item é usado como enviado.
ValorTotalNoValor total esperado da nota (vNF), usado apenas para validação. Quando informado e diferente do valor total calculado (produtos - descontos + frete + seguro + outras despesas + impostos que compõem o total), a emissão é bloqueada e o erro detalha o cálculo. Não informado (nulo) = sem validação.
DataEmissaoNoData e Hora de emissão da nota (dhEmi). Envia a data atual caso não informada.
EnviarEmailNo
TpNFCreditoNoTipo de Nota de Crédito. Obrigatório quando Finalidade = 5. Código SEFAZ: Valores: 1 - Multa e juros; 2 - Apropriação de crédito presumido de IBS sobre saldo devedor na ZFM; 3 - Retorno por recusa total na entrega ou por não localização do destinatário; 4 - Redução de valores; 5 - Transferência de crédito na sucessão; 6 - Retorno por recusa parcial na entrega
CalcularIBPTNoCalcula o valor aproximado dos tributos (vTotTrib, tabela IBPT, Lei 12.741/2012). Padrão: verdadeiro.
NFReferenciaNoNotas fiscal de Referência
TipoAmbienteYesIdentificação do ambiente da SEFAZ. Valores: 1 - Produção (emissão REAL, com valor fiscal, irreversível); 2 - Homologação (teste, sem valor fiscal - use durante desenvolvimento e testes)
IntermediadorNoDados do intermediador/marketplace (site ou plataforma de terceiros).
JustificativaNoUtilizar quando o tipo de emissão for diferente normal
ValorDescontoNoValor total do desconto da nota. Quando informado, é distribuído proporcionalmente entre os itens (proporção pelo ValorTotal de cada item), SUBSTITUINDO o ValorDesconto informado em cada produto. Não informado (nulo) = o desconto de cada item é usado como enviado.
ConsumidorFinalNoIndica operação com Consumidor final (NFCe de ser 1 Validar!)
ModeloDocumentoYesCódigo do modelo do Documento Fiscal. Valores: 55 - NF-e (B2B / com destinatário CPF/CNPJ identificado); 65 - NFC-e (consumidor final / varejo)
ObservacaoFiscoNo
DataEntradaSaidaNoData e Hora da saída ou de entrada da mercadoria (dhSaiEnt), só na NF-e modelo 55. Não informada, a nota sai sem dhSaiEnt (em branco no DANFE); não usa a DataEmissao.
NaturezaOperacaoYesDescrição da natureza da operação (máx 60 caracteres). Exemplos: "Venda de mercadoria", "Remessa para industrialização", "Devolução de venda".
IndicadorPresencaYesIndicador de presença do comprador no estabelecimento comercial no momento da operação. Padrão sugerido para NF-e B2B = 9 (operação não presencial, outros). Para NFC-e varejo = 1 (presencial). Valores: 0 - Não se aplica; 1 - Operação presencial;; 2 - Operação não presencial, pela Internet;; 3 - Operação não presencial, Teleatendimento;; 4 - NFC-e em operação com entrega a domicílio;; 5 - Presencial fora do estabelecimento;; 9 - Operação não presencial, outros.
confirmacaoUsuarioNoEnvie true SOMENTE depois que o usuário viu a pré-visualização final e confirmou explicitamente a emissão nesta conversa. Obrigatório em conexões OAuth.
IdentificadorInternoNo
NFPagamentoAntecipadoNoGrupo de notas de antecipação de pagamento (gPagAntecipado - Reforma Tributária).

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. Changed3 schema fields changed
    • changedInput schema / properties / DataEmissao / description
      Previous value: -"Data e Hora da saída ou de entrada da produto/serviço (Envia a data atual caso não informada)"New value: +"Data e Hora de emissão da nota (dhEmi). Envia a data atual caso não informada."
    • changedInput schema / properties / DataEntradaSaida / description
      Previous value: -"Data e Hora da saída ou de entrada da produto/serviço"New value: +"Data e Hora da saída ou de entrada da mercadoria (dhSaiEnt), só na NF-e modelo 55. Não informada, a nota sai sem dhSaiEnt (em branco no DANFE); não usa a DataEmissao."
    • 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
    • addedInput schema / properties / ValorDesconto
      Added value: +{
+  "description": "Valor total do desconto da nota. Quando informado, é distribuído proporcionalmente entre os itens (proporção pelo ValorTotal de cada item), SUBSTITUINDO o ValorDesconto informado em cada produto. Não informado (nulo) = o desconto de cada item é usado como enviado.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
  8. Changed1 schema field changed
    • addedInput schema / properties / confirmacaoUsuario
      Added value: +{
+  "description": "Envie true SOMENTE depois que o usuário viu a pré-visualização final e confirmou explicitamente a emissão nesta conversa. Obrigatório em conexões OAuth.",
+  "type": "boolean"
+}
  9. Changed1 schema field changed
    • changedInput schema / properties / CalcularIBPT / description
      Previous value: -"Indica operação com Consumidor final (NFCe de ser 1 Validar!)"New value: +"Calcula o valor aproximado dos tributos (vTotTrib, tabela IBPT, Lei 12.741/2012). Padrão: verdadeiro."
  10. Changed2 schema fields changed
    • addedInput schema / properties / ValorFrete
      Added value: +{
+  "description": "Valor total do frete da nota. Quando informado, é distribuído proporcionalmente entre os itens (proporção pelo ValorTotal de cada item), SUBSTITUINDO o ValorFrete informado em cada produto. Não informado (nulo) = o frete de cada item é usado como enviado.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedInput schema / properties / ValorTotal
      Added value: +{
+  "description": "Valor total esperado da nota (vNF), usado apenas para validação. Quando informado e diferente do valor total calculado (produtos - descontos + frete + seguro + outras despesas + impostos que compõem o total), a emissão é bloqueada e o erro detalha o cálculo. Não informado (nulo) = sem validação.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
  11. Changed3 schema fields changed
    • addedInput schema / properties / NFPagamentoAntecipado
      Added value: +{
+  "description": "Grupo de notas de antecipação de pagamento (gPagAntecipado - Reforma Tributária).",
+  "items": {
+    "type": "string"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}
    • changedInput schema / properties / TpNFCredito / description
      Previous value: -"Tipo de Nota de Crédito. Obrigatório quando Finalidade = 5. Código SEFAZ: Valores: 1 - Multa e juros; 2 - Apropriação de crédito presumido de IBS sobre saldo devedor na ZFM; 3 - Retorno"New value: +"Tipo de Nota de Crédito. Obrigatório quando Finalidade = 5. Código SEFAZ: Valores: 1 - Multa e juros; 2 - Apropriação de crédito presumido de IBS sobre saldo devedor na ZFM; 3 - Retorno por recusa total na entrega ou por não localização do destinatário; 4 - Redução de valores; 5 - Transferência de crédito na sucessão; 6 - Retorno por recusa parcial na entrega"
    • changedInput schema / properties / TpNFCredito / enum
      Previous value: -[
-  1,
-  2,
-  3,
-  null
-]New value: +[
+  1,
+  2,
+  3,
+  4,
+  5,
+  6,
+  null
+]
  12. Changed1 schema field changed
    • addedInput schema / properties / TipoDanfe
      Added value: +{
+  "description": "Formato de impressão do DANFE (tag tpImp da NF-e). Não informado = padrão atual (1-Retrato para NF-e, 4 para NFC-e). Valores: 0 - Sem geração de DANFE; 1 - DANFE normal, Retrato (padrão NF-e); 2 - DANFE normal, Paisagem; 3 - DANFE Simplificado; 4 - DANFE NFC-e (padrão NFC-e; somente modelo 65); 5 - DANFE NFC-e em mensagem eletrônica (somente modelo 65); 6 - DANFE Simplificado Tipo 2 (NT 2026.002/2026.003, Ajuste SINIEF 13/26; somente modelo 55) - NF-e de varejo em operação típica de NFC-e, impressa em bobina com QR Code. Exige operação interna (CFOP 5xxx), consumidor final, finalidade 1-Normal, saída, sem notas referenciadas e IndicadorPresenca 1, 4 ou 5.",
+  "enum": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5,
+    6,
+    null
+  ],
+  "type": [
+    "integer",
+    "null"
+  ]
+}
  13. Changed2 schema fields changed
    • changedInput schema / properties / Pagamentos / items / properties / BandeiraOperadora / description
      Previous value: -"01 - Visa; 02 - Mastercard; 03 - American Express; 04 - Sorocred; 05 - Diners Club; 06 - Elo; 07 - Hipercard; 08 - Aura; 09 - Cabal; 99 - Outros"New value: +"01 - Visa; 02 - Mastercard; 03 - American Express; 04 - Sorocred; 05 - Diners Club; 06 - Elo; 07 - Hipercard; 08 - Aura; 09 - Cabal; 10 - Alelo; 11 - Banes Card; 12 - CalCard; 13 - Credz; 14 - Discover; 15 - GoodCard; 16 - GreenCard; 17 - Hiper; 18 - JcB; 19 - Mais; 20 - MaxVan; 21 - Policard; 22 - RedeCompras; 23 - Sodexo; 24 - ValeCard; 25 - Verocheque; 26 - VR; 27 - Ticket; 99 - Outros"
    • changedInput schema / properties / Pagamentos / items / properties / BandeiraOperadora / enum
      Previous value: -[
-  "01",
-  "02",
-  "03",
-  "04",
-  "05",
-  "06",
-  "07",
-  "08",
-  "09",
-  "99",
-  null
-]New value: +[
+  "01",
+  "02",
+  "03",
+  "04",
+  "05",
+  "06",
+  "07",
+  "08",
+  "09",
+  "10",
+  "11",
+  "12",
+  "13",
+  "14",
+  "15",
+  "16",
+  "17",
+  "18",
+  "19",
+  "20",
+  "21",
+  "22",
+  "23",
+  "24",
+  "25",
+  "26",
+  "27",
+  "99",
+  null
+]
  14. Changed7 schema fields changed
    • addedInput schema / properties / Pagamentos / items / properties / CNPJPagamento
      Added value: +{
+  "description": "CNPJ do estabelecimento onde o pagamento foi processado/transacionado/recebido (CNPJPag - NT 2023.004). Informar junto com UFPagamento (os dois ou nenhum). Opcional.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / Pagamentos / items / properties / CNPJRecebedor
      Added value: +{
+  "description": "CNPJ do beneficiário do pagamento (CNPJReceb - NT 2023.004). Opcional.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / Pagamentos / items / properties / DataPagamento
      Added value: +{
+  "description": "Data do pagamento (dPag - NT 2023.004). Opcional.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / Pagamentos / items / properties / IdTerminalPagamento
      Added value: +{
+  "description": "Identificador do terminal de pagamento (idTermPag - NT 2023.004). Opcional, 1-40 caracteres.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / Pagamentos / items / properties / NumeroAutorizacao / description
      Added value: +"Número de autorização da operação (cAut). Para PIX, informar o EndToEndId (e2eid) da transação."
    • addedInput schema / properties / Pagamentos / items / properties / UFPagamento
      Added value: +{
+  "description": "UF do estabelecimento onde o pagamento foi processado (UFPag - NT 2023.004). Opcional.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • 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"
  15. Changed5 schema fields changed
    • changedInput schema / properties / Finalidade / description
      Previous value: -"Finalidade da emissão da NF. Valores: 1 - Normal (caso mais comum); 2 - Complementar (referenciando NF anterior em NFReferencia); 3 - Ajuste; 4 - Devolução"New value: +"Finalidade da emissão da NF. Valores: 1 - Normal (caso mais comum); 2 - Complementar (referenciando NF anterior em NFReferencia); 3 - Ajuste; 4 - Devolução; 5 - Nota de crédito; 6 - Nota de débito"
    • changedInput schema / properties / Finalidade / enum
      Previous value: -[
-  1,
-  2,
-  3,
-  4
-]New value: +[
+  1,
+  2,
+  3,
+  4,
+  5,
+  6
+]
    • changedInput schema / properties / Pagamentos / description
      Previous value: -"Formas de pagamento. OBRIGATÓRIO quando Finalidade = 1 (Normal). Para finalidades 2/3/4 pode ficar vazio. Para NFC-e (mod 65) deve haver pelo menos um pagamento com FormaPagamento diferente de \"90\" (sem pagamento)."New value: +"Formas de pagamento. OBRIGATÓRIO quando Finalidade = 1 (Normal). Para finalidades 2/3/4/5/6 pode ficar vazio. Para NFC-e (mod 65) deve haver pelo menos um pagamento com FormaPagamento diferente de \"90\" (sem pagamento)."
    • addedInput schema / properties / TpNFCredito
      Added value: +{
+  "description": "Tipo de Nota de Crédito. Obrigatório quando Finalidade = 5. Código SEFAZ: Valores: 1 - Multa e juros; 2 - Apropriação de crédito presumido de IBS sobre saldo devedor na ZFM; 3 - Retorno",
+  "enum": [
+    1,
+    2,
+    3,
+    null
+  ],
+  "type": [
+    "integer",
+    "null"
+  ]
+}
    • addedInput schema / properties / TpNFDebito
      Added value: +{
+  "description": "Tipo de Nota de Débito. Obrigatório quando Finalidade = 6. Código SEFAZ: Valores: 1 - Transferência de créditos para Cooperativas; 2 - Anulação de Crédito por Saídas Imunes/Isentas; 3 - Débitos de notas fiscais não processadas na apuração; 4 - Multa e juros; 5 - Transferência de crédito de sucessão; 6 - Pagamento antecipado; 7 - Perda em estoque",
+  "enum": [
+    1,
+    2,
+    3,
+    4,
+    5,
+    6,
+    7,
+    null
+  ],
+  "type": [
+    "integer",
+    "null"
+  ]
+}
  16. Changed2 schema fields changed
    • removedInput schema / properties / IndicadorIntermediador
      Removed value: -{
-  "description": "Indicador de intermediador/marketplace",
-  "type": "boolean"
-}
    • addedInput schema / properties / Intermediador
      Added value: +{
+  "additionalProperties": false,
+  "description": "Dados do intermediador/marketplace (site ou plataforma de terceiros).",
+  "properties": {
+    "Cnpj": {
+      "description": "CNPJ do intermediador da transação (marketplace/plataforma de terceiros). Obrigatório.",
+      "type": "string"
+    },
+    "IdCadIntTran": {
+      "description": "Identificação do vendedor no site do intermediador (usuário/login cadastrado). Obrigatório.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "Cnpj",
+    "IdCadIntTran"
+  ],
+  "type": [
+    "object",
+    "null"
+  ]
+}
  17. 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"
+  ]
+}
  18. Changed186 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"
+]
    • removedInput schema / properties / DataEmissao / format
      Removed value: -"date-time"
    • changedInput schema / properties / DataEmissao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • removedInput schema / properties / DataEntradaSaida / format
      Removed value: -"date-time"
    • changedInput schema / properties / DataEntradaSaida / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Contato / properties / Email / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Contato / properties / Fax / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Contato / properties / Telefone / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Contato / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / CpfCnpj / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Endereco / properties / Bairro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Endereco / properties / Cep / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Endereco / properties / CodMunicipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Endereco / properties / Complemento / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Endereco / properties / Logradouro / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Endereco / properties / Municipio / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Endereco / properties / Numero / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Endereco / properties / Pais / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Endereco / properties / Uf / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Endereco / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Ie / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / properties / Nome / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Entrega / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / Exporta / properties / LocalDespacho / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Exporta / properties / LocalEmbarqueTransp / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Exporta / properties / UFSaidaPais / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Exporta / type
      Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
    • changedInput schema / properties / IdentificadorInterno / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Justificativa / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Lote / type
      Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
    • changedInput schema / properties / NFReferencia / type
      Previous value: -"array"New value: +[
+  "array",
+  "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 / Pagamentos / items / properties / BandeiraOperadora / enum
      Previous value: -[
-  "01",
-  "02",
-  "03",
-  "04",
-  "05",
-  "06",
-  "07",
-  "08",
-  "09",
-  "99"
-]New value: +[
+  "01",
+  "02",
+  "03",
+  "04",
+  "05",
+  "06",
+  "07",
+  "08",
+  "09",
+  "99",
+  null
+]
    • changedInput schema / properties / Pagamentos / items / properties / BandeiraOperadora / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Pagamentos / items / properties / CNPJCredenciadora / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Pagamentos / items / properties / Descricao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Pagamentos / items / properties / FormaPagamento / enum
      Previous value: -[
-  "01",
-  "02",
-  "03",
-  "04",
-  "05",
-  "10",
-  "11",
-  "12",
-  "13",
-  "14",
-  "15",
-  "16",
-  "17",
-  "18",
-  "19",
-  "20",
-  "21",
-  "22",
-  "23",
-  "24",
-  "90",
-  "91",
-  "99"
-]New value: +[
+  "01",
+  "02",
+  "03",
+  "04",
+  "05",
+  "10",
+  "11",
+  "12",
+  "13",
+  "14",
+  "15",
+  "16",
+  "17",
+  "18",
+  "19",
+  "20",
+  "21",
+  "22",
+  "23",
+  "24",
+  "90",
+  "91",
+  "99",
+  null
+]
    • changedInput schema / properties / Pagamentos / items / properties / FormaPagamento / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Pagamentos / items / properties / NumeroAutorizacao / type
      Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
    • changedInput schema / properties / Pagamentos / type
      Previous value: -"array"New value: +[
+  "array",
+  "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 / Retencoes / properties / BaseCalculoIRRF / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Retencoes / properties / BaseCalculoRetencaoPrevidencia / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Retencoes / properties / ValorIRRF / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Retencoes / properties / ValorRetencaoPrevidencia / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Retencoes / properties / ValorRetidoCOFINS / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Retencoes / properties / ValorRetidoCSLL / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Retencoes / properties / ValorRetidoPIS / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedInput schema / properties / Retencoes / type
      Previous value: -"object"New value: +[
+  "object",
+  "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"
+]
  19. 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"
+}
  20. 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"
+}
  21. First observed

TDQS

A4.9/5.0
Behavior5/5

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

Annotations already flag destructiveHint=true and openWorldHint=true, and the description adds critical context beyond them: synchronous 5-30s operation, real transmission to SEFAZ ('TRANSMITE DE VERDADE'), the OAuth requirement for confirmacaoUsuario=true, and the return payload (chave, protocolo, XML/DANFE base64). This is genuinely useful behavioral disclosure.

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?

Front-loaded with the core action and model distinction, then the return payload, then the safety gate. Every sentence carries actionable information; the emphasis on 'TRANSMITE DE VERDADE' is warranted for an irreversible operation.

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

Completeness5/5

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

Despite 36 parameters and an output schema that already documents returns, the description covers the essential decision points (model choice, environment, confirmation precondition) that an agent must resolve before calling an irreversible emission tool. Nothing critical is missing.

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?

Schema coverage is 78%, so the baseline is a 3, but the description adds real meaning for the highest-stakes parameters: modeloDocumento, tipoAmbiente, and the confirmation gate. It doesn't attempt to explain the many tax/fiscal parameters, but the high-coverage schema carries those.

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?

States a specific verb and resource ('Emite uma NF-e (modelo 55) ou NFC-e (modelo 65) na SEFAZ') and immediately distinguishes the two document models. An agent can tell this apart from siblings like nfe_previsualizar and nfe_emitir_complementar without opening the schema.

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

Usage Guidelines5/5

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

Explicitly maps modeloDocumento=55 vs 65 to their use cases (B2B vs consumidor final), recommends tipoAmbiente=2 for tests, and states the precondition that the user must have approved the preview. Names the alternative (nfe_previsualizar) and the exact condition that gates this call.

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