# Gestión económica

Presupuesto, acuerdos, cobros, pagos y gastos del proyecto, con cada persona viendo solo lo que su rol le abre.

Fuente: https://ardumaker.com/docs/gestion-economica/

- Categoría: Proyectos y empresas
- Estado: Disponible
- Requisitos: Que el manager active la sección de finanzas del proyecto; Permisos en `finanzas` o `finanzas_balance` según el rol
- Herramientas MCP: Sin herramientas MCP: se usa desde el panel.

## ¿Qué permite hacer?

- Fijar el total acordado del proyecto y, si se quiere, su desglose por concepto.
- Registrar el **acuerdo** con cada persona del equipo, atado opcionalmente a una etapa o tarea (pago por entregable).
- Anotar movimientos: `cobro` al cliente, `pago` a alguien del equipo o `gasto` del proyecto.
- Subir comprobantes y facturas por movimiento.

## ¿Cuándo conviene usarlo?

- Para que el cliente vea el total y sus propios pagos, sin ver lo que cobra cada colaborador.
- Para que cada colaborador vea solo su trato y lo que se le pagó.

## ¿Cómo funciona en ArduMaker?

| Sección | Qué abre |
| --- | --- |
| `finanzas` | Lo propio: mi trato, mis movimientos, subir mi comprobante, bajar mi factura |
| `finanzas_balance` | El total: costo, desglose y lo de todos |

- El recorte se hace en el servidor: quien no tiene el balance recibe el total, el desglose y el balance vacíos, y solo sus acuerdos y movimientos.
- El balance se agrupa por moneda y no se convierte; la moneda se guarda por fila, como código de tres letras.
- Los importes se guardan como decimales exactos.
- Comprobantes y facturas se bajan por una ruta autenticada que vuelve a comprobar de quién es el movimiento.

## ¿Qué cambia realmente?

- Apagar la sección no borra nada: acuerdos y movimientos vuelven a aparecer al prenderla.
- Un acuerdo con pagos no se borra: se cancela.
- Un acuerdo no se borra cuando la persona sale del proyecto.

## Resultado esperado

Quien tiene el balance ve, por moneda, lo cobrado, lo pagado y el saldo. Los demás ven su resumen: acordado, cobrado y pendiente.

## Errores y resolución

| Mensaje | Causa |
| --- | --- |
| `This project does not use the finances section` | La sección está apagada (responde 404). |
| `Only the project manager can enable the finances section` | Solo el manager la prende o apaga. |
| `This agreement already has payments against it: cancel it instead of deleting` | Se intentó borrar un acuerdo con pagos. |
| `MCP agents can never access a project's finances, not even to read them` | La llamada vino de un agente MCP. |

> **PRECAUCION:** Al activar la sección, conviene revisar en Roles qué nivel tiene cada rol en las dos secciones de finanzas: un rol con `ver` para secciones futuras ve el balance.

## Relación con MCP

No hay acceso MCP, ni siquiera de lectura. Aunque el dueño del agente sea el manager, toda llamada de un agente a las finanzas se rechaza con tipo `agente_prohibido`.

Referencia completa de cada herramienta: [/mcp/docs](https://ardumaker.com/mcp/docs).

## Funciones relacionadas

- [Roles y permisos](https://ardumaker.com/docs/roles-y-permisos/)
- [Etapas](https://ardumaker.com/docs/etapas/)
- [Tareas](https://ardumaker.com/docs/tareas/)
- [Empresas](https://ardumaker.com/docs/empresas/)
