@comando.one/mcp-server 0.1.0 → 0.2.0

package/README.md

@@ -1,4 +1,4 @@
-# @comando/mcp-server
+# @comando.one/mcp-server
 
 Servidor **MCP (Model Context Protocol)** para a API pública do **Comando.One**. Conecte o Claude (Desktop, Code ou qualquer cliente MCP) ao seu ERP e **opere tudo por linguagem natural**: clientes, propostas, contratos, faturas, cobranças Pix/boleto, NFS-e, contas a pagar, financeiro e webhooks.
 
@@ -11,7 +11,7 @@ Adicione ao seu `claude_desktop_config.json`:
   "mcpServers": {
     "comando": {
       "command": "npx",
-      "args": ["-y", "@comando/mcp-server"],
+      "args": ["-y", "@comando.one/mcp-server"],
       "env": {
         "COMANDO_API_KEY": "cmd_live_...",
         "COMANDO_COMPANY_ID": ""
@@ -23,6 +23,24 @@ Adicione ao seu `claude_desktop_config.json`:
 
 Gere sua chave em **Configurações → API Keys** no app. Reinicie o Claude Desktop e pronto.
 
+## Alternativa: MCP remoto (sem instalar nada)
+
+Além deste pacote stdio, existe um **endpoint MCP remoto (streaming)** em `https://api.comando.one/mcp` (transporte MCP Streamable HTTP). Para clientes com conector remoto:
+
+```json
+{
+  "mcpServers": {
+    "comando-remoto": {
+      "type": "http",
+      "url": "https://api.comando.one/mcp",
+      "headers": { "Authorization": "Bearer cmd_live_..." }
+    }
+  }
+}
+```
+
+Ambos expõem o **mesmo conjunto de ferramentas** (50 curadas + `lookups` + `comando_request` = cobertura total da API).
+
 ## Variáveis de ambiente
 
 | Variável | Obrigatória | Padrão | Descrição |
@@ -33,7 +51,7 @@ Gere sua chave em **Configurações → API Keys** no app. Reinicie o Claude Des
 
 ## Como funciona
 
-- **~50 tools curadas** (gerados a partir do OpenAPI canônico, zero drift) cobrindo as operações de maior valor — `customers_list`, `invoices_create`, `charges_create`, `nfse_emit`, `payouts_create`, etc.
+- **~70 tools curadas** (gerados a partir do OpenAPI canônico, zero drift) cobrindo as operações de maior valor — `customers_list`, `invoices_create`/`invoices_delete`, `charges_create`, `nfse_emit`, `payouts_create`, `contracts_pause`/`contracts_resume`, `service_categories_create`, `reports_aging_actions`/`reports_cashflow_forecast`, `audit_timeline`, `cost_centers_create`, etc.
 - **`comando_request`** — escape hatch genérico (`method`, `path`, `query`, `body`) que cobre 100% dos endpoints restantes.
 - **`lookups`** — catálogos read-only (centros de custo, condições/métodos de pagamento, naturezas, contas bancárias).
 - **`whoami`** — identidade, empresas acessíveis e scopes da chave.

package/dist/index.js

@@ -180,7 +180,50 @@ var MANIFEST = [
   // ----- Webhooks -----
   { operationId: "listWebhooks", tool: "webhooks_list" },
   { operationId: "getWebhookById", tool: "webhooks_get" },
-  { operationId: "createWebhook", tool: "webhooks_create", write: true }
+  { operationId: "createWebhook", tool: "webhooks_create", write: true },
+  // ----- Split de Pagamentos -----
+  { operationId: "listSplitRules", tool: "split_rules_list" },
+  { operationId: "getSplitRule", tool: "split_rules_get" },
+  { operationId: "createSplitRule", tool: "split_rules_create", write: true },
+  { operationId: "updateSplitRule", tool: "split_rules_update", write: true },
+  { operationId: "deleteSplitRule", tool: "split_rules_delete", write: true, destructive: true },
+  { operationId: "listSplitExecutions", tool: "split_executions_list" },
+  { operationId: "getSplitExecution", tool: "split_executions_get" },
+  { operationId: "reverseSplitExecution", tool: "split_reverse", write: true, destructive: true },
+  { operationId: "releaseSplitItem", tool: "split_release_item", write: true },
+  // Auditoria
+  { operationId: "getAuditTimeline", tool: "audit_timeline" },
+  // Categorias de serviço
+  { operationId: "listServiceCategories", tool: "service_categories_list" },
+  { operationId: "createServiceCategory", tool: "service_categories_create", write: true },
+  { operationId: "updateServiceCategory", tool: "service_categories_update", write: true },
+  { operationId: "deleteServiceCategory", tool: "service_categories_delete", write: true, destructive: true },
+  // Relatórios (read-only)
+  { operationId: "reportAgingActions", tool: "reports_aging_actions" },
+  { operationId: "reportCashflowForecast", tool: "reports_cashflow_forecast" },
+  // Contratos — pausar/retomar
+  { operationId: "pauseContract", tool: "contracts_pause", write: true },
+  { operationId: "resumeContract", tool: "contracts_resume", write: true },
+  // Reajustes de contrato (specs/reajustes/) — aplicar muda preço → destructive
+  { operationId: "listDueReadjustments", tool: "contracts_readjustments_due" },
+  { operationId: "listContractReadjustments", tool: "contracts_readjustments_list" },
+  { operationId: "applyContractReadjustment", tool: "contracts_readjustments_apply", write: true, destructive: true },
+  { operationId: "getMarketIndices", tool: "market_indices_get" },
+  // Faturas — exclusão física
+  { operationId: "deleteInvoice", tool: "invoices_delete", write: true, destructive: true },
+  // NFS-e — sincronizar status / baixar arquivos
+  { operationId: "syncNfse", tool: "nfse_sync", write: true },
+  { operationId: "getNfseFiles", tool: "nfse_files" },
+  // Centros de custo (CRUD)
+  { operationId: "listCostCenters", tool: "cost_centers_list" },
+  { operationId: "createCostCenter", tool: "cost_centers_create", write: true },
+  { operationId: "updateCostCenter", tool: "cost_centers_update", write: true },
+  { operationId: "deleteCostCenter", tool: "cost_centers_delete", write: true, destructive: true },
+  // Lembretes (CRUD)
+  { operationId: "listReminders", tool: "reminders_list" },
+  { operationId: "createReminder", tool: "reminders_create", write: true },
+  { operationId: "updateReminder", tool: "reminders_update", write: true },
+  { operationId: "deleteReminder", tool: "reminders_delete", write: true, destructive: true }
 ];
 
 // ../../src/lib/openApiSpec.ts
@@ -230,7 +273,14 @@ var WEBHOOK_EVENT_KEYS = [
   "customer.deleted",
   "supplier.created",
   "supplier.updated",
-  "supplier.deleted"
+  "supplier.deleted",
+  "split.calculated",
+  "repasse.released",
+  "repasse.paid",
+  "repasse.failed",
+  "repasse.reversed",
+  "supplier_payout_request.created",
+  "supplier_payout_request.approved"
 ];
 var SCHEMAS = {
   Error: {
@@ -406,6 +456,65 @@ var SCHEMAS = {
       notes: { type: "string" }
     }
   },
+  ContractReadjustment: {
+    type: "object",
+    description: "Reajuste aplicado a um contrato (specs/reajustes/).",
+    properties: {
+      id: { type: "string", format: "uuid" },
+      contract_id: { type: "string", format: "uuid" },
+      applied_at: { type: "string", format: "date-time" },
+      applied_by: { type: ["string", "null"], format: "uuid" },
+      period_start: { type: ["string", "null"], format: "date", description: "In\xEDcio do per\xEDodo coberto (\xFAltimo reajuste anterior)" },
+      period_end: { type: ["string", "null"], format: "date" },
+      previous_amount: { type: "number" },
+      new_amount: { type: "number" },
+      applied_percent: { type: "number", description: "Percentual efetivamente aplicado" },
+      suggested_percent: { type: ["number", "null"], description: "Sugest\xE3o do \xEDndice preferido no momento da aplica\xE7\xE3o" },
+      suggested_index: { type: ["string", "null"], enum: ["ipca", "igpm", "inpc", "usd", "eur", null] },
+      notes: { type: ["string", "null"] }
+    }
+  },
+  ContractReadjustmentCreate: {
+    type: "object",
+    description: "Informe 'new_amount' OU 'percent' \u2014 o outro \xE9 derivado do valor atual do contrato.",
+    properties: {
+      new_amount: { type: "number", description: "Novo valor do contrato (R$)" },
+      percent: { type: "number", description: "Percentual de reajuste (ex.: 4.62)" },
+      suggested_percent: { type: "number", description: "Sugest\xE3o exibida no momento (para o hist\xF3rico sugerido \xD7 aplicado)" },
+      suggested_index: { type: "string", enum: ["ipca", "igpm", "inpc", "usd", "eur"] },
+      notes: { type: "string" }
+    }
+  },
+  ContractReadjustmentQueueItem: {
+    type: "object",
+    description: "Contrato na fila de reajuste (vencido ou na janela).",
+    properties: {
+      id: { type: "string", format: "uuid" },
+      customer_id: { type: "string", format: "uuid" },
+      customers: { type: "object", properties: { name: { type: "string" } } },
+      title: { type: ["string", "null"] },
+      status: { type: "string" },
+      frequency: { type: "string" },
+      amount: { type: "number" },
+      readjustment_index: { type: "string", enum: ["ipca", "igpm", "inpc", "usd", "eur", "manual"] },
+      readjustment_period_months: { type: "integer" },
+      last_readjustment_date: { type: ["string", "null"], format: "date" },
+      next_readjustment_date: { type: ["string", "null"], format: "date" },
+      next_generation_date: { type: ["string", "null"], format: "date", description: "Quando a pr\xF3xima fatura ser\xE1 gerada \u2014 se antes do reajuste, ela sai no valor antigo" },
+      overdue: { type: "boolean" }
+    }
+  },
+  MarketIndexSuggestion: {
+    type: "object",
+    description: "Acumulado de um \xEDndice oficial no per\xEDodo (fonte: BCB, cache local).",
+    properties: {
+      index_code: { type: "string", enum: ["ipca", "igpm", "inpc", "usd", "eur"] },
+      accumulated_pct: { type: ["number", "null"], description: "Acumulado em pontos percentuais (4.62 = 4,62%); null = sem cobertura de dados" },
+      coverage_start: { type: ["string", "null"], format: "date" },
+      coverage_end: { type: ["string", "null"], format: "date" },
+      last_ref_date: { type: ["string", "null"], format: "date", description: "At\xE9 onde o \xEDndice cobre (IPCA sai com ~15 dias de atraso)" }
+    }
+  },
   InvoiceItem: {
     type: "object",
     properties: {
@@ -510,7 +619,9 @@ var SCHEMAS = {
     type: "object",
     properties: {
       id: { type: "string", format: "uuid" },
-      name: { type: "string" },
+      name: { type: "string", description: "T\xEDtulo / r\xF3tulo de exibi\xE7\xE3o do fornecedor" },
+      legal_name: { type: ["string", "null"], description: "Raz\xE3o social (PJ) ou nome completo (PF/estrangeira)" },
+      surname: { type: ["string", "null"], description: "Sobrenome (pessoa f\xEDsica)" },
       email: { type: ["string", "null"] },
       phone: { type: ["string", "null"] },
       document: { type: ["string", "null"], description: "CPF ou CNPJ" },
@@ -523,6 +634,8 @@ var SCHEMAS = {
       payment_terms_days: { type: ["integer", "null"] },
       status: { type: "string", enum: ["ativo", "inativo"] },
       notes: { type: ["string", "null"] },
+      pagarme_recipient_id: { type: ["string", "null"], description: "ID do recebedor Pagar.me (re_\u2026) para split nativo. Criado pela aplica\xE7\xE3o." },
+      pagarme_kyc_status: { type: ["string", "null"], enum: ["pending", "registration", "approved", "refused", "suspended", "blocked", null], description: "Status de KYC do recebedor Pagar.me." },
       created_at: { type: "string", format: "date-time" },
       updated_at: { type: "string", format: "date-time" }
     }
@@ -531,7 +644,9 @@ var SCHEMAS = {
     type: "object",
     required: ["name"],
     properties: {
-      name: { type: "string" },
+      name: { type: "string", description: "T\xEDtulo / r\xF3tulo de exibi\xE7\xE3o. Se omitido, derivado de legal_name." },
+      legal_name: { type: "string", description: "Raz\xE3o social (PJ) ou nome completo (PF/estrangeira)" },
+      surname: { type: "string", description: "Sobrenome (pessoa f\xEDsica)" },
       email: { type: "string" },
       phone: { type: "string" },
       document: { type: "string" },
@@ -674,8 +789,8 @@ var SCHEMAS = {
       id: { type: "string", format: "uuid" },
       status: { type: "string", enum: ["pending", "paid", "cancelled", "expired", "failed"] },
       status_raw: { type: "string", description: "Status bruto do provider" },
-      method: { type: "string", enum: ["pix", "boleto", "checkout"] },
-      provider: { type: "string", enum: ["inter", "c6bank", "pix_offline"], description: "Provedor resolvido. 'pix_offline' = Pix est\xE1tico (BR Code gerado localmente, sem API banc\xE1ria)." },
+      method: { type: "string", enum: ["pix", "boleto", "checkout", "credit_card"] },
+      provider: { type: "string", enum: ["inter", "c6bank", "pix_offline", "pagarme"], description: "Provedor resolvido. 'pix_offline' = Pix est\xE1tico (BR Code local). 'pagarme' = Pix server-side ou cart\xE3o (method=credit_card retorna 'checkout.url' = link da p\xE1gina de pagamento)." },
       invoice_id: { type: ["string", "null"], format: "uuid" },
       customer_id: { type: ["string", "null"], format: "uuid" },
       amount: { type: ["number", "null"] },
@@ -691,7 +806,8 @@ var SCHEMAS = {
     type: "object",
     required: ["method"],
     properties: {
-      method: { type: "string", enum: ["pix", "boleto", "checkout"], description: "Canal de pagamento" },
+      method: { type: "string", enum: ["pix", "boleto", "checkout", "credit_card"], description: "Canal de pagamento" },
+      provider: { type: "string", enum: ["inter", "c6bank", "pix_offline", "pagarme"], description: "Opcional. Desambigua quando a empresa tem mais de um provedor no mesmo canal (ex.: Pix Inter x Pix Pagar.me). Se omitido, usa o provedor ativo do canal." },
       invoice_id: { type: "string", format: "uuid", description: "Fatura existente (opcional)" },
       customer_id: { type: "string", format: "uuid", description: "Obrigat\xF3rio se invoice_id omitido" },
       amount: { type: "number", description: "Obrigat\xF3rio se invoice_id omitido" },
@@ -773,6 +889,122 @@ var SCHEMAS = {
       description: { type: "string" }
     }
   },
+  SplitRuleRecipient: {
+    type: "object",
+    description: "Linha de uma regra de split: um benefici\xE1rio e sua base de c\xE1lculo.",
+    properties: {
+      id: { type: "string", format: "uuid" },
+      recipient_type: { type: "string", enum: ["supplier", "platform", "company_master"] },
+      supplier_id: { type: ["string", "null"], format: "uuid" },
+      supplier_payment_method_id: { type: ["string", "null"], format: "uuid" },
+      basis: { type: "string", enum: ["percentual", "fixo", "combinado"] },
+      percent: { type: "number", description: "0\u2013100 (percentual)" },
+      fixed_cents: { type: "integer", description: "Valor fixo em centavos" },
+      is_platform_fee: { type: "boolean" },
+      apply_per_installment: { type: "boolean" },
+      installments: { type: ["object", "null"], description: "Divis\xE3o por parcela (jsonb)" },
+      sort_order: { type: "integer" }
+    }
+  },
+  SplitRule: {
+    type: "object",
+    description: "Regra de divis\xE3o (template) de um recebimento entre benefici\xE1rios.",
+    properties: {
+      id: { type: "string", format: "uuid" },
+      name: { type: "string" },
+      description: { type: ["string", "null"] },
+      scope: { type: "string", enum: ["company_default", "contract", "invoice", "charge"] },
+      contract_id: { type: ["string", "null"], format: "uuid" },
+      fiscal_mode: { type: "string", enum: ["intermediacao", "revenda"] },
+      fee_payer: { type: "string", enum: ["platform", "recipients", "proportional"] },
+      release_trigger: { type: "string", enum: ["on_settlement", "on_nota", "manual", "scheduled"] },
+      rounding_strategy: { type: "string", enum: ["remainder_to_master", "largest_remainder"] },
+      is_active: { type: "boolean" },
+      gateway_split_enabled: { type: "boolean", description: "Quando true, usa o split nativo da Pagar.me (divis\xE3o no ato do pagamento) se a cobran\xE7a for Pagar.me e os fornecedores tiverem recebedor aprovado; sen\xE3o, repasse interno." },
+      recipients: { type: "array", items: { $ref: "#/components/schemas/SplitRuleRecipient" } },
+      created_at: { type: "string", format: "date-time" },
+      updated_at: { type: "string", format: "date-time" }
+    }
+  },
+  SplitRuleCreate: {
+    type: "object",
+    required: ["name", "recipients"],
+    properties: {
+      name: { type: "string" },
+      description: { type: "string" },
+      scope: { type: "string", enum: ["company_default", "contract", "invoice", "charge"], default: "company_default" },
+      contract_id: { type: "string", format: "uuid", description: "Obrigat\xF3rio quando scope=contract" },
+      fiscal_mode: { type: "string", enum: ["intermediacao", "revenda"], default: "intermediacao" },
+      fee_payer: { type: "string", enum: ["platform", "recipients", "proportional"], default: "platform" },
+      release_trigger: { type: "string", enum: ["on_settlement", "on_nota", "manual", "scheduled"], default: "on_settlement" },
+      rounding_strategy: { type: "string", enum: ["remainder_to_master", "largest_remainder"], default: "remainder_to_master" },
+      is_active: { type: "boolean", default: true },
+      gateway_split_enabled: { type: "boolean", default: true, description: "Usar o split nativo da Pagar.me quando aplic\xE1vel (sen\xE3o repasse interno)." },
+      recipients: {
+        type: "array",
+        description: "Benefici\xE1rios. Percentual primeiro, depois fixo. Soma de percentuais \u2264 100.",
+        items: {
+          type: "object",
+          required: ["recipient_type", "basis"],
+          properties: {
+            recipient_type: { type: "string", enum: ["supplier", "platform", "company_master"] },
+            supplier_id: { type: "string", format: "uuid", description: "Obrigat\xF3rio se recipient_type=supplier" },
+            supplier_payment_method_id: { type: "string", format: "uuid" },
+            basis: { type: "string", enum: ["percentual", "fixo", "combinado"] },
+            percent: { type: "number" },
+            fixed_cents: { type: "integer" },
+            is_platform_fee: { type: "boolean" },
+            sort_order: { type: "integer" },
+            apply_per_installment: { type: "boolean", description: "Split por parcela: percent/fixo v\xEAm de 'installments'" },
+            installments: { type: "object", description: 'Por n\xBA de parcela, ex.: { "1": { "percent": 50 }, "default": { "percent": 100 } }' }
+          }
+        }
+      }
+    }
+  },
+  SplitExecutionItem: {
+    type: "object",
+    description: "Fatia de uma execu\xE7\xE3o de split, por benefici\xE1rio.",
+    properties: {
+      id: { type: "string", format: "uuid" },
+      recipient_type: { type: "string", enum: ["supplier", "platform", "company_master"] },
+      supplier_id: { type: ["string", "null"], format: "uuid" },
+      supplier_name: { type: ["string", "null"] },
+      is_platform_fee: { type: "boolean" },
+      gross_share_cents: { type: "integer" },
+      fee_share_cents: { type: "integer" },
+      net_share_cents: { type: "integer" },
+      status: { type: "string", enum: ["pending", "awaiting_nota", "released", "paying", "paid", "reversed", "failed"] },
+      payment_order_id: { type: ["string", "null"], format: "uuid" },
+      nota_status: { type: "string" },
+      error_message: { type: ["string", "null"], description: "Motivo da falha do repasse (quando status=failed)" },
+      released_at: { type: ["string", "null"], format: "date-time" },
+      paid_at: { type: ["string", "null"], format: "date-time" },
+      reversed_at: { type: ["string", "null"], format: "date-time" }
+    }
+  },
+  SplitExecution: {
+    type: "object",
+    description: "Execu\xE7\xE3o de split: inst\xE2ncia concreta de uma divis\xE3o por cobran\xE7a recebida.",
+    properties: {
+      id: { type: "string", format: "uuid" },
+      invoice_id: { type: ["string", "null"], format: "uuid" },
+      charge_id: { type: ["string", "null"], format: "uuid" },
+      split_rule_id: { type: ["string", "null"], format: "uuid" },
+      gateway_provider: { type: ["string", "null"] },
+      gross_cents: { type: "integer" },
+      gateway_fee_cents: { type: "integer" },
+      net_cents: { type: "integer" },
+      fiscal_mode: { type: "string", enum: ["intermediacao", "revenda"] },
+      release_trigger: { type: "string", enum: ["on_settlement", "on_nota", "manual", "scheduled"] },
+      status: { type: "string", enum: ["pending", "calculated", "releasing", "completed", "partial", "reversed", "failed"] },
+      settled_at: { type: ["string", "null"], format: "date-time" },
+      error_message: { type: ["string", "null"] },
+      items: { type: "array", items: { $ref: "#/components/schemas/SplitExecutionItem" } },
+      created_at: { type: "string", format: "date-time" },
+      updated_at: { type: "string", format: "date-time" }
+    }
+  },
   SupplierPaymentMethod: {
     type: "object",
     properties: {
@@ -991,6 +1223,34 @@ var SCHEMAS = {
       sort_order: { type: "integer" }
     }
   },
+  Reminder: {
+    type: "object",
+    properties: {
+      id: { type: "string", format: "uuid" },
+      scope: { type: "string", enum: ["personal", "company"] },
+      audience: { type: "array", items: { type: "string", enum: ["admin", "operador", "visualizador"] }, description: "Pap\xE9is que recebem (vazio = todos os membros)." },
+      kind: { type: "string", enum: ["manual", "digest"] },
+      template_key: { type: ["string", "null"], description: "Para digest: revenue.summary, receivables.overdue, payables.due, cards.upcoming, nfse.monthly, cashflow.position, mrr.snapshot." },
+      params: { type: "object", description: "Par\xE2metros do digest (ex: { period: 'week' } ou { days_ahead: 7 })." },
+      title: { type: ["string", "null"] },
+      body: { type: ["string", "null"] },
+      entity_type: { type: ["string", "null"] },
+      entity_id: { type: ["string", "null"], format: "uuid" },
+      channels: { type: "object", properties: { in_app: { type: "boolean" }, email: { type: "boolean" }, push: { type: "boolean" } } },
+      recurrence_type: { type: "string", enum: ["once", "daily", "weekly", "monthly"] },
+      run_time: { type: "string", description: "HH:MM[:SS], hora local do fuso." },
+      weekday: { type: ["integer", "null"], description: "0=domingo \u2026 6=s\xE1bado (semanal)." },
+      day_of_month: { type: ["integer", "null"], description: "1\u201331 (mensal; meses curtos usam o \xFAltimo dia)." },
+      timezone: { type: "string" },
+      start_date: { type: ["string", "null"], format: "date" },
+      end_date: { type: ["string", "null"], format: "date" },
+      next_run_at: { type: ["string", "null"], format: "date-time" },
+      last_run_at: { type: ["string", "null"], format: "date-time" },
+      active: { type: "boolean" },
+      created_at: { type: "string", format: "date-time" },
+      updated_at: { type: "string", format: "date-time" }
+    }
+  },
   PaymentCondition: {
     type: "object",
     properties: {
@@ -1004,6 +1264,15 @@ var SCHEMAS = {
     type: "object",
     properties: { id: { type: "string", format: "uuid" }, name: { type: "string" } }
   },
+  ServiceCategory: {
+    type: "object",
+    properties: {
+      id: { type: "string", format: "uuid" },
+      name: { type: "string" },
+      color: { type: ["string", "null"] },
+      created_at: { type: "string", format: "date-time" }
+    }
+  },
   WebhookDelivery: {
     type: "object",
     properties: {
@@ -1072,7 +1341,7 @@ var OPENAPI_SPEC = {
   },
   servers: [
     { url: "https://api.comando.one/v1", description: "Produ\xE7\xE3o" },
-    { url: "https://pecdxlrbutkrtxvjsquf.supabase.co/functions/v1/public-api/v1", description: "Supabase direto" }
+    { url: "https://sb.comando.one/functions/v1/public-api/v1", description: "Supabase direto" }
   ],
   security: API_KEY_SECURITY,
   tags: [
@@ -1093,7 +1362,8 @@ var OPENAPI_SPEC = {
     { name: "Contas banc\xE1rias", description: "Contas banc\xE1rias (somente leitura)" },
     { name: "Pagamentos a Fornecedor", description: "Payouts \u2014 pagar/agendar Pix e boleto a fornecedores" },
     { name: "M\xE9todos de pagamento", description: "Formas de recebimento dispon\xEDveis" },
-    { name: "Formas de pagamento do fornecedor", description: "Cadastro de destinos de pagamento por fornecedor" }
+    { name: "Formas de pagamento do fornecedor", description: "Cadastro de destinos de pagamento por fornecedor" },
+    { name: "Lembretes", description: "Lembretes e resumos agendados (recorrentes ou avulsos)" }
   ],
   components: {
     securitySchemes: {
@@ -1526,6 +1796,89 @@ var OPENAPI_SPEC = {
         responses: { "204": { description: "Exclu\xEDdo" }, "404": errorResponse("Contrato n\xE3o encontrado"), "409": errorResponse("H\xE1 registros vinculados que impedem a exclus\xE3o"), ...COMMON_ERRORS }
       }
     },
+    "/contracts/{id}/pause": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      post: {
+        tags: ["Contratos"],
+        summary: "Pausar contrato (status \u2192 suspenso)",
+        operationId: "pauseContract",
+        security: [{ ApiKeyAuth: ["contracts:write"] }],
+        responses: { "200": { description: "Contrato pausado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "404": errorResponse("Contrato n\xE3o encontrado"), ...COMMON_ERRORS }
+      }
+    },
+    "/contracts/{id}/resume": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      post: {
+        tags: ["Contratos"],
+        summary: "Retomar contrato (status \u2192 ativo)",
+        operationId: "resumeContract",
+        security: [{ ApiKeyAuth: ["contracts:write"] }],
+        responses: { "200": { description: "Contrato retomado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "404": errorResponse("Contrato n\xE3o encontrado"), "409": errorResponse("Status n\xE3o permite retomada"), ...COMMON_ERRORS }
+      }
+    },
+    "/contracts/readjustments/due": {
+      get: {
+        tags: ["Contratos"],
+        summary: "Fila de reajuste (contratos atrasados + janela)",
+        description: "Contratos ativos, n\xE3o isentos, com reajuste vencido ou vencendo na janela informada. Campo 'overdue' indica atraso.",
+        operationId: "listDueReadjustments",
+        security: [{ ApiKeyAuth: ["contracts:read"] }],
+        parameters: [
+          { name: "days", in: "query", schema: { type: "integer", default: 30, minimum: 0, maximum: 365 }, description: "Janela em dias al\xE9m dos atrasados" }
+        ],
+        responses: {
+          "200": { description: "Fila de reajuste", content: { "application/json": { schema: { type: "object", properties: { data: { type: "array", items: { $ref: "#/components/schemas/ContractReadjustmentQueueItem" } }, window_days: { type: "integer" } } } } } },
+          ...COMMON_ERRORS
+        }
+      }
+    },
+    "/contracts/{id}/readjustments": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      get: {
+        tags: ["Contratos"],
+        summary: "Hist\xF3rico de reajustes do contrato",
+        operationId: "listContractReadjustments",
+        security: [{ ApiKeyAuth: ["contracts:read"] }],
+        responses: {
+          "200": { description: "Reajustes aplicados (mais recente primeiro)", content: { "application/json": { schema: { type: "object", properties: { data: { type: "array", items: { $ref: "#/components/schemas/ContractReadjustment" } } } } } } },
+          "404": errorResponse("Contrato n\xE3o encontrado"),
+          ...COMMON_ERRORS
+        }
+      },
+      post: {
+        tags: ["Contratos"],
+        summary: "Aplicar reajuste no contrato",
+        description: "Atualiza o valor do contrato (e escala os itens proporcionalmente), grava o hist\xF3rico e avan\xE7a a data do pr\xF3ximo reajuste. Informe 'new_amount' OU 'percent'. Faturas j\xE1 geradas n\xE3o s\xE3o alteradas.",
+        operationId: "applyContractReadjustment",
+        security: [{ ApiKeyAuth: ["contracts:write"] }],
+        requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ContractReadjustmentCreate" } } } },
+        responses: {
+          "201": { description: "Reajuste aplicado", content: { "application/json": { schema: { $ref: "#/components/schemas/ContractReadjustment" } } } },
+          "400": errorResponse("Dados inv\xE1lidos"),
+          "404": errorResponse("Contrato n\xE3o encontrado"),
+          "409": errorResponse("Contrato com valor zero \u2014 informe new_amount"),
+          ...COMMON_ERRORS
+        }
+      }
+    },
+    "/market-indices": {
+      get: {
+        tags: ["Contratos"],
+        summary: "\xCDndices de mercado acumulados no per\xEDodo (BCB)",
+        description: "Acumulado de IPCA/IGP-M/INPC (composto mensal) e varia\xE7\xE3o da PTAX de d\xF3lar/euro entre 'from' e 'to'. Fonte: Banco Central (SGS e PTAX), sincronizada diariamente.",
+        operationId: "getMarketIndices",
+        security: [{ ApiKeyAuth: ["contracts:read"] }],
+        parameters: [
+          { name: "from", in: "query", required: true, schema: { type: "string", format: "date" }, description: "In\xEDcio do per\xEDodo (ex.: data do \xFAltimo reajuste)" },
+          { name: "to", in: "query", schema: { type: "string", format: "date" }, description: "Fim do per\xEDodo (padr\xE3o: hoje)" }
+        ],
+        responses: {
+          "200": { description: "Acumulados por \xEDndice", content: { "application/json": { schema: { type: "object", properties: { from: { type: "string", format: "date" }, to: { type: "string", format: "date" }, data: { type: "array", items: { $ref: "#/components/schemas/MarketIndexSuggestion" } } } } } } },
+          "400": errorResponse("Par\xE2metro 'from' obrigat\xF3rio"),
+          ...COMMON_ERRORS
+        }
+      }
+    },
     // -----------------------------------------------------------------------
     // Invoices
     // -----------------------------------------------------------------------
@@ -1571,6 +1924,14 @@ var OPENAPI_SPEC = {
           "404": errorResponse("Fatura n\xE3o encontrada"),
           ...COMMON_ERRORS
         }
+      },
+      delete: {
+        tags: ["Faturas"],
+        summary: "Excluir fatura",
+        operationId: "deleteInvoice",
+        description: "Exclus\xE3o f\xEDsica da fatura (itens e cobran\xE7as vinculadas via cascade). Use cancel para apenas cancelar.",
+        security: [{ ApiKeyAuth: ["invoices:delete"] }],
+        responses: { "204": { description: "Exclu\xEDda" }, "404": errorResponse("Fatura n\xE3o encontrada"), "409": errorResponse("H\xE1 registros vinculados que impedem a exclus\xE3o"), ...COMMON_ERRORS }
       }
     },
     "/invoices/{id}/cancel": {
@@ -1668,6 +2029,114 @@ var OPENAPI_SPEC = {
         security: [{ ApiKeyAuth: ["expenses:read", "expenses:write", "finance:read"] }],
         parameters: [...PAGINATION_PARAMS, { name: "active", in: "query", schema: { type: "string", enum: ["true", "false"] } }],
         responses: { "200": paginatedResponse("#/components/schemas/CostCenter"), ...COMMON_ERRORS }
+      },
+      post: {
+        tags: ["Cat\xE1logos"],
+        summary: "Criar centro de custo",
+        operationId: "createCostCenter",
+        security: [{ ApiKeyAuth: ["finance:write"] }],
+        requestBody: { required: true, content: { "application/json": { schema: { type: "object", required: ["name"], properties: {
+          name: { type: "string" },
+          color: { type: "string" },
+          icon: { type: "string" },
+          dre_group: { type: "string" },
+          sort_order: { type: "integer" },
+          active: { type: "boolean" }
+        } } } } },
+        responses: { "201": { description: "Centro de custo criado", content: { "application/json": { schema: { $ref: "#/components/schemas/CostCenter" } } } }, "400": errorResponse("Nome ausente"), "409": errorResponse("Nome duplicado"), ...COMMON_ERRORS }
+      }
+    },
+    "/cost-centers/{id}": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      patch: {
+        tags: ["Cat\xE1logos"],
+        summary: "Atualizar centro de custo",
+        operationId: "updateCostCenter",
+        security: [{ ApiKeyAuth: ["finance:write"] }],
+        requestBody: { required: true, content: { "application/json": { schema: { type: "object", properties: { name: { type: "string" }, color: { type: "string" }, icon: { type: "string" }, dre_group: { type: "string" }, sort_order: { type: "integer" }, active: { type: "boolean" } } } } } },
+        responses: { "200": { description: "Atualizado", content: { "application/json": { schema: { $ref: "#/components/schemas/CostCenter" } } } }, "400": errorResponse("Nada para atualizar"), "404": errorResponse("N\xE3o encontrado"), "409": errorResponse("Nome duplicado"), ...COMMON_ERRORS }
+      },
+      delete: {
+        tags: ["Cat\xE1logos"],
+        summary: "Excluir centro de custo",
+        operationId: "deleteCostCenter",
+        security: [{ ApiKeyAuth: ["finance:delete"] }],
+        responses: { "204": { description: "Exclu\xEDdo" }, "404": errorResponse("N\xE3o encontrado"), "409": errorResponse("H\xE1 registros vinculados"), ...COMMON_ERRORS }
+      }
+    },
+    "/reminders": {
+      get: {
+        tags: ["Lembretes"],
+        summary: "Listar lembretes",
+        operationId: "listReminders",
+        description: "Lembretes e resumos agendados da empresa.",
+        security: [{ ApiKeyAuth: ["reminders:list"] }],
+        parameters: [
+          ...PAGINATION_PARAMS,
+          { name: "active", in: "query", schema: { type: "string", enum: ["true", "false"] } },
+          { name: "scope", in: "query", schema: { type: "string", enum: ["personal", "company"] } }
+        ],
+        responses: { "200": paginatedResponse("#/components/schemas/Reminder"), ...COMMON_ERRORS }
+      },
+      post: {
+        tags: ["Lembretes"],
+        summary: "Criar lembrete",
+        operationId: "createReminder",
+        description: "Cria um lembrete. ESCOPO: scope='personal' cria um lembrete s\xF3 do usu\xE1rio (aparece em 'Meus lembretes'); scope='company' cria para a empresa (todos os membros veem). No chat, scope='personal' usa o usu\xE1rio autenticado; via chave cmd_live (sem usu\xE1rio) informe owner_user_id para pessoal. RELATIVO ('daqui 30 min'): { title, remind_in_minutes } \u2014 o servidor calcula o hor\xE1rio. ABSOLUTO: { title, remind_at } (ISO, use 'Z' p/ UTC). Em ambos, kind=manual, recurrence_type=once, start_date e run_time s\xE3o inferidos.",
+        security: [{ ApiKeyAuth: ["reminders:create"] }],
+        requestBody: { required: true, content: { "application/json": { schema: { type: "object", required: ["title"], properties: {
+          scope: { type: "string", enum: ["personal", "company"], description: "personal = s\xF3 do usu\xE1rio; company = todos da empresa. Default: personal no chat (com usu\xE1rio), company via chave de API." },
+          owner_user_id: { type: "string", format: "uuid", description: "Dono do lembrete pessoal (membro da empresa). No chat \xE9 inferido do usu\xE1rio; s\xF3 necess\xE1rio via chave cmd_live para scope=personal." },
+          kind: { type: "string", enum: ["manual", "digest"], description: "Default: manual (ou digest se houver template_key)." },
+          title: { type: "string", description: "T\xEDtulo do lembrete (obrigat\xF3rio para kind=manual)." },
+          body: { type: "string" },
+          template_key: { type: "string", description: "Obrigat\xF3rio para kind=digest." },
+          remind_in_minutes: { type: "integer", description: "Atalho RELATIVO: minutos a partir de agora (servidor calcula). Ex.: 'daqui 30min' \u2192 30. Preferir para lembretes relativos." },
+          remind_at: { type: "string", description: "Atalho ABSOLUTO: instante ISO (use 'Z' para UTC). Vira recurrence once + start_date + run_time no fuso." },
+          params: { type: "object" },
+          audience: { type: "array", items: { type: "string", enum: ["admin", "operador", "visualizador"] } },
+          channels: { type: "object", properties: { in_app: { type: "boolean" }, email: { type: "boolean" }, push: { type: "boolean" } } },
+          recurrence_type: { type: "string", enum: ["once", "daily", "weekly", "monthly"], description: "Default once quando se usa remind_in_minutes/remind_at." },
+          run_time: { type: "string", description: "HH:MM (hora local) \u2014 para recorr\xEAncias." },
+          weekday: { type: "integer", description: "0\u20136 (semanal)." },
+          day_of_month: { type: "integer", description: "1\u201331 (mensal)." },
+          timezone: { type: "string" },
+          start_date: { type: "string", format: "date" },
+          end_date: { type: "string", format: "date" }
+        } } } } },
+        responses: { "201": { description: "Lembrete criado", content: { "application/json": { schema: { $ref: "#/components/schemas/Reminder" } } } }, "400": errorResponse("Campos inv\xE1lidos"), ...COMMON_ERRORS }
+      }
+    },
+    "/reminders/{id}": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      patch: {
+        tags: ["Lembretes"],
+        summary: "Atualizar / pausar lembrete",
+        operationId: "updateReminder",
+        security: [{ ApiKeyAuth: ["reminders:update"] }],
+        requestBody: { required: true, content: { "application/json": { schema: { type: "object", properties: {
+          title: { type: "string" },
+          body: { type: "string" },
+          params: { type: "object" },
+          audience: { type: "array", items: { type: "string" } },
+          channels: { type: "object" },
+          recurrence_type: { type: "string", enum: ["once", "daily", "weekly", "monthly"] },
+          run_time: { type: "string" },
+          weekday: { type: "integer" },
+          day_of_month: { type: "integer" },
+          timezone: { type: "string" },
+          start_date: { type: "string", format: "date" },
+          end_date: { type: "string", format: "date" },
+          active: { type: "boolean" }
+        } } } } },
+        responses: { "200": { description: "Atualizado", content: { "application/json": { schema: { $ref: "#/components/schemas/Reminder" } } } }, "400": errorResponse("Nada para atualizar"), "404": errorResponse("N\xE3o encontrado"), ...COMMON_ERRORS }
+      },
+      delete: {
+        tags: ["Lembretes"],
+        summary: "Excluir lembrete",
+        operationId: "deleteReminder",
+        security: [{ ApiKeyAuth: ["reminders:delete"] }],
+        responses: { "204": { description: "Exclu\xEDdo" }, "404": errorResponse("N\xE3o encontrado"), ...COMMON_ERRORS }
       }
     },
     "/payment-conditions": {
@@ -1690,6 +2159,116 @@ var OPENAPI_SPEC = {
         responses: { "200": paginatedResponse("#/components/schemas/ServiceUnit"), ...COMMON_ERRORS }
       }
     },
+    "/audit/timeline": {
+      get: {
+        tags: ["Auditoria"],
+        summary: "Timeline de auditoria de uma entidade",
+        operationId: "getAuditTimeline",
+        description: "Retorna o hist\xF3rico de altera\xE7\xF5es (audit_logs) de uma entidade da empresa, mais recente primeiro.",
+        security: [{ ApiKeyAuth: ["audit:read"] }],
+        parameters: [
+          { name: "entity_type", in: "query", required: true, schema: { type: "string" }, description: "Tipo da entidade (ex.: invoice, customer, contract)" },
+          { name: "entity_id", in: "query", required: true, schema: { type: "string", format: "uuid" }, description: "ID da entidade" },
+          { name: "limit", in: "query", schema: { type: "integer", minimum: 1, maximum: 30, default: 12 }, description: "M\xE1ximo de eventos (1\u201330)" }
+        ],
+        responses: {
+          "200": {
+            description: "Timeline da entidade",
+            content: { "application/json": { schema: {
+              type: "object",
+              properties: {
+                entity_type: { type: "string" },
+                entity_id: { type: "string", format: "uuid" },
+                entries: { type: "array", items: { type: "object", properties: {
+                  created_at: { type: "string", format: "date-time" },
+                  action: { type: "string" },
+                  description: { type: "string" },
+                  user_email: { type: "string" }
+                } } }
+              }
+            } } }
+          },
+          ...COMMON_ERRORS
+        }
+      }
+    },
+    "/service-categories": {
+      get: {
+        tags: ["Servi\xE7os"],
+        summary: "Listar categorias de servi\xE7o",
+        operationId: "listServiceCategories",
+        security: [{ ApiKeyAuth: ["services:read"] }],
+        parameters: [...PAGINATION_PARAMS, { name: "search", in: "query", schema: { type: "string" }, description: "Filtro por nome (ilike)" }],
+        responses: { "200": paginatedResponse("#/components/schemas/ServiceCategory"), ...COMMON_ERRORS }
+      },
+      post: {
+        tags: ["Servi\xE7os"],
+        summary: "Criar categoria(s) de servi\xE7o",
+        operationId: "createServiceCategory",
+        security: [{ ApiKeyAuth: ["services:write"] }],
+        requestBody: { required: true, content: { "application/json": { schema: { type: "object", properties: {
+          name: { type: "string", description: "Nome de uma categoria" },
+          names: { type: "array", items: { type: "string" }, description: "Lista de nomes (cria v\xE1rias de uma vez)" },
+          color: { type: "string", description: "Cor hex (default #6366f1)" }
+        } } } } },
+        responses: { "201": { description: "Categoria(s) criada(s)", content: { "application/json": { schema: { $ref: "#/components/schemas/ServiceCategory" } } } }, "400": errorResponse("Nome ausente"), "409": errorResponse("Categoria j\xE1 existe"), ...COMMON_ERRORS }
+      }
+    },
+    "/service-categories/{id}": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      patch: {
+        tags: ["Servi\xE7os"],
+        summary: "Atualizar categoria de servi\xE7o",
+        operationId: "updateServiceCategory",
+        security: [{ ApiKeyAuth: ["services:write"] }],
+        requestBody: { required: true, content: { "application/json": { schema: { type: "object", properties: { name: { type: "string" }, color: { type: "string" } } } } } },
+        responses: { "200": { description: "Atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/ServiceCategory" } } } }, "400": errorResponse("Nada para atualizar"), "404": errorResponse("N\xE3o encontrada"), "409": errorResponse("Nome duplicado"), ...COMMON_ERRORS }
+      },
+      delete: {
+        tags: ["Servi\xE7os"],
+        summary: "Excluir categoria de servi\xE7o",
+        operationId: "deleteServiceCategory",
+        security: [{ ApiKeyAuth: ["services:delete"] }],
+        responses: { "204": { description: "Exclu\xEDda" }, "404": errorResponse("N\xE3o encontrada"), ...COMMON_ERRORS }
+      }
+    },
+    "/reports/aging-actions": {
+      get: {
+        tags: ["Relat\xF3rios"],
+        summary: "Aging de inadimpl\xEAncia com a\xE7\xF5es sugeridas",
+        operationId: "reportAgingActions",
+        security: [{ ApiKeyAuth: ["invoices:read", "finance:read"] }],
+        parameters: [
+          { name: "limit", in: "query", schema: { type: "integer", minimum: 1, maximum: 40, default: 12 } },
+          { name: "min_overdue_days", in: "query", schema: { type: "integer", minimum: 1, maximum: 365, default: 1 } },
+          { name: "include_shared", in: "query", schema: { type: "boolean", default: true }, description: "Incluir clientes compartilhados" },
+          { name: "customer_id", in: "query", schema: { type: "string", format: "uuid" } },
+          { name: "search", in: "query", schema: { type: "string" } }
+        ],
+        responses: { "200": { description: "Faturas em atraso + a\xE7\xF5es recomendadas", content: { "application/json": { schema: { type: "object", properties: {
+          count: { type: "integer" },
+          limit: { type: "integer" },
+          min_overdue_days: { type: "integer" },
+          total_overdue_amount: { type: "number" },
+          actions: { type: "array", items: { type: "object" } }
+        } } } } }, ...COMMON_ERRORS }
+      }
+    },
+    "/reports/cashflow-forecast": {
+      get: {
+        tags: ["Relat\xF3rios"],
+        summary: "Previs\xE3o de fluxo de caixa",
+        operationId: "reportCashflowForecast",
+        security: [{ ApiKeyAuth: ["finance:read"] }],
+        parameters: [
+          { name: "horizon_days", in: "query", schema: { type: "integer", minimum: 1, maximum: 120, default: 30 } },
+          { name: "opening_balance", in: "query", schema: { type: "number", default: 0 } },
+          { name: "include_receivables", in: "query", schema: { type: "boolean", default: true } },
+          { name: "include_payables", in: "query", schema: { type: "boolean", default: true } }
+        ],
+        responses: { "200": { description: "Proje\xE7\xE3o di\xE1ria de caixa (timeline)", content: { "application/json": { schema: { type: "object" } } } }, ...COMMON_ERRORS }
+      }
+    },
     // -----------------------------------------------------------------------
     // NFS-e
     // -----------------------------------------------------------------------
@@ -1744,6 +2323,27 @@ var OPENAPI_SPEC = {
         }
       }
     },
+    "/nfse/{id}/sync": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      post: {
+        tags: ["NFS-e"],
+        summary: "Sincronizar status da NFS-e com o provedor",
+        operationId: "syncNfse",
+        security: [{ ApiKeyAuth: ["nfse:read"] }],
+        responses: { "200": { description: "Resultado da sincroniza\xE7\xE3o", content: { "application/json": { schema: { type: "object", properties: { id: { type: "string" }, invoice_id: { type: "string" }, processed: { type: "integer" }, updated: { type: "integer" }, attached: { type: "integer" } } } } } }, "404": errorResponse("NFS-e n\xE3o encontrada"), "502": errorResponse("Erro do provedor de NFS-e"), ...COMMON_ERRORS }
+      }
+    },
+    "/nfse/{id}/files": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      get: {
+        tags: ["NFS-e"],
+        summary: "URLs assinadas do XML e DANFSE",
+        operationId: "getNfseFiles",
+        description: "Retorna URLs tempor\xE1rias (30 min) para download do XML e do PDF (DANFSE). Gera o PDF sob demanda se a nota estiver autorizada/cancelada.",
+        security: [{ ApiKeyAuth: ["nfse:read"] }],
+        responses: { "200": { description: "URLs assinadas", content: { "application/json": { schema: { type: "object", properties: { id: { type: "string" }, invoice_id: { type: "string" }, status: { type: "string" }, xml_signed_url: { type: ["string", "null"] }, danfse_signed_url: { type: ["string", "null"] }, signed_url_ttl_seconds: { type: "integer" } } } } } }, "404": errorResponse("NFS-e n\xE3o encontrada"), ...COMMON_ERRORS }
+      }
+    },
     // -----------------------------------------------------------------------
     // Fornecedores
     // -----------------------------------------------------------------------
@@ -1963,7 +2563,7 @@ var OPENAPI_SPEC = {
         parameters: [
           ...PAGINATION_PARAMS,
           { name: "status", in: "query", schema: { type: "string", enum: ["pending", "paid", "cancelled", "expired", "failed"] } },
-          { name: "method", in: "query", schema: { type: "string", enum: ["pix", "boleto", "checkout"] } },
+          { name: "method", in: "query", schema: { type: "string", enum: ["pix", "boleto", "checkout", "credit_card"] } },
           { name: "customer_id", in: "query", schema: { type: "string", format: "uuid" } },
           { name: "invoice_id", in: "query", schema: { type: "string", format: "uuid" } }
         ],
@@ -1971,9 +2571,9 @@ var OPENAPI_SPEC = {
       },
       post: {
         tags: ["Cobran\xE7as"],
-        summary: "Criar cobran\xE7a (Pix, boleto ou checkout)",
+        summary: "Criar cobran\xE7a (Pix, boleto, checkout ou cart\xE3o)",
         operationId: "createCharge",
-        description: "Gera uma cobran\xE7a no provider ativo da empresa (Inter ou C6 Bank). Forne\xE7a invoice_id ou customer_id+amount+due_date.",
+        description: "Gera uma cobran\xE7a no provider ativo da empresa (Inter, C6 Bank, Pix Offline ou Pagar.me). Forne\xE7a invoice_id ou customer_id+amount+due_date. Com Pagar.me, method=pix retorna o copia-e-cola e method=credit_card retorna 'checkout.url' (link da p\xE1gina de pagamento pr\xF3pria).",
         security: [{ ApiKeyAuth: ["charges:create"] }],
         requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ChargeCreate" } } } },
         responses: {
@@ -2255,6 +2855,104 @@ var OPENAPI_SPEC = {
       }
     },
     // -----------------------------------------------------------------------
+    // Split de Pagamentos (regras, execuções, repasses)
+    // -----------------------------------------------------------------------
+    "/split-rules": {
+      get: {
+        tags: ["Split de Pagamentos"],
+        summary: "Listar regras de split",
+        operationId: "listSplitRules",
+        security: [{ ApiKeyAuth: ["split:list"] }],
+        parameters: [
+          ...PAGINATION_PARAMS,
+          { name: "scope", in: "query", schema: { type: "string", enum: ["company_default", "contract", "invoice", "charge"] } }
+        ],
+        responses: { "200": paginatedResponse("#/components/schemas/SplitRule"), ...COMMON_ERRORS }
+      },
+      post: {
+        tags: ["Split de Pagamentos"],
+        summary: "Criar regra de split",
+        operationId: "createSplitRule",
+        description: "Cria uma regra de divis\xE3o com seus benefici\xE1rios (recipients). Percentual primeiro, depois fixo; soma de percentuais \u2264 100.",
+        security: [{ ApiKeyAuth: ["split:create"] }],
+        requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/SplitRuleCreate" } } } },
+        responses: { "201": { description: "Regra criada", content: { "application/json": { schema: { $ref: "#/components/schemas/SplitRule" } } } }, "400": errorResponse("Dados inv\xE1lidos"), ...COMMON_ERRORS }
+      }
+    },
+    "/split-rules/{id}": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      get: {
+        tags: ["Split de Pagamentos"],
+        summary: "Obter regra de split",
+        operationId: "getSplitRule",
+        security: [{ ApiKeyAuth: ["split:list"] }],
+        responses: { "200": { description: "Regra", content: { "application/json": { schema: { $ref: "#/components/schemas/SplitRule" } } } }, "404": errorResponse("Regra n\xE3o encontrada"), ...COMMON_ERRORS }
+      },
+      patch: {
+        tags: ["Split de Pagamentos"],
+        summary: "Atualizar regra de split",
+        operationId: "updateSplitRule",
+        description: "Atualiza campos da regra. Se 'recipients' for enviado, substitui todos os benefici\xE1rios.",
+        security: [{ ApiKeyAuth: ["split:update"] }],
+        requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/SplitRuleCreate" } } } },
+        responses: { "200": { description: "Regra atualizada", content: { "application/json": { schema: { $ref: "#/components/schemas/SplitRule" } } } }, "404": errorResponse("Regra n\xE3o encontrada"), ...COMMON_ERRORS }
+      },
+      delete: {
+        tags: ["Split de Pagamentos"],
+        summary: "Excluir regra de split",
+        operationId: "deleteSplitRule",
+        security: [{ ApiKeyAuth: ["split:delete"] }],
+        responses: { "200": { description: "Removida", content: { "application/json": { schema: { type: "object", properties: { deleted: { type: "boolean" }, id: { type: "string" } } } } } }, "404": errorResponse("Regra n\xE3o encontrada"), ...COMMON_ERRORS }
+      }
+    },
+    "/split-executions": {
+      get: {
+        tags: ["Split de Pagamentos"],
+        summary: "Listar execu\xE7\xF5es de split",
+        operationId: "listSplitExecutions",
+        security: [{ ApiKeyAuth: ["split:list"] }],
+        parameters: [
+          ...PAGINATION_PARAMS,
+          { name: "status", in: "query", schema: { type: "string", enum: ["pending", "calculated", "releasing", "completed", "partial", "reversed", "failed"] } },
+          { name: "invoice_id", in: "query", schema: { type: "string", format: "uuid" } },
+          { name: "supplier_id", in: "query", schema: { type: "string", format: "uuid" }, description: "Filtra execu\xE7\xF5es que contenham fatia deste fornecedor" }
+        ],
+        responses: { "200": paginatedResponse("#/components/schemas/SplitExecution"), ...COMMON_ERRORS }
+      }
+    },
+    "/split-executions/{id}": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      get: {
+        tags: ["Split de Pagamentos"],
+        summary: "Obter execu\xE7\xE3o de split (com fatias)",
+        operationId: "getSplitExecution",
+        security: [{ ApiKeyAuth: ["split:list"] }],
+        responses: { "200": { description: "Execu\xE7\xE3o", content: { "application/json": { schema: { $ref: "#/components/schemas/SplitExecution" } } } }, "404": errorResponse("Execu\xE7\xE3o n\xE3o encontrada"), ...COMMON_ERRORS }
+      }
+    },
+    "/split-executions/{id}/reverse": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      post: {
+        tags: ["Split de Pagamentos"],
+        summary: "Estornar execu\xE7\xE3o de split",
+        operationId: "reverseSplitExecution",
+        description: "Marca a execu\xE7\xE3o e suas fatias como 'reversed'. Para cada fatia de fornecedor j\xE1 paga, registra um ajuste de recupera\xE7\xE3o (o fornecedor deve devolver o valor).",
+        security: [{ ApiKeyAuth: ["split:update"] }],
+        responses: { "200": { description: "Estornada", content: { "application/json": { schema: { type: "object", properties: { execution_id: { type: "string" }, status: { type: "string" }, adjustments_created: { type: "integer" }, recover_amount_cents: { type: "integer" } } } } } }, "404": errorResponse("Execu\xE7\xE3o n\xE3o encontrada"), "409": errorResponse("J\xE1 estornada"), ...COMMON_ERRORS }
+      }
+    },
+    "/split-items/{id}/release": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      post: {
+        tags: ["Split de Pagamentos"],
+        summary: "Liberar fatia manualmente",
+        operationId: "releaseSplitItem",
+        description: "Libera uma fatia (pending/awaiting_nota/failed \u2192 released), apta a virar payout.",
+        security: [{ ApiKeyAuth: ["split:update"] }],
+        responses: { "200": { description: "Liberada", content: { "application/json": { schema: { type: "object", properties: { id: { type: "string" }, status: { type: "string" } } } } } }, "404": errorResponse("Fatia n\xE3o encontrada"), ...COMMON_ERRORS }
+      }
+    },
+    // -----------------------------------------------------------------------
     // Formas de pagamento do fornecedor
     // -----------------------------------------------------------------------
     "/suppliers/{id}/payment-methods": {
@@ -2310,7 +3008,7 @@ var OPENAPI_SPEC = {
           ...PAGINATION_PARAMS,
           { name: "active", in: "query", schema: { type: "string", enum: ["true", "false"] } },
           { name: "provider", in: "query", schema: { type: "string", enum: ["inter", "c6bank"] } },
-          { name: "channel", in: "query", schema: { type: "string", enum: ["pix", "boleto", "checkout"] } }
+          { name: "channel", in: "query", schema: { type: "string", enum: ["pix", "boleto", "checkout", "credit_card"] } }
         ],
         responses: { "200": paginatedResponse("#/components/schemas/PaymentMethod"), ...COMMON_ERRORS }
       }
@@ -2360,7 +3058,8 @@ var API_MODULES = [
     permissions: [
       { key: "read", label: "Listar e visualizar", description: "Consultar faturas e cobran\xE7as" },
       { key: "create", label: "Criar cobran\xE7a", description: "Gerar boletos, Pix e cobran\xE7as" },
-      { key: "cancel", label: "Cancelar cobran\xE7a", description: "Cancelar cobran\xE7as em aberto" }
+      { key: "cancel", label: "Cancelar cobran\xE7a", description: "Cancelar cobran\xE7as em aberto" },
+      { key: "delete", label: "Excluir fatura", description: "Excluir faturas permanentemente (itens e cobran\xE7as vinculadas)" }
     ]
   },
   {
@@ -2458,6 +3157,33 @@ var API_MODULES = [
       { key: "create", label: "Pagar / agendar", description: "Executar ou agendar pagamentos Pix e boleto a fornecedores" },
       { key: "cancel", label: "Cancelar agendamento", description: "Cancelar pagamentos agendados" }
     ]
+  },
+  {
+    key: "split",
+    label: "Split de Pagamentos",
+    permissions: [
+      { key: "list", label: "Listar e visualizar", description: "Consultar regras, execu\xE7\xF5es e repasses de split" },
+      { key: "create", label: "Criar regra", description: "Criar regras de divis\xE3o de recebimentos" },
+      { key: "update", label: "Atualizar / liberar", description: "Editar regras, liberar fatias e estornar repasses" },
+      { key: "delete", label: "Excluir regra", description: "Remover regras de split" }
+    ]
+  },
+  {
+    key: "audit",
+    label: "Auditoria",
+    permissions: [
+      { key: "read", label: "Consultar hist\xF3rico", description: "Consultar a timeline de altera\xE7\xF5es de uma entidade (audit_logs)" }
+    ]
+  },
+  {
+    key: "reminders",
+    label: "Lembretes",
+    permissions: [
+      { key: "list", label: "Listar e visualizar", description: "Consultar lembretes e resumos agendados" },
+      { key: "create", label: "Criar", description: "Criar lembretes e resumos recorrentes da empresa" },
+      { key: "update", label: "Atualizar / pausar", description: "Editar, ativar e pausar lembretes" },
+      { key: "delete", label: "Excluir", description: "Excluir lembretes" }
+    ]
   }
 ];
 var ALL_SCOPES = API_MODULES.flatMap(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comando.one/mcp-server",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Servidor MCP (Model Context Protocol) para a API pública do Comando.One — opere seu ERP por linguagem natural.",
   "type": "module",
   "license": "MIT",