# Gestão económica

Orçamento, acordos, cobranças, pagamentos e despesas do projeto, com cada pessoa a ver só o que a sua função abre.

Fonte: https://ardumaker.com/pt/docs/gestion-economica/

- Categoria: Projetos e empresas
- Estado: Disponível
- Requisitos: Que o manager ative a seção de finanças do projeto; Permissões em `finanzas` ou `finanzas_balance` segundo a função
- Ferramentas MCP: Sem ferramentas MCP: usa-se a partir do painel.

## O que permite fazer?

- Definir o total acordado do projeto e, se se quiser, o seu desdobramento por conceito.
- Registar o **acordo** com cada pessoa da equipe, associado opcionalmente a uma etapa ou tarefa (pagamento por entrega).
- Anotar movimentos: `cobro` ao cliente, `pago` a alguém da equipe ou `gasto` do projeto.
- Enviar comprovativos e faturas por movimento.

## Quando convém usar?

- Para que o cliente veja o total e os seus próprios pagamentos, sem ver o que recebe cada colaborador.
- Para que cada colaborador veja só o seu acordo e o que lhe foi pago.

## Como funciona na ArduMaker?

| Seção | O que abre |
| --- | --- |
| `finanzas` | O próprio: o meu acordo, os meus movimentos, enviar o meu comprovativo, transferir a minha fatura |
| `finanzas_balance` | O total: custo, desdobramento e o de todos |

- O recorte faz-se no servidor: quem não tem o balanço recebe o total, o desdobramento e o balanço vazios, e só os seus acordos e movimentos.
- O balanço agrupa-se por moeda e não se converte; a moeda guarda-se por linha, como código de três letras.
- Os montantes guardam-se como decimais exatos.
- Comprovativos e faturas transferem-se por uma rota autenticada que volta a verificar de quem é o movimento.

## O que muda realmente?

- Desligar a seção não apaga nada: acordos e movimentos voltam a aparecer ao ligá-la.
- Um acordo com pagamentos não se apaga: cancela-se.
- Um acordo não se apaga quando a pessoa sai do projeto.

## Resultado esperado

Quem tem o balanço vê, por moeda, o cobrado, o pago e o saldo. Os outros veem o seu resumo: acordado, cobrado e pendente.

## Erros e resolução

| Mensagem | Causa |
| --- | --- |
| `This project does not use the finances section` | A seção está desligada (responde 404). |
| `Only the project manager can enable the finances section` | Só o manager a liga ou desliga. |
| `This agreement already has payments against it: cancel it instead of deleting` | Tentou-se apagar um acordo com pagamentos. |
| `MCP agents can never access a project's finances, not even to read them` | A chamada veio de um agente MCP. |

> **PRECAUCION:** Ao ativar a seção, reveja em Funções que nível tem cada função nas duas seções de finanças: uma função com `ver` para seções futuras vê o balanço.

## Relação com MCP

Não há acesso MCP, nem sequer de leitura. Mesmo que o dono do agente seja o manager, toda a chamada de um agente às finanças é rejeitada com tipo `agente_prohibido`.

Referência completa de cada ferramenta: [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Funções e permissões](https://ardumaker.com/pt/docs/roles-y-permisos/)
- [Etapas](https://ardumaker.com/pt/docs/etapas/)
- [Tarefas](https://ardumaker.com/pt/docs/tareas/)
- [Empresas](https://ardumaker.com/pt/docs/empresas/)