01. DADOS GERAIS

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.

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

• Como atualizar as rotinas do WinThor?