A tela Erros 3044 tem como objetivo consultar e analisar os erros ocorridos durante a execução da rotina 3044.
Essa rotina pode ter origem tanto em API quanto em Rotina (ROT), permitindo que o usuário filtre e acompanhe problemas que aconteceram em diferentes etapas do processo.

Além da consulta, os resultados retornados podem ser exportados em formato CSV, facilitando o armazenamento, análise ou envio das informações.


Filtros de Pesquisa

O usuário pode realizar a consulta de erros utilizando os seguintes filtros:

Data de Importação:

  • Permite selecionar um período (inicial e final) para restringir os resultados.
  • Formato aceito: dd/mm/aaaa.

Origem dos Dados:

  • API → Quando o fluxo 3044 é executado pelo Rating Web.
  • ROT → Quando o fluxo ocorre via Rating Service.

Tipo de Processamento:

  • Importação → Erros durante a carga inicial dos dados.
  • Validação → Erros encontrados conforme as definições das críticas do Bacen.
  • Processamento → Falhas inesperadas durante a execução da rotina.
  • Geração → Problemas na criação ou no preenchimento do arquivo.

Ações Disponíveis

  • Consultar
    Executa a busca com base nos filtros selecionados e retorna a lista de erros encontrados.
  • Limpar Filtro
    Reseta todos os filtros da tela para o estado inicial.

Exportação de Resultados

O botão de exportação de resultados só será habilitado quando houver retorno de erros. Quando existirem erros, eles poderão ser exportados em um arquivo no formato CSV, possibilitando:

  • Manipulação em planilhas
  • Análise externa de ocorrências



Fluxo de Uso

  • Informar o período de importação desejado.
  • Selecionar a origem dos dados (API ou ROT).
  • Marcar o(s) tipo(s) de processamento a serem analisados.
  • Clicar em Consultar para visualizar os erros.
  • Caso necessário, exportar os resultados para CSV.
  • Usar Limpar Filtro para iniciar uma nova consulta.

Possíveis Erros no Processo 3044

Importação

Erros na importação ocorrerão somente ao importar o arquivo 3044 (JSON).

Possíveis erros da importação:

  • Arquivo mal formatado.
  • Informações faltantes no cabeçalho ou nas seções de operação/movimento.
  • Erro inesperado ao inserir os dados na base.

Solução para os casos mencionados:

  • Para erros no arquivo, revise a estrutura e as informações contidas nele.
  • Para falhas não previstas, abrir uma demanda junto à equipe responsável.

Validação

Possíveis Erros na Validação:

Quando a interface Dimensa:

  • Erros na validação dos campos que compõem o IPOC (código  Contrato, Número AdeLib, Código do Cliente, CPF/CNPJ, Tipo de Pessoa, Código da Modalidade e Sigla da Modalidade).
    • O erro ocorrerá quando o IPOC estiver vazio e alguma das informações que compõem também estiverem vazias. 
  • Erros na validação da classificação 3050 quando a instituição envia para o Bacen. 
    • Classificação 3050 não for informada e os campos que compõem também estiverem vazios. 
    • Classificação 3050 informada não existir na tabela t425_3050.

Quando importação arquivo JSON:

  • Erro na validação quando o ipoc for vazio.
  • Erros na validação da classificação 3050 quando a instituição envia para o Bacen. 
    • Classificação 3050  informada não existir na tabela t425_3050.

Para todos os tipos de interface:

  • Erro na validação quando a operação está com a ação igual a 3.
  • Erros na validação quando operação tem ação incluir(1)
    • Algum dos campos saldo e data devedor e atraso estiver nulos. 
    • Saldo devedor é negativo. 
    • Operação não possui pagamento/concessão.
    • Atraso diferente de S ou N. 
  • Erros na validação quando operação tem ação excluir(2)
    • Operação possui pagamento/concessão.
  • Erro na validação quando o IPOC estiver preenchido e os 8 primeiros dígitos não for o CNPJ/ISPB da instituição cadastrada na configuração.
  • Erro na validação quando existem movimentos sem operação vinculada.
  • Erros na validação de críticas do Bacen(B01, T01, T02, T03, T05, T06 e T09). Documento 3044 – Dados de Eventos em Operações de Crédito
  • Erro inesperado ao realizar consultas e alterações nos registros.

Processamento

Possíveis erros no processamento:

  • Erro inesperado ao realizar consultas ou update nos registros.

Geração

Possíveis erros na geração:

  • Erro inesperado ao criar arquivo no diretório definido na configuração.
  • Erro inesperado ao realizar consultas.
  • Erro inesperado ao preencher arquivo.


Consulta de Erros via Banco de Dados

Para clientes que não utilizam o sistema web, o fluxo de consulta de erros deve ser realizado por meio de SELECTs diretamente no banco de dados.
Abaixo seguem os SELECTs para consulta.

SELECT
    cd_emp AS "CD.EMP",
    dt_imp AS "DATA IMPORT",
    sg_itf AS "INTERFACE",
    ds_tbl AS "TABELA ERRO",
    ds_cam AS "CAMPO ERRO",
    ds_erro AS "DESC. ERRO",
    CASE tp_ori
        WHEN 'API' THEN 'API'
        WHEN 'ROT' THEN 'ROTINA'
        ELSE 'DESCONHECIDO'
    END AS "ORIGEM",
    CASE tp_prc
        WHEN 'I' THEN 'IMPORTAÇÃO'
        WHEN 'V' THEN 'VALIDAÇÃO'
        WHEN 'P' THEN 'PROCESSAMENTO'
        WHEN 'G' THEN 'GERAÇÃO'
        ELSE 'DESCONHECIDO'
    END AS "PROCESSO"
FROM t425ergr
WHERE 
    cd_emp = 1 -- INSERIR COD. DE EMPRESA 
AND dt_imp = '2025-09-11' -- INSERIR DATA (YYYY-MM-DD)
SELECT
    cd_emp AS "CD.EMP",
    dt_imp AS "DATA IMPORT",
    sg_itf AS "INTERFACE",
    ds_tbl AS "TABELA ERRO",
    ds_cam AS "CAMPO ERRO",
    ds_erro AS "DESC. ERRO",
    CASE tp_ori
        WHEN 'API' THEN 'API'
        WHEN 'ROT' THEN 'ROTINA'
        ELSE 'DESCONHECIDO'
    END AS "ORIGEM",
    CASE tp_prc
        WHEN 'I' THEN 'IMPORTAÇÃO'
        WHEN 'V' THEN 'VALIDAÇÃO'
        WHEN 'P' THEN 'PROCESSAMENTO'
        WHEN 'G' THEN 'GERAÇÃO'
        ELSE 'DESCONHECIDO'
    END AS "PROCESSO"
FROM t425ergr
WHERE 
    cd_emp = 1 -- INSERIR COD. DE EMPRESA 
AND dt_imp = TO_DATE('2025-09-15', 'YYYY-MM-DD') -- INSERIR DATA (YYYY-MM-DD)

Descrição dos campos

  • CD.EMP: Código da empresa
  • DATA IMPORT: Data da importação realizada exemplo importação realizada 07/10/2025 e processada 08/10/2025, deverá colocar 07/10/2025 na consulta.
  • INTERFACE: Interface do dado(CF, CC, JS - Quando importação arquivo JSON)
  • TABELA ERRO: Informação de qual tabela que originou o erro
  • CAMPO ERRO: Informação de qual campo da tabela originou o erro
  • DESC. ERRO: Descrição do erro
  • ORIGEM: Quando processo feito pelo Rating WEB - API, Se processo feito pelo Rating Service - ROT
  • PROCESSO: Tipo de processo que originou o erro, sendo, importação, validação, processamento e geração

Condição WHERE

  • Informar qual empresa deseja consultar no cd_emp
  • Informar a data de importação que deseja consultar no dt_imp