Relatório de Negativação SERASA

Documentação Técnica WRSER001 — Relatório de Negativação SERASA “Negativação SERASA” é o processo pelo qual a empresa registra clientes inadimplentes (títulos vencidos e não pagos) no birô de crédito SERASA, como mecanismo de cobrança; a “exclusão” é a retirada desse registro, feita quando o título é quitado ou renegociado. 01. 1. VISÃO GERAL 1. Visão Geral “Negativação SERASA” é o processo pelo qual a empresa registra clientes inadimplentes (títulos vencidos e não pagos) no birô de crédito SERASA, como mecanismo de cobrança; a “exclusão” é a retirada desse registro, feita quando o título é quitado ou renegociado. Este relatório lista os títulos a receber que tiveram movimentação de inclusão e/ou exclusão no SERASA dentro de um período, mostrando cliente, vendedor, título, datas e valores — usado pela área de cobrança/crédito para acompanhar quais clientes foram negativados, quais tiveram a negativação retirada, e a situação atual de cada título envolvido. 02. 2. COMO ACESSAR 2. Como Acessar Menu Financeiro > Relatórios (rotina “WRSER001”). 03. 3. PARÂMETROS DE FILTRO 3. Parâmetros de Filtro Parâmetro Obrigatório Tipo de controle Operador O que filtra prmFilial Sim Lista de seleção (múltipla) Contido em Filiais dos títulos prmDataEmissao Sim Intervalo de datas Entre Data de emissão do título prmDataVencimento Não Intervalo de datas Entre Data de vencimento do título prmCarteira Não Lista de seleção (múltipla) Contido em Carteira do título prmVendedorInicial / prmVendedorFinal Não Lista de seleção Contido em Faixa de código de vendedor prmParticipanteInicial / prmParticipanteFinal Não Lista de seleção Contido em Faixa de código de cliente/participante prmStatusTitulo Não Lista de seleção Igual Status do título: Aberto ou Liquidado prmStatusSerasa Não Lista de seleção Igual Tipo de movimento SERASA: Inclusão ou Exclusão Atenção — inconsistência encontrada no código: os filtros de faixa de vendedor e de participante (final da faixa) apresentam um comportamento que pode não corresponder ao esperado — o código usa a variável do valor inicial em vez do valor final ao montar o filtro do vendedor. Recomenda-se validar com o time técnico o comportamento real ao usar esses dois filtros de faixa antes de confiar cegamente nos resultados filtrados por vendedor. 04. 4. TABELAS E VIEWS UTILIZADAS 4. Tabelas e Views Utilizadas Entidade/Classe C# Tabela/View real no banco O que representa ViewDeTitulosAReceber VWATAK4NET_TITULOS_A_RECEBER View com os títulos a receber, já com saldo, status e datas calculadas MovimentacaoFinanceira TBMOVTOFIN Lançamentos financeiros — usada para localizar os lançamentos de inclusão/exclusão no SERASA BancoCaixa TBBANCOCAIXA Cadastro de carteiras — usada para restringir aos lançamentos feitos contra uma carteira do tipo “Serasa” 05. 5. REGRAS DE NEGÓCIO E CÁLCULOS 5. Regras de Negócio e Cálculos Filtro dos títulos. O relatório parte dos títulos a receber filtrados por filial, data de emissão, data de vencimento, carteira, faixa de vendedor, faixa de cliente e status do título. Movimentos de inclusão e exclusão. São considerados apenas os lançamentos financeiros cuja operação seja especificamente de inclusão ou exclusão de negativação SERASA, e que tenham sido lançados contra uma carteira cadastrada como do tipo “Serasa” — a negativação sempre passa por uma carteira específica configurada para esse fim. Cruzamento título × movimento. O sistema cruza os títulos com os movimentos de inclusão (formando a lista de títulos incluídos no SERASA) e, separadamente, com os movimentos de exclusão (títulos excluídos). Montagem do resultado. Para um título que teve inclusão e depois exclusão, o relatório gera duas linhas: uma de “Inclusão” e uma de “Exclusão”, cada uma com a data e os dados do respectivo movimento. Títulos que só tiveram inclusão (sem exclusão) ainda geram uma segunda linha “Exclusão” reaproveitando os dados da inclusão — comportamento a validar com o time de negócio, pois pode não refletir a intenção original do relatório (títulos sem exclusão real aparecendo com uma linha de “Exclusão”). Títulos que só têm exclusão geram apenas essa linha. Remoção de duplicidade. Ao final, o resultado é agrupado e filtrado para eliminar linhas duplicadas que possam surgir do cruzamento entre títulos e movimentos. 06. 6. COLUNAS PRINCIPAIS DO RESULTADO 6. Colunas Principais do Resultado Campo Descrição de negócio LetraSerasa / TipoDeOperacao Indicador (I/E) e descrição textual do movimento — “Inclusão” ou “Exclusão” Cod_cli_for / Nome_cli_for Código e nome do cliente negativado Cod_vendedor / Nome_vendedor Vendedor responsável pela venda de origem cod_filial, cod_docto, serie_docto, num_docto, num_parcela Identificação do documento/parcela do título Data_emissao / Data_vencto Datas de emissão e vencimento do título Valor_titulo / Valor_saldo Valor original e saldo em aberto do título DataDoLancamentoInclusao / DataDoLancamentoExclusao Datas em que ocorreram os lançamentos de inclusão/exclusão no SERASA Num_remessa_Inclusao / Num_remessa_Exclusao Número da remessa enviada ao SERASA para inclusão/exclusão Status_titulo Situação atual do título (Aberto/Liquidado) Cod_carteira / Nome_carteira Carteira/agência SERASA usada no lançamento ValorDoLancamentoDC Valor do lançamento financeiro (débito/crédito) da movimentação SERASA

WRBNC090 – Conferência Diária Vendas Cupom Loja

Documentação Técnica WRBNC090 — Conferência Diária Vendas Cupom Loja É o relatório de fechamento/conferência do caixa diário de uma loja (frente de caixa/PDV), usado para conferir o movimento de cupons fiscais (vendas) emitidos em um dia específico contra os meios de pagamento recebidos, parcelamentos, descontos e trocos. 01. 1. VISÃO GERAL 1. Visão Geral É o relatório de fechamento/conferência do caixa diário de uma loja (frente de caixa/PDV), usado para conferir o movimento de cupons fiscais (vendas) emitidos em um dia específico contra os meios de pagamento recebidos, parcelamentos, descontos e trocos. Mostra, por equipamento fiscal e por operador de caixa, a Redução Z, os totais por meio de pagamento, os cupons por status (faturado, cancelado etc.) e eventuais cupons ainda não atualizados contabilmente. É usado pela retaguarda/tesouraria para bater se o caixa da loja fechou corretamente no fim do dia. 02. 2. COMO ACESSAR 2. Como Acessar Menu Financeiro > Relatórios (rotina “WRBnc090”). 03. 3. PARÂMETROS DE FILTRO 3. Parâmetros de Filtro Parâmetro Obrigatório Tipo de controle Operador O que filtra prmFilial Sim Seleção Igual Filial (loja) do movimento prmDataMovimento Sim Data Igual Data do movimento de caixa a conferir prmEqpto Não Texto Igual Código do equipamento fiscal (ECF/impressora fiscal) prmFuncionario Não Texto Igual Código do funcionário/operador de caixa prmCupom Não Lista de seleção Igual Tipo/status do cupom (ex: faturado, cancelado, Redução Z, todos) prmImprimePreVenda Não Lista de seleção Igual Se inclui o detalhamento das pré-vendas vinculadas prmImprimeParcelamento Não Lista de seleção Igual Se exibe o detalhamento do parcelamento dos pagamentos prmAgrupaCuponsMeioPagamento Não Lista de seleção Igual Se agrupa os cupons detalhados por meio de pagamento em vez de listar um por um 04. 4. TABELAS E VIEWS UTILIZADAS 4. Tabelas e Views Utilizadas Entidade/Classe C# Tabela real no banco O que representa CupomFiscal TBCUPOMFISCAL Cabeçalho dos cupons fiscais emitidos CupomFiscalItem TBCUPOMFISCALITEM Itens de cada cupom fiscal CupomFiscalParcela (consulta SQL) TBCUPOMPARCELA Parcelas/formas de pagamento de cada cupom Saida TBSAIDAS Documento de saída (venda) vinculado ao cupom TituloAReceber TBTITULOREC Título a receber gerado a partir da venda, quando parcelado CadastroGeral TBCADASTROGERAL Cliente/participante da venda SequenciaDeNumeracao TBSEQUENCIA Sequência de numeração de documentos, usada para restringir aos modelos fiscais de NFC-e/NF-e Consulta SQL adicional TBFORMACOB Forma de cobrança do pagamento 05. 5. REGRAS DE NEGÓCIO E CÁLCULOS 5. Regras de Negócio e Cálculos Escopo de documentos. O relatório considera apenas documentos fiscais dos modelos NFC-e/NF-e (modelos “61”, “65”, “55”, “33”), da filial e data informadas. Troco não é duplicado. Quando um cupom tem mais de uma forma de pagamento, o valor de troco é zerado nas linhas repetidas do mesmo cupom, para não ser somado mais de uma vez ao total. Operações canceladas não entram no valor. Cupons com status de cancelamento em operações de débito/estorno têm o valor tratado como zero, para não distorcer os totais do dia. Redução Z. O sistema monta o fechamento do equipamento fiscal (Redução Z) agrupando por equipamento, série, filial e data, calculando a venda bruta e líquida (valor pago menos troco) e os totais de desconto e encargos do dia. Resumo por meio de pagamento. Os valores são agrupados por meio de pagamento e tipo de financiamento, somando os valores pagos e trocos; uma linha “TROCO” totaliza o valor de troco a ser deduzido do total recebido. Pré-vendas (opcional). Quando solicitado, o relatório também lista as pré-vendas vinculadas aos cupons do dia. Cupons por status e por colaborador. O relatório agrupa os cupons tanto pelo status (faturado, cancelado etc.) quanto pelo operador de caixa responsável, tanto para o total geral quanto especificamente para cupons NFC-e. Pendência de contabilização. Cupons já faturados, mas ainda não contabilizados no sistema, são identificados separadamente como pendência de conferência. Agrupamento por meio de pagamento (opcional). Se solicitado, os cupons detalhados são consolidados por meio de pagamento em vez de aparecer um por um. 06. 6. COLUNAS PRINCIPAIS DO RESULTADO 6. Colunas Principais do Resultado Campo Descrição de negócio IdDaFilial / CodEquipto / SerieEquipto Loja e equipamento fiscal que emitiu o cupom Cupom / Serie / Status Identificação e situação do cupom (faturado, cancelado etc.) ChaveDeFato / CodigoDoDocumento Chave de rastreio do documento gerado MeioDePagamento Forma de pagamento usada na venda ValorCupom / ValorTotal / ValorTroco / ValorDoDesconto / ValorDosEncargos Valores financeiros do cupom ValorReceber / SaldoReceber Valor e saldo do título a receber gerado, quando parcelado NumParcela Número da parcela do pagamento StatusCTB Indica se o cupom já foi contabilizado NomeColaborador / CodColaborador Operador de caixa/vendedor responsável (nos agrupamentos por colaborador) Os subrelatórios de Redução Z, Meios de Pagamento, Pré-vendas e agrupamentos por Status/Colaborador usam as mesmas tabelas listadas acima — não introduzem novas fontes de dados.

WRBNC011 – Movimentação Financeira por Carteira e Conta Contábil

Documentação Técnica WRBNC011 — Movimentação Financeira por Carteira e Conta Contábil Mostra a movimentação financeira (entradas e saídas de caixa/banco) de um período, agrupada por carteira (banco/caixa) e classificada pela conta contábil associada a cada operação. 01. 1. VISÃO GERAL 1. Visão Geral Mostra a movimentação financeira (entradas e saídas de caixa/banco) de um período, agrupada por carteira (banco/caixa) e classificada pela conta contábil associada a cada operação. É usado pelo analista financeiro para conferir o que entrou e saiu de cada carteira, já organizado pela conta contábil correspondente — pode ser gerado em layout sintético (só totais por conta) ou analítico (lançamento a lançamento). Opcionalmente também mostra o saldo bancário do último fechamento como referência inicial. 02. 2. COMO ACESSAR 2. Como Acessar Menu Financeiro > Relatórios (rotina “WRBnc011”). 03. 3. PARÂMETROS DE FILTRO 3. Parâmetros de Filtro Parâmetro Obrigatório Tipo de controle Operador O que filtra prmFilial Não Lista de seleção (múltipla) Contido em Filiais incluídas na movimentação lkCarteira Não Lista de seleção (múltipla) Contido em Carteiras (contas bancárias/caixas) incluídas prmDataLancamento Não Intervalo de datas Entre Data de lançamento (de/até) prmConsideraSaldoConciliado Não Lista de seleção Igual Considera apenas lançamentos conciliados, apenas não conciliados, ou todos prmEmiteLancamentoNaoConciliado Não Lista de seleção Igual Declarado na tela, mas não tem efeito sobre o resultado (ver “Regras de Negócio”, Regra 5) prmCodigoMoeda Não Lista de seleção Igual Se o valor exibido é na moeda corrente ou em moeda alternativa/estrangeira prmImprimeSaldoBanco Não Lista de seleção Igual Se/como exibe o saldo bancário do último fechamento (não considerar, total, ou detalhado por banco) prmModeloRelatorios Sim Lista de seleção Igual Layout: Sintético (totais por conta) ou Analítico (lançamento a lançamento) prmOperacaoFinanceirasDesconsideradas Não Lista de seleção (múltipla) Contido em Operações financeiras a excluir da movimentação prmCodConta Não Pesquisa (F8) Entre Faixa de código de conta contábil a incluir 04. 4. TABELAS E VIEWS UTILIZADAS 4. Tabelas e Views Utilizadas Entidade/Origem Tabela/View real no banco O que representa SaldoBanco TBSALDOBCO Saldo diário de cada banco/caixa (usada apenas para o bloco opcional de saldo bancário) Consulta principal (SQL direto, não passa por Entity Framework) tbmovtofin, tbtitulorec, tbtitulopag, tbplanoconta, tbcadastrogeral Movimentação financeira, títulos a receber e a pagar (para determinar a conta contábil de origem), plano de contas e cadastro de carteiras/participantes O corpo principal deste relatório roda uma consulta SQL montada diretamente no código (não passa pela camada padrão de consultas do sistema) — por isso os nomes de tabela aparecem em minúsculo, como estão gravados no banco. 05. 5. REGRAS DE NEGÓCIO E CÁLCULOS 5. Regras de Negócio e Cálculos Filtro base da movimentação. O relatório considera lançamentos da tabela de movimentação financeira que afetam o módulo Bancário/Financeiro, dentro da filial, período e carteira informados, excluindo as operações financeiras marcadas para desconsiderar. Entradas e saídas. Cada lançamento é classificado como “Entradas” (partida devedora) ou “Saídas” (partida credora); o valor das saídas é invertido (negativo) para o cálculo do total. Origem da conta contábil. A conta contábil exibida para cada lançamento segue uma ordem de prioridade: primeiro a conta vinculada ao título a receber relacionado, depois a conta do título a pagar relacionado, e só então a conta gravada diretamente na própria movimentação financeira — refletindo de onde vem a classificação contábil da operação. Filtro de conciliação. Se solicitado, o relatório restringe o resultado apenas a lançamentos já conciliados com o extrato bancário, ou apenas aos não conciliados. Parâmetro sem efeito. O parâmetro “Emite Lançamento Não Conciliado” aparece na tela de filtros, mas não é utilizado em nenhum ponto do cálculo do relatório — sua seleção não altera o resultado. Recomenda-se validar com o time técnico se essa é uma funcionalidade pendente de implementação. Modo de exibição. No modo “Sintético”, os lançamentos são agrupados e somados por conta contábil, sem detalhar cada um; no modo “Analítico”, cada lançamento aparece em uma linha própria. Saldo bancário (opcional). Quando solicitado, o relatório soma o saldo do último fechamento registrado de cada banco/caixa, podendo detalhar banco a banco ou apenas exibir o total. 06. 6. COLUNAS PRINCIPAIS DO RESULTADO 6. Colunas Principais do Resultado Campo Descrição de negócio operacao “Entradas” ou “Saídas” cod_conta / desc_conta / cod_reduz_conta Código, descrição e código reduzido da conta contábil do lançamento total_conta (modo sintético) / valor_lancto_dc (modo analítico) Valor do lançamento, já com o sinal de entrada/saída apelido_cp Nome/apelido da carteira (banco/caixa) associada data_lancto / num_lancto / complemento / operfin Dados do lançamento individual (modo analítico) IdDoBancoCaixa / NomeDoBancoCaixa / ValorDoSaldo / DataDoSaldo Bloco de saldo bancário do último fechamento SaldoTotalBanco Total consolidado do saldo bancário

WRBNC010 – Fluxo de Caixa

Documentação Técnica WRBNC010 — Fluxo de Caixa Projeta a posição de caixa da empresa ao longo do tempo: parte do saldo bancário atual e soma/subtrai os títulos a receber e a pagar em aberto, organizados por mês (3 meses antes, o mês informado, e 3 meses depois), mostrando o saldo acumulado projetado. 01. 1. VISÃO GERAL 1. Visão Geral Projeta a posição de caixa da empresa ao longo do tempo: parte do saldo bancário atual e soma/subtrai os títulos a receber e a pagar em aberto, organizados por mês (3 meses antes, o mês informado, e 3 meses depois), mostrando o saldo acumulado projetado. Também resume o total já vencido e o total ainda a vencer, tanto a receber quanto a pagar. Diferente dos relatórios WRBNC002/003/004 (que reaproveitam o WRBNC001), este relatório tem consulta própria — embora reutilize as mesmas views de Títulos a Receber e a Pagar já usadas em outros relatórios financeiros. 02. 2. COMO ACESSAR 2. Como Acessar Menu Financeiro > Relatórios (rotina “WRBnc010”). 03. 3. PARÂMETROS DE FILTRO 3. Parâmetros de Filtro Parâmetro Obrigatório Tipo de controle Operador O que filtra prmFilial Não Lista de seleção (múltipla) Contido em Uma ou mais filiais prmAno Sim Número Igual Ano de referência do período consultado prmMes Sim Número Igual Mês de referência — junto com o ano define o mês-base do fluxo (a janela de 3 meses antes/depois é calculada a partir dele) prmTipoDocumentoAReceber Não Lista de seleção (múltipla) Contido em Tipo(s) de documento de contas a receber prmTipoDocumentoAPagar Não Lista de seleção (múltipla) Contido em Tipo(s) de documento de contas a pagar prmFormaDeCobranca Não Lista de seleção (múltipla) Contido em Forma(s) de cobrança dos títulos a receber prmFormaDePagamento Não Lista de seleção (múltipla) Contido em Forma(s) de pagamento dos títulos a pagar prmNaturezaAReceber Não Lista de seleção Igual Natureza do título a receber (“T” = todas) prmNaturezaAPagar Não Lista de seleção Igual Natureza do título a pagar (“T” = todas) prmConsideraDiaUtil Não Lista de seleção Igual Se usa a data de vencimento ajustada para dia útil ou a data de vencimento corrida prmTipoDeMovimento Não Texto Igual Tipo(s) de movimento cujos documentos (pedidos ainda não faturados) substituem lançamentos equivalentes já previstos 04. 4. TABELAS E VIEWS UTILIZADAS 4. Tabelas e Views Utilizadas Entidade/Classe C# Tabela/View real no banco O que representa ViewDeTitulosAReceber VWATAK4NET_TITULOS_A_RECEBER Títulos a receber (usada para saldo anterior, títulos dentro da janela e títulos posteriores) ViewDeTitulosAPagar VWATAK4NET_TITULOS_A_PAGAR Títulos a pagar (mesma lógica, espelhada) SaldoBanco TBSALDOBCO Saldo bancário do último fechamento registrado Consulta de documentos por tipo de movimento (serviço especializado) (não mapeada nesta análise — usada apenas quando “Tipo de Movimento” é informado) Pedidos/documentos ainda não faturados, usados como previsão de parcela 05. 5. REGRAS DE NEGÓCIO E CÁLCULOS 5. Regras de Negócio e Cálculos Janela de 6 meses. O relatório monta uma janela ao redor do mês/ano informado: 3 meses antes e 3 meses depois, além do próprio mês-base. Saldo bancário atual. Soma o saldo do último fechamento registrado por carteira, considerando apenas contas marcadas para entrar no fluxo de caixa. Saldo anterior a receber e a pagar. Soma os títulos em aberto com vencimento anterior ao início da janela; documentos que começam com “AD” (adiantamento) entram com valor invertido. Títulos dentro da janela. Lista os títulos a receber/pagar em aberto com data de emissão e vencimento dentro da janela de 6 meses, já ajustados pelo prazo de liberação de cobrança (dias adicionais até o valor ficar efetivamente disponível). Títulos além da janela. Títulos a receber com vencimento posterior ao fim da janela entram apenas no total acumulado, sem detalhamento mês a mês. Previsão por tipo de movimento. Quando informado, documentos/pedidos ainda não faturados daquele tipo substituem lançamentos equivalentes já previstos, evitando contar duas vezes o mesmo valor. Agrupamento por período. O resultado é organizado em três blocos: antes da janela central de 3 meses, dentro da janela (agrupado mês a mês), e depois da janela; o mês central é agrupado por data de vencimento exata (dia a dia). Saldo acumulado. Percorrendo os grupos em ordem cronológica, o relatório calcula o saldo acumulado a receber, a pagar e o saldo total projetado, partindo do saldo bancário inicial. Resumos complementares. O relatório também apresenta um resumo do saldo por banco/caixa e um resumo comparando o total já vencido com o total ainda a vencer (tanto a receber quanto a pagar), tomando como referência a data atual do usuário. 06. 6. COLUNAS PRINCIPAIS DO RESULTADO 6. Colunas Principais do Resultado Campo Descrição de negócio NomeMesAnterior / NomeMesPosterior / DataAnteriorPosterior Identificação do mês do agrupamento (antes/depois da janela central) DataDeVencimento Data de vencimento (já ajustada pelo prazo de liberação, quando aplicável) ValorDoTituloaReceber / ValorDoTituloaPagar Valor do título a receber/pagar ValorDoSaldo Saldo líquido do agrupamento (a receber menos a pagar) SaldoAcumuladoAReceber / SaldoAcumuladoAPagar / TotalDeSaldoAcumulado Saldo projetado acumulado ao longo do tempo TipoDoGrupo Indica se o agrupamento é antes, dentro, ou depois da janela central Titulo / IdDoDocumento Identificação do título/documento IdDoParticipante / NomeDoParticipante / IdDoGrupoCliente / NomeDoGrupoCliente Cliente/fornecedor (ou grupo econômico) do título IdDaCarteira / NomeDaCarteira Carteira/conta bancária vinculada IdDaContaResultado / NomeDaContaResultado Conta de resultado contábil associada Natureza Natureza/categoria do título Subrelatório de saldo bancário: IdDoBancoCaixa, NomeDoBancoCaixa, DataDoSaldo, ValorDoSaldo. Subrelatório de vencido x a vencer: VencidosPagar, VencidosReceber, AVencerPagar, AVencerReceber, TotalRPB (saldo bancário total).

Movimentação Financeira por Carteira – Conciliado

Documentação Técnica WRBNC009 — Movimentação Financeira por Carteira – Conciliado Exibe a movimentação bancária (entradas e saídas) de cada carteira/conta em um período, mostrando saldo anterior, lançamentos do período e saldo resultante — voltado à conferência da posição bancária já batida com o extrato. 01. 1. VISÃO GERAL 1. Visão Geral Exibe a movimentação bancária (entradas e saídas) de cada carteira/conta em um período, mostrando saldo anterior, lançamentos do período e saldo resultante — voltado à conferência da posição bancária já batida com o extrato. É uma variação do “WRBNC006 – Movimentação Financeira por Carteira” com dois comportamentos travados internamente: sempre considera o saldo conciliado, e nunca exibe lançamentos ainda não conciliados, independentemente do que for informado na tela — ou seja, mostra sempre a posição já confirmada com o banco, nunca pendências de conciliação. 02. 2. COMO ACESSAR 2. Como Acessar Menu Financeiro > Relatórios (rotina “WRBnc009”). 03. 3. PARÂMETROS DE FILTRO 3. Parâmetros de Filtro Parâmetro Obrigatório Tipo de controle Operador O que filtra prmFilial Não Lista de seleção (múltipla) Contido em Uma ou mais filiais prmDataLancamento Não Intervalo de datas Entre Período de lançamento prmCarteiraWRBNC009 Não Lista de seleção (múltipla) Contido em Carteira(s)/conta(s) bancária(s) prmEmiteLancamentoNaoConciliado Não Lista de seleção Igual Aparece na tela, mas sem efeito — o relatório sempre se comporta como se esse parâmetro fosse “Não” (ver “Regras de Negócio”, Regra 1) prmCodigoMoeda Não Lista de seleção Igual Moeda corrente ou estrangeira dos valores exibidos prmConsultarPorDataDeConciliacao Não Lista de seleção Igual Se filtra pela data em que os lançamentos foram conciliados, em vez da data de lançamento prmReparteLancamentoAnterioresConciliados Não Lista de seleção Igual Se distribui/reclassifica lançamentos anteriores conciliados dentro do período consultado 04. 4. TABELAS E VIEWS UTILIZADAS 4. Tabelas e Views Utilizadas Este relatório não executa nenhuma consulta própria — internamente ele instancia o relatório “WRBNC006” e delega a ele toda a obtenção dos dados, sempre passando “Considera Saldo Conciliado = Sim” e “Emite Lançamento Não Conciliado = Não” fixos. As tabelas/views usadas por trás (TBSALDOBCO, vwAtak4Net_movtofin_banco, TBMOVTOFIN, TBTITULOPAG, TBCHEQUE) são as mesmas documentadas na ficha do WRBNC006. 05. 5. REGRAS DE NEGÓCIO E CÁLCULOS 5. Regras de Negócio e Cálculos Comportamento travado. Independentemente do que for selecionado na tela, este relatório sempre considera o saldo conciliado no cálculo e nunca exibe a seção de lançamentos ainda não conciliados — o parâmetro “Emite Lançamento Não Conciliado” é lido, mas seu valor é ignorado internamente. Saldo anterior. Soma o saldo bancário na data anterior ao início do período, por carteira, sempre calculando também a versão conciliada do saldo. Cheques a compensar. Assim como no WRBNC006, lista os cheques emitidos para pagamento ainda não conciliados, vinculados ao respectivo título a pagar em aberto. Lançamentos do período. Movimentações bancárias dentro do intervalo informado, filtradas pela data de lançamento ou pela data de conciliação, conforme o parâmetro escolhido. Lançamentos anteriores conciliados. Lançamentos lançados antes do início do período, mas conciliados dentro dele — só calculado quando não se está consultando por data de conciliação nem repartindo lançamentos anteriores. Moeda estrangeira. Todos os valores possuem uma versão em moeda estrangeira, exibida conforme o parâmetro de moeda selecionado. 06. 6. COLUNAS PRINCIPAIS DO RESULTADO 6. Colunas Principais do Resultado Campo Descrição de negócio IdDaCarteira / NomeDaCarteira Conta bancária/carteira SaldoAnteriorReal / SaldoAnteriorConciliado Saldo de abertura do período (real e conciliado) DataDaConciliacao / DataDoLancamento Datas de conciliação e de lançamento ChaveDefato / ChaveDeFatoTitulo Identificadores do lançamento e do título de origem TipoDePartida / StatusConciliado Débito/crédito e se já foi conciliado IdDoDocumento / SerieDoDocumento / NumeroDoDocumento / NumeroDoLancamento / NumeroDaParcela Identificação do documento/parcela Complemento Histórico do lançamento ValorDoLancamentoDC / ValorDoLancamentoConciliado Valor do lançamento e sua parcela já conciliada ValorCredito / ValorDebito Valores segregados de crédito e débito DocumentoDaOperacao / IdDaOperacaoFinaceira Operação financeira associada ao lançamento NomeDeCadastroNoTitulo Nome do cliente/fornecedor no título TotalValorCredito / TotalValorDebito / TotalLancamentoConciliadosNoPeriodo Totais por carteira (linhas de subtotal) NivelDoRelatorio Seção do relatório (saldo anterior, lançamentos do período, cheques a compensar, etc.)

WRBNC008 – Fechamento Diário Detalhado

Documentação Técnica WRBNC008 — Fechamento Diário Detalhado O relatório WRBNC008 — Fechamento Diário Detalhado mostra, para um período de datas selecionado, o detalhe lançamento a lançamento das movimentações de Contas a Receber, Contas a Pagar e Controle Bancário que compuseram o fechamento do dia. 01. 1. VISÃO GERAL DA ROTINA 1. Visão Geral da Rotina O relatório WRBNC008 — Fechamento Diário Detalhado mostra, para um período de datas selecionado, o detalhe lançamento a lançamento das movimentações de Contas a Receber, Contas a Pagar e Controle Bancário que compuseram o fechamento do dia. Ao contrário do “WRBNC005 – Fechamento Diário” (que exibe apenas os saldos consolidados por tipo de documento/carteira), este relatório relaciona cada movimentação individual — data, valor, participante, documento — dentro desses grupos, servindo para o analista financeiro auditar quais lançamentos específicos formaram o saldo do dia. Reaproveita integralmente a consulta e as regras de cálculo do WRBNC005; a diferença é que, em vez de agregar por saldo, lista as movimentações uma a uma. Geração: disponível no módulo Financeiro, gerado via Crystal Reports a partir da tela de parâmetros padrão do sistema. 02. 2. VÍDEO TUTORIAL 2. Vídeo Tutorial ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03. 3. PRÉ-REQUISITOS E CONTEXTO DE ACESSO 3. Pré-requisitos e Contexto de Acesso O acesso é controlado pelo recurso “WRBnc008” (ID 50969), vinculado ao menu do módulo Financeiro. Mesmos pré-requisitos de dados do WRBNC005. 04. 4. PROCESSO DE GERAÇÃO — PASSO A PASSO 4. Processo de Geração — Passo a Passo Passo 1: Acessar o relatório No menu do módulo Financeiro, o usuário acessa “WRBNC008 – Fechamento diário detalhado”. Passo 2: Informar a filial (opcional) “prmFilial” — uma ou mais filiais. Passo 3: Informar o período de lançamento “prmDataLancamento” — intervalo de datas. Passo 4: Escolher quais módulos entram no relatório “prmTipoModulo” — Contas a Receber, Contas a Pagar e/ou Banco (aceita mais de um). Passo 5: Filtrar tipo de documento ou carteira (opcional) “prmTipoDocumento” (aplicado às linhas de Contas a Receber/Pagar) e “prmCarteira” (aplicado às linhas de Banco). Passo 6: Escolher o formato de apresentação “prmFormato” — não altera os dados retornados, só a exibição no layout. Passo 7: Gerar o relatório O sistema processa e apresenta o detalhamento lançamento a lançamento. 05. 5. DESCRIÇÃO DE CADA CAMPO DA TELA 5. Descrição de Cada Campo da Tela Parâmetro: prmFilial Tipo: lista de seleção (múltiplos) Obrigatoriedade: opcional Descrição: Uma ou mais filiais. Comportamento: Sem seleção, considera todas. Impacto: Determina o universo de lançamentos exibidos. — Parâmetro: prmDataLancamento Tipo: intervalo de datas Obrigatoriedade: opcional Descrição: Período de lançamento. Comportamento: Reaplica o filtro de data (“DataDeLancamento” entre a véspera do início e o fim do período) sobre a base já calculada pelo WRBNC005. Impacto: Delimita quais lançamentos individuais aparecem. — Parâmetro: prmTipoDocumento Tipo: lista de seleção (múltiplos) Obrigatoriedade: opcional Descrição: Tipo(s) de documento a incluir. Comportamento: Aplicado somente às linhas de Contas a Receber/Pagar. Impacto: Restringe o detalhamento a determinados tipos de documento. — Parâmetro: prmCarteira Tipo: lista de seleção (múltiplos) Obrigatoriedade: opcional Descrição: Carteira(s)/conta(s) bancária(s) a incluir. Comportamento: Aplicado somente às linhas de Banco. Impacto: Restringe o detalhamento bancário a determinadas contas. — Parâmetro: prmTipoModulo Tipo: lista de seleção Obrigatoriedade: opcional Descrição: Quais módulos entram no relatório: Contas a Receber, Contas a Pagar e/ou Banco. Comportamento: Apesar do operador declarado como “Igual”, o código itera a lista permitindo mais de um valor selecionado simultaneamente. Impacto: Define quais dos três blocos aparecem detalhados no relatório. — Parâmetro: prmFormato Tipo: lista de seleção Obrigatoriedade: obrigatório Descrição: Opção de formato de apresentação do relatório. Comportamento: Repassado ao dado de saída como uma flag; não filtra nem altera os dados retornados. Impacto: Afeta apenas a apresentação no layout impresso, não o conteúdo. 06. 6. UTILIZAÇÃO E CONSULTA DE REGISTROS 6. Utilização e Consulta de Registros O relatório não tem tela de busca própria; os parâmetros de geração definem inteiramente o conteúdo apresentado. 07. 7. PROCESSO DE EDIÇÃO 7. Processo de Edição O relatório não é editável — é saída de leitura/impressão gerada a partir de lançamentos já registrados em outras rotinas do sistema. 08. 8. ESTRUTURA TÉCNICA E COMPORTAMENTO DO SISTEMA 8. Estrutura Técnica e Comportamento do Sistema Gerado pelo Crystal Reports a partir de “~/Relatorios/WRBnc/WRBnc008.rpt”. A classe “WRBNC008” não consulta o banco diretamente: delega 100% da busca de dados para “WRBNC005.ObterRelatorioPrincipal” e depois filtra o resultado, mantendo apenas as linhas de movimentação (lançamento individual) de Contas a Receber, Contas a Pagar e Banco — o bloco de Estoque do WRBNC005 não é utilizado neste relatório. 09. 9. REGRAS DE NEGÓCIO E RESTRIÇÕES 9. Regras de Negócio e Restrições Regra 1 — Reaproveitamento do WRBNC005 com foco em lançamentos O relatório parte do resultado do WRBNC005 (que já separa a base em Contas a Receber, Contas a Pagar, Controle Bancário e Estoque) e mantém apenas as linhas de movimentação de Contas a Receber, Contas a Pagar e Banco. Regra 2 — Filtro por módulo Para cada módulo selecionado, o relatório filtra as linhas correspondentes, aplicando opcionalmente o filtro de tipo de documento (Contas a Receber/Pagar) ou de carteira (Banco). Regra 3 — Sem lançamentos Se a combinação de filtros não retornar nenhum lançamento, o relatório exibe uma linha “Nenhum Lançamento no período”. Regra 4 — Tradução da operação financeira O código da operação financeira de cada lançamento é traduzido para sua descrição de negócio antes de ser exibido. Regra 5 — Resumo por operação financeira Um subrelatório resume os lançamentos agrupados por operação financeira, somando o valor total e segregando em crédito e débito. Regra 6 — Ordenação O resultado final é ordenado por data de lançamento e, dentro da mesma data, pela chave de identificação do lançamento. — WRBNC008 — Fechamento Diário Detalhado 10. 1. VISÃO GERAL 1. Visão Geral Mostra, para um período de datas selecionado, o detalhe lançamento a lançamento das movimentações de Contas a Receber, Contas a Pagar e Controle Bancário que compuseram o fechamento do dia. Ao contrário do “WRBNC005 – Fechamento Diário” (que exibe apenas os saldos consolidados

Transferência Entre Contas

Documentação Técnica Manual Técnico — Transferência Entre Contas (ERP Atak CORE V1) Árvore no ERP: FINANCEIRO > Transferências > Entre contas Árvore no ERP: FINANCEIRO > Transferências > Entre contas Recurso: 1557 (pai 1554 — Transferências) Rota / Tela: EditViewDeTransferenciaEntreContas Versão: ERP Atak CORE V1 Gerado em: 2026-09-09 15h16m — 01. 1. VISÃO GERAL 1. Visão Geral A rotina “Entre contas” realiza a transferência de valor entre duas contas bancárias / carteiras financeiras do ERP. O usuário parte da carteira em que está logado (carteira de origem) e informa a carteira de destino, o valor e a data de lançamento. O sistema gera as movimentações financeiras de saída e entrada, e a respectiva integração contábil, sob um único código de operação (Chave de Fato). A rotina atende três cenários distintos, todos no mesmo fluxo: Transferência simples (mesma filial, sem cheque) — gera 2 movimentações financeiras. Transferência com mútuo (filial de origem diferente da filial de destino, sem cheque) — gera 4 movimentações financeiras, sendo 2 de transferência e 2 de mútuo (operação 38 – MÚTUO/BCOMUT), passando pelas carteiras de lançamento de mútuo das filiais. Transferência com geração de cheques próprios — gera a movimentação de saída com variação “Cheque a Prazo de Transferência” e, para cada cheque informado, um Título a Pagar, um Cheque e a movimentação financeira correspondente. Camadas envolvidas Camada Artefato Frontend (ExtJS) ERPAtak.APP\app\view\dominio\Financeiro\Transferencia\TransferenciaEntreContas\ (5 views) e app\controller\dominio\Financeiro\Transferencia\ControllerDeTransferenciaEntreContas.js Controller (MVC) ATAK.CORE\Controllers\Financeiro\Transferencia\TransferenciaEntreContasController.cs Serviço de Aplicação ATAK.ServicoDeAplicacao.Implementacao\Financeiro\LancamentosDaMovimentacaoFinanceira\Operacoes\Transferencias\ServicoDeTransferenciaEntreContas.cs Validações compartilhadas …\Operacoes\Base\Validacoes.cs (ValidarDadosParaMutuo) DTOs ATAK.DTO\Financeiro\OperacoesFinanceiras\DTOCabecalhoDeOperacoes.cs, DTODeTituloAProcessar.cs, DTODeChequesProprios.cs Consultas IConsultaDeMovimentacaoFinanceiraComprovantes, IConsultaDeViewMovimentacaoContabilFinanceiro, IConsultaDeCheque Mensagens ATAK.Exception\Base\Linguagens\Portugues.cs Permissões ATAK.Dominio\…\RecursosDisponiveis\Classes\RecursosGeraisFinanceiro.cs Fluxo do assistente (wizard de 5 passos) O frontend é um assistente (AssistenteBaseController) com a descrição “Transferência entre Contas”: Passo Título Observação 1 Informações Dados da transferência. Único passo obrigatório quando “Gerar Cheque” = Não. 2 Cheques próprios Parâmetros de geração automática dos cheques. Só é percorrido quando “Gerar Cheque” = Sim. 3 Conferência de cheques próprios Grade dos cheques gerados, com totalizadores. 4 Conferência de cheques Grade final de conferência antes da gravação. 5 Comprovante Resultado da operação: movimentações financeiras, lançamentos contábeis e cheques gerados. — 02. 2. ENDPOINTS 2. Endpoints Roteamento convencional {controller}/{action}/{id}. Controller: TransferenciaEntreContasController. 2.1 POST TransferenciaEntreContas/Salvar Ação principal da rotina. Recebe o cabeçalho da operação e efetiva a transferência. Assinatura: public ActionResult Salvar(DTOCabecalhoDeOperacoes dto) Comportamento: Se dto.TitulosAProcessar for nulo ou vazio, dispara a mensagem OPERACAO_CANCELADA_ALGUNS_DADOS_PODEM_ESTAR_INCORRETOS e retorna null (nenhum registro é criado). Caso contrário, chama IServicoDeTransferenciaEntreContas.Processar(…) passando apenas o primeiro item de TitulosAProcessar (a rotina trata uma única transferência por execução), somado à data de movimentação e ao usuário obtidos de UsuarioDaAplicacao. Com o código da operação retornado, consulta: IConsultaDeCheque.ObterPorIntegracao(idDaMovimentacao) IConsultaDeMovimentacaoFinanceiraComprovantes.ObterMovimentacoesPorCodigoDaOperacao(idDaMovimentacao) IConsultaDeViewMovimentacaoContabilFinanceiro.ObterListaDeLancamentosContabeisPorChaveFatoOperacao(idDaMovimentacao, listaDeOperacoesFinanceiras) Parâmetros repassados ao serviço (na ordem): Documento, IdDaCarteiraLogada, IdCarteiraDestino, TitulosAProcessar[0].Valor, TitulosAProcessar[0].ValorMoeda, TitulosAProcessar[0].DataEmissao, user.DataDeMovimentacao, user.ObterUsuario(), TitulosAProcessar[0].FilialDestinoTransferencia, TitulosAProcessar[0].FilialOrigemTransferencia, TitulosAProcessar[0].ValorDaCotacao, TitulosAProcessar[0].IDDoTipoDeDocumento, TitulosAProcessar[0].MovObservacao, IDDaFormaDePagamento, ChequesProprios. Retorno (JSON, GeradorDeJson.Generico): Campo Conteúdo success true CodigoDaOperacao Chave de Fato gerada para a operação CodigoMovimentacao Mesmo valor de CodigoDaOperacao listaDeOperacoesFinanceiras Movimentações financeiras geradas listaDeOperacoesContabeis Lançamentos contábeis integrados listaDeCheques Cheques gerados (vazio quando não há cheques próprios) O frontend envia a requisição com timeout de 600000 ms (10 minutos). 2.2 POST TransferenciaEntreContas/Imprimir Emite o comprovante da operação. Verifica a existência do arquivo de layout do cliente e, quando ausente, copia o modelo padrão: Origem: ~/DocumentosDoFinanceiro/ComprovanteCaixa/Padrao/ComprovanteCaixa.rpt Destino: ~/DocumentosDoFinanceiro/ComprovanteCaixa/Cliente/ Retorna JSON com success = true. O frontend oferece a exportação do comprovante em PDF e em Excel. 2.3 Endpoints auxiliares consumidos pela tela Endpoint Uso GET DadosFilial/VerificarCarteiraEhDoTipoCaixa Verifica se a carteira logada é do tipo caixa e preenche o campo “Filial Origem”. GET CarteiraCheque/ObterPorId Obtém a configuração de cheque da carteira logada (ChequeFormContinuo e próximo número de cheque). GET FormaPagamento/ListarPorTipoDeFormaDePagamento (tipo = CH) Restringe o lookup “Forma de Pagamento” às formas do tipo cheque. 2.4 Ações fora do escopo deste recurso O mesmo controller expõe SalvarMultiplo e ImprimirEntreMultiplasContas, que pertencem ao Recurso 3965 — Entre Múltiplas Contas (rota EditViewDeTransferenciaEntreMultiplasContas). Da mesma forma, o método ProcessarTransferenciaMultipla existe na mesma classe de serviço, mas não é acionado por esta rotina. — 03. 3. MODELOS DE DADOS 3. Modelos de Dados 3.1 DTOCabecalhoDeOperacoes (entrada) DTO genérico compartilhado por todas as operações financeiras. Propriedades efetivamente utilizadas por esta rotina: Propriedade Tipo Obrigatório Descrição IdDaCarteiraLogada int Sim Carteira de origem. Preenchida pelo frontend com a carteira selecionada no login (VariaveisGlobais.CarteiraSelecionada). IdCarteiraDestino int Sim Carteira de destino (campo “Carteira Destino”). Documento string Não Número do documento da transferência (máximo 25 caracteres). DataDeLancamento DateTime Sim Data de lançamento informada na tela. IDDaFormaDePagamento int Condicional Obrigatório quando “Gerar Cheque” = Sim. TitulosAProcessar List de DTODeTituloAProcessar Sim A rotina utiliza somente o índice 0. Lista inicializada vazia no getter. ChequesProprios List de DTODeChequesProprios Condicional Preenchida somente no caminho com cheques próprios. 3.2 DTODeTituloAProcessar (item 0) Campos consumidos pelo controller nesta rotina: Propriedade Tipo Descrição Valor decimal Valor da transferência na moeda padrão. ValorMoeda decimal Valor na moeda da carteira. DataEmissao DateTime Data de emissão / lançamento. FilialOrigemTransferencia string Filial da carteira de origem. FilialDestinoTransferencia string Filial da carteira de destino. ValorDaCotacao decimal? Cotação usada na conversão de moeda. IDDoTipoDeDocumento string Tipo de documento. MovObservacao string Observação da movimentação (máximo 200 caracteres). IDDaCarteiraDePagamento int Carteira de destino (preenchida também no item pelo frontend). Documento string Documento (replicado no item). 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 Entidade Quando Observação MovimentacaoFinanceira Sempre Criada por FabricaDeMovimentacaoDeEntradaESaida.NovaMovimentacaoFinanceiraReduzida, com ListaAtualizarModulo.tcBanco. Vínculo com FatoContabilDoFinanceiro Sempre Operação 37 – TRANSFERÊNCIA (BCOTRNF), variação Sem Variação; nos cenários com cheque, variação 299 – Cheque a Prazo de Transferência; nas pernas de mútuo, operação 38 – MÚTUO (BCOMUT), variação Sem Variação. TituloPagar Somente com cheques próprios Criado por FabricaDeContasAPagar.NovoTituloAPagar, status tcAberto, plano de contas patrimonial da carteira de cheque a compensar. Cheque Somente com cheques próprios Criado por FabricaDeFinanceiro.NovoCheque, status ListaStatusDoCheque.tcGerado, tipo ListaTipoDoCheque.tcPagar. — 04. 4. REGRAS DE NEGÓCIO 4. Regras de Negócio 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

Adiantamento de Fornecedor

Documentação Técnica AdiantamentoFornecedor Rotina do módulo Financeiro responsável por registrar o “Adiantamento a fornecedor” — um lançamento de contas a pagar que antecipa um pagamento a um participante (fornecedor) antes da vinculação a uma fatura/nota fiscal real, gerando automaticamente o(s) título(s), o(s) cheque(s) (quando aplicável) e os lançamentos financeiros e contábeis correspondentes. 01. VISÃO GERAL Visão Geral Rotina do módulo Financeiro responsável por registrar o “Adiantamento a fornecedor” — um lançamento de contas a pagar que antecipa um pagamento a um participante (fornecedor) antes da vinculação a uma fatura/nota fiscal real, gerando automaticamente o(s) título(s), o(s) cheque(s) (quando aplicável) e os lançamentos financeiros e contábeis correspondentes. É uma tela filha do grupo de menu “Transferências”. A regra de negócio é compartilhada com a rotina de Adiantamento de Cliente — ambas chamam o mesmo serviço de inclusão de título, que internamente decide se o adiantamento é de contas a pagar (Fornecedor) ou de contas a receber (Cliente) conforme o módulo informado pelo controller. 02. ENDPOINTS Endpoints [POST] /AdiantamentoFornecedor/Salvar Registra um novo adiantamento a fornecedor a partir dos dados informados na tela. Internamente, delega para o serviço de inclusão de título (IServicoDeInclusaoDeTitulo), sempre com o módulo fixado em “Contas a Pagar” (ListaAtualizarModulo.tcPagar) e sempre com a categoria de lançamento contábil “120” — este endpoint nunca gera adiantamento de cliente (Contas a Receber); esse é um fluxo tratado por outra rotina. Após a inclusão, o sistema retorna, em uma única resposta, os cheques gerados/vinculados, as movimentações financeiras e os lançamentos contábeis produzidos pela operação. Permissão: “AdiantamentoFornecedor/Salvar” (ID 3005) Parâmetros: Nome Tipo Obrigatório Descrição dto DTOCabecalhoDeOperacoes (corpo da requisição) Sim Cabeçalho da operação, contendo a filial, a lista de títulos a processar (apenas o primeiro item da lista é considerado), os cheques próprios e de terceiros informados, a forma de pagamento, a data de lançamento, o documento e a observação Exemplo de request: “` POST /AdiantamentoFornecedor/Salvar { “IDDaFilial”: “01”, “IDDaFormaDeCobranca”: 8, “DataDeLancamento”: “2026-09-09”, “Documento”: “98765”, “Observacao”: “Adiantamento pago em espécie”, “TitulosAProcessar”: [ { “IDDaCarteira”: 2, “IDDoParticipante”: 789, “Valor”: 2500.00 } ], “ChequesProprios”: [], “ChequesDeTerceiros”: [] } “` Exemplo de response (sucesso): “`json { “success”: true, “listaDeOperacoesFinanceiras”: [], “listaDeCheques”: [], “listaDeOperacoesContabeis”: [] } “` Se dto.TitulosAProcessar vier vazio ou nulo, a ação não chama o serviço de negócio e apresenta a mensagem “Operação Cancelada. Alguns dados podem estar incorretos. Verifique se os dados informados estão corretos e tente novamente.” (ver Regras de Negócio). [POST] /AdiantamentoFornecedor/Imprimir Prepara o arquivo-modelo do comprovante de adiantamento (Crystal Reports) para impressão. Não executa nenhuma regra de negócio nem grava dados de adiantamento — apenas garante que a pasta de destino exista e copia o arquivo-modelo “ComprovanteCaixaAdiantamento.rpt” da pasta padrão para a pasta de destino, caso ainda não exista lá. Observação técnica: o caminho de destino usado internamente por esta ação é o mesmo “…/ComprovanteAdiantamento/Cliente” usado pela rotina de Adiantamento de Cliente (aparenta ser um resíduo de cópia de código entre as duas rotinas) — isso não afeta o resultado visível ao usuário, pois o arquivo-modelo copiado é o mesmo para ambas. Permissão: “AdiantamentoFornecedor/Imprimir” (ID 3006) Parâmetros: nenhum Exemplo de request: “` POST /AdiantamentoFornecedor/Imprimir “` Exemplo de response: “`json { “success”: true } “` [GET] /AdiantamentoFornecedor/ValidarInclusaoDeCheque Verifica, para uma lista de cheques informada, quais deles já estão vinculados a outro adiantamento (e por isso não podem ser reutilizados nesta operação) e quais estão livres para uso. É usada pela tela antes de permitir que o usuário inclua um cheque de terceiro no adiantamento. Permissão: coberta pela permissão de acesso à rotina “EditViewDeAdiantamentoFornecedor” (ID 1556) — não possui permissão granular própria. Parâmetros: Nome Tipo Obrigatório Descrição IDsDosCheques List<string> (query string) Sim Lista de IDs de cheques a validar Exemplo de request: “` GET /AdiantamentoFornecedor/ValidarInclusaoDeCheque?IDsDosCheques=CHQ001&IDsDosCheques=CHQ002 “` Exemplo de response: “`json { “success”: true, “listaChequesOK”: [“CHQ001”], “listaChequesJaVinculados”: [“CHQ002”] } “` 03. MODELOS DE DADOS Modelos de Dados DTOCabecalhoDeOperacoes (cabeçalho enviado pela tela) Campo Tipo Descrição IDDaFilial string Filial informada na tela (é sobrescrita internamente pela filial logada do usuário — ver Regras de Negócio) DataDeLancamento DateTime Data de lançamento da operação Documento string Número/identificação do documento informado Observacao string Observação livre digitada pelo usuário IDDaFormaDeCobranca int Forma de pagamento selecionada (obrigatória para o fluxo de contas a pagar) TitulosAProcessar List[DTODeTituloAProcessar] Lista de títulos a processar — apenas o primeiro item é efetivamente utilizado pelo fluxo de adiantamento a fornecedor ChequesProprios List[DTODeChequesProprios] Cheques próprios (emitidos pela empresa) usados para pagar o adiantamento — determina se o sub-fluxo executado é à vista ou a prazo, conforme a data de vencimento de cada cheque ChequesDeTerceiros List[DTODeChequesDeTerceiros] Cheques de terceiros (recebidos de outro participante e repassados como pagamento) usados para pagar o adiantamento — determina qual sub-fluxo interno é executado, ver Regras de Negócio DTODeTituloAProcessar (campos relevantes ao fluxo de adiantamento a fornecedor) Campo Tipo Descrição IDDaFilial string Filial do título (sobrescrita pela filial logada) IDDaCarteira int Carteira (conta bancária/caixa) usada na operação — obrigatória junto com a filial IDDoParticipante int Participante (fornecedor) do adiantamento Valor decimal Valor do adiantamento SerieDoDocumento string Série do documento NumeroDoDocumento int Número do documento NumeroDaParcela int Sempre forçado para 1 neste fluxo QuantidadeDeParcelas int Sempre forçado para 1 neste fluxo DataDeVencimento / DataDeVencimentoUtil DateTime Sempre forçadas para a data atual, exceto no sub-fluxo de cheque de terceiros, onde a data é ajustada para não ficar anterior à data de movimentação configurada para o usuário (adiantamento comum não tem vencimento futuro) IDDoTipoDeDocumento string Se não informado, assume um tipo de documento padrão de configuração (o mesmo tipo usado para verificar se um cheque já está vinculado a outro adiantamento) NaturezaDoTitulo, NumeroDoTituloAuxiliar, CodigoDeBarras, NossoNumero string Sempre zerados/forçados para vazio neste fluxo ValorDaCotacao decimal Sempre forçado para 0 IDDoVendedor int? Sempre forçado para nulo ChaveDeFato string Chave de fato do título gerado (distinta da chave de integração que amarra o conjunto da operação) Os demais campos de DTODeTituloAProcessar pertencem a outros fluxos (boleto, remessa bancária, tributos, PIX etc.) e não são utilizados pela rotina de Adiantamento a Fornecedor. 04. REGRAS DE NEGÓCIO Regras de Negócio Regra 1 — Filial e carteira são obrigatórias. Se

Transferência Entre Múltiplas Contas

Documentação Técnica 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. 01. VISÃO GERAL Visão Geral 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: Item Valor Recurso de acesso 3965 Rota do recurso EditViewDeTransferenciaEntreMultiplasContas Recurso pai 1554 – Transferências Fonte de permissões RecursosGeraisFinanceiro.cs Controller TransferenciaEntreContasController (Controllers\Financeiro\Transferencia) Serviço de aplicação ServicoDeTransferenciaEntreContas.ProcessarTransferenciaMultipla View (ExtJS) EditViewDeTransferenciaEntreMultiplasContas.js Controller (ExtJS) ControllerDeTransferenciaEntreMultiplasContas.js Grid do lote ListViewDeTransferenciaEntreMultiplasContas.js Store do lote StoreDeTransferenciaEntreMultiplasContas.js (em memória, sem proxy) 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). 02. ENDPOINTS Endpoints [POST] /TransferenciaEntreContas/SalvarMultiplo Processa o lote inteiro de transferências. É a única action que grava dados nesta rotina. Permissão: recurso 3965 – Entre Múltiplas Contas (rota EditViewDeTransferenciaEntreMultiplasContas), filho do recurso 1554 – Transferências. O recurso está cadastrado com validaAntes = true, ou seja, a tela executa uma validação de contexto antes de abrir (ver Regras de Negócio). Parâmetros (corpo da requisição, JSON — lista de DTODeTransferenciaEntreMultiplasContasItem): Campo Tipo Obrigatório Descrição DataDeLancamento DateTime Sim Data do lançamento da transferência daquele item. Documento string Não Número/identificação do documento da transferência. É também o idProperty do model na grade. CarteiraOrigem int Sim Código da carteira (banco/caixa) de onde o valor sai. FilialOrigem int Sim Código da filial da carteira de origem. Preenchido automaticamente a partir da carteira de origem. CarteiraDestino int Sim Código da carteira (banco/caixa) que recebe o valor. FilialDestino int Sim Código da filial da carteira de destino. Valor decimal Sim Valor da transferência. Precisa ser maior que zero. ValorDaCotacao decimal Não Cotação da moeda, usada quando as carteiras operam em moeda diferente da moeda padrão. MovObservacao string Não Observação gravada na movimentação financeira (até 200 caracteres na tela). Exemplo de requisição: POST /TransferenciaEntreContas/SalvarMultiplo Content-Type: application/json [ { “DataDeLancamento”: “2026-09-10T00:00:00”, “Documento”: “TRF-0001”, “CarteiraOrigem”: 12, “FilialOrigem”: 1, “CarteiraDestino”: 34, “FilialDestino”: 1, “Valor”: 1500.00, “ValorDaCotacao”: 1, “MovObservacao”: “Rateio de caixa da matriz” }, { “DataDeLancamento”: “2026-09-10T00:00:00”, “Documento”: “TRF-0002”, “CarteiraOrigem”: 12, “FilialOrigem”: 1, “CarteiraDestino”: 55, “FilialDestino”: 2, “Valor”: 800.00, “ValorDaCotacao”: 1, “MovObservacao”: “Repasse para filial 2” } ] Exemplo de resposta: { “success”: true, “CodigoDaOperacao”: “000000000012345”, “CodigoMovimentacao”: “000000000012345”, “listaDeOperacoesFinanceiras”: [ { “ChaveDeFato”: “000000000012345”, “IDDaIntegracao”: “000000000012345”, “CodigoDoDocumentoDaOperacao”: “TRF-0001”, “NumeroDoLancamento”: 1, “Valor”: 1500.00 } ], “listaDeOperacoesContabeis”: [ { “ChaveDeFato”: “000000000012345”, “ContaDebito”: “1.01.01.0001”, “ContaCredito”: “1.01.01.0002”, “Valor”: 1500.00 } ] } Comportamento no servidor: Se a lista recebida estiver vazia, a action não processa nada e dispara a mensagem de operação cancelada (ver Regras de Negócio), retornando null. Se houver itens, chama ProcessarTransferenciaMultipla passando a lista, a data de movimentação do usuário logado e o usuário logado. Com o identificador retornado (chave de fato/integração), consulta as movimentações financeiras geradas (ObterMovimentacoesPorCodigoDaOperacao) e, a partir das chaves de fato dessas movimentações, os lançamentos contábeis (ObterListaDeLancamentosContabeisPorListaDeChaveFato). Devolve os dois conjuntos no JSON, que alimentam as grades do Passo 2 (comprovante). [POST] /TransferenciaEntreContas/ImprimirEntreMultiplasContas Prepara o ambiente de arquivos do relatório de comprovante da transferência múltipla. Não recebe parâmetros e não grava dados de negócio. Permissão: recurso 3965 – Entre Múltiplas Contas. Comportamento: Garante a existência do diretório ~/DocumentosDoFinanceiro/ComprovanteTransferenciaMultiplaEntreContas/Cliente (cria o diretório e aplica FileIOPermission quando necessário). Se o arquivo de layout TransferneciaEntreMultiplasContas.rpt não existir na pasta do cliente, copia o layout padrão da pasta Padrao. Retorna success igual a true. Exemplo de resposta: { “success”: true } Após o retorno com sucesso, a tela abre a janela de relatórios com a URL: /relatorios/documentosDoFinanceiro.aspx?NR=ComprovanteTransferenciaEntreMultiplasContas&RL=CompTransferenciaEntreMultiplasContas&CO=[codigoDaOperacao]&tipo=financeiro&exportarDiretamente=9 As exportações para Excel e Word usam a mesma action, alterando os parâmetros de saída (NR=ComprovanteCaixa e exportarDiretamente 1, 2 ou 3 para Excel e 4 para Word). 03. MODELOS DE DADOS Modelos de Dados DTODeTransferenciaEntreMultiplasContasItem (ATAK.DTO\Financeiro\Transferencia) Contrato de entrada da action SalvarMultiplo. A requisição envia uma lista desses itens. Propriedade Tipo DataDeLancamento DateTime Documento string CarteiraOrigem int FilialOrigem int CarteiraDestino int FilialDestino int Valor decimal ValorDaCotacao decimal MovObservacao string DTODeTransferenciaEntreMultiplasContas (model ExtJS da grade) Model usado apenas na grade em memória do Passo 1. Possui os mesmos campos do DTO do servidor, acrescidos dos campos “Completo” (descrição formatada para exibição na grade), que não são enviados ao servidor. Campo Tipo Observação DataDeLancamento date Exibida no formato d/m/Y. Documento string idProperty do model. CarteiraOrigem int Código enviado ao servidor. FilialOrigem int Código enviado ao servidor. CarteiraOrigemCompleto string Descrição da carteira de origem para exibição. FilialOrigemCompleto string Descrição da filial de origem para exibição. CarteiraDestino int Código enviado ao servidor. FilialDestino int Código enviado ao servidor. CarteiraDestinoCompleto string Descrição da carteira de destino para exibição. FilialDestinoCompleto string Descrição da filial de destino para exibição. Valor decimal Coluna com totalizador (soma) na grade. ValorDaCotacao decimal Cotação informada na tela. MovObservacao string Observação da movimentação. Campos da tela (Passo 1 – Informações) Campo na tela itemId Obrigatório Observação Carteira Origem lkpCarteiraLancamentoTRECLIQDoFinanceiroTrasOrigem Sim Lookup de banco/caixa. Vem preenchido com a carteira logada. Filial Origem lkFilialDestinoTransferenciaOrigem Sim Campo desabilitado na tela; preenchido automaticamente com a filial da carteira de origem. Agência e Conta (origem) – Não Somente exibição, preenchidos pela carteira de origem. Carteira Destino lkpCarteiraLancamentoTRECLIQDoFinanceiroTrasDestino Sim

Monitoramento de Eventos