Linkage e Processamento

Visão geral do fluxo

O linkage é o processo de associar pagamentos a contratos usando algoritmos de matching. O fluxo completo é:

1. Upload de dados — importar pagamentos e contratos de arquivos CSV.
2. Configuração de merge — definir como os dados serão combinados.
3. Execução de linkage — o sistema associa pagamentos a contratos automaticamente.
4. Validação manual — gestores revisam e corrigem as associações.
5. Métricas — avaliar a qualidade do linkage (precisão, recall, F1).

Configuração de merge

A configuração de merge define como os dados de pagamentos e contratos serão combinados. Para criar ou editar uma configuração:

1. Vá para Linkage no menu principal (ou Configurações de Merge no Dashboard).
2. Clique em Nova Configuração ou edite uma existente.
3. Defina os parâmetros de matching: thresholds de fuzzy matching, método de scoring, gap temporal, etc.
4. Salve a configuração.

Executar linkage

1. Acesse Linkage → Controle de Linkage.
2. Selecione a configuração de merge desejada.
3. Clique em Executar Linkage.
4. Aguarde o processamento (pode levar alguns minutos dependendo do volume de dados).
5. Os resultados aparecerão em Resultados de Linkage.

O sistema utiliza:

• Matching por CNPJ — correspondência exata ou fuzzy
• Scoring temporal — proximidade temporal entre pagamento e contrato
• Scoring de valor — similaridade entre valores
• Scoring de exclusividade — unicidade do vínculo

Validação manual

Após a execução do linkage, os gestores podem revisar os resultados:

1. Acesse Linkage → Validação.
2. Para cada associação, escolha:
   • Validar — confirmar que o link está correto
   • Rejeitar — marcar como incorreto
   • Indeterminado — quando não é possível confirmar
3. Adicione observações quando necessário.

Upload de lotes

Para importar novos dados no sistema:

1. Acesse Upload de Dados (Dashboard ou menu).
2. Selecione o arquivo CSV para upload.
3. O sistema identificará automaticamente o tipo de dado (contratos, pagamentos, etc.).
4. Aguarde o processamento e verifique o resultado na lista de uploads.

Métricas de linkage

As métricas ajudam a avaliar a qualidade do linkage:

• Precisão — percentual de links corretos entre os gerados
• Recall — percentual de links reais que foram encontrados
• F1-Score — média harmônica entre precisão e recall
• Cobertura — percentual de pagamentos com pelo menos um link

Acesse Linkage → Métricas para ver os relatórios detalhados.