@comando.one/mcp-server 0.12.2 → 0.12.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/index.js +7 -6
  2. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -952,8 +952,8 @@ var SCHEMAS = {
952
952
  type: "object",
953
953
  required: ["name"],
954
954
  properties: {
955
- name: { type: "string" },
956
- description: { type: "string" },
955
+ name: { type: "string", description: "Nome do item (exibi\xE7\xE3o). Na NFS-e s\xF3 \xE9 usado se `description` vier vazio." },
956
+ description: { type: "string", description: "Texto do item. \xC9 ele que comp\xF5e a discrimina\xE7\xE3o da NFS-e (uma linha por item)." },
957
957
  unit: { type: "string", default: "un" },
958
958
  quantity: { type: "number", default: 1 },
959
959
  unit_price: { type: "number" },
@@ -1569,7 +1569,8 @@ var SCHEMAS = {
1569
1569
  type: "object",
1570
1570
  required: ["invoice_id"],
1571
1571
  properties: {
1572
- invoice_id: { type: "string", format: "uuid", description: "Fatura a partir da qual emitir a NFS-e" }
1572
+ invoice_id: { type: "string", format: "uuid", description: "Fatura a partir da qual emitir a NFS-e" },
1573
+ discriminacao: { type: "string", maxLength: 2e3, description: "Opcional. Texto integral da discrimina\xE7\xE3o do servi\xE7o (xDescServ) \u2014 substitui o montado dos itens. Nota autorizada n\xE3o se edita (s\xF3 cancela e reemite), ent\xE3o \xE9 aqui que se acerta o texto. Inclua o n\xFAmero da fatura se quiser que ele apare\xE7a. Sem o campo: n\xFAmero da fatura + a descri\xE7\xE3o de cada item." }
1573
1574
  }
1574
1575
  },
1575
1576
  NfseCancel: {
@@ -2386,7 +2387,7 @@ var OPENAPI_SPEC = {
2386
2387
  tags: ["Faturas"],
2387
2388
  summary: "Criar fatura",
2388
2389
  operationId: "createInvoice",
2389
- description: "Cria uma fatura. Se 'items' for enviado, o valor \xE9 calculado a partir deles.",
2390
+ description: "Cria uma fatura. Se 'items' for enviado, o valor \xE9 calculado a partir deles. O cliente pode ser da empresa **ou compartilhado com ela com a permiss\xE3o 'Faturar'** (o dono marca em Clientes \u2192 Compartilhar; \xE9 diferente de 'Faturas', que trata das faturas do dono). A fatura pertence a quem a lan\xE7a \u2014 financeiro, baixa e NFS-e s\xE3o dessa empresa; s\xF3 o cadastro do cliente \xE9 do dono. Cliente compartilhado sem 'Faturar' devolve 404 \u2014 na API e na tela.",
2390
2391
  security: [{ ApiKeyAuth: ["invoices:create"] }],
2391
2392
  requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/InvoiceCreate" } } } },
2392
2393
  responses: { "201": { description: "Fatura criada", content: { "application/json": { schema: { $ref: "#/components/schemas/Invoice" } } } }, "400": errorResponse("Dados inv\xE1lidos"), "404": errorResponse("Cliente n\xE3o encontrado"), ...COMMON_ERRORS }
@@ -3155,7 +3156,7 @@ var OPENAPI_SPEC = {
3155
3156
  tags: ["NFS-e"],
3156
3157
  summary: "Emitir NFS-e",
3157
3158
  operationId: "emitNfse",
3158
- description: "Emite uma NFS-e a partir de uma fatura. O m\xE9todo (certificado/portal) vem da configura\xE7\xE3o da empresa. Pode levar alguns segundos.\n\n**Os itens da fatura N\xC3O precisam de `service_id`** \u2014 item avulso emite normalmente; a classifica\xE7\xE3o fiscal (cTribNac, cNBS, al\xEDquotas) vem da configura\xE7\xE3o fiscal da empresa e do CNAE padr\xE3o, n\xE3o do item.\n\nC\xF3digos: **201** = autorizada ou em transmiss\xE3o \u2014 o `id` devolvido \xE9 o mesmo `{id}` de `/v1/nfse/{id}`, `/files`, `/sync` e `/cancel`. **422 com `status: 'rejeitada'`** = o fisco REJEITOU (motivo em `message`) \u2014 n\xE3o existe nota, n\xE3o afirme ao usu\xE1rio que foi emitida. **422 sem `status`** = a EMPRESA n\xE3o est\xE1 configurada para emitir. **409** = esta fatura j\xE1 tem nota (o `error` traz o id da existente). **424** = o provedor fiscal falhou; o motivo dele vem em `error`.\n\nRetentativa \xE9 segura: mande o header `Idempotency-Key` (a mesma resposta volta, com `Idempotent-Replayed: true`), e mesmo sem ele o 409 impede uma segunda nota para a mesma fatura.",
3159
+ description: "Emite uma NFS-e a partir de uma fatura. O m\xE9todo (certificado/portal) vem da configura\xE7\xE3o da empresa. Pode levar alguns segundos.\n\n**Discrimina\xE7\xE3o do servi\xE7o (o texto que vai \xE0 prefeitura).** Por padr\xE3o \xE9 o n\xFAmero da fatura seguido, uma linha por item, do `description` de cada item \u2014 e, s\xF3 se o `description` estiver vazio, o `name`. Ou seja: com os dois preenchidos, o `name` \xE9 exibi\xE7\xE3o interna e N\xC3O chega ao documento fiscal. Para controlar o texto, mande `discriminacao` (at\xE9 2000 caracteres). Nota autorizada n\xE3o se edita: errou o texto, \xE9 cancelar e reemitir \u2014 por isso confira antes. Um 409 de nota anterior s\xF3 vale para nota `autorizada` ou `transmitindo`; fatura com nota **cancelada** pode ser emitida de novo.\n\n**Os itens da fatura N\xC3O precisam de `service_id`** \u2014 item avulso emite normalmente; a classifica\xE7\xE3o fiscal (cTribNac, cNBS, al\xEDquotas) vem da configura\xE7\xE3o fiscal da empresa e do CNAE padr\xE3o, n\xE3o do item.\n\nC\xF3digos: **201** = autorizada ou em transmiss\xE3o \u2014 o `id` devolvido \xE9 o mesmo `{id}` de `/v1/nfse/{id}`, `/files`, `/sync` e `/cancel`. **422 com `status: 'rejeitada'`** = o fisco REJEITOU (motivo em `message`) \u2014 n\xE3o existe nota, n\xE3o afirme ao usu\xE1rio que foi emitida. **422 sem `status`** = a EMPRESA n\xE3o est\xE1 configurada para emitir. **409** = esta fatura j\xE1 tem nota (o `error` traz o id da existente). **424** = o provedor fiscal falhou; o motivo dele vem em `error`.\n\nRetentativa \xE9 segura: mande o header `Idempotency-Key` (a mesma resposta volta, com `Idempotent-Replayed: true`), e mesmo sem ele o 409 impede uma segunda nota para a mesma fatura.",
3159
3160
  security: [{ ApiKeyAuth: ["nfse:emitir"] }],
3160
3161
  requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/NfseEmit" } } } },
3161
3162
  responses: { "201": { description: "Emiss\xE3o solicitada", content: { "application/json": { schema: { type: "object", properties: { id: { type: ["string", "null"], description: "Id da NFS-e \u2014 use em /v1/nfse/{id}, /files, /sync e /cancel. Mesmo valor de history_id." }, invoice_id: { type: "string" }, status: { type: "string", description: "autorizada | transmitindo | rejeitada" }, numero_nfse: { type: ["string", "null"] }, chave_acesso: { type: ["string", "null"] }, history_id: { type: ["string", "null"], description: "Alias de `id`, mantido por compatibilidade." }, message: { type: ["string", "null"] } } } } } }, "400": errorResponse("invoice_id ausente"), "404": errorResponse("Fatura n\xE3o encontrada"), "409": errorResponse("A fatura j\xE1 tem NFS-e autorizada ou em transmiss\xE3o \u2014 o `error` traz o id da existente"), "402": errorResponse("Saldo insuficiente na carteira pr\xE9-paga (ou limite de gasto atingido) \u2014 nada foi transmitido. `code`: saldo_insuficiente | limite_de_gasto_atingido | carteira_inativa; recarregue em Cobran\xE7a da plataforma"), "422": errorResponse('Rejeitada pelo fisco (corpo traz `status: "rejeitada"` e `message`) OU empresa sem NFS-e configurada (corpo traz s\xF3 `error`)'), "424": errorResponse("O provedor de NFS-e falhou \u2014 o motivo dele vem em `error`"), ...COMMON_ERRORS }
@@ -4953,7 +4954,7 @@ function buildWhoamiTool(api) {
4953
4954
  // src/branding.ts
4954
4955
  var MCP_SERVER_NAME = "comando-one";
4955
4956
  var MCP_SERVER_TITLE = "Comando1";
4956
- var MCP_SERVER_VERSION = "0.12.2";
4957
+ var MCP_SERVER_VERSION = "0.12.4";
4957
4958
  var MCP_SERVER_DESCRIPTION = "ERP das empresas de servi\xE7o brasileiras: clientes, propostas, contratos, faturas, cobran\xE7as Pix e boleto, NFS-e, contas a pagar e financeiro.";
4958
4959
  var MCP_SERVER_WEBSITE = "https://comando.one";
4959
4960
  var MCP_SERVER_ICONS = [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@comando.one/mcp-server",
3
- "version": "0.12.2",
3
+ "version": "0.12.4",
4
4
  "description": "Servidor MCP (Model Context Protocol) para a API pública do Comando1 — opere seu ERP por linguagem natural.",
5
5
  "author": "Orbital Tecnologia e Desenvolvimento LTDA <contato@comando.one> (https://orbitaldev.com.br)",
6
6
  "homepage": "https://comando.one",