Skip to main content
Glama

Emitir NFS-e (serviços)

nfse_emitir
Destructive

Emite NFS-e (Nota Fiscal de Serviços Eletrônica). Cada município brasileiro tem regras e webservices próprios - confira o município emissor antes. Pode usar Portal Nacional NFS-e ou prefeitura específica conforme cadastro da empresa.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "TipoAmbiente": "<TipoAmbiente>",
      "nFSInfo": "<nFSInfo>"
    },
    "name": "nfse_emitir"
  }
}

Input Schema

NameRequiredDescriptionDefault
LoteNo
nFSInfoYesLista de NFS-e a emitir no lote. Mínimo 1 item.
TipoAmbienteYesIdentificação do ambiente da prefeitura/portal nacional. Valores: 1 - Produção (emissão REAL, com valor fiscal); 2 - Homologação (teste)

Output Schema

NameRequiredDescriptionDefault
LoteNoNúmero do lote enviado;
ErrorNoMensagem de erro da operação. Vazia ("") quando foi bem-sucedida.
NotasNo
AvisosNoAvisos não bloqueantes. Pode vir preenchida mesmo em emissão bem-sucedida.
CodLoteNoCódigo atrelado ao lote; - Usado para busca de lotes
ProtocoloNoNúmero de protocolo do lote
StatusLoteNo1 - Lote processado; 2 - Aguardando processamento; 3 - Ocorreu um erro ao processar o lote; 4 - Ocorreu um erro ao analisar as informações do lote
Base64XmlLoteNoDados xml do lote, bytes em base64
DsTipoAmbienteNoDescrição do ambiente de envio
MunicipioEnvioNoMunicipio onde foi enviado
CodTipoAmbienteNoCódigo do ambiente de envio
DataRecebimentoNoData de recebimento do lote;
TempoRequisicaoPrefeituraNoTempo total da transmissão para prefeitura em milisegundos

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / Imovel
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Grupo imovel no leiaute da NT 009 (locação, cessão onerosa ou arrendamento de imóvel, subitem 99.03, e demais operações com imóvel). Enviado só na homologação do Emissor Nacional até a produção adotar a NT 009 (prevista para 01/12/2026); em produção é ignorado. Quando informado, substitui EnderecoImovel e InscricaoImobiliariaImovel.",
      +  "properties": {
      +    "CodMunicipio": {
      +      "description": "Código IBGE do município do imóvel (7 dígitos). Vazio: município de prestação do serviço.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Locacao": {
      +      "additionalProperties": false,
      +      "description": "Locação, cessão onerosa ou arrendamento de imóvel (grupo gLocacao).",
      +      "properties": {
      +        "DataVencimentoOriginal": {
      +          "description": "Data de vencimento original do aluguel (dVencOrig).",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "DescontoCondicionadoTotal": {
      +          "description": "Desconto condicionado total (vDescCondTot). No 99.03 a API calcula DescontoCondicionado = PercentualCopropriedade x este / 100.",
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "DescontoIncondicionadoTotal": {
      +          "description": "Desconto incondicionado total (vDescIncondTot). No 99.03 a API calcula DescontoIncondicionado = PercentualCopropriedade x este / 100.",
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "PercentualCopropriedade": {
      +          "description": "Percentual de copropriedade (pCopropriedade). Um único locador: 100.",
      +          "type": "number"
      +        },
      +        "ValorTotalOperacao": {
      +          "description": "Valor total da operação (vTotOper), sem a parcela do coproprietário. No subitem 99.03 a API calcula Valores.ValorServico = PercentualCopropriedade x ValorTotalOperacao / 100 (o valor enviado é substituído).",
      +          "type": "number"
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "Unidades": {
      +      "description": "Unidades imobiliárias da operação (grupo gUnidImob, até 99). Todas do mesmo município, com o mesmo prestador, tomador e percentual de copropriedade.",
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "Ajustes": {
      +            "description": "Parcelas fora da base do IBS/CBS (grupo gAjusteBCLocImoveis, até 1.000).",
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "Descricao": {
      +                  "description": "Descrição da parcela quando o Tipo for 99 (até 150 caracteres).",
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "Tipo": {
      +                  "description": "Tipo da parcela (tpAjusteBCLocImoveis): Valores: 01 - Tributos inclusos no aluguel (IPTU, contribuição de melhoria) - só NBS 1.1002.10.00 e 1.1002.20.00; 02 - Emolumento incluso no aluguel - só NBS 1.1002.10.00 e 1.1002.20.00; 03 - Condomínio incluso no aluguel - só NBS 1.1002.10.00 e 1.1002.20.00; 04 - Redutor social - só NBS 1.1002.10.00; 99 - Outras parcelas (informe a Descricao)",
      +                  "enum": [
      +                    "01",
      +                    "02",
      +                    "03",
      +                    "04",
      +                    "99",
      +                    null
      +                  ],
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "Valor": {
      +                  "description": "Valor da parcela, sem a parte do coproprietário.",
      +                  "type": "number"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "Cib": {
      +            "description": "Código do Cadastro Imobiliário Brasileiro (CIB, 8 caracteres). Informe o CIB ou o Endereco.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "Endereco": {
      +            "additionalProperties": false,
      +            "description": "Endereço do imóvel quando não houver CIB (sem município: vale o CodMunicipio do imóvel).",
      +            "properties": {
      +              "Bairro": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "Cep": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "Complemento": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "Logradouro": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "Numero": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "InscricaoImobiliaria": {
      +            "description": "Inscrição imobiliária fiscal (IPTU), até 30 caracteres.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
  2. Changed1 schema field changed
    • addedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / BensMoveis
      Added value: +{
      +  "description": "Bens móveis objeto de locação (grupo bensMoveis da NFS-e Nacional, código 99.04.01), até 1.000. Enviado só na homologação do Emissor Nacional até a produção adotar a NT 009 (prevista para 01/12/2026); em produção é ignorado.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "Descricao": {
      +        "description": "Descrição do bem móvel locado (até 150 caracteres).",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "Ncm": {
      +        "description": "NCM do bem móvel locado (8 dígitos).",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "Quantidade": {
      +        "description": "Quantidade do bem (1 a 999).",
      +        "type": "integer"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": [
      +    "array",
      +    "null"
      +  ]
      +}
  3. Changed1 schema field changed
    • addedInput schema / properties / nFSInfo / items / properties / Servico / properties / ConfiguracaoImposto / properties / RegimePisCofins
      Added value: +{
      +  "description": "Regime de apuração do PIS/COFINS usado nas alíquotas do grupo piscofins: 1 = Cumulativo (0,65% / 3,00%), 2 = Não cumulativo (1,65% / 7,60%). Vazio = pelo regime cadastrado na empresa (Lucro Real = não cumulativo, demais = cumulativo). Útil para receitas que a Lei 10.833/2003 art. 10 mantém no cumulativo mesmo no Lucro Real (software, hospitais e clínicas, etc.).",
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
  4. Changed1 schema field changed
    • addedInput schema / properties / nFSInfo / items / properties / Servico / properties / ConfiguracaoImposto / properties / DestacarPisCofins
      Added value: +{
      +  "description": "Destaca na NFS-e (padrão nacional) o PIS/COFINS de apuração própria do prestador (grupo piscofins: CST 01, alíquotas e valores), sem retenção pelo tomador e sem abater o valor líquido. Alíquotas conforme o regime da empresa: Lucro Real 1,65% / 7,60%, demais 0,65% / 3,00%. Somente empresas do Regime Normal (CRT 3). Pode ser combinado com as retenções acima (tpRetPisCofins passa a refletir o que foi retido).",
      +  "type": "boolean"
      +}
  5. Changed3 schema fields changed
    • addedInput schema / properties / nFSInfo / items / properties / Servico / properties / DocumentoReferencia
      Added value: +{
      +  "description": "Documento de referência (infoCompl/docRef, até 255 caracteres): contrato, proposta, NF referenciada etc.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / nFSInfo / items / properties / Servico / properties / InformacoesComplementares
      Added value: +{
      +  "description": "Informações complementares da NFS-e nacional (infoCompl/xInfComp, até 2000 caracteres). Sai no DANFSe.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / nFSInfo / items / properties / Servico / properties / NumeroPedido
      Added value: +{
      +  "description": "Número do pedido do tomador (infoCompl/xPed, até 60 caracteres).",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  6. Changed6 schema fields changed
    • addedInput schema / properties / nFSInfo / items / properties / ConstrucaoCivil / description
      Added value: +"Dados da obra (grupo obra do DPS nacional). Obrigatório para os serviços 07.02, 07.04, 07.05, 07.06, 07.07, 07.08, 07.17, 07.19 e 14.14 (E0370). Basta UM identificador, nesta prioridade: CodObra, Cib, EnderecoObra. Sem nenhum deles, nesses serviços, usa-se o endereço do tomador como local da obra."
    • addedInput schema / properties / nFSInfo / items / properties / ConstrucaoCivil / properties / Art / description
      Added value: +"Documento de responsabilidade técnica (ART, RRT, DRT). Vai em infoCompl/idDocTec."
    • addedInput schema / properties / nFSInfo / items / properties / ConstrucaoCivil / properties / Cib
      Added value: +{
      +  "description": "Código do Cadastro Imobiliário Brasileiro (8 caracteres). Só no leiaute 1.01.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / nFSInfo / items / properties / ConstrucaoCivil / properties / CodObra / description
      Added value: +"Número da obra: CNO (Cadastro Nacional de Obras) ou CEI do INSS. Até 30 caracteres."
    • addedInput schema / properties / nFSInfo / items / properties / ConstrucaoCivil / properties / EnderecoObra
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Endereço da obra (CEP, Logradouro, Numero, Complemento, Bairro). Usado quando não há CodObra nem Cib.",
      +  "properties": {
      +    "Bairro": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Cep": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "CodMunicipio": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "CodPais": {
      +      "default": 1058,
      +      "type": "integer"
      +    },
      +    "Complemento": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Logradouro": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Municipio": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Numero": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Pais": {
      +      "default": "BRASIL",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Uf": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / nFSInfo / items / properties / ConstrucaoCivil / properties / InscricaoImobiliaria
      Added value: +{
      +  "description": "Inscrição imobiliária fiscal do imóvel na prefeitura. Opcional, complementa o identificador.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  7. Changed2 schema fields changed
    • addedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / EnderecoImovel
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Endereço do imóvel onde o serviço foi prestado. Obrigatório (grupo imovel na DPS) quando o cIndOp é de operação sobre bem imóvel (020101/020201/020301) É um endereço próprio da operação (NÃO o do tomador); se ficar vazio nesses casos, cai no endereço do tomador.",
      +  "properties": {
      +    "Bairro": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Cep": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "CodMunicipio": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "CodPais": {
      +      "default": 1058,
      +      "type": "integer"
      +    },
      +    "Complemento": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Logradouro": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Municipio": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Numero": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Pais": {
      +      "default": "BRASIL",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "Uf": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / InscricaoImobiliariaImovel
      Added value: +{
      +  "description": "Inscrição imobiliária fiscal (IPTU) do imóvel - opcional, dentro do grupo imovel.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  8. Changed1 schema field changed
    • addedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / TipoOperacao
      Added value: +{
      +  "description": "Tipo de Operação (tpOper). Obrigatório para os serviços da LC 116/2003 25.05, 15.09, 17.12 e 10.05 (senão a prefeitura recusa com E0903). Se null nesses casos, assume 5 (fornecimento e recebimento concomitantes). Valores: 1 - Fornecimento com pagamento posterior; 2 - Recebimento do pagamento com fornecimento já realizado; 3 - Fornecimento com pagamento já realizado; 4 - Recebimento do pagamento com fornecimento posterior; 5 - Fornecimento e recebimento do pagamento concomitantes",
      +  "enum": [
      +    1,
      +    2,
      +    3,
      +    4,
      +    5,
      +    null
      +  ],
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
  9. Changed2 schema fields changed
    • changedInput schema / properties / nFSInfo / items / properties / Servico / description
      Previous value: -"Dados do serviço prestado. OBRIGATÓRIO. Exige ao menos: ItemListaServico (código LC 116/2003 do município) e Valores.ValorServico > 0."New value: +"Dados do serviço prestado. OBRIGATÓRIO. Exige ao menos: ItemListaServico (item LC 116/2003 no provedor municipal, ou Código de Tributação Nacional cTribNac no ambiente nacional - ver ItemListaServico) e Valores.ValorServico > 0."
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ItemListaServico / description
      Previous value: -"Código do serviço prestado conforme a Lista de Serviços da LC 116/2003 (ex: \"1.01\", \"7.02\", \"14.01\"). Cada município tem regras próprias - alguns aceitam o código nacional, outros exigem código municipal específico. Para o padrão nacional unificado (DPS) use o código LC 116. OBRIGATÓRIO."New value: +"Código do serviço prestado. OBRIGATÓRIO. O significado depende do provedor do município (IdProvedorNFSe):"
  10. Changed87 schema fields changed
    • changedInput schema / properties / Lote / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / ConstrucaoCivil / properties / Art / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / ConstrucaoCivil / properties / CodObra / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / ConstrucaoCivil / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • removedInput schema / properties / nFSInfo / items / properties / DataCompetencia / format
      Removed value: -"date-time"
    • changedInput schema / properties / nFSInfo / items / properties / DataCompetencia / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • addedInput schema / properties / nFSInfo / items / properties / DataEmissao / description
      Added value: +"Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00)"
    • removedInput schema / properties / nFSInfo / items / properties / DataEmissao / format
      Removed value: -"date-time"
    • changedInput schema / properties / nFSInfo / items / properties / DataEmissao / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / IdentificadorInterno / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Intermediario / properties / CPFCNPJ / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Intermediario / properties / InscricaoMunicipal / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Intermediario / properties / RzSocial / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Intermediario / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / NumeroRps / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / SerieRps / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / CodMunicipioIncidencia / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / CodMunicipioPrestacao / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / CodNBS / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / CodTributacaoMunicipio / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / CodigoCnae / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / ApoioPrestador / enum
      Previous value: -[
      -  1,
      -  2
      -]New value: +[
      +  1,
      +  2,
      +  null
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / ApoioPrestador / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / ApoioTomador / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / CodMoeda / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / CompartilharMDIC / enum
      Previous value: -[
      -  0,
      -  1
      -]New value: +[
      +  0,
      +  1,
      +  null
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / CompartilharMDIC / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / ModoPrestacao / enum
      Previous value: -[
      -  1,
      -  2,
      -  3,
      -  4
      -]New value: +[
      +  1,
      +  2,
      +  3,
      +  4,
      +  null
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / ModoPrestacao / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / MovimentacaoTemporariaBens / enum
      Previous value: -[
      -  1,
      -  2,
      -  3
      -]New value: +[
      +  1,
      +  2,
      +  3,
      +  null
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / MovimentacaoTemporariaBens / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / NumeroDI / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / NumeroRE / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / ValorMoedaEstrangeira / type
      Previous value: -"number"New value: +[
      +  "number",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / VinculoPrestador / enum
      Previous value: -[
      -  0,
      -  1,
      -  2,
      -  3,
      -  4,
      -  5,
      -  6
      -]New value: +[
      +  0,
      +  1,
      +  2,
      +  3,
      +  4,
      +  5,
      +  6,
      +  null
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / properties / VinculoPrestador / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ComercioExterior / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / ConfiguracaoImposto / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / Descricao / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / AliqCbs / type
      Previous value: -"number"New value: +[
      +  "number",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / AliqIbsMun / type
      Previous value: -"number"New value: +[
      +  "number",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / AliqIbsUf / type
      Previous value: -"number"New value: +[
      +  "number",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / BaseCalculo / type
      Previous value: -"number"New value: +[
      +  "number",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / CodClassTrib / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / properties / CodIndicadorOperacao / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / IBSCBS / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / Valores / properties / AliquotaIr / type
      Previous value: -"number"New value: +[
      +  "number",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / Valores / properties / AliquotaSimplesNacional / type
      Previous value: -"number"New value: +[
      +  "number",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Servico / properties / Valores / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Contato / properties / Email / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Contato / properties / Fax / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Contato / properties / Telefone / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Contato / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / CpfCnpj / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Endereco / properties / Bairro / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Endereco / properties / Cep / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Endereco / properties / CodMunicipio / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Endereco / properties / Complemento / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Endereco / properties / Logradouro / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Endereco / properties / Municipio / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Endereco / properties / Numero / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Endereco / properties / Pais / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Endereco / properties / Uf / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Endereco / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / Im / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / properties / NmTomador / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedInput schema / properties / nFSInfo / items / properties / Tomador / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedOutput schema / properties / Avisos / type
      Previous value: -"array"New value: +[
      +  "array",
      +  "null"
      +]
    • changedOutput schema / properties / Base64XmlLote / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / CodLote / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / DataRecebimento / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / DsTipoAmbiente / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / Error / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / MunicipioEnvio / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / Notas / items / properties / Base64Doc / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / Notas / items / properties / Base64Xml / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / Notas / items / properties / Chave / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / Notas / items / properties / CodVerificacao / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / Notas / items / properties / CpfCnpjPrestador / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / Notas / items / properties / CpfCnpjTomador / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / Notas / items / properties / DtEmissao / format
      Removed value: -"date-time"
    • changedOutput schema / properties / Notas / items / properties / Erro / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / Notas / items / properties / IdentificadorInterno / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / Notas / items / properties / NumeroNFSe / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / Notas / items / properties / Valores / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedOutput schema / properties / Notas / type
      Previous value: -"array"New value: +[
      +  "array",
      +  "null"
      +]
    • changedOutput schema / properties / Protocolo / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
  11. First observed

TDQS

B3.3/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 bar is lower. The description adds genuine context beyond them: municipal rules and webservices vary, and the emission path differs by company registration, which signals provider-dependent failure modes. It stops short of saying the emission is legally binding and cannot be undone except via evento_cancelar, and says nothing about what happens when the municipality rejects the payload.

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

Conciseness4/5

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

Three short sentences, purpose front-loaded, no filler or repetition of the title. The closing sentence about Portal Nacional vs. prefeitura is slightly vague ("conforme cadastro da empresa") but still carries information an agent needs, so nothing is clearly wasted.

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 destructive, real fiscal emission backed by a very large and only partially documented schema, three sentences are thin. The description never states that TipoAmbiente=1 produces a legally valid document, that batches are submitted per item in nFSInfo, that corrections require a separate cancellation tool, or what sibling to call to verify the result — gaps an agent must not guess at when emitting an invoice.

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 description coverage is 67% and the schema itself is extremely verbose, documenting nearly every field including defaults, mandatory groups and layout caveats. The description adds no parameter-level meaning of its own beyond the municipality hint, which is the expected baseline when the schema carries this much detail for only three top-level parameters.

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?

The first sentence gives a specific verb and resource ("Emite NFS-e (Nota Fiscal de Serviços Eletrônica)"), which is unambiguous about what is produced. It does not, however, contrast itself with other emission siblings (nfe_emitir, cte_emitir, nfse_consultar), so the agent must rely on the tool name pattern to route correctly.

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

Usage Guidelines3/5

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

It gives one real precondition ("confira o município emissor antes") and explains that the target webservice depends on the company's registration (Portal Nacional vs. prefeitura). There is no when-not guidance, no pointer to nfse_consultar for checking status, and no mention that this is the emission step as opposed to a preview or calculation tool.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.