Páginas filhas
  • DDFINAN-34164 - DT - 643 - Processo de Localização e Conciliação dos Registros vindos da API

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. DADOS GERAIS

Produto:

TOTVS Distribuição e Varejo

Linha de Produto:

Linha Winthor 

Segmento:

Distribuição TOTVS Goiânia 

Módulo:06 - TESOURARIA
Função:643 - CONCILIAÇÃO E GERAÇÃO AUTOMATICA DE LANÇAMENTOS
Requisito/Story/Issue Issue :

DDFINAN-34164

02. SITUAÇÃO/REQUISITO

Implementar na rotina 643 um processo de localização e conciliação que utilize os registros retornados pela API bancária, permitindo ao usuário identificar, validar e vincular os movimentos automaticamente encontrados na base.

Objetivo do Processo

Oferecer ao gestor financeiro a capacidade de:

  • Localizar registros financeiros oriundos da API,

  • Cruzar informações com lançamentos internos (PCMOVCR),

  • Pré-conciliar automaticamente quando os dados corresponderem,

  • Permitir conciliação manual quando necessário.

03. SOLUÇÃO

A seguir, o detalhamento do fluxo implementado, caracterizando oficialmente o Processo de Localização e Conciliação dos Registros vindos da API:

3.1. Abertura da Tela

Ao chegar na etapa de conciliação por API, o sistema exibe a nova tela:

“Localização de conciliação de registros”

Essa tela é responsável pela identificação e vinculação dos lançamentos retornados pela API com os títulos internos (PCMOVCR).

3.2. Seleção da Moeda

Ao entrar na tela:

  • O sistema solicita que o usuário escolha a moeda (PCMOEDA) utilizada para a conciliação.

  • Essa moeda será o filtro principal para a pesquisa dos lançamentos conciliáveis.

3.3. Processo Automático de Localização (Match Automático)

Após selecionar a moeda, a rotina inicia o processo de localização dos registros.
O sistema pesquisa na tabela PCMOVCR utilizando as seguintes regras:

Regras obrigatórias

  • pcmovcr.dtconcil IS NULL

  • pcmovcr.data dentro do período informado na etapa anterior

  • pcextratobancario.VALORLANCAMENTO = pcmovcr.valor

  • Banco selecionado = pcmovcr.codbanco

  • Moeda selecionada = pcmovcr.codcob

Regras de sinal

  • Se SINALLANCAMENTO = '+'pcmovcr.tipo = 'D'

  • Se SINALLANCAMENTO = '-'pcmovcr.tipo = 'C'

Regra opcional

  • pcextratobancario.NUMERODOCUMENTO = pcmovcr.numcarr

Quando todas as regras são atendidas, o sistema considera que há match automático.

3.4. Apresentação dos Registros Encontrados

Os resultados são exibidos na tela:

Registros com match automático

  • Aparecem pré-selecionados

  • Com risco sobre a descrição

  • Indicando conciliação sugerida

Registros sem match

  • Exibidos em preto

  • Sem risco

  • Disponíveis para conciliação manual

O usuário pode desmarcar qualquer pré-conciliação clicando duas vezes sobre o item.

3.5. Localização Manual

Caso o sistema não encontre match automático:

  • O usuário pode clicar no título do lançamento para abrir a pesquisa manual.

  • A rotina aplica o mesmo conjunto de regras da pesquisa automática.

  • Se forem encontrados múltiplos registros elegíveis:

    • O sistema permite a seleção de apenas um título

    • Efetua o vínculo manual entre API ↔ PCMOVCR

3.6. Navegação e Continuidade do Processo

A tela disponibiliza três ações:

  • Retornar → volta ao passo anterior da conciliação

  • Avançar → segue o fluxo da conciliação API (Processo DDFINAN-34165)

  • Fechar → encerra a rotina

3.7. Resultado Final do Processo

Com a adaptação, a rotina 643 passa a suportar plenamente o Processo de Localização e Conciliação dos Registros vindos da API, permitindo:

  • Conciliação automática padronizada,

  • Conferência visual clara entre registros conciliados e pendentes,

  • Possibilidade de intervenção manual,

  • Maior eficiência e redução de erros.


Totvs custom tabs box
tabsComo ter a melhoria?
idspasso1
Totvs custom tabs box items
defaultyes
referenciapasso1

Solução da rotina 643 - Conciliação e Geração automática de lançamentos a partir da atualização da versão 38.0.9.0 ou acima.
Deve atualizar a rotina para a versão igual ou superior

...