@comando.one/mcp-server 0.12.3 → 0.12.5

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 +11 -5
  2. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -689,6 +689,7 @@ var SCHEMAS = {
689
689
  due_date: { type: ["string", "null"], format: "date" },
690
690
  proposal_id: { type: ["string", "null"], format: "uuid" },
691
691
  contract_id: { type: ["string", "null"], format: "uuid" },
692
+ payment_method_id: { type: ["string", "null"], format: "uuid", description: "Forma de Cobran\xE7a da fatura (a que a tela mostra). Mesma lista de GET /v1/payment-methods." },
692
693
  created_at: { type: "string", format: "date-time" },
693
694
  updated_at: { type: "string", format: "date-time" }
694
695
  }
@@ -1512,6 +1513,7 @@ var SCHEMAS = {
1512
1513
  title: { type: "string" },
1513
1514
  amount: { type: "number", description: "Ignorado se 'items' for enviado (calculado dos itens)" },
1514
1515
  status: { type: "string", enum: ["rascunho", "enviada", "aceita", "ativa"], default: "rascunho" },
1516
+ payment_method_id: { type: "string", format: "uuid", description: 'Opcional. Forma de Cobran\xE7a da fatura (id de GET /v1/payment-methods). Vazia, a tela mostra "Selecionar\u2026"; se a baixa que quitar a fatura informar a forma de recebimento, ela \xE9 copiada para c\xE1.' },
1515
1517
  due_date: { type: "string", format: "date", description: "Obrigat\xF3rio. A fatura nasce com uma parcela 1/1 neste vencimento \u2014 sem parcela ningu\xE9m cobra (o dispatch seleciona por parcela). O envio autom\xE1tico nasce desligado; para ligar use PATCH /v1/invoices/{id}/auto-send." },
1516
1518
  items: {
1517
1519
  type: "array",
@@ -2387,7 +2389,7 @@ var OPENAPI_SPEC = {
2387
2389
  tags: ["Faturas"],
2388
2390
  summary: "Criar fatura",
2389
2391
  operationId: "createInvoice",
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.",
2392
+ 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.",
2391
2393
  security: [{ ApiKeyAuth: ["invoices:create"] }],
2392
2394
  requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/InvoiceCreate" } } } },
2393
2395
  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 }
@@ -2415,14 +2417,15 @@ var OPENAPI_SPEC = {
2415
2417
  requestBody: {
2416
2418
  content: { "application/json": { schema: { type: "object", properties: {
2417
2419
  status: { type: "string", enum: ["rascunho", "enviada", "aceita", "ativa"] },
2418
- title: { type: ["string", "null"] }
2420
+ title: { type: ["string", "null"] },
2421
+ payment_method_id: { type: ["string", "null"], format: "uuid", description: "Forma de Cobran\xE7a (GET /v1/payment-methods); null limpa. Depois que h\xE1 baixa o banco trava a troca: 409 mandando estornar antes." }
2419
2422
  } } } }
2420
2423
  },
2421
2424
  responses: {
2422
2425
  "200": { description: "Fatura atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/Invoice" } } } },
2423
2426
  "400": errorResponse("Nenhum campo aceito foi enviado, ou status inv\xE1lido"),
2424
2427
  "404": errorResponse("Fatura n\xE3o encontrada"),
2425
- "409": errorResponse('status "cancelada" (use /cancel), ou a fatura j\xE1 est\xE1 cancelada'),
2428
+ "409": errorResponse('status "cancelada" (use /cancel), a fatura j\xE1 est\xE1 cancelada, ou h\xE1 baixa registrada e a forma de cobran\xE7a n\xE3o pode mais ser trocada'),
2426
2429
  ...COMMON_ERRORS
2427
2430
  }
2428
2431
  },
@@ -2529,7 +2532,7 @@ var OPENAPI_SPEC = {
2529
2532
  tags: ["Faturas"],
2530
2533
  summary: "Dar baixa em uma parcela",
2531
2534
  operationId: "settleInvoiceCharge",
2532
- description: "Registra o recebimento de uma parcela: cria o pagamento e o aloca \xE0 parcela. A parcela e a fatura passam a `pago` (ou `parcial`) pelo pr\xF3prio banco. Sem `amount`, quita o saldo restante; sem `payment_date`, usa hoje (America/Sao_Paulo). Baixa PARCIAL \xE9 permitida; acima do saldo, n\xE3o. Campo de corpo que a rota n\xE3o conhece devolve 400 em vez de ser ignorado.",
2535
+ description: "Registra o recebimento de uma parcela: cria o pagamento e o aloca \xE0 parcela. A parcela e a fatura passam a `pago` (ou `parcial`) pelo pr\xF3prio banco. Sem `amount`, quita o saldo restante; sem `payment_date`, usa hoje (America/Sao_Paulo). Se a baixa QUITA a fatura e informa a forma de recebimento, ela \xE9 copiada para a Forma de Cobran\xE7a da fatura quando esta est\xE1 vazia (baixa parcial n\xE3o mexe). Baixa PARCIAL \xE9 permitida; acima do saldo, n\xE3o. Campo de corpo que a rota n\xE3o conhece devolve 400 em vez de ser ignorado.",
2533
2536
  security: [{ ApiKeyAuth: ["invoices:settle"] }],
2534
2537
  requestBody: { required: false, content: { "application/json": { schema: { type: "object", properties: {
2535
2538
  amount: { type: "number", description: "Valor recebido. Omitido, quita o saldo restante da parcela." },
@@ -2589,6 +2592,9 @@ var OPENAPI_SPEC = {
2589
2592
  payment_date: { type: "string", format: "date" },
2590
2593
  payment_total: { type: "number" },
2591
2594
  notes: { type: "string" },
2595
+ payment_method_id: { type: ["string", "null"], format: "uuid", description: "Forma de recebimento usada na baixa." },
2596
+ payment_method_name: { type: ["string", "null"], description: "Nome da forma (ex.: Cart\xE3o de Cr\xE9dito)." },
2597
+ bank_account_id: { type: ["string", "null"], format: "uuid" },
2592
2598
  reconciled: { type: "boolean", description: "conciliado com o extrato \u2014 n\xE3o pode ser estornado por aqui" }
2593
2599
  } } }
2594
2600
  } } } } }, "404": errorResponse("Fatura ou parcela n\xE3o encontrada"), ...COMMON_ERRORS }
@@ -4954,7 +4960,7 @@ function buildWhoamiTool(api) {
4954
4960
  // src/branding.ts
4955
4961
  var MCP_SERVER_NAME = "comando-one";
4956
4962
  var MCP_SERVER_TITLE = "Comando1";
4957
- var MCP_SERVER_VERSION = "0.12.3";
4963
+ var MCP_SERVER_VERSION = "0.12.5";
4958
4964
  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.";
4959
4965
  var MCP_SERVER_WEBSITE = "https://comando.one";
4960
4966
  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.3",
3
+ "version": "0.12.5",
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",