Cadastros financeiros
Pré-requisito:
Tenha acesso a um Workspace. O cadastro é do Workspace e pode ser reutilizado por todos os seus projetos.
A aba **Financeiro → Cadastros** reúne os registros que dão contexto ao financeiro operacional: clientes, contratos, produtos e serviços do catálogo e custos-hora por pessoa ou papel. A ordem dos segmentos acompanha a dependência dos dados: primeiro o cliente, depois o contrato; catálogo e custos-hora são independentes.
Esses cadastros são compartilhados pelos projetos do Workspace. Um contrato pertence a um cliente; o projeto pode associar cliente e contrato na sua configuração financeira, vincular itens do catálogo pelo preço acordado e apropriar horas usando a taxa vigente. O Agility não possui cadastro de banco nem plano de contas contábil: essas entidades não aparecem na rota nem nos componentes de Financeiro. Contas bancárias, conciliação e classificação contábil devem ser tratadas no ERP integrado, quando houver.
Passo a passo
Abrir os cadastros
Entre no Workspace e abra **Financeiro**. Se a página abrir em outra aba, selecione **Cadastros**; a aba é endereçável por `?section=cadastros`. Os quatro segmentos aparecem como abas: **Clientes**, **Contratos**, **Catálogo** e **Custos-hora**, cada um com a quantidade de registros carregados.
Abrir a aba Operacional do Workspace
Além de **Cadastros**, o Financeiro do Workspace tem a aba **Operacional** (`?section=operacional`). Ela reúne as visões que atravessam projetos: **Ordens de serviço**, **SLA**, **Tesouraria / aging** e **Documentos financeiros do ERP**. Use as ordens e o SLA para acompanhar a execução comercial dos contratos; os dois cartões de ERP são leituras de consulta e só aparecem preenchidos quando a integração fornece esses dados. Não confunda essa visão consolidada com o Financeiro de um projeto, que contém os lançamentos e a margem daquele contexto.
Ler Ordens de serviço e SLA
No bloco **Ordens de serviço**, filtre e abra uma OS para conferir contrato, cliente, projeto, datas, situação e valores. O bloco **SLA** mostra meta, resultado e eventual alerta de prazo descumprido; uma OS só pode ser criada para contrato ativo. Quando o ERP estiver sem resposta, a tela mantém o estado de integração e explica que a origem externa não está disponível, em vez de apresentar valores locais como se fossem oficiais.
Consultar tesouraria e documentos do ERP
Use **Tesouraria / aging** para consultar títulos e vencimentos retornados pelo ERP e **Documentos financeiros do ERP** para consultar os documentos financeiros associados. Esses cartões não são um cadastro ou uma tela de edição do Agility: seus estados, totais e mensagens refletem a proveniência e o resultado da última leitura da integração. Para corrigir um título ou documento, siga o processo no ERP de origem e atualize a leitura no Agility.
Cadastrar um cliente pessoa jurídica
Na aba **Clientes**, clique em **Novo cliente**. O diálogo começa na opção **Pessoa jurídica**. Se o ERP disponibilizar parceiros ativos com o papel de cliente, o campo **Parceiro no ERP** permite selecionar um deles ou deixar **Sem vínculo ERP**. Ao vincular, nome e CNPJ vêm do ERP e deixam de ser editáveis no cadastro do Agility; isso mantém a mesma entidade nas duas bases e permite comparar a margem por cliente.
Sem vínculo ERP, preencha **Nome** e, se desejar, **CNPJ**. O documento é digitado com máscara, mas o servidor armazena apenas os dígitos. Pessoa jurídica exige CNPJ com 14 dígitos; para um cadastro pessoa física, troque para a aba **Pessoa física**, informe o nome e um CPF com 11 dígitos. Trocar a aba limpa o documento digitado, pois CPF e CNPJ têm formatos diferentes.
Complete os dados de endereço que serão úteis para identificação: **Endereço**, **País**, **Cidade** e **Estado**. Os campos são opcionais, mas preencher ao menos a cidade e o estado ajuda a reconhecer o cliente na operação. Clique em **Salvar**; o cliente passa a aparecer na tabela, com documento, tipo (PJ ou PF), eventual parceiro ERP e quantidade de contratos.
Localizar e editar um cliente
Use **Buscar por nome, CNPJ ou parceiro**. A busca aceita o documento pontuado como aparece na tela ou somente os dígitos. Na coluna de ações, escolha **Editar cliente**. Em um cliente vinculado ao ERP, o nome e o documento ficam bloqueados e a tela informa que a edição deve ser feita no ERP; endereço, país, cidade e estado continuam editáveis.
Cadastrar o contrato do cliente
Abra a aba **Contratos** e clique em **Novo contrato**. Selecione o **Cliente** no campo obrigatório; por isso um cliente precisa existir antes do contrato. Informe o **Código** (a aplicação o transforma em maiúsculas), o **Título** e o **Tipo**. Os tipos disponíveis são **Recorrente**, **Preço fixo**, **Hora faturável** e **Marcos**.
Informe o valor de referência em reais. O rótulo muda conforme o tipo: mensalidade para contrato recorrente, valor da hora para hora faturável e valor do contrato para preço fixo ou marcos; o valor é opcional e pode ser zero. Salve para ver a linha com código, título, cliente, tipo, valor e quantidade de ordens de serviço. Na edição, o cliente aparece bloqueado: repontá-lo reatribuiria a margem histórica.
Use **Buscar por código, título ou cliente** para filtrar contratos. Contratos cadastrados aqui podem ser selecionados na configuração financeira de um projeto, em uma solicitação de faturamento e na criação de uma ordem de serviço. Um contrato inativo não pode receber uma nova OS; reative ou escolha outro contrato antes de continuar.
Criar item no catálogo
Na aba **Catálogo**, clique em **Novo item**. Escolha a espécie **Produto** ou **Serviço**, preencha o **Código**, a **Unidade** (por exemplo, hora, mês ou licença), o **Nome**, o **Preço de referência (R$)** e, opcionalmente, uma **Observação** sobre o que está incluído. O preço é apenas uma referência do Workspace; o preço efetivamente contratado é gravado depois no vínculo com cada projeto.
Salve e confirme a linha com código, nome, espécie, unidade, preço e situação **Ativo**. O botão **Editar item** permite alterar código, nome, unidade, preço e observação, mas a espécie fica fixa. Use **Desativar** para retirar o item dos seletores de projetos sem apagar seu histórico; itens desativados continuam listados e podem ser **Reativados**.
Definir custo-hora
Na aba **Custos-hora**, clique em **Novo custo-hora**. Em **Dimensão**, selecione **Pessoa** ou **Papel**. Informe o identificador no campo correspondente (por exemplo, `ana.souza` para pessoa ou `Desenvolvedor` para papel), o **Custo-hora (R$)** e a data **Vigente desde**. A taxa passa a ser uma referência histórica; uma nova taxa do mesmo sujeito encerra a anterior.
Após salvar, a tabela mostra dimensão, sujeito, custo-hora e a data de vigência. A busca aceita o nome da pessoa ou do papel. Taxas encerradas ficam esmaecidas, recebem a marca **encerrada** e não oferecem edição: alterar o sujeito reescreveria custos já apropriados. Cadastre uma taxa vigente antes de apontar horas em um projeto.
Sobre bancos e plano de contas
Não procure as opções **Bancos** ou **Plano de contas** dentro desta página: elas não fazem parte do Financeiro do Agility. Os lançamentos do Agility trabalham com tipo (receita, despesa, compra ou faturamento), direção, valor, competência, fornecedor opcional e, quando disponível, centro de custo do ERP. A escrituração bancária e a conta contábil são responsabilidade do ERP integrado e não devem ser inventadas como cadastro no Agility.
Verificação
- A aba Clientes mostra pelo menos um cliente com tipo PF/PJ e, quando aplicável, documento e parceiro ERP.
- A aba Contratos apresenta o cliente relacionado, o tipo comercial e o valor de referência; o cliente do contrato não pode ser trocado na edição.
- Um produto ou serviço ativo aparece no catálogo e pode ser escolhido para vínculo dentro do financeiro de um projeto.
- A aba Custos-hora mostra uma taxa vigente por pessoa ou papel, com custo e data a partir da qual ela vale.
- Ao criar outra taxa para o mesmo sujeito, a anterior deixa de ser editável e fica marcada como encerrada.
- A aba Operacional permite consultar Ordens de serviço, SLA, aging/tesouraria e documentos financeiros do ERP; cartões externos indicam a origem e não oferecem edição local.
Erros comuns
Nome de cliente duplicado
O servidor recusa nomes repetidos e exibe que já existe um cliente com este nome. Pesquise a tabela e edite o cadastro existente ou escolha um nome que diferencie a entidade.
CPF ou CNPJ inválido
A mensagem de documento inválido indica que o CPF precisa ter 11 dígitos e o CNPJ, 14. Remova caracteres extras, confira o documento e salve novamente; a pontuação mostrada na tela é apenas formatação de leitura.
Contrato sem cliente ou código repetido
Contrato exige cliente e código único. Volte à aba Clientes para cadastrar o cliente, selecione-o no diálogo e altere o código se ele já estiver em uso.
Código de catálogo já utilizado
Cada produto ou serviço do Workspace deve ter código único. Pesquise o código, edite o item existente ou escolha outro; desativar um item não libera automaticamente seu código para uma nova linha.
Vigência de custo-hora sobreposta
Uma taxa nova não pode se sobrepor à vigência de outra taxa do mesmo sujeito. Escolha uma data posterior ao fim da vigência anterior ou use a taxa vigente existente; uma taxa encerrada também não pode ser editada.