Esta guía te lleva a través de un flujo completo de conciliación usando Matcher.
Definirás un contexto de conciliación, configurarás fuentes y reglas, ingerirás datos de transacciones, ejecutarás trabajos de conciliación y revisarás los resultados.
Prerrequisitos
Antes de comenzar, asegúrate de tener:
Acceso a la API de Matcher con un token de autenticación válido
Archivos de transacciones de muestra (proporcionados a continuación)
Datos de muestra
Este ejemplo concilia un extracto bancario contra registros internos del libro contable usando dos archivos CSV.
Bank_statement.csv
transaction_id,amount,currency,date,reference
BANK-001,1000.00,USD,2024-01-15,Pago de factura
BANK-002,250.50,USD,2024-01-16,Cuota de suscripción
BANK-003,500.00,USD,2024-01-17,Servicios de consultoría
BANK-004,75.00,USD,2024-01-18,Suministros de oficina
Ledger_transactions.csv
transaction_id,amount,currency,date,reference
LED-001,1000.00,USD,2024-01-15,Pago de factura
LED-002,250.50,USD,2024-01-16,Suscripción mensual
LED-003,500.00,USD,2024-01-17,Servicios de consultoría
LED-005,120.00,USD,2024-01-19,Gastos de viaje
- Tres pares de transacciones se concilian
- Una transacción bancaria y una transacción del libro contable quedan sin conciliar
- Las transacciones no conciliadas se crean como excepciones
Paso 1: crear un contexto de conciliación
Crea un contexto de conciliación para definir el alcance de la conciliación.
Solicitud
curl -X POST "https://api.matcher.example.com/v1/config/contexts" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Banco vs Libro contable - Enero 2024",
"type": "1:1",
"interval": "daily"
}'
Respuesta
{
"id": "969a11cd-6b7d-4e71-b82b-0828e0603149",
"tenantId": "11111111-1111-1111-1111-111111111111",
"name": "Banco vs Libro contable - Enero 2024",
"type": "1:1",
"interval": "daily",
"status": "ACTIVE",
"feeToleranceAbs": "0",
"feeTolerancePct": "0",
"createdAt": "2024-01-20T10:00:00Z",
"updatedAt": "2024-01-20T10:00:00Z"
}
Guarda el ID del contexto. Es requerido en los pasos siguientes.
Paso 2: agregar fuentes de datos
Adjunta las fuentes de datos que se conciliarán dentro de este contexto.
Fuente bancaria
Solicitud
curl -X POST "https://api.matcher.example.com/v1/config/contexts/{contextId}/sources" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Extracto de Chase Bank",
"type": "BANK"
}'
Respuesta
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"contextId": "969a11cd-6b7d-4e71-b82b-0828e0603149",
"name": "Extracto de Chase Bank",
"type": "BANK",
"config": {},
"createdAt": "2024-01-20T10:01:00Z",
"updatedAt": "2024-01-20T10:01:00Z"
}
Fuente del libro contable
Solicitud
curl -X POST "https://api.matcher.example.com/v1/config/contexts/{contextId}/sources" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Libro Principal",
"type": "LEDGER"
}'
Respuesta
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"contextId": "969a11cd-6b7d-4e71-b82b-0828e0603149",
"name": "Libro Principal",
"type": "LEDGER",
"config": {},
"createdAt": "2024-01-20T10:02:00Z",
"updatedAt": "2024-01-20T10:02:00Z"
}
Paso 3: crear una regla de conciliación
Define cómo se comparan las transacciones durante la conciliación.
Este ejemplo aplica una coincidencia exacta en monto, moneda y fecha.
Solicitud
curl -X POST "https://api.matcher.example.com/v1/config/contexts/{contextId}/rules" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "EXACT",
"priority": 1,
"config": {
"fields": ["amount", "currency", "date"]
}
}'
Respuesta
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"contextId": "969a11cd-6b7d-4e71-b82b-0828e0603149",
"type": "EXACT",
"priority": 1,
"config": {
"fields": ["amount", "currency", "date"]
},
"createdAt": "2024-01-20T10:03:00Z",
"updatedAt": "2024-01-20T10:03:00Z"
}
Paso 4: subir archivos de transacciones
Sube datos de transacciones para cada fuente configurada.
Espera hasta que ambos trabajos de ingesta se completen antes de iniciar el trabajo de conciliación.
Paso 5: ejecutar el trabajo de conciliación
Comienza con una ejecución de prueba para previsualizar los resultados de conciliación sin persistir cambios.
Ejecución de prueba
curl -X POST "https://api.matcher.example.com/v1/matching/contexts/{contextId}/run" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"mode": "DRY_RUN"
}'
Revisar resultados
La ejecución de prueba devuelve:
- Conciliaciones propuestas con puntajes de confianza
- Transacciones no conciliadas clasificadas como excepciones
- Un resumen de la efectividad de la conciliación
Paso 6: confirmar resultados
Si los resultados previsualizados son correctos, vuelve a ejecutar el trabajo usando el modo COMMIT para finalizar la conciliación.
curl -X POST "https://api.matcher.example.com/v1/matching/contexts/{contextId}/run" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"mode": "COMMIT"
}'
Entendiendo los resultados
Después de la conciliación:
- Las conciliaciones de alta confianza se confirman automáticamente
- Las transacciones no conciliadas se registran como excepciones
- Todas las acciones se persisten en el log de auditoría
Ahora puedes revisar, enrutar o resolver excepciones según sea necesario.
Resumen
Este inicio rápido cubrió el ciclo de vida completo de conciliación:
Contexto definido
Alcance de conciliación establecido
Fuentes agregadas
Fuentes de banco y libro contable configuradas
Reglas creadas
Lógica de coincidencia exacta aplicada
Datos ingeridos
Archivos de transacciones subidos
Conciliación ejecutada
Ejecución de prueba revisada y resultados confirmados
Excepciones identificadas
Transacciones no conciliadas aisladas
Próximos pasos
