Financeiro do quadro/projeto e rentabilidade
Pré-requisito:
Tenha um projeto com a capability Financeiro e, se for associar dimensão comercial, um cliente e contrato cadastrados no Workspace.
O financeiro do quadro/projeto é a superfície operacional do trabalho: reúne configuração, custo previsto, custo realizado, lançamentos, produtos e serviços contratados, ordens de serviço, SLAs, solicitações de faturamento e a rentabilidade por tipo. Um Board principal abre essa superfície pela rota do Board; um projeto Tradicional sem Board usa a mesma superfície no escopo do Projeto.
A rentabilidade é calculada sobre os mesmos fatos do projeto. Nos cartões superiores, **Receita** mostra o reconhecido e o faturado, **Custo** soma as saídas apropriadas, **Margem** é receita menos custo e **Margem %** é a margem em relação à receita reconhecida. No Financeiro do Workspace, a aba **Rentabilidade** consolida e compara os resultados por **projeto**, **cliente** ou **contrato**; a linha de projeto é um link para seu financeiro detalhado.
Passo a passo
Abrir o financeiro do quadro ou projeto
No projeto, selecione **Financeiro**. Projetos com Board principal são encaminhados ao Financeiro do Board; a rota recebe `workspaceId`, `projectId` e `boardId`. Projetos Tradicionais sem Board renderizam diretamente o Financeiro do Projeto. A superfície mostra no cabeçalho o cliente e o código do contrato quando esses vínculos já estiverem configurados.
Configurar o custo previsto e os vínculos
Clique em **Configurar**. Em **Custo previsto (R$)** informe o orçamento de custo operacional do projeto. Selecione opcionalmente um **Cliente** e um **Contrato**; ambos vêm dos cadastros do Workspace e o contrato pode ser deixado sem vínculo. Os vínculos alimentam a dimensão usada na rentabilidade por cliente e por contrato e também filtram opções de faturamento e ordens de serviço.
A mesma caixa permite informar uma **Verba corporativa (ref.)** e um **Projeto do ERP (dimensão de orçamento)**. A referência é textual, por exemplo `VERBA-TI-2026`; quando o projeto do ERP está vinculado, a disponibilidade da verba passa a ser fato confirmado pelo ERP. Não digite um saldo de verba no Agility. Salve e confira os cartões **Custo previsto**, **Custo realizado** e **Desvio (realizado − previsto)**.
Interpretar previsto versus realizado
O cartão **Custo previsto** vem da configuração. **Custo realizado** é formado pelas despesas, compras e apropriações de horas salvas no projeto; receitas e faturamentos não são custo. O **Desvio** é realizado menos previsto: valor positivo indica estouro. Quando a regra de alerta for atingida, a tela exibe um aviso com limiar, causa e período; quando não houver alerta, exibe **dentro do previsto**.
Vincular o que foi contratado
No card **Produtos e serviços**, clique em **Vincular item**. Escolha um item ativo do catálogo, informe a quantidade, revise o **Preço acordado (R$)** — que pode ser diferente do preço de referência atual — e, se necessário, acrescente uma observação. Salve o vínculo. O card mostra quantidade de itens, total contratado e uma tabela com item, unidade, quantidade e preço acordado. Para alterar, use **Ajustar**; para retirar, use **Desvincular**.
Usar contratos e ordens de serviço
No card **Ordens de serviço**, clique em **Nova OS** para abrir uma ordem vinculada ao projeto e a um contrato ativo. Informe código e título. Em um Board, uma OS aberta no nível do contrato e ainda sem projeto também pode ser adotada com **Vincular OS**; em projeto sem Board não existe essa adoção. O status da OS (Aberta, Em andamento, Concluída ou Cancelada) aparece na tabela.
Solicitar um faturamento
Clique em **Solicitar faturamento** no topo da superfície. Informe o **Valor (R$)**, que vem sugerido pela receita acumulada, e escolha opcionalmente um **Contrato**. Clique em **Solicitar**. A operação usa uma chave idempotente formada pelo escopo e pelo valor para evitar duplicar a mesma solicitação; a nova linha aparece no card **Faturamento**.
Acompanhar o ciclo da solicitação
No card **Faturamento**, acompanhe os estados **Rascunho**, **Solicitado**, **Processando**, **Emitido** ou **Rejeitado**. As ações disponíveis avançam ou rejeitam somente as transições permitidas; use **Processar** ou **Emitir** conforme o estado atual. Se o ERP ou a integração mudar o estado, não force uma transição pela tela: leia a situação retornada e siga o fluxo aceito.
Ler a rentabilidade do projeto
No topo, compare Receita, Custo, Margem e Margem %. Abaixo, o card **Rentabilidade entre projetos** do detalhe exibe a decomposição dos lançamentos por tipo e natureza. Receita reconhecida é a base do percentual; sem receita reconhecida, Margem % aparece como `—` e a tela informa que não há receita reconhecida para calcular o percentual.
Consolidar por projeto, cliente ou contrato
Volte ao menu **Financeiro** do Workspace e permaneça na aba **Rentabilidade**. Em **Rentabilidade por projeto**, selecione **Por projeto**, **Por cliente** ou **Por contrato**. Cada tabela traz Receita, Custo, Margem e Margem %. Na visão por projeto, clique no nome para abrir o Financeiro daquele projeto; as visões por cliente e contrato permitem comparar a carteira sem alterar os fatos.
Conferir fontes e limitações
Na tabela de lançamentos, a coluna **Origem** identifica se o fato é do Agility ou externo; os fatos externos são somente leitura. Produtos contratados, OS e SLAs têm cards próprios, mas não substituem o lançamento financeiro. Se o projeto for sintético, apenas a consolidação é exibida e a execução deve ser registrada nos projetos analíticos.
Verificação
- Os cartões exibem custo previsto, custo realizado e desvio, e o desvio muda quando uma despesa, compra ou hora é lançada.
- O cabeçalho do projeto mostra o cliente e o código do contrato configurados, quando houver.
- Produtos ou serviços vinculados exibem quantidade, preço acordado e total contratado, sem alterar retroativamente o preço de referência do catálogo.
- Uma solicitação de faturamento aparece no card Faturamento e percorre apenas transições de estado válidas.
- A visão Rentabilidade do Workspace mostra as três dimensões — projeto, cliente e contrato — com receita, custo, margem e percentual.
- Na visão por projeto, clicar no nome abre o Financeiro detalhado do projeto correspondente.
Erros comuns
Capability Financeiro indisponível
Se o projeto não tiver a capability efetiva de Financeiro, o acesso direto é bloqueado e a tela informa o motivo. Habilite a capability na configuração do projeto ou escolha um projeto que tenha essa capacidade antes de tentar lançar fatos.
Item inativo ou já vinculado
Itens desativados não entram no seletor de vínculo; reative-os em Financeiro → Cadastros. Se o item já estiver vinculado, ajuste quantidade e preço do vínculo existente em vez de criar outra linha.
Contrato inativo para nova OS
A abertura de uma OS exige contrato ativo. Se o contrato estiver inativo ou não houver contrato selecionado, volte aos cadastros, revise a situação e configure um contrato válido para o projeto.
Transição de faturamento inválida
O servidor só aceita a sequência de estados prevista para faturamento. Se a mensagem indicar transição inválida, não repita o mesmo comando: atualize a lista, leia o estado atual e use a ação compatível ou corrija o processo no sistema de origem.
Margem percentual sem receita
Quando não existe receita reconhecida, a coluna Margem % mostra `—`. Isso não significa margem zero; registre ou reconheça a receita adequada antes de interpretar o percentual.
Valores de verba corporativa não confirmados
Sem vínculo ou resposta do ERP, o card de verba não inventa um saldo: informa que a verba não está orçada ou que o saldo não foi confirmado. Confira o Projeto do ERP e a integração; o Agility controla o consumo operacional, mas o saldo é fato do ERP.
Projeto sintético sem lançamentos diretos
A mensagem de projeto sintético é esperada: esse tipo apenas agrupa e consolida. Abra o projeto analítico que contém o Board ou a execução para cadastrar lançamentos, horas e faturamentos.