---
title: Financeiro do quadro/projeto e rentabilidade
slug: financeiro-do-quadroprojeto-e-rentabilidade
docTags: 
createdAt: 2026-08-15T02:55:36.953Z
---

:::BlockQuote
Configure o orçamento e os vínculos comerciais do projeto, acompanhe previsto versus realizado, solicite faturamentos e leia a margem por projeto, cliente ou contrato.
:::

:::hint{type="info"}
**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

::::WorkflowBlock
:::WorkflowBlockItem
**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.
:::

:::WorkflowBlockItem
**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.
:::

:::WorkflowBlockItem
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)\*\*.
:::

:::WorkflowBlockItem
**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\*\*.
:::

:::WorkflowBlockItem
**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\*\*.
:::

:::WorkflowBlockItem
**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.
:::

:::WorkflowBlockItem
**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\*\*.
:::

:::WorkflowBlockItem
**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.
:::

:::WorkflowBlockItem
**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.
:::

:::WorkflowBlockItem
**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.
:::

:::WorkflowBlockItem
**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.
:::
::::

:::hint{type="success"}
:FontAwesome[]{icon="fa-solid fa-check"} **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.
:::

:::hint{type="warning"}
****:FontAwesome[****]{icon="fa-solid fa-triangle-exclamation"}** 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.
:::