Reconciliação de Pagamentos

A reconciliação permite fazer a correspondência entre os pagamentos gerados pelo PCH-SIG e os extratos dos operadores de pagamento mobile money (TELECEL, Orange Money, MTN).

Vista geral

Operadores suportados

Operador	Código	Cor	Formato de ficheiro
TELECEL	telecel	Vermelho 🔴	CSV (;) ou Excel
Orange Money	orange_money	Laranja 🟠	CSV (;) ou Excel
MTN Mobile Money	mtn	Amarelo 🟡	CSV (,) ou Excel

Criar uma sessão de reconciliação

Etapa 1: Seleção dos parâmetros

1. Aceda a Pagamentos > Reconciliação
2. Clique em Nova reconciliação
3. Selecione:

Campo	Descrição	Obrigatório
Operador	TELECEL, Orange Money ou MTN	Sim
Período início	Data de início das transações	Sim
Período fim	Data de fim das transações	Sim
Ciclo	Ciclo de pagamento em questão	Não

Etapa 2: Importação do ficheiro do operador

Descarregue o extrato do operador e importe-o no sistema.

Formato TELECEL

Coluna	Descrição
ID Transferência	Referência interna
Telefone	Número do beneficiário
Montante (FCFA)	Montante transferido
Estado Transferência	SUCESSO, FALHA, EM CURSO
Data	Data da transação
Mensagem / Ref. Operador	Referência do operador
ID Ordem Transferência	Código do ciclo (ex: PCH-GB-001-C-16)
Nome Beneficiário	Nome do beneficiário
Saldo Restante (FCFA)	Saldo da conta do operador

Formato Orange Money

Coluna	Descrição
Transaction ID	Referência da transação
Recipient Phone	Número do beneficiário
Amount	Montante
Status	Estado
Transaction Date	Data/hora

Formato MTN

Coluna	Descrição
TransRef	Referência da transação
MSISDN	Número do beneficiário
Amount	Montante
TxnStatus	Estado
DateTime	Data/hora

Etapa 3: Execução da correspondência

Após a importação, clique em Executar correspondência para lançar o algoritmo de correspondência.

Algoritmo de correspondência

O sistema utiliza um algoritmo multi-critérios para fazer a correspondência das transações:

Prioridade de correspondência

1. Chave de reconciliação (apenas TELECEL, pontuação 100)

   • Formato: 245{telefone}-{codigobeneficiario}

2. Referência exata (pontuação 100)

   • Correspondência direta por referência externa

3. Correspondência aproximada (pontuação 60+)

   • Telefone: +20 pontos
   • Montante exato (±1 FCFA): +40 pontos
   • Montante próximo (±1%): +20 pontos
   • Mesmo dia: +40 pontos
   • ±3 dias: +20 pontos

Estados de correspondência

Estado	Código	Descrição	Ação
Correspondência exata	exact	Tudo corresponde perfeitamente	Aceitar
Correspondência aproximada	fuzzy	Pontuação >= 60, verificação manual	Verificar
Desvio de montante	ecart_montant	Pagamento encontrado, montante diferente	Corrigir
Desvio de estado	ecart_statut	Pagamento encontrado, estado diferente	Corrigir
Não encontrado interno	non_trouve_interne	Transação externa sem pagamento	Investigar
Não encontrado externo	non_trouve_externe	Pagamento sem transação	Investigar

Resolução de desvios

Ações disponíveis

Ação	Código	Descrição
Aceitar	aceite	Validar a entrada tal como está
Corrigir	corrigido	Atualizar o pagamento com os dados externos
Rejeitar	rejeitado	Marcar como inválido/rejeitado

Resolução individual

1. Clique numa entrada com desvio
2. Verifique os detalhes (interno vs externo)
3. Adicione um comentário explicativo
4. Escolha a ação de resolução

Resolução em lote

1. Filtre as entradas por estado
2. Selecione várias entradas
3. Clique em Resolução em lote
4. Aplique a ação a todas as seleções

Integração TELECEL

Extração automática do saldo

O sistema extrai automaticamente o saldo da conta do operador a partir da última linha do ficheiro TELECEL:

Ficheiro TELECEL importado
    ↓
Extração "Saldo Restante (FCFA)"
    ↓
Atualização ContaOperador.saldoAtual
    ↓
Criação de movimento de ajustamento

Código do ciclo

A TELECEL inclui o identificador do ciclo na coluna "ID Ordem Transferência" (ex: PCH-GB-001-C-16), permitindo ligar automaticamente as transações ao ciclo.

Impacto nas contas dos operadores

Durante a resolução:

• Aceitar + estado "bem-sucedido" → Débito da conta do operador
• Corrigir + estado "bem-sucedido" → Débito da conta do operador + atualização do pagamento
• Rejeitar → Sem impacto contabilístico

Estatísticas da sessão

Indicador	Descrição
Linhas importadas	Total de transações do ficheiro
Correspondências	Exatas + Aproximadas
Desvios	Montante + Estado
Não encontrados	Internos + Externos
Taxa de correspondência	(Exatas + Aproximadas) / Total * 100
Variância	Desvio de montante total

Finalização

Uma vez todas as entradas resolvidas:

1. Verifique que nenhuma entrada está "Em espera"
2. Clique em Finalizar sessão
3. A sessão passa para o estado "Terminada"
4. O ciclo pode ser atualizado se necessário

Exportação dos resultados

Formatos disponíveis:

Formato	Conteúdo
CSV	Dados brutos para análise
Excel	Relatório detalhado com formatação
PDF	Relatório de síntese para arquivo

Restrições por ciclo

:::warning Importante A reconciliação não é possível em ciclos com estado terminado. Os ciclos validado e em_curso podem ser reconciliados. :::

Boas práticas

:::tip Recomendações

1. Reconcilie regularmente: No final de cada ciclo
2. Verifique os desvios: Não ignore montantes diferentes
3. Documente as rejeições: Adicione comentários explicativos
4. Arquive os relatórios: Guarde as exportações PDF
5. Monitorize os não encontrados: Pode indicar problemas de dados :::

Permissões necessárias

Ação	Permissão
Consultar sessões	reconciliation.view
Criar sessão	reconciliation.create
Resolver entradas	reconciliation.resolve
Finalizar	reconciliation.finalize

Ver também

• Exportação de pagamentos
• Ciclos de pagamento
• Grelhas tarifárias