---
title: Lançamentos: receitas, despesas e apontamento de horas
slug: lancamentos-receitas-despesas-e-apontamento-de-horas
docTags: 
createdAt: 2026-08-15T02:50:23.470Z
---

:::BlockQuote
Registre fatos financeiros diretamente no projeto ou quadro e aproprie horas pelo custo vigente da pessoa ou do papel.
:::

:::hint{type="info"}
**Pré-requisito: **

Cadastre ao menos um custo-hora em Financeiro → Cadastros para apontar horas. Para associar o projeto a uma dimensão de rentabilidade, configure cliente e contrato na tela financeira do projeto.
:::

***

O lançamento é criado no Financeiro do projeto, pela aba Financeiro do projeto ou pelo caminho do Board. A mesma superfície mostra a tabela de apropriações, os KPIs de receita, custo e margem e os botões \*\*Novo lançamento\*\* e \*\*Apontar horas\*\*. Um lançamento próprio do Agility pode ser editado ou excluído; um fato com origem externa é somente leitura.

A caixa \*\*Novo lançamento\*\* registra quatro tipos: \*\*Despesa\*\*, \*\*Receita\*\*, \*\*Compra\*\* e \*\*Faturamento\*\*. Compra é o fluxo destinado a um fornecedor e pode receber centro de custo do ERP; o apontamento de horas é uma apropriação separada, porque o servidor deriva seu valor de horas × taxa vigente, em vez de aceitar um valor digitado.

***

### Passo a passo

::::WorkflowBlock
:::WorkflowBlockItem
**Abrir o financeiro do projeto**

Abra um projeto com a capability de Financeiro. Se ele tiver Board principal, selecione a aba \*\*Financeiro\*\* do Board; se for um projeto Tradicional sem Board, a mesma tela é exibida no escopo canônico do Projeto. Aguarde a tabela de lançamentos e os cartões de receita, custo, margem e margem %. Um projeto sintético não aceita lançamentos diretos: seus fatos devem ser criados nos projetos analíticos.
:::

:::WorkflowBlockItem
**Registrar uma receita**

Clique em \*\*Novo lançamento\*\* e selecione o tipo \*\*Receita\*\*. Em \*\*Descrição\*\*, informe o fato que entrou no projeto (por exemplo, uma entrega reconhecida). Digite o \*\*Valor (R$)\*\* com até duas casas decimais e informe a \*\*Competência\*\*. O campo de fornecedor não aparece para receita; o centro de custo só aparece se o ERP fornecer centros ativos que aceitem lançamentos.
:::

:::WorkflowBlockItem
Clique em \*\*Lançar\*\*. A nova linha aparece com data, selo \*\*Receita\*\*, descrição, valor positivo, origem e, se selecionado, o centro de custo. A receita alimenta o total de receita reconhecida e a margem; a solicitação de faturamento, descrita na seção de rentabilidade, é um processo separado e não deve ser confundida com o reconhecimento da receita.
:::

:::WorkflowBlockItem
**Registrar uma despesa**
Abra novamente \*\*Novo lançamento\*\*, escolha \*\*Despesa\*\*, informe descrição, valor e competência e, se fizer sentido, escolha um centro de custo ativo no seletor \*\*Centro de custo (ERP)\*\*. O centro de custo é uma dimensão do ERP e o rótulo do momento do lançamento fica congelado no histórico, mesmo que o ERP renomeie o centro mais tarde. Clique em \*\*Lançar\*\*; a tabela mostra a despesa como saída, com o prefixo de valor negativo.
:::

:::WorkflowBlockItem
**Registrar uma compra com fornecedor**
Em \*\*Novo lançamento\*\*, marque \*\*Compra\*\*. Preencha descrição, valor e competência; essa combinação é obrigatória como nos demais tipos. O diálogo revela \*\*Fornecedor (origem ERP demo)\*\*: informe o nome ou referência do fornecedor da compra. Opcionalmente selecione o centro de custo e clique em \*\*Lançar\*\*. A linha passa a mostrar, abaixo da descrição, o fornecedor e o selo \*\*Compra\*\*.
:::

:::WorkflowBlockItem
**Editar ou remover um lançamento próprio**
Na tabela, ações aparecem apenas para fatos com origem \*\*Agility\*\*. Use o lápis para \*\*Editar lançamento\*\* e corrija descrição, valor e competência; em uma compra, o fornecedor também pode ser corrigido. O tipo e a origem não mudam. Se a linha tiver quantidade × preço derivado, o valor fica desabilitado para evitar uma combinação inconsistente. Use a lixeira para excluir e atualize a tabela; fatos externos não podem ser removidos no Agility.
:::

:::WorkflowBlockItem
**Abrir o apontamento de horas**
Clique em \*\*Apontar horas\*\*. O formulário lista em \*\*Pessoa / papel\*\* todas as taxas carregadas do Workspace, exibindo o sujeito, sua dimensão (Pessoa ou Papel) e o valor da hora. Se a lista estiver vazia, o botão fica bloqueado e a tela informa para cadastrar um custo-hora em Financeiro; não há valor manual que substitua essa taxa.
:::

:::WorkflowBlockItem
**Informar horas e competência**

Selecione a pessoa ou o papel, preencha \*\*Horas\*\* em incrementos de 0,5 e informe a \*\*Competência\*\*. A competência é importante: o servidor procura a taxa vigente naquela data, e não necessariamente a taxa criada mais recentemente. Clique em \*\*Apontar horas\*\*. A tabela receberá uma apropriação do tipo hora de serviço e o custo será calculado pela taxa encontrada.
:::

:::WorkflowBlockItem
O cálculo do apontamento é \`horas × custo-hora vigente\`. Por exemplo, 8 horas com uma taxa de R$ 150,00 geram R$ 1.200,00 de custo; o usuário não digita os R$ 1.200,00. A taxa é escolhida por \`subjectKind\` (person ou role), \`subjectRef\` e competência. Ao editar um apontamento, escolha novamente a pessoa/papel e a quantidade de horas; o servidor reprecifica o custo pela taxa vigente na competência informada.
:::

:::WorkflowBlockItem
**Conferir a apropriação**

Na tabela de lançamentos, confira data, selo do tipo, descrição, valor e origem. O total de custo e a margem dos cartões devem refletir a nova saída. Abaixo da lista, \*\*Rentabilidade\*\* decompõe os fatos por tipo e natureza (entrada, saída ou faturado), permitindo conferir separadamente receita, despesa, compra, faturamento e horas.
:::
::::

:::hint{type="success"}
:FontAwesome[]{icon="fa-solid fa-check"} **Verificação**

- Receitas e despesas aparecem na tabela com seus selos, competência, descrição, direção e valor atualizados.
- Uma compra mostra o fornecedor abaixo da descrição e é contabilizada como saída.
- O apontamento aparece como hora de serviço e seu valor corresponde às horas multiplicadas pela taxa vigente na competência.
- Os cartões Receita, Custo, Margem e Margem % são recalculados após salvar o lançamento ou apontamento.
- O lápis e a lixeira aparecem para fatos próprios do Agility, enquanto fatos de origem externa não oferecem essas ações.
:::

:::hint{type="warning"}
****:FontAwesome[****]{icon="fa-solid fa-triangle-exclamation"}** Erros comuns**

**Nenhum custo-hora vigente para a data**

O apontamento é recusado quando não existe taxa vigente para a competência escolhida. Cadastre uma taxa em Custos-hora com data de início adequada ou escolha uma competência coberta por uma taxa existente.

**Apontamento sem pessoa ou papel**

O formulário exige selecionar um sujeito listado no campo Pessoa / papel. Se não houver opções, cadastre a taxa; se a opção correta não aparecer, verifique se o cadastro está vigente e se o identificador foi digitado conforme a taxa.

**Fato de origem externa imutável**

Quando a origem exibida é externa, o Agility não mostra editar ou excluir. Corrija a informação no sistema de origem; essa regra preserva o fato que veio do ERP ou de outro adaptador.

**Projeto sintético sem execução**

Projetos sintéticos apenas consolidam projetos analíticos e exibem a mensagem de que não recebem lançamentos diretos. Abra o projeto analítico que executou o trabalho e lance a despesa, receita, compra ou hora lá.

**Campos obrigatórios ou valor inválido**

Descrição, valor, competência e, no apontamento, sujeito e horas, são obrigatórios. Confira se o valor é não negativo, se as horas respeitam o passo de 0,5 e se a data está preenchida antes de tentar salvar novamente.
:::