Skip to main content
Glama

fiscal

by br.com.brasilnfe
OverviewDiscussionsAdmin

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.

Input Schema

TableJSON 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

TableJSON 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 / 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"
+  ]
+}
  2. 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"
+}
  3. 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"
+  ]
+}
  4. 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"
+  ]
+}
  5. 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"
+  ]
+}
  6. 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"
+  ]
+}
  7. 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):"
  8. 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"
+]
  9. First observed

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=false, destructiveHint=true and openWorldHint=true, so the agent knows this is a real, externally-visible write. The description adds the municipal-heterogeneity caveat and the portal-vs-city-hall routing, but says nothing about environment risk (production vs homologação lives only in the schema), idempotency, or duplicate-emission behavior.

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, followed by the municipality caution and the routing note. No filler; each sentence contributes.

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

Completeness3/5

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

For a highly complex fiscal-emission tool with a deep schema, an output schema (so returns need no explanation) and strong annotations, the description is on the thin side. It covers the municipality prerequisite but omits things like company/certificate prerequisites, duplicate-NFS-e risk, and what happens on partial lote failure.

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 description adds no parameter-level detail at all for Lote, nFSInfo or TipoAmbiente. With the schema already carrying rich nested documentation, the schema does the heavy lifting, so the baseline 3 is appropriate rather than a lower score.

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+resource ('Emite NFS-e - Nota Fiscal de Serviços Eletrônica'), which is clearly the municipal service invoice and distinguishable from the goods-invoice siblings like nfe_emitir and cte_emitir. It also names the two emission channels (Portal Nacional vs prefeitura), adding scope beyond the name.

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?

Gives a real prerequisite ('confira o município emissor antes') and a routing condition based on the company's cadastro, which is useful context. However, it names no alternatives (e.g., nfse_consultar to verify, nfe_emitir for goods) and gives no when-not guidance, so usage is only implied.

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