Entre Múltiplas Contas (Transferência Entre Múltiplas Contas)

Rotina do módulo Financeiro que executa, em um único processamento, várias transferências de valor entre contas bancárias/carteiras.

Rotina do módulo Financeiro que executa, em um único processamento, várias transferências de valor entre contas bancárias/carteiras. O usuário monta uma lista (lote) de transferências na tela, informando para cada linha a carteira/filial de origem, a carteira/filial de destino, a data de lançamento, o documento, o valor, a cotação e uma observação. Ao salvar, todo o lote é enviado de uma só vez ao servidor, que processa item a item e devolve as movimentações financeiras e os lançamentos contábeis gerados, exibidos no passo de comprovante.

Árvore no ERP (menu do sistema):

FINANCEIRO > Transferências (recurso 1554) > Entre Múltiplas Contas (recurso 3965)

Identificação técnica:

Observações de arquitetura relevantes:

• Não existe um controller próprio chamado TransferenciaEntreMultiplasContasController. A rotina é servida pelo controller da transferência simples (TransferenciaEntreContasController), por meio das actions SalvarMultiplo e ImprimirEntreMultiplasContas.
• A grade do lote é uma store puramente em memória (sem proxy/URL). Nada é persistido enquanto o usuário adiciona, edita ou exclui itens: o lote inteiro só chega ao servidor no acionamento de Salvar.
• A tela é um assistente (assistente base do GMF) de dois passos: Passo 1 “Informações” (montagem do lote) e Passo 2 “Comprovante” (movimentações financeiras e contábeis geradas, com opções de impressão e exportação).

Regra 1 — É obrigatório estar logado em uma carteira para abrir a rotina. O recurso 3965 está cadastrado com validaAntes = true. Antes de abrir a tela, o sistema verifica se existe carteira selecionada na sessão. Se não existir, a abertura é cancelada.

Mensagem exibida: “Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira.”

Regra 2 — A carteira de destino não pode ser igual à carteira de origem. A validação ocorre nos dois lookups (ao carregar a carteira de origem e ao carregar a carteira de destino). O campo é limpo e a seleção é desfeita.

Mensagem exibida: “Carteira de destino não pode ser a mesma que a carteira de origem. Por favor, tente novamente.”

Regra 3 — As carteiras de origem e destino precisam ser da mesma moeda (validação na tela). Ao carregar qualquer um dos lookups, o sistema compara a moeda da carteira de origem com a da carteira de destino. Divergindo, a seleção é desfeita.

Mensagem exibida: “A moeda da carteira origem precisa ser a mesma da carteira de destino.”

Regra 4 — A mesma validação de moeda é reaplicada no servidor e bloqueia o processamento. No processamento de cada item, se a moeda da carteira de origem for diferente da moeda da carteira de destino, a operação é interrompida.

Mensagem exibida: Erro “Não foi possível realizar operação.” / Motivo “Não foi possível realizar a transferência ” / Solução ” pois as carteiras de origem e destino são de moedas diferentes.”

Regra 5 — Só é possível adicionar um item ao lote com o formulário válido. A ação Adicionar Item só monta e insere o registro na grade se o formulário do Passo 1 estiver válido (todos os campos obrigatórios preenchidos). Caso contrário, os campos inválidos são sinalizados pelo próprio formulário.

Regra 6 — Não é possível salvar sem ao menos uma transferência na lista. Se a grade estiver vazia no acionamento de Salvar, a requisição não é enviada.

Mensagem exibida: “Nenhuma Transferência adicionada na lista.” (aviso, título “Status”)

Regra 7 — Lote vazio recebido pelo servidor cancela a operação. Se, mesmo assim, a action SalvarMultiplo receber uma lista vazia, ela cancela o processamento.

Mensagem exibida: Erro “Operação Cancelada” / Motivo “Alguns dados podem estar incorretos” / Solução “Verifique se os dados informados estão corretos e tente novamente”

Regra 8 — O valor de cada transferência deve ser maior que zero. A validação é feita item a item, antes de processar a transferência. Um único item com valor menor ou igual a zero interrompe o lote.

Mensagem exibida: Erro “Não foi possível Processara Tranferencia” / Motivo “O valor da transferência deve ser maior que 0. Valor informado : {0}” / Solução “Informe valor da tranferencia corretamente”

Regra 9 — A filial de destino informada precisa existir. Se a filial de destino do item não for localizada, o processamento é interrompido.

Mensagem exibida: Erro “Não foi concluir a operação” / Motivo “A filial destino : [{0}] não foi encontrada” / Solução “Por favor, verifique os parâmetros informados.”

Regra 10 — A filial de origem informada precisa existir.

Mensagem exibida: Erro “Não foi concluir a operação” / Motivo “A filial origem : [{0}] não foi encontrada” / Solução “Por favor, verifique os parâmetros informados.”

Regra 11 — As carteiras de origem e destino precisam existir no cadastro. A busca é feita para as duas carteiras do item; não encontrando, o processamento é interrompido identificando qual carteira falhou (“de origem” ou “destino”).

Mensagem exibida: “Não foi possível Obter Carteira, A carteira {0} informada não foi encontrada, Por favor, verifique os parâmetros informados. Código informado : {1}”

Regra 12 — Moeda não informada no cadastro da carteira assume a moeda padrão. Se a carteira de origem ou de destino estiver sem moeda cadastrada, o sistema assume a moeda padrão do sistema para aquela carteira antes de seguir. As mensagens de moeda inválida de origem e de destino existem no código, mas na prática não são atingidas nesta rotina, porque a atribuição da moeda padrão ocorre antes da checagem.

Mensagem exibida (origem): Erro “Não foi possível realizar operação” / Motivo “Moeda no cadastro de origem inválida” / Solução “Por favor informe a moeda no cadastro da carteira de Origem para que possa realizar a transferência.”

Mensagem exibida (destino): Erro “Não foi possível realizar operação” / Motivo “Moeda no cadastro de destino inválida” / Solução “Por favor informe a moeda no cadastro da carteira de Destino para que possa realizar a transferência.”

Regra 13 — Conversão pela cotação quando as carteiras operam em moeda estrangeira. Se a moeda das duas carteiras for igual entre si, porém diferente da moeda padrão do sistema, o valor da movimentação é convertido multiplicando o valor informado pela cotação do item (ValorDaCotacao). Quando as carteiras estão na moeda padrão, o valor é gravado como informado.

Regra 14 — Transferência entre filiais diferentes gera operação de mútuo. Se a filial de origem for diferente da filial de destino, o sistema classifica a operação como mútuo entre filiais e gera lançamentos adicionais (detalhados em Lógica Contábil e Financeira). Se as filiais forem iguais, a transferência é direta entre as duas carteiras.

Regra 15 — Para mútuo, as duas filiais precisam ter a conta de lançamento de mútuo configurada. Antes de gerar os lançamentos de mútuo, o sistema valida a carteira de mútuo das filiais envolvidas.

Mensagem exibida (filial do pagamento/destino): Erro “Não foi possível validar Dados” / Motivo “Não é possível executar uma operação financeira mutua sem a carteira mutua” / Solução “Por favor configure a carteira mutua para a filial da operação”

Mensagem exibida (filial do título/origem): Erro “Não foi possível validar Dados” / Motivo “Não é possível executar uma operação financeira mútua sem a carteira mútua” / Solução “Por favor, realizar parametrização no cadastro da filial, em Dados Relacionados=>Conta Lancto Mútuo”

Regra 16 — O fato contábil de mútuo precisa estar ativo e parametrizado. Na operação de mútuo, o sistema busca o fato contábil da operação financeira MÚTUO (BCOMUT) com variação Sem Variação. Se esse fato não tiver lançamentos configurados, a contabilização é interrompida.

Mensagem exibida: Erro “Ocorreu um erro durante a contabilização.” / Motivo “Processo interrompido. Lista de erros: 1 – Fato contábil do financeiro com Operação financeira: 38 – MÚTUO(BCOMUT) e variação : Sem Variação está desativado 2 – Fato contábil do financeiro com Operação financeira: 38 – MÚTUO(BCOMUT) e variação : Sem Variação está desativado.” / Solução “Verifique o erro ocorrido”

Regra 17 — Toda movimentação precisa resolver uma conta contábil válida. Ao montar a contabilização, o sistema resolve a conta contábil a partir da origem configurada no modelo do fato contábil. Não encontrando conta válida, o processo é interrompido.

Mensagem exibida: Erro “Não foi possível obter Plano de contas” / Motivo “Não foi possível determinar uma Conta contábil válida com a configuração do modelo. Conta {0}. Operação: {1} Variação: {2} operacaoFinanceira variacao” / Solução “Configure uma conta contábil valida para operação”

Mensagem exibida (falha na resolução): Erro “Não foi possível obter Plano de contas” / Motivo “Não foi possível determinar uma Conta contábil válida com a configuração do modelo. Conta {0} – Erro: {1}” / Solução “Configure uma conta contábil valida para operação”

Regra 18 — O lote inteiro compartilha uma única chave de fato/integração. Antes de percorrer os itens, o sistema gera uma única nova chave de fato. Essa mesma chave é usada como identificador da operação e como identificador de integração de todas as movimentações do lote, e o número de lançamento é sequencial e contínuo entre os itens (não reinicia a cada transferência). É essa chave que é devolvida ao front-end como CodigoDaOperacao e usada na consulta das movimentações e do comprovante.

Regra 19 — A contabilização só ocorre com todas as movimentações portando operação financeira. Após processar todos os itens, o sistema só envia o conjunto para a integração contábil se nenhuma movimentação estiver sem operação financeira atribuída.

Regra 20 — O padrão de contabilização é executado em dois blocos separados. As movimentações marcadas com contabilização padrão para mútuo são separadas das demais. As movimentações comuns são contabilizadas primeiro (sem indicador de mútuo) e, em seguida, as de mútuo são contabilizadas com o indicador de mútuo ativo, que altera a origem da conta contábil utilizada.

Regra 21 — A edição de item do lote é feita pela grade, antes de salvar. Clicar em uma linha da grade recarrega o formulário com os dados daquele item para alteração; Salvar Item atualiza o registro selecionado e Excluir Item remove a linha. Enquanto o lote não é salvo, nada é gravado no banco. Ao recarregar o formulário a partir da grade, o campo Observação não é reposto no formulário — se o item for regravado sem redigitar a observação, ela é perdida.

Regra 22 — Padrões carregados ao abrir a tela e após cada inclusão. A carteira de origem é preenchida com a carteira em que o usuário está logado e a data de lançamento com a data de movimentação do usuário acrescida de um dia. Esses padrões são reaplicados após cada item adicionado.

Regra 23 — Não há reprocessamento nem estorno pela própria rotina. Concluído o salvamento, a tela avança para o passo de comprovante, cujas ações são apenas fechar, imprimir/exportar e iniciar uma nova transferência. A rotina não oferece consulta, alteração ou exclusão de transferências já gravadas.

Regra 24 — Cheques próprios não se aplicam a esta rotina. O serviço compartilhado possui tratamento de cheques próprios e da variação Cheque a Prazo de transferência, mas a action SalvarMultiplo sempre chama o processamento sem lista de cheques, de forma que esses caminhos nunca são executados na transferência entre múltiplas contas.

Observações:

• Não existe recurso de listagem (ListViewDe…) para esta rotina; o recurso 3965 é o único ponto de controle de acesso, cobrindo tanto a montagem do lote quanto o salvamento e a impressão do comprovante.
• Recursos irmãos sob 1554 – Transferências: 1555 (Adiantamento de Cliente), 1556 (Adiantamento a Fornecedor) e 1557 (Transferência Entre Contas — versão de transferência simples, servida pelas actions Salvar e Imprimir do mesmo controller).
• Fonte: RecursosGeraisFinanceiro.cs.