next-finance-mcp 0.5.2 → 0.5.4

package/dist/client.d.ts

@@ -44,6 +44,36 @@ export declare function listarPlanoDeContas(filtro?: FiltroPlanoDeContas): Promi
 export declare function listarCentrosDeCusto(busca?: string): Promise<{
     centros: Record<string, unknown>[];
 }>;
+export interface FiltroComprasProduto {
+    pessoaId?: string;
+    dataInicio?: string;
+    dataFim?: string;
+    busca?: string;
+    pagina?: number;
+    limite?: number;
+}
+export declare function buscarComprasProduto(opts?: FiltroComprasProduto): Promise<{
+    compras: {
+        codigo: string;
+        produto: string;
+        fornecedor: string;
+        fornecedor_id: string;
+        moeda: string;
+        valor: number;
+        data: string;
+    }[];
+    paginacao: {
+        pagina: number;
+        limite: number;
+        total: number;
+        paginas: number;
+        tem_mais: boolean;
+    };
+    periodo: {
+        inicio: string;
+        fim: string;
+    };
+}>;
 export declare function listarTiposConta(): Promise<{
     tipos: Record<string, unknown>[];
 }>;

package/dist/client.js

@@ -305,7 +305,58 @@ export async function listarCentrosDeCusto(busca) {
     }
     return { centros: centros };
 }
-// ── Tipos de Conta ────────────────────────────────────────────────────────────
+export async function buscarComprasProduto(opts = {}) {
+    const today = new Date();
+    const dataInicio = opts.dataInicio ?? `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, "0")}-01`;
+    const dataFim = opts.dataFim ?? today.toISOString().slice(0, 10);
+    const pagina = Math.max(1, opts.pagina ?? 1);
+    const limite = Math.min(200, Math.max(1, opts.limite ?? 50));
+    const body = {
+        DataInicial: dataInicio,
+        DataFinal: dataFim,
+    };
+    if (opts.pessoaId)
+        body["PessoaId"] = opts.pessoaId;
+    const raw = await apiPost("/api/ProdutoBusiness/FiltrarCompra", body);
+    let items = (Array.isArray(raw) ? raw : []);
+    // Filtro client-side por nome do produto
+    if (opts.busca?.trim()) {
+        const t = opts.busca.trim().toLowerCase();
+        items = items.filter(item => {
+            const prod = item["ProdutoBusiness"];
+            const nome = String(prod?.["Nome"] ?? item["Codigo"] ?? "").toLowerCase();
+            return nome.includes(t);
+        });
+    }
+    // Paginação client-side
+    const total = items.length;
+    const offset = (pagina - 1) * limite;
+    const paginados = items.slice(offset, offset + limite);
+    // Slim: campos essenciais
+    const compras = paginados.map(item => {
+        const prod = item["ProdutoBusiness"];
+        return {
+            codigo: String(item["Codigo"] ?? ""),
+            produto: String(prod?.["Nome"] ?? ""),
+            fornecedor: String(item["PessoaNome"] ?? ""),
+            fornecedor_id: String(item["PessoaId"] ?? ""),
+            moeda: String(item["MoedaNome"] ?? "BRL"),
+            valor: Number(item["Valor"] ?? 0),
+            data: String(item["DataAtualizacao"] ?? "").slice(0, 10),
+        };
+    });
+    return {
+        compras,
+        paginacao: {
+            pagina,
+            limite,
+            total,
+            paginas: Math.ceil(total / limite),
+            tem_mais: offset + limite < total,
+        },
+        periodo: { inicio: dataInicio, fim: dataFim },
+    };
+}
 export async function listarTiposConta() {
     const raw = await apiGet("/api/TipoConta");
     const tipos = Array.isArray(raw) ? raw : Object.values(raw).find(v => Array.isArray(v)) ?? [];
@@ -364,6 +415,18 @@ export async function buscarLancamentos(opts) {
         lancamentos = Array.isArray(raw) ? raw
             : (Object.values(raw).find(v => Array.isArray(v)) ?? []);
     }
+    // Helpers para verificar plano/centro tanto no lançamento raiz quanto nas divisões
+    // (lançamentos rateados têm NomePlanoDeContas vazio no raiz e preenchido em ListaLancamentoDivisao)
+    function nomesPlano(l) {
+        const raiz = String(l["NomePlanoDeContas"] ?? "");
+        const divs = l["ListaLancamentoDivisao"] ?? [];
+        return [raiz, ...divs.map(d => String(d["NomePlanoDeContas"] ?? ""))].filter(Boolean);
+    }
+    function nomesCentro(l) {
+        const raiz = String(l["NomeCentroDeCustos"] ?? "");
+        const divs = l["ListaLancamentoDivisao"] ?? [];
+        return [raiz, ...divs.map(d => String(d["NomeCentroDeCustos"] ?? ""))].filter(Boolean);
+    }
     // Filtros client-side (a API não filtra por plano/centro/tipo)
     const excluirTransf = opts.excluirTransferencias !== false; // default: true
     if (excluirTransf)
@@ -376,11 +439,12 @@ export async function buscarLancamentos(opts) {
         lancamentos = lancamentos.filter(l => l["Receita"]);
     if (opts.planoDeContas?.trim()) {
         const t = opts.planoDeContas.trim().toLowerCase();
-        lancamentos = lancamentos.filter(l => String(l["NomePlanoDeContas"] ?? "").toLowerCase().includes(t));
+        // inclui lançamento se plano bate no raiz OU em qualquer divisão
+        lancamentos = lancamentos.filter(l => nomesPlano(l).some(n => n.toLowerCase().includes(t)));
     }
     if (opts.centroDeCusto?.trim()) {
         const t = opts.centroDeCusto.trim().toLowerCase();
-        lancamentos = lancamentos.filter(l => String(l["NomeCentroDeCustos"] ?? "").toLowerCase().includes(t));
+        lancamentos = lancamentos.filter(l => nomesCentro(l).some(n => n.toLowerCase().includes(t)));
     }
     if (opts.busca?.trim()) {
         const t = opts.busca.trim().toLowerCase();

package/dist/index.js

@@ -109,6 +109,24 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 },
             },
         },
+        {
+            name: "buscar_compras_produto",
+            description: "Busca compras de produtos agrupadas por produto e fornecedor. " +
+                "Use 'busca' para filtrar pelo nome do produto (ex: 'bombom garoto', 'arroz'). " +
+                "Use 'pessoa_id' para filtrar por fornecedor específico. " +
+                "Ideal para ver histórico de compras, comparar preços e rastrear aquisições.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    busca: { type: "string", description: "Filtra pelo nome do produto (ex: 'bombom garoto', 'leite')" },
+                    pessoa_id: { type: "string", description: "ID do fornecedor (opcional)" },
+                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 1º do mês atual)" },
+                    data_fim: { type: "string", description: "Data fim YYYY-MM-DD (padrão: hoje)" },
+                    pagina: { type: "number", description: "Página (começa em 1, padrão: 1)" },
+                    limite: { type: "number", description: "Itens por página (padrão: 50, máximo: 200)" },
+                },
+            },
+        },
     ],
 }));
 // ── Helpers ──────────────────────────────────────────────────────────────────
@@ -222,6 +240,22 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
                     limite: args["limite"],
                 }));
             }
+            case "buscar_compras_produto": {
+                const authErr = requireAuth();
+                if (authErr)
+                    return authErr;
+                const walErr = requireWallet();
+                if (walErr)
+                    return walErr;
+                return ok(await client.buscarComprasProduto({
+                    pessoaId: args["pessoa_id"],
+                    dataInicio: args["data_inicio"],
+                    dataFim: args["data_fim"],
+                    busca: args["busca"],
+                    pagina: args["pagina"],
+                    limite: args["limite"],
+                }));
+            }
             default:
                 return ok({ erro: `Ferramenta desconhecida: ${name}` });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-finance-mcp",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "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",