1. Processar
Onde fica: Operação → Processar. O processamento transforma os arquivos do stage em dados (camada bronze).
Selecione o projeto
Escolha o projeto. A tela lista os arquivos no stage com um ponto/etiqueta indicando pendente ou processado.
Escolha o que processar
Marque os arquivos desejados (ou Selecionar pendentes) e clique em Processar. A opção Reprocessar tudo força o reprocessamento da carteira inteira.
Acompanhe o progresso
A seção Progresso mostra arquivo a arquivo, com ícones de status:
| Ícone | Estado |
|---|---|
| Na fila | |
| Processando | |
| Concluído | |
| Erro (mensagem em vermelho) |
2. Conciliar
Onde fica: Operação → Conciliação. A conciliação deriva contratos, parcelas e pagamentos a partir do bronze.
Selecione o projeto e os arquivos pendentes
Os pendentes aparecem em dois grupos: Cessão e Liquidação. Marque os que quer conciliar (ou use Reprocessar tudo).
Inicie a conciliação
Clique em Iniciar Conciliação e acompanhe as fases (consolidar cessões, derivar parcelas, etc.).
Leia os resultados
No fim aparecem as métricas: contratos, parcelas, pagamentos, valor de face, VP total e valor pago.
Atenção aos avisos
A tela destaca três situações comuns:
- Registros não carregados — CNAB inválido (ex.: nº de parcela não numérico, contrato vazio). Mostra uma amostra com o motivo.
- Duplicatas em liquidação — linhas repetidas; mostra arquivo/contrato/parcela.
- Deduplicação aplicada — o sistema manteve o snapshot mais recente por contrato/parcela.
Ao terminar, um job de atualização das tabelas é disparado automaticamente em segundo plano. Você pode sair da tela — acompanhe pelo indicador de jobs.
3. Checagens de qualidade
Onde fica: Carteira → Check (aba Qualidade). As checagens validam a saúde dos dados antes de fechar o período.
Arquivo
Arquivo
- Arquivos duplicados — arquivos cujos registros já existem em outro (ex.: cópia
(1).REM).
Processo (bronze)
Processo (bronze)
- Pagamentos órfãos — liquidação sem a cessão correspondente.
- Pagamento antes da cessão — data de liquidação anterior à cessão.
- Overpayment — valor pago acima de ~130% do título.
- Divergência de valor — título diferente entre cessão e liquidação.
- Contratos multi‑data, duplicatas, datas inválidas, arquivos faltando.
Conciliação (derivado)
Conciliação (derivado)
- Parcelas/contratos órfãos, pagamentos fantasma/não aplicados.
- Vencimento antes da cessão, pago antes do vencimento.
- Saldo negativo (pago maior que o devido), parcelas/contratos duplicados, divergência arquivo × pagamento, datas inválidas.
Como tratar uma checagem que falhou
Abra o detalhe
Clique no card do problema (os que têm contagem maior que zero). Abre um painel de detalhe com a descrição e uma amostra dos registros afetados.
Escolha a ação certa
O painel oferece a correção adequada ao tipo de problema:
- Revisão necessária — não há correção automática segura. Use Exportar registros (CSV), investigue a origem e corrija o arquivo (e reenvie).
- Correção automática — para casos seguros (remover duplicatas, remover órfãos derivados, reprocessar). Clique em Corrigir, confirme o aviso de impacto e aguarde o resultado.
4. Auditoria (investigar a origem)
Onde fica: Operação → Auditoria (também acessível pelas abas Inspeção e Rastreio do Check). Serve para rastrear o caminho arquivo CNAB → contrato → parcela → pagamento.
- Inspeção de arquivo
- Rastreio de contrato
Lista os arquivos com filtros por status (processados/pendentes) e tipo (cessão/liquidação). Clique num arquivo para abrir o detalhe, com KPIs (registros, VP total, contratos/pagamentos) e abas com os registros CNAB, contratos e parcelas extraídos. Você pode ver o arquivo bruto (primeiras linhas) e baixar o CNAB original.
5. Quando um arquivo não processa
Confirme o status em Processar
O arquivo aparece como pendente (ou com erro, com a mensagem em vermelho na seção Progresso).
Verifique se há job em andamento
Olhe o indicador de jobs. Se houver uma remoção em andamento para o projeto, aguarde concluir antes de tentar de novo.
Inspecione o arquivo bruto
Em Auditoria → Inspeção de arquivo, abra o arquivo e veja o arquivo bruto. Procure por linhas malformadas, codificação estranha ou header/trailer inválidos.
Verifique a parametrização
Se o layout é novo, talvez nenhum template case com ele. Confira/crie o template em Parametrizar novo CNAB e teste com a ferramenta de detecção.
Checklist rápido de investigação
Não processa? → arquivo bruto na Auditoria · Erro de parsing? → confira o formato/template · Duplicatas? → remova as cópias e reprocesse · Conciliação com inválidos? → corrija contrato/parcela na origem e reenvie · Job travado (> 1h)? → acione o admin.