next-finance-mcp 0.9.21 → 0.9.22

package/dist/client.d.ts

@@ -121,7 +121,10 @@ export declare function buscarComprasProduto(opts?: FiltroComprasProduto): Promi
         fornecedor: string;
         moeda: string;
         valor: number;
+        quantidade: number;
+        valor_total: number;
         data: string;
+        observacao: string;
     }[];
     paginacao: {
         pagina: number;
@@ -200,6 +203,9 @@ export interface ItemDespesaSlim {
     valor: number;
     desconto: number;
     valor_total: number;
+    valor_bruto?: number;
+    valor_total_bruto?: number;
+    desconto_aplicado?: number;
 }
 export interface DespesaSlim {
     data: string;

package/dist/client.js

@@ -851,15 +851,22 @@ export async function buscarComprasProduto(opts = {}) {
     const total = items.length;
     const offset = (pagina - 1) * limite;
     const paginados = items.slice(offset, offset + limite);
-    // Slim: apenas campos legíveis — sem IDs
+    // Slim: apenas campos legíveis — sem IDs.
+    // Nota: o endpoint /api/ProdutoBusiness/FiltrarCompra retorna o produto cadastrado
+    // (agregação por produto). Não traz a Despesa pai, então NÃO há como ratear desconto
+    // a nível de documento aqui. Use ultimo_preco_produto para obter o preço REAL pago
+    // (que cruza com Despesa/FiltrarDespesaServProd e aplica desconto proporcional).
     const compras = paginados.map(item => {
         const prod = item["ProdutoBusiness"];
         return {
-            produto: String(prod?.["Nome"] ?? ""),
+            produto: String(prod?.["Descricao"] ?? prod?.["Nome"] ?? item["Codigo"] ?? ""),
             fornecedor: String(item["PessoaNome"] ?? ""),
             moeda: String(item["MoedaNome"] ?? "BRL"),
-            valor: Number(item["Valor"] ?? 0),
+            valor: Number(item["Valor"] ?? 0), // preço bruto unitário (sem ratear desconto)
+            quantidade: Number(item["Quantidade"] ?? 0),
+            valor_total: Number(item["ValorTotal"] ?? 0),
             data: String(item["DataAtualizacao"] ?? "").slice(0, 10),
+            observacao: "Preço bruto sem desconto da nota. Para preço real pago, use 'ultimo_preco_produto'.",
         };
     });
     return {
@@ -1088,15 +1095,43 @@ async function resolverIdFornecedor(nome) {
     const primeiro = arr[0];
     return String(primeiro["Id"] ?? "");
 }
-function slimItemDespesa(i) {
+/** Calcula valores REAIS (com desconto da nota distribuído) para um item de DespesaServProd.
+ *  Pode receber a Despesa pai inline (do FiltrarDespesaServProd) ou separadamente. */
+function aplicarDescontoProporcional(item, despesa) {
+    const qtd = Number(item["Quantidade"] ?? 0);
+    const valorBruto = Number(item["Valor"] ?? 0);
+    const totalBruto = Number(item["ValorTotal"] ?? (qtd > 0 ? qtd * valorBruto : valorBruto));
+    if (!despesa)
+        return { precoUnitario: valorBruto, valorTotal: totalBruto };
+    const despBruto = Number(despesa["Valor"] ?? 0);
+    const despLiquido = Number(despesa["ValorLiquido"] ?? despBruto);
+    if (despBruto <= 0 || Math.abs(despBruto - despLiquido) < 0.01) {
+        return { precoUnitario: valorBruto, valorTotal: totalBruto };
+    }
+    const fator = despLiquido / despBruto;
+    const totalReal = Math.round(totalBruto * fator * 100) / 100;
+    const precoReal = qtd > 0 ? Math.round((totalReal / qtd) * 100) / 100 : valorBruto * fator;
+    return {
+        precoUnitario: precoReal,
+        valorTotal: totalReal,
+        descontoAplicado: Math.round((totalBruto - totalReal) * 100) / 100,
+        precoUnitarioBruto: valorBruto,
+        valorTotalBruto: totalBruto,
+    };
+}
+function slimItemDespesa(i, despesa) {
+    const calc = aplicarDescontoProporcional(i, despesa);
     return {
         descricao: String(i["DescricaoServProd"] ?? "").trim(),
         codigo: i["Codigo"] ? String(i["Codigo"]).trim() : undefined,
         quantidade: Number(i["Quantidade"] ?? 0),
         unidade: i["UnidadeMedida"] ? String(i["UnidadeMedida"]).trim() : undefined,
-        valor: Number(i["Valor"] ?? 0),
+        valor: calc.precoUnitario,
         desconto: Number(i["Desconto"] ?? 0),
-        valor_total: Number(i["ValorTotal"] ?? 0),
+        valor_total: calc.valorTotal,
+        valor_bruto: calc.precoUnitarioBruto,
+        valor_total_bruto: calc.valorTotalBruto,
+        desconto_aplicado: calc.descontoAplicado,
     };
 }
 function slimDespesa(d, comItens) {
@@ -1110,7 +1145,8 @@ function slimDespesa(d, comItens) {
         valor_liquido: Number(d["ValorLiquido"] ?? 0),
     };
     if (comItens && itensRaw.length > 0) {
-        result.itens = itensRaw.map(slimItemDespesa);
+        // Passa a despesa pai (d) pra distribuir descontos proporcionalmente
+        result.itens = itensRaw.map(i => slimItemDespesa(i, d));
     }
     return result;
 }
@@ -1179,19 +1215,23 @@ export async function buscarItensDespesa(opts = {}) {
     const total = itens.length;
     const inicio = (pagina - 1) * limite;
     const resultado = itens.slice(inicio, inicio + limite).map(i => {
-        const despesa = i["Despesa"] ?? {};
+        const despesa = i["Despesa"] ?? null;
+        const calc = aplicarDescontoProporcional(i, despesa);
         return {
             descricao: String(i["DescricaoServProd"] ?? "").trim(),
             codigo: i["Codigo"] ? String(i["Codigo"]).trim() : undefined,
             quantidade: Number(i["Quantidade"] ?? 0),
             unidade: i["UnidadeMedida"] ? String(i["UnidadeMedida"]).trim() : undefined,
-            valor: Number(i["Valor"] ?? 0),
+            valor: calc.precoUnitario, // REAL pago
             desconto: Number(i["Desconto"] ?? 0),
-            valor_total: Number(i["ValorTotal"] ?? 0),
+            valor_total: calc.valorTotal, // REAL pago
+            valor_bruto: calc.precoUnitarioBruto,
+            valor_total_bruto: calc.valorTotalBruto,
+            desconto_aplicado: calc.descontoAplicado,
             // Dados do documento pai — sem IDs
-            data: String(despesa["Data"] ?? "").slice(0, 10),
-            numero: String(despesa["Numero"] ?? "").trim(),
-            fornecedor: String(despesa["PessoaNome"] ?? "").trim(),
+            data: String(despesa?.["Data"] ?? "").slice(0, 10),
+            numero: String(despesa?.["Numero"] ?? "").trim(),
+            fornecedor: String(despesa?.["PessoaNome"] ?? "").trim(),
         };
     });
     return {
@@ -1541,36 +1581,16 @@ export async function ultimoPrecoProduto(opts) {
         const dataIso = String(it["DataAtualizacao"] ?? "");
         const despesa = it["Despesa"] ?? null;
         const data = dataIso || String(despesa?.["Data"] ?? "");
-        const qtd = Number(it["Quantidade"] ?? 0);
-        const valorBruto = Number(it["Valor"] ?? 0);
-        const totalBruto = Number(it["ValorTotal"] ?? (qtd > 0 ? qtd * valorBruto : valorBruto));
-        // Distribui descontos a nível de despesa proporcionalmente ao valor do item.
-        // Despesa.Valor = total bruto; Despesa.ValorLiquido = líquido pago.
-        // Fator = ValorLiquido / Valor (entre 0 e 1).
-        let precoUnitarioReal = valorBruto;
-        let totalReal = totalBruto;
-        let descontoAplicado;
-        let precoBrutoOut;
-        if (despesa) {
-            const despBruto = Number(despesa["Valor"] ?? 0);
-            const despLiquido = Number(despesa["ValorLiquido"] ?? despBruto);
-            if (despBruto > 0 && Math.abs(despBruto - despLiquido) > 0.01) {
-                const fator = despLiquido / despBruto;
-                totalReal = Math.round(totalBruto * fator * 100) / 100;
-                precoUnitarioReal = qtd > 0 ? Math.round((totalReal / qtd) * 100) / 100 : valorBruto * fator;
-                descontoAplicado = Math.round((totalBruto - totalReal) * 100) / 100;
-                precoBrutoOut = valorBruto;
-            }
-        }
+        const calc = aplicarDescontoProporcional(it, despesa);
         return {
             data: data.slice(0, 10),
             produto: nomeProd.trim(),
             fornecedor: String(it["PessoaNome"] ?? despesa?.["PessoaNome"] ?? "").trim(),
-            preco_unitario: precoUnitarioReal,
-            quantidade: qtd,
-            valor_total: totalReal,
-            preco_unitario_bruto: precoBrutoOut,
-            desconto_aplicado: descontoAplicado,
+            preco_unitario: calc.precoUnitario,
+            quantidade: Number(it["Quantidade"] ?? 0),
+            valor_total: calc.valorTotal,
+            preco_unitario_bruto: calc.precoUnitarioBruto,
+            desconto_aplicado: calc.descontoAplicado,
             moeda: it["MoedaNome"] ? String(it["MoedaNome"]) : undefined,
         };
     })

package/dist/index.js

@@ -8,7 +8,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import * as client from "./client.js";
 import { openLoginUI } from "./login-server.js";
-const server = new Server({ name: "next-finance-mcp", version: "0.9.21" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "next-finance-mcp", version: "0.9.22" }, { capabilities: { tools: {} } });
 // ── Ferramentas ─────────────────────────────────────────────────────────────
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [

package/package.json

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