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

