Lançamentos: receitas, despesas e apontamento de horas
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
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.
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.
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.
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.
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**.
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.
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.
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.
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.
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.
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.
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.