3.1 DTOCabecalhoDeOperacoes (entrada)

DTO genérico compartilhado por todas as operações financeiras. Propriedades efetivamente utilizadas por esta rotina:

3.2 DTODeTituloAProcessar (item 0)

Campos consumidos pelo controller nesta rotina:

3.3 DTODeChequesProprios

Herda de DTODeChequesParaOperacoesFinanceiras e acrescenta IDDoCheque (string). Campos da base utilizados no processamento: IDDaCarteiraDoCheque, Numero, NumeroDoCheque, Valor, DataDeVencimento, DataDeEmissao, CodigoCadastro, NomeDoEmitente, Emitente, IDDaFormaDePagamento, IdDaFilial, Observacao, Complemento.

3.4 Entidades geradas

—

4.1 Operações financeiras realizadas

Todas as movimentações são gravadas sob a mesma Chave de Fato (idDaOperacao), obtida por IServicoDeSequenciaDeNumeracao.ObterNovaChaveDeFato(). O contador numeroDeLancamento inicia em 1 e é incrementado a cada movimentação.

O fato contábil base é obtido com ObterFatoContabil(ListaDeOperFin.tcBCOTRNF, EnumRotinaDeVariacao.SemVariacao).

Cenário A — Mesma filial, sem cheques (2 movimentações):

Cenário B — Filiais diferentes, sem cheques (mútuo, 4 movimentações):

Todas as quatro movimentações recebem ContabilizacaoPadraoParaMutuo = true. Nas pernas de mútuo, o sistema força fatoMutuo.Lancamentos[0].OrigemDaContaDeCredito e OrigemDaContaDeDebito para EnumOrigemDaContaFinanceiro.FilialCodigoContaLancamentoMutuo.

Cenário C — Mesma filial, com cheques próprios (1 movimentação + títulos e cheques):

Em seguida executa IncluirTransferenciaChequePropriosAPagar, que gera, para cada cheque, um Título a Pagar, um Cheque e uma movimentação financeira de Crédito com ListaAtualizarModulo.tcPagar.

Cenário D — Filiais diferentes, com cheques próprios (3 movimentações + títulos e cheques):

Seguidas de IncluirTransferenciaChequePropriosAPagar usando a carteira de lançamento de mútuo da filial de origem como contrapartida.

4.2 Integração contábil

Ao final de Processar, o sistema verifica se alguma movimentação da lista ficou com OperacaoFinanceira nula. Havendo, a integração contábil não é executada. Caso contrário, a lista é separada por ContabilizacaoPadraoParaMutuo e integrada em duas chamadas:

1. Movimentações sem contabilização de mútuo: ProcessaLancamentosFinanceirosTransferencia(lista, null, obterPlanoDeContasParaTransferencia, false).
2. Movimentações de mútuo, com o indicador interno de mútuo ligado: ProcessaLancamentosFinanceirosTransferencia(lista, null, obterPlanoDeContasParaTransferencia, true).

4.3 Resolução do plano de contas (obterPlanoDeContas)

Se o resultado for nulo e a origem da conta contábil for diferente de 0, o sistema dispara NAO_FOI_POSSIVEL_OBTER_PLANO_DE_CONTAS_KCMKG. Qualquer exceção no método dispara NAO_FOI_POSSIVEL_OBTER_PLANO_DE_CONTAS_CYFIR.

4.4 Regras de valor e moeda

1. Cheques sobrepõem o valor informado: quando a lista de cheques próprios não é nula, o valor da transferência passa a ser a soma dos valores dos cheques, ignorando o valor digitado na tela.
2. Valor deve ser positivo: se o valor final for menor ou igual a zero, dispara NAO_FOI_POSSIVEL_PROCESSAR_KXPSQ.
3. Moeda ausente: se a moeda do banco/caixa de origem ou destino for nula, o sistema atribui a moeda padrão obtida em ObterMoedaDefault().
4. Moedas divergentes: se a moeda da carteira de origem for diferente da moeda da carteira de destino, dispara NAO_FOI_POSSIVEL_REALIZAR_OPERACAO_LWGFP e a operação é interrompida.
5. Conversão pela cotação: quando ambas as carteiras usam moeda diferente da moeda padrão, o valor é recalculado como ValorMoeda multiplicado pela cotação informada.

4.5 Regras de filial e mútuo

1. Filial de destino vazia dispara NAO_FOI_CONCLUIR_A_OPERACAO_WXMMT.
2. Filial de origem vazia dispara NAO_FOI_CONCLUIR_A_OPERACAO_PVXXB.
3. O mútuo é acionado automaticamente quando a filial de destino é diferente da filial de origem. Não existe opção na tela para ligar ou desligar o mútuo.
4. Ao acionar o mútuo, Validacoes.ValidarDadosParaMutuo(filialDaCarteiraOrigem, filialDaCarteiraDestino) exige que ambas as filiais tenham a carteira de lançamento de mútuo configurada (Filial.CarteiraParaLancamentoMutuo). A ausência na filial de destino dispara NAO_FOI_POSSIVEL_VALIDAR_DADOS_XDOCL; na filial de origem, NAO_FOI_POSSIVEL_VALIDAR_DADOS_FHCPQ.
5. O fato contábil de mútuo (operação 38, variação Sem Variação) precisa existir e ter lançamentos. Sem ele, dispara OCORREU_UM_ERRO_DURANTE_A_CONTABILIZACAO_UCNGR (caminho com cheque) ou OCORREU_UM_ERRO_DURANTE_A_CONTABILIZACAO_AGXJO (caminho sem cheque).
6. No caminho com cheques, o fato contábil da operação 37 com variação 299 – Cheque a Prazo de Transferência precisa existir; caso contrário, dispara OCORREU_UM_ERRO_DURANTE_A_CONTABILIZACAO_YQHNA.

4.6 Regras de carteira

1. As carteiras de origem e destino são obtidas por ObterCarteira. Não encontrada, dispara NAO_FOI_POSSIVEL_OBTER_CARTEIRA_NAYRZ, identificando “de origem” ou “destino”.
2. A tela impede que a carteira de destino seja igual à carteira logada: ao selecionar a mesma carteira, o frontend exibe a janela “Operação inválida” com o texto “Carteira de destino não pode ser a mesma que a carteira de origem. Por favor, tente novamente.” e limpa o lookup.
3. O acesso à rotina exige que exista carteira selecionada. Sem carteira, o frontend bloqueia a abertura com a mensagem “Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira.” (comportamento associado a validaAntes = true no recurso 1557).
4. Em IncluirTransferencia, o status de conciliação é definido como Sim quando o status de conciliação não é informado e lancamento.Conciliado é diferente de 2; caso contrário, Não.

4.7 Regras de cheques próprios (IncluirTransferenciaChequePropriosAPagar)

Pré-condições verificadas antes de gerar qualquer registro:

1. O usuário logado precisa ter cadastro configurado, senão dispara O_USUARIO_LOGADO_NAO_POSSUI_CADASTRO_CONFIGURADO_FXROK.
2. A forma de pagamento é obrigatória, senão dispara NAO_FOI_POSSIVEL_INCLUIR_ADIANTAMENTO_GZKCH.
3. A carteira de cheque a compensar precisa estar configurada, senão dispara NAO_FOI_POSSIVEL_INCLUIR_ADIANTAMENTO_TTLJT.
4. A carteira de cheque a compensar precisa ter plano de contas, senão dispara NAO_FOI_POSSIVEL_INCLUIR_ADIANTAMENTO_LPEHE.

Processamento:

• Os cheques são separados em à vista (data de vencimento igual à data de movimentação) e a prazo (demais).
• Para cada cheque são criados, nesta ordem e com Commit a cada etapa: TituloPagar (status tcAberto), Cheque (status tcGerado, tipo tcPagar) e MovimentacaoFinanceira (partida Crédito, módulo tcPagar).
• Fatos contábeis: operação tcTPAGINC com variação ChequeAVista para os cheques à vista e ChequeAPrazo para os cheques a prazo.
• Tipo de documento padrão do título: ObterConteudoPorID(4). Tipo de documento do cheque: ObterConteudoPorID(227).
• Numeração do cheque: o número informado só é utilizado quando a carteira do cheque tem ChequeFormularioContinuo igual a Não e o número informado é maior que zero. Caso contrário, o sistema obtém o próximo número por ObterProximoNumeroDaSequenciaComUpdate.
• O nome do emitente é truncado em 50 caracteres.
• Observação de comportamento no fonte atual: a vinculação tituloCheque.IDDoDocumentoDeCheque = novoCheque.ChaveDeFato é atribuída somente no caminho dos cheques à vista; no caminho dos cheques a prazo essa atribuição não ocorre.

4.8 Validações do frontend

Mensagens exibidas pela tela antes do envio ao servidor:

• “Para Forma de Pagamento com Cheque é necessário incluir ao menos um cheque”
• “Necessário incluir um cheque.”
• “Número do cheque obrigatório. Verifique os dados informados.”
• “Cód. cadastro obrigatório. Verifique os dados informados.”
• “Número de cheque já adicionado. Verifique os dados informados.”
• “Valor do cheque não informado.”
• “Valor da parcela não informado.”
• “O Valor da parcela não pode ser maior que o valor informado para o cheque”
• “Há cheque(s) com valor igual a 0. Favor corrigir os dados.”
• “Não é possível salvar cheques com valor zero. Verifique os dados informados.”
• “Data de vencimento do cheque deve ser maior ou igual a data de hoje”
• “Por favor, preencha todos os campos corretamente.”
• “Cheque adicionado.”
• “Operação concluída com sucesso.”

Comportamento do campo “Gerar Cheque”: ao selecionar Sim, o sistema exibe e torna obrigatório o campo “Forma de Pagamento”, oculta os campos “Valor” e “Valor Cotação”, desabilita o botão Concluir e habilita o botão Próximo. Ao voltar para Não, o comportamento é invertido.

No passo 2, o sistema consulta CarteiraCheque/ObterPorId com a carteira logada: se ChequeFormContinuo for igual a Não, o campo “Número do Cheque” é habilitado e obrigatório; caso contrário é desabilitado e preenchido com o número retornado pelo servidor.

4.9 Dados obrigatórios

Obrigatórios na tela (passo 1):

Obrigatórios no backend:

4.10 Mensagens de erro (transcrição literal de Portugues.cs)

OPERACAO_CANCELADA_ALGUNS_DADOS_PODEM_ESTAR_INCORRETOS

• Erro: Operação Cancelada
• Motivo: Alguns dados podem estar incorretos
• Solução: Verifique se os dados informados estão corretos e tente novamente

NAO_FOI_POSSIVEL_PROCESSAR_KXPSQ

• Erro: Não foi possível processar
• Motivo: O valor da transferência deve ser maior que 0. Valor informado : {0}
• Solução: Favor informe o valor da transferência corretamente

NAO_FOI_CONCLUIR_A_OPERACAO_WXMMT

• 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.

NAO_FOI_CONCLUIR_A_OPERACAO_PVXXB

• 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.

NAO_FOI_POSSIVEL_OBTER_CARTEIRA_NAYRZ

• Mensagem única: 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}

NAO_FOI_POSSIVEL_REALIZAR_OPERACAO_CPZFN

• 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.

NAO_FOI_POSSIVEL_REALIZAR_OPERACAO_PJANY

• 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.

NAO_FOI_POSSIVEL_REALIZAR_OPERACAO_LWGFP

• 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.

NAO_FOI_POSSIVEL_VALIDAR_DADOS_XDOCL

• 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

NAO_FOI_POSSIVEL_VALIDAR_DADOS_FHCPQ

• 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

OCORREU_UM_ERRO_DURANTE_A_CONTABILIZACAO_YQHNA

• Erro: Ocorreu um erro durante a contabilização.
• Motivo: Processo interrompido. Lista de erros: 1 – Fato contábil do financeiro com Operação financeira: 37 – TRANSFERÊNCIA (BCOTRNF) e variação : 299 – Cheque a Prazo de Transferência
• Solução: Verifique o erro ocorrido

OCORREU_UM_ERRO_DURANTE_A_CONTABILIZACAO_UCNGR e OCORREU_UM_ERRO_DURANTE_A_CONTABILIZACAO_AGXJO

• 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

NAO_FOI_POSSIVEL_OBTER_PLANO_DE_CONTAS_KCMKG

• 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

NAO_FOI_POSSIVEL_OBTER_PLANO_DE_CONTAS_CYFIR

• 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

O_USUARIO_LOGADO_NAO_POSSUI_CADASTRO_CONFIGURADO_FXROK

• Mensagem única: O usuário logado não possui cadastro configurado, e é necessário para realizar a operação.

NAO_FOI_POSSIVEL_INCLUIR_ADIANTAMENTO_GZKCH

• Erro: Não foi possível incluir Adiantamento
• Motivo: Para gerar um título de adiantamento é obrigatório informar uma forma de pagamento. Código informado : {0}
• Solução: Favor informe uma forma de pagamento

NAO_FOI_POSSIVEL_INCLUIR_ADIANTAMENTO_TTLJT

• Erro: Não foi possível incluir Adiantamento
• Motivo: Para gerar um título de adiantamento é obrigatório informar uma carteira de cheque a compensar.
• Solução: Por favor informe uma carteira

NAO_FOI_POSSIVEL_INCLUIR_ADIANTAMENTO_LPEHE

• Erro: Não foi possível incluir Adiantamento
• Motivo: Para gerar um título de adiantamento é obrigatório informar um plano de contas para a carteira: {0} – {1}
• Solução: Por favor informe um plano de contas.

—