next-finance-mcp 0.9.78 → 0.9.80

package/dist/client.d.ts

@@ -1040,18 +1040,19 @@ export declare function calcularReajusteContrato(o: {
     indice?: string;
     meses?: number;
 }): Promise<Record<string, unknown>>;
-/** Aplica o reajuste no contrato (PUT), acrescenta a nota no texto e, por padrão,
- *  gera as parcelas (GerarFaturamento). Retorna o antes/depois. */
+/** Aplica o reajuste no contrato (PUT): muda o Valor e os valores dos serviços e
+ *  acrescenta a nota no texto. NÃO gera faturamento nem mexe na validade — "Criar
+ *  Parcelas" e "Gerar Faturamento" são ações à parte no NEXT. Retorna antes/depois. */
 export declare function reajustarContrato(o: {
     numero?: number | string;
     pessoa?: string;
     indice?: string;
     meses?: number;
     responsavel?: string;
-    gerarParcelas?: boolean;
 }): Promise<Record<string, unknown>>;
-/** Gera (fatura) as parcelas do contrato — GerarFaturamento. */
-export declare function gerarParcelasContrato(o: {
+/** Gera o FATURAMENTO do contrato (emite os documentos das parcelas) — GerarFaturamento.
+ *  Ação SEPARADA do reajuste e do "Criar Parcelas". */
+export declare function gerarFaturamentoContrato(o: {
     numero?: number | string;
     pessoa?: string;
 }): Promise<Record<string, unknown>>;

package/dist/client.js

@@ -4065,8 +4065,9 @@ export async function calcularReajusteContrato(o) {
 }
 // Campos SÓ de resposta (não devem voltar no PUT do contrato).
 const CONTRATO_CAMPOS_RESPOSTA = ["ContaNome", "TipoContratoNome", "PessoaNome", "ReajusteStatus", "PagamentoStatus", "PossuiAnexo"];
-/** Aplica o reajuste no contrato (PUT), acrescenta a nota no texto e, por padrão,
- *  gera as parcelas (GerarFaturamento). Retorna o antes/depois. */
+/** Aplica o reajuste no contrato (PUT): muda o Valor e os valores dos serviços e
+ *  acrescenta a nota no texto. NÃO gera faturamento nem mexe na validade — "Criar
+ *  Parcelas" e "Gerar Faturamento" são ações à parte no NEXT. Retorna antes/depois. */
 export async function reajustarContrato(o) {
     const c = await resolverContratoCompleto(o);
     const indice = normalizarIndice(o.indice) ?? detectarIndiceReajuste(c["InformacaoAdicional"]);
@@ -4079,6 +4080,9 @@ export async function reajustarContrato(o) {
     const body = { ...c };
     for (const k of CONTRATO_CAMPOS_RESPOSTA)
         delete body[k];
+    // CRÍTICO: NÃO reenviar as parcelas — reenviar ContratoLancamento no PUT REGENERA
+    // as parcelas do contrato (corrompe o histórico). O reajuste mexe só em valor/nota.
+    delete body["ContratoLancamento"];
     body["Valor"] = novoValor;
     if (Array.isArray(body["ContratoServico"])) {
         body["ContratoServico"] = body["ContratoServico"].map(s => ({
@@ -4091,30 +4095,22 @@ export async function reajustarContrato(o) {
     const infoAtual = c["InformacaoAdicional"] ? String(c["InformacaoAdicional"]).replace(/\s+$/, "") : "";
     body["InformacaoAdicional"] = infoAtual ? `${infoAtual}\n\n${nota}` : nota;
     await apiPut(`/api/Contrato/${encodeURIComponent(String(c["Id"]))}`, body);
-    // Gera as parcelas no valor novo (padrão true).
-    let parcelasGeradas = false;
-    if (o.gerarParcelas !== false) {
-        try {
-            await apiGet(`/api/Contrato/GerarFaturamento/${encodeURIComponent(String(c["Id"]))}`);
-            parcelasGeradas = true;
-        }
-        catch { /* faturamento pode ser feito depois com gerar_parcelas_contrato */ }
-    }
     return {
         sucesso: true,
         contrato: Number(c["Numero"]),
         pessoa: c["PessoaNome"] ? String(c["PessoaNome"]).trim() : undefined,
         indice, indice_referencia: idx.mesFinalLabel, variacao_percent: arred2(idx.percentual),
         valor_anterior: valorAtual, valor_novo: novoValor,
-        parcelas_geradas: parcelasGeradas,
         nota_adicionada: nota,
+        proximo_passo: "No NEXT, use 'Criar Parcelas' para gerar o novo ciclo (o NEXT soma +12 meses na validade). O reajuste NÃO altera a validade nem emite faturamento.",
     };
 }
-/** Gera (fatura) as parcelas do contrato — GerarFaturamento. */
-export async function gerarParcelasContrato(o) {
+/** Gera o FATURAMENTO do contrato (emite os documentos das parcelas) — GerarFaturamento.
+ *  Ação SEPARADA do reajuste e do "Criar Parcelas". */
+export async function gerarFaturamentoContrato(o) {
     const c = await resolverContratoCompleto(o);
     await apiGet(`/api/Contrato/GerarFaturamento/${encodeURIComponent(String(c["Id"]))}`);
-    return { sucesso: true, contrato: Number(c["Numero"]), mensagem: "Faturamento gerado — as parcelas 'A RECEBER' foram criadas/atualizadas." };
+    return { sucesso: true, contrato: Number(c["Numero"]), mensagem: "Faturamento gerado (documentos emitidos para as parcelas)." };
 }
 /** Monta a ficha completa de um contato a partir do registro slim (precisa do Id). */
 async function detalharContato(p) {

package/dist/http-index.js

@@ -27,7 +27,7 @@ import * as client from "./client.js";
 import { createCtx, runInCtx, enterDefaultCtx } from "./context.js";
 import { toolDefinitions, handleTool, ok, SOFIA_INSTRUCTIONS } from "./tools.js";
 import { TenantStoreEnv } from "./tenant-store.js";
-const VERSION = "0.9.78";
+const VERSION = "0.9.80";
 // Contexto default (fallback do ALS). No HTTP cada request roda em runInCtx().
 enterDefaultCtx();
 // Multi-tenant: NUNCA persistir sessão no disco compartilhado do container.

package/dist/index.js

@@ -13,7 +13,7 @@ import { openLoginUI } from "./login-server.js";
 import { toolDefinitions, handleTool, ok, SOFIA_INSTRUCTIONS } from "./tools.js";
 // Modo stdio: ativa um contexto único global no startup. Multi-tenancy só no modo HTTP.
 enterDefaultCtx();
-const VERSION = "0.9.78";
+const VERSION = "0.9.80";
 const server = new Server({ name: "SofIA", version: VERSION }, {
     capabilities: { tools: {} },
     instructions: SOFIA_INSTRUCTIONS,

package/dist/tools.d.ts

@@ -125,7 +125,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -270,7 +269,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -430,7 +428,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -578,7 +575,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -789,7 +785,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -934,7 +929,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -1085,7 +1079,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -1236,7 +1229,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -1414,7 +1406,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -1577,7 +1568,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -1746,7 +1736,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -1894,7 +1883,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -2046,7 +2034,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -2200,7 +2187,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -2399,7 +2385,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -2559,7 +2544,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -2767,7 +2751,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -2924,7 +2907,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -3090,7 +3072,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -3253,7 +3234,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -3428,7 +3408,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -3663,7 +3642,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -3838,7 +3816,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -3989,7 +3966,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -4137,7 +4113,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -4291,7 +4266,6 @@ export declare const toolDefinitions: ({
             atualizar_endereco?: undefined;
             classe_fornecedor?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -4350,10 +4324,6 @@ export declare const toolDefinitions: ({
                 type: string;
                 description: string;
             };
-            gerar_parcelas: {
-                type: string;
-                description: string;
-            };
             nome_carteira?: undefined;
             busca?: undefined;
             moeda?: undefined;
@@ -4599,7 +4569,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -4744,7 +4713,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -4892,7 +4860,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -5037,7 +5004,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -5199,7 +5165,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             conta_open_finance?: undefined;
             com_itens?: undefined;
             pessoa_id?: undefined;
@@ -5354,7 +5319,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -5505,7 +5469,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -5654,7 +5617,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             com_itens?: undefined;
@@ -5804,7 +5766,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -5969,7 +5930,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
             pessoa_id?: undefined;
@@ -6128,7 +6088,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
             com_itens?: undefined;
@@ -6288,7 +6247,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -6509,7 +6467,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -6638,7 +6595,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -6821,7 +6777,6 @@ export declare const toolDefinitions: ({
             pessoa?: undefined;
             indice?: undefined;
             meses?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -6986,7 +6941,6 @@ export declare const toolDefinitions: ({
             pessoa?: undefined;
             indice?: undefined;
             meses?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -7135,7 +7089,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;
@@ -7281,7 +7234,6 @@ export declare const toolDefinitions: ({
             indice?: undefined;
             meses?: undefined;
             responsavel?: undefined;
-            gerar_parcelas?: undefined;
             nome_fornecedor?: undefined;
             agrupar_por_fornecedor?: undefined;
             conta_open_finance?: undefined;

package/dist/tools.js

@@ -642,9 +642,10 @@ export const toolDefinitions = [
     },
     {
         name: "reajustar_contrato",
-        description: "APLICA o reajuste no contrato (grava): calcula o índice acumulado (IPCA/IGPM, BCB), atualiza o VALOR e os valores dos " +
-            "serviços, acrescenta a nota padrão em 'Informações sobre o contrato' e, por padrão, GERA as parcelas no valor novo. " +
-            "Confirme o valor novo com o usuário antes de chamar. O índice vem do texto do contrato (ou de 'indice').",
+        description: "APLICA o reajuste no contrato (grava): calcula o índice acumulado (IPCA/IGPM, BCB, 12 meses até o último mês fechado), " +
+            "atualiza o VALOR e os valores dos serviços e acrescenta a nota padrão em 'Informações sobre o contrato'. " +
+            "NÃO mexe na validade nem emite faturamento — 'Criar Parcelas' (que soma +12 meses na validade) e 'Gerar Faturamento' são " +
+            "ações à parte no NEXT. Confirme o valor novo com o usuário antes de chamar. O índice vem do texto do contrato (ou de 'indice').",
         inputSchema: {
             type: "object",
             properties: {
@@ -653,14 +654,13 @@ export const toolDefinitions = [
                 indice: { type: "string", description: "'IPCA' ou 'IGPM' — só se não estiver no texto do contrato" },
                 meses: { type: "number", description: "Nº de meses a acumular (default 12)" },
                 responsavel: { type: "string", description: "Nome que assina a nota do reajuste (vira 'P/<nome>')" },
-                gerar_parcelas: { type: "boolean", description: "Gerar as parcelas após o reajuste (default true)" },
             },
             required: ["numero"],
         },
     },
     {
-        name: "gerar_parcelas_contrato",
-        description: "Gera o faturamento do contrato (cria/atualiza as parcelas 'A RECEBER') — NEXT `GerarFaturamento`. Use após criar ou reajustar um contrato.",
+        name: "gerar_faturamento_contrato",
+        description: "Gera o FATURAMENTO do contrato (emite os documentos das parcelas) — NEXT `GerarFaturamento`. Ação SEPARADA do reajuste e do 'Criar Parcelas'. Use só quando o usuário pedir para faturar/emitir.",
         inputSchema: {
             type: "object",
             properties: {
@@ -1719,17 +1719,16 @@ export async function handleTool(name, args, options = {}) {
                 indice: args["indice"],
                 meses: args["meses"],
                 responsavel: args["responsavel"],
-                gerarParcelas: args["gerar_parcelas"],
             }));
         }
-        case "gerar_parcelas_contrato": {
+        case "gerar_faturamento_contrato": {
             const authErr = requireAuth();
             if (authErr)
                 return authErr;
             const walErr = requireWallet();
             if (walErr)
                 return walErr;
-            return ok(await client.gerarParcelasContrato({
+            return ok(await client.gerarFaturamentoContrato({
                 numero: args["numero"],
                 pessoa: args["pessoa"],
             }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-finance-mcp",
-  "version": "0.9.78",
+  "version": "0.9.80",
   "mcpName": "io.github.paivapiovesan/next-finance",
   "description": "MCP Server para o NEXT Finance (finance.net.br) — login via browser, listagem de carteiras, contas e lançamentos",
   "type": "module",