@comando.one/mcp-server 0.12.1 → 0.12.3

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 +15 -8
  2. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -416,7 +416,8 @@ var SCHEMAS = {
416
416
  trade_name: { type: ["string", "null"] },
417
417
  status: { type: "string" },
418
418
  created_at: { type: "string", format: "date-time" },
419
- updated_at: { type: "string", format: "date-time" }
419
+ updated_at: { type: "string", format: "date-time" },
420
+ addresses: { type: "array", items: { $ref: "#/components/schemas/CustomerAddress" }, description: "S\xF3 vem com ?include=addresses. Endere\xE7o padr\xE3o primeiro; lista vazia = cliente sem endere\xE7o cadastrado." }
420
421
  }
421
422
  },
422
423
  CustomerCreate: {
@@ -951,8 +952,8 @@ var SCHEMAS = {
951
952
  type: "object",
952
953
  required: ["name"],
953
954
  properties: {
954
- name: { type: "string" },
955
- 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)." },
956
957
  unit: { type: "string", default: "un" },
957
958
  quantity: { type: "number", default: 1 },
958
959
  unit_price: { type: "number" },
@@ -1568,7 +1569,8 @@ var SCHEMAS = {
1568
1569
  type: "object",
1569
1570
  required: ["invoice_id"],
1570
1571
  properties: {
1571
- 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." }
1572
1574
  }
1573
1575
  },
1574
1576
  NfseCancel: {
@@ -1912,7 +1914,8 @@ var OPENAPI_SPEC = {
1912
1914
  ...PAGINATION_PARAMS,
1913
1915
  { name: "search", in: "query", schema: { type: "string" }, description: "Busca por nome, e-mail ou documento" },
1914
1916
  { name: "status", in: "query", schema: { type: "string" }, description: "Filtrar por status" },
1915
- { name: "type", in: "query", schema: { type: "string", enum: ["fisica", "juridica", "estrangeira"] }, description: "Filtrar por tipo de pessoa" }
1917
+ { name: "type", in: "query", schema: { type: "string", enum: ["fisica", "juridica", "estrangeira"] }, description: "Filtrar por tipo de pessoa" },
1918
+ { name: "include", in: "query", schema: { type: "string", enum: ["addresses"] }, description: "addresses = traz os endere\xE7os de cada cliente no campo `addresses` (1 chamada em vez de 1 por cliente)" }
1916
1919
  ],
1917
1920
  responses: {
1918
1921
  "200": paginatedResponse("#/components/schemas/Customer"),
@@ -1950,6 +1953,9 @@ var OPENAPI_SPEC = {
1950
1953
  summary: "Obter cliente",
1951
1954
  operationId: "getCustomer",
1952
1955
  security: [{ ApiKeyAuth: ["customers:read"] }],
1956
+ parameters: [
1957
+ { name: "include", in: "query", schema: { type: "string", enum: ["addresses"] }, description: "addresses = inclui os endere\xE7os do cliente no campo `addresses`" }
1958
+ ],
1953
1959
  responses: {
1954
1960
  "200": { description: "Cliente", content: { "application/json": { schema: { $ref: "#/components/schemas/Customer" } } } },
1955
1961
  "404": errorResponse("Cliente n\xE3o encontrado"),
@@ -2048,6 +2054,7 @@ var OPENAPI_SPEC = {
2048
2054
  get: {
2049
2055
  tags: ["Clientes"],
2050
2056
  summary: "Listar endere\xE7os do cliente",
2057
+ description: "Funciona tamb\xE9m para cliente compartilhado com a sua empresa (somente leitura). Para os endere\xE7os de v\xE1rios clientes de uma vez, use GET /customers?include=addresses.",
2051
2058
  operationId: "listCustomerAddresses",
2052
2059
  security: [{ ApiKeyAuth: ["customers:read"] }],
2053
2060
  responses: { "200": { description: "Endere\xE7os", content: { "application/json": { schema: { type: "object", properties: { data: { type: "array", items: { $ref: "#/components/schemas/CustomerAddress" } } } } } } }, "404": errorResponse("Cliente n\xE3o encontrado"), ...COMMON_ERRORS }
@@ -2380,7 +2387,7 @@ var OPENAPI_SPEC = {
2380
2387
  tags: ["Faturas"],
2381
2388
  summary: "Criar fatura",
2382
2389
  operationId: "createInvoice",
2383
- 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 permiss\xE3o de faturas = editor** (o dono configura em Clientes \u2192 Compartilhar). 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 s\xF3 para leitura devolve 404.",
2384
2391
  security: [{ ApiKeyAuth: ["invoices:create"] }],
2385
2392
  requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/InvoiceCreate" } } } },
2386
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 }
@@ -3149,7 +3156,7 @@ var OPENAPI_SPEC = {
3149
3156
  tags: ["NFS-e"],
3150
3157
  summary: "Emitir NFS-e",
3151
3158
  operationId: "emitNfse",
3152
- 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.",
3153
3160
  security: [{ ApiKeyAuth: ["nfse:emitir"] }],
3154
3161
  requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/NfseEmit" } } } },
3155
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 }
@@ -4947,7 +4954,7 @@ function buildWhoamiTool(api) {
4947
4954
  // src/branding.ts
4948
4955
  var MCP_SERVER_NAME = "comando-one";
4949
4956
  var MCP_SERVER_TITLE = "Comando1";
4950
- var MCP_SERVER_VERSION = "0.12.1";
4957
+ var MCP_SERVER_VERSION = "0.12.3";
4951
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.";
4952
4959
  var MCP_SERVER_WEBSITE = "https://comando.one";
4953
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.1",
3
+ "version": "0.12.3",
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",