Empréstimo obtido
Empréstimo obtido — Financeiro (ERPV1)
A tela Financeiro → Caixa → Empréstimo obtido registra um empréstimo que a empresa recebeu.
Visão Geral
A tela Financeiro → Caixa → Empréstimo obtido registra um empréstimo que a empresa recebeu. Ela funciona como um assistente de 3 passos (Informações, Cheque e Comprovante) e opera sempre sobre a carteira em que o usuário está logado.
Há três tipos de empréstimo:
- Contas a Pagar: gera um título a pagar e o crédito do valor na carteira logada.
- Entre Contas: transfere o valor de uma carteira de destino para a carteira logada (dentro da mesma filial ou entre filiais, com mútuo).
- Cheque de Terceiros: o valor do empréstimo vem de cheques de terceiros informados no passo 2.
Ao concluir, o sistema mostra um comprovante com o código da operação, o valor e as listas de títulos, cheques e lançamentos contábeis gerados, e permite imprimi-lo.
Pré-requisitos
- O usuário precisa estar logado em uma carteira. Sem carteira, a tela não abre.
- Parâmetro do módulo financeiro “tipo de documento para empréstimo obtido” configurado (tipos Contas a Pagar e Cheque de Terceiros).
- Sequência de numeração configurada para esse tipo de documento.
- Fato contábil BCOEMPOBT ativo, com lançamentos e histórico (variação Entre Contas para o tipo Entre Contas).
- Para empréstimo entre filiais diferentes: carteira para lançamento de mútuo configurada nas duas filiais.
- Formas de pagamento cadastradas.
Fluxo Operacional
Fluxo 1 — Empréstimo Contas a Pagar
- Abrir Financeiro → Caixa → Empréstimo obtido.
- Preencher o passo Informações com Tipo “Contas a Pagar”, Participante, Forma de Pagamento, datas e Valor.
- Clicar em Concluir.
- Conferir o Comprovante e, se necessário, imprimir.
Fluxo 2 — Empréstimo Entre Contas
- No passo Informações escolher Tipo “Entre Contas”.
- Informar a Carteira Destino (Agência e Conta são preenchidas automaticamente), Forma de Pagamento, datas e Valor.
- Clicar em Concluir e conferir o Comprovante.
Fluxo 3 — Empréstimo com Cheque de Terceiros
- No passo Informações escolher Tipo “Cheque de Terceiros” e clicar em Próximo.
- No passo Cheque, preencher os dados de cada cheque e adicioná-lo à lista.
- Clicar em Concluir. O valor do empréstimo é a soma dos cheques.
- Conferir o Comprovante.
Fluxo 4 — Imprimir o comprovante
- No passo Comprovante clicar em Imprimir.
- Escolher Gerar PDF, Exportar Excel ou Exportar Word. No Excel, escolher a opção de arquivo e confirmar com OK.
Interface e Comportamentos da Tela
Passo 1 — Informações (janela “Empréstimo Obtido”)
Os botões Cancelar e Anterior ficam ocultos.
| Campo | Obrigatório | Comportamento |
|---|---|---|
| Data de Emissão | Sim | Padrão: data de movimentação do usuário |
| Data de Vencimento | Sim | Padrão: hoje |
| Filial | — | Somente leitura, preenchida a partir da carteira logada |
| Moeda | — | Padrão: moeda da carteira ou do sistema |
| Valor Cotação / Valor em Moeda | — | Só aparecem se a moeda difere da moeda do sistema. Ao sair do Valor em Moeda, o Valor passa a ser cotação × valor em moeda |
| Tipo | Sim | Contas a Pagar, Entre Contas, Cheque de Terceiros |
| Carteira Destino | Sim (Entre Contas) | Só aparece em Entre Contas; Agência e Conta somente leitura |
| Participante | Sim | Oculto em Entre Contas |
| Forma de Pagamento | Sim | — |
| Número do Título Auxiliar | Não | — |
| Valor | Sim | Oculto em Cheque de Terceiros |
Comportamento por tipo:
- Cheque de Terceiros: Concluir desabilitado e Próximo habilitado.
- Demais tipos: Concluir habilitado e Próximo desabilitado.
Passo 2 — Cheque (janela “Cheque”, formulário “Cheques recebidos de terceiros”)
Só é usado no tipo Cheque de Terceiros. O formulário é o mesmo da tela Empréstimo concedido.
| Campo | Obrigatório | Observação |
|---|---|---|
| Banda magnética | Não | Preenche os dados do cheque |
| Cheque Nº | Sim | Até 6 caracteres |
| Série | Sim | Até 3 caracteres |
| Compensação | Sim | Até 3 caracteres |
| Banco | — | — |
| Agência | Sim | Até 5 caracteres |
| Conta | Sim | Até 20 caracteres |
| Valor | Sim | Mínimo 0 |
| Vencimento | — | — |
| Participante | Sim | — |
| Código reduzido | Não | Até 10 caracteres |
| CPF/CNPJ Emitente | Não | Validado; se válido, o nome do emitente é preenchido automaticamente |
| Emitente | Não | Até 50 caracteres |
| Forma de cobrança | Sim | — |
| Razão Conta / Observação | Não | — |
Passo 3 — Comprovante (janela “Comprovante de empréstimo obtido”)
Mostra Data (da primeira operação financeira), Código da operação, Valor e três listas (títulos, cheques e lançamentos contábeis). Botões Fechar, Imprimir e Novo (reinicia o assistente).
Feedbacks ao Usuário
Feedbacks da tela
| Situação | Feedback | Texto exato |
|---|---|---|
| Abertura sem carteira | Alerta “Atenção:” | Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira. |
| Emissão maior que vencimento | Alerta “Status” | A Data de Emissão, não pode ser maior que a Data de Vencimento! |
| Campos obrigatórios vazios | Alerta “Status” | Por favor, preencha todos os campos corretamente. |
| Cheque de Terceiros sem cheque | Alerta “Status” | Necessário incluir um cheque. |
| Gravando | Aguarde | O sistema está trabalhando, por favor aguarde… |
| Sucesso | Informação “Status” | Operação concluída com sucesso. |
| Cheque incluído | Informação | Cheque adicionado. |
| Cheque repetido na lista | Informação | Cheque já adicionado. Verifique os dados informados. |
| Cheque já existe no sistema | Erro | Cheque já cadastrado no sistema. |
Feedbacks do servidor
| Situação | Erro | Motivo | Solução |
|---|---|---|---|
| Dados do título ausentes | Não foi possível Salvar | Os dados informados podem estar incorretos | Verifique se os dados informados estão corretos. |
| Carteira inexistente | Não foi possível incluir Emprestimo | A carteira não encontrada | Informar uma carteira válida para concluir a operação |
| Sem tipo de documento do empréstimo | É obrigatório informar um tipo de documento para empréstimo nas configurações do módulo financeiro. | — | Favor configure e infome um tipo de documento para empréstimo |
| Forma de pagamento inexistente | Não foi encontrado um valor para o campo Forma de pagamento. Verifique as configurações do banco de dados. | — | Favor informe um valor para o campo Forma de pagamento |
| Fato contábil não configurado | Não foi possível Incluir Emprestimo | É necessário configurar o fato contábil {0} – {1} | Favor configure o fato contábil para operação |
| Histórico não configurado (Entre Contas) | Não foi possível incluir emprestimos entre contas | É necessário configurar um histórico para o fato contábil BCOEMPOBT e variação Entre Contas | Configure um histórico para o fato contábil BCOEMPOBT |
| Sequência não configurada | Erro ao execurtar está operação. | Configurar a sequência para o tipo de documento | Faça os devidos ajustes e tente novamente. |
| Cheque duplicado no banco | Nào é possível concluir a operação | O cheque Nº {0} ja encontra-se cadastrado | Insira um número de cheque não existente |
| Falha genérica | {0}. | Falha na operação. | Verifique os dados e tente novamente. |
Processamento pelo Backend
POST EmprestimoObtido/Salvar
- Se há título a processar, marca o primeiro como empréstimo obtido e chama a inclusão do empréstimo na data de lançamento. Retorna sucesso, cheques, operações financeiras e operações contábeis. Sem título, retorna o erro “Não foi possível Salvar”.
- A inclusão ocorre em transação, com uma nova chave de integração (código da operação). Sem carteira de pagamento (Contas a Pagar e Cheque de Terceiros) segue o empréstimo obtido; com carteira de pagamento (Entre Contas) segue o empréstimo entre contas.
Empréstimo obtido (fato contábil BCOEMPOBT; variação Contas a Pagar ou Cheque de Terceiros):
- Vencimento = informado ou hoje (UTC); emissão original = hoje; parcela 1 de 1.
- Cheque de Terceiros: para cada cheque cria um título a receber aberto (valor do cheque, plano de contas patrimonial), o cheque (aberto, tipo pagar) e uma movimentação a débito; no fim, uma movimentação a crédito com o total na carteira.
- Contas a Pagar: cria título a pagar aberto (natureza realizado, série e número do tipo de documento), movimentação a crédito do título e a débito na carteira. Em moeda estrangeira usa cotação e valor em moeda informados.
- Registra o vínculo com o fato contábil e a integração contábil.
Empréstimo entre contas:
- Origem = carteira logada; destino = Carteira Destino. A filial de origem é a logada se a carteira é do tipo Caixa; senão, a do cadastro.
- Mesma filial: 2 movimentações (débito na origem, crédito no destino) e integração contábil.
- Filiais diferentes: valida a carteira de mútuo e gera movimentações de mútuo (fato BCOMUT).
- Valor em moeda zero assume o Valor.
POST EmprestimoObtido/Imprimir
Garante a pasta de comprovantes do cliente (copiando o modelo padrão se faltar) e retorna sucesso. Em seguida a tela abre o relatório de comprovante com carteira, código da operação e filial, em PDF, Excel ou Word.
Regras de Negócio
R1 — Carteira obrigatória
A tela só abre com uma carteira logada.
R2 — Datas
A Data de Emissão não pode ser maior que a Data de Vencimento.
R3 — Tipos de empréstimo
Contas a Pagar, Entre Contas e Cheque de Terceiros. A opção “Cheque” existe no código, mas está desativada.
R4 — Moeda estrangeira
Valor Cotação e Valor em Moeda só aparecem quando a moeda difere da moeda do sistema; Valor = cotação × valor em moeda.
R5 — Cheque de Terceiros
O valor do empréstimo é a soma dos cheques; é obrigatório incluir ao menos um cheque. Um cheque (número, banco, agência e conta) não pode repetir na lista nem existir no sistema.
R6 — Configurações exigidas
Tipo de documento do empréstimo, forma de pagamento, fato contábil BCOEMPOBT com histórico e, entre filiais, carteira de mútuo.
R7 — Atomicidade
Toda a inclusão é feita em uma única transação.
Troubleshooting
Tela não abre
Cenário: Usuário sem carteira logada.
Mensagem exibida: Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira.
O que fazer: Logar em uma carteira e abrir a tela novamente.
Falta configuração de tipo de documento
Cenário: Concluir Contas a Pagar ou Cheque de Terceiros sem o parâmetro do módulo.
Mensagem exibida: É obrigatório informar um tipo de documento para empréstimo nas configurações do módulo financeiro.
O que fazer: Configurar o tipo de documento para empréstimo no módulo financeiro.
Falta fato contábil
Cenário: Fato BCOEMPOBT sem lançamentos ou histórico.
Mensagem exibida: É necessário configurar o fato contábil {0} – {1}
O que fazer: Configurar o fato contábil e o histórico.
Cheque já cadastrado
Cenário: Cheque já existe no sistema.
Mensagem exibida: Cheque já cadastrado no sistema.
O que fazer: Conferir os dados do cheque e usar um número não existente.
Erro de sequência
Cenário: Tipo de documento sem sequência.
Mensagem exibida: Erro ao execurtar está operação.
O que fazer: Configurar a sequência do tipo de documento.
Casos de Uso
Caso 1 — Empréstimo bancário a pagar
O financeiro recebe um empréstimo de um banco, escolhe Contas a Pagar, informa o participante, a forma de pagamento, o vencimento e o valor, e conclui. O comprovante mostra o título a pagar gerado.
Caso 2 — Transferência entre contas
A empresa recebe recursos de outra carteira: escolhe Entre Contas, informa a Carteira Destino e o valor e conclui.
Caso 3 — Empréstimo garantido por cheques
A empresa recebe um empréstimo entregando cheques de terceiros: escolhe Cheque de Terceiros, adiciona cada cheque e conclui. O valor é a soma dos cheques.