Primeros pasos con Matcher

Recorre las cinco etapas del ciclo de vida de la conciliación, desde definir un contexto hasta resolver excepciones en tu primera ejecución de coincidencia.

Esta guía presenta el ciclo de vida de conciliación en Matcher, desde la configuración inicial hasta la revisión de resultados. Se enfoca en los conceptos y decisiones involucradas en cada etapa.

Para instrucciones paso a paso con ejemplos de solicitudes y respuestas de la API, consulta el Inicio rápido de la API de Matcher.

​

El ciclo de vida de conciliación

---

Toda conciliación en Matcher sigue el mismo ciclo de cinco etapas:

1. Definir alcance

   Crear un contexto que describe qué estás conciliando y registra su intervalo de conciliación.
2. Conectar fuentes

   Registrar los sistemas cuyas transacciones deseas comparar.
3. Configurar reglas

   Definir los criterios que Matcher usa para emparejar transacciones.
4. Ejecutar matching

   Subir datos y dejar que Matcher encuentre pares, comenzando con una vista previa antes de confirmar.
5. Resolver excepciones

   Revisar transacciones no conciliadas y decidir cómo manejarlas.

Las secciones a continuación explican cada etapa.

​

Definir alcance con un contexto

---

Un contexto es el contenedor principal para un flujo de conciliación. Responde tres preguntas:

• ¿Qué estás conciliando? Por ejemplo, una cuenta bancaria contra tu libro mayor.
• ¿Qué tipo de emparejamiento? Uno a uno, uno a muchos o muchos a muchos.
• ¿Qué etiqueta de intervalo describe el período de conciliación? Por ejemplo, daily, weekly u on-demand.

El valor requerido de interval es un dato descriptivo de texto libre; no programa la ejecución. Las ejecuciones automáticas usan un ReconciliationSchedule separado, basado en cron y con una frecuencia mínima de cinco minutos.

Tipo de emparejamiento	Cuándo usar	Ejemplo
1:1	Cada transacción tiene exactamente una contraparte	Extracto bancario vs. asientos contables
1:N	Un registro se mapea a varios del otro lado	Una sola factura pagada en cuotas
N:M	Múltiples registros en ambos lados se relacionan entre sí	Pagos en lote divididos entre cuentas

La mayoría de las conciliaciones comienzan con 1:1. Puedes cambiar el tipo de emparejamiento más adelante a medida que tu proceso evolucione.

Referencia de API: Crear contexto | Actualizar contexto

​

Conectar fuentes de datos

---

Cada contexto necesita al menos dos fuentes: los sistemas cuyos datos de transacciones deseas comparar. Una fuente representa un único flujo de datos, como un extracto bancario, una exportación del libro mayor o un archivo de pasarela de pagos.

​

Tipos de fuentes

Tipo	Uso típico
BANK	Extractos bancarios y extractos de cuenta
LEDGER	Exportaciones del libro mayor o ERP
GATEWAY	Datos de procesadores de pago (Stripe, Adyen, etc.)
FETCHER	Datos extraídos mediante Fetcher/Discovery
CUSTOM	Cualquier otro dato estructurado

​

Mapeo de campos

Los archivos de transacciones de diferentes sistemas rara vez usan los mismos nombres de columna. Los mapeos de campos traducen las columnas de tu fuente al esquema estándar de Matcher para que las transacciones puedan ser comparadas.

Por ejemplo, un archivo bancario puede llamar a la fecha de transacción “Post Date”, mientras que tu libro mayor la llama “posting_date”. Los mapeos de campos normalizan ambas al campo date de Matcher.

Cada transacción debe proporcionar al menos cuatro campos después del mapeo:

Campo	Descripción
external_id	Identificador único dentro de la fuente
amount	Valor de la transacción
currency	Código de moneda ISO 4217 (ej., USD, BRL)
date	Fecha de la transacción

Referencia de API: Crear fuente | Crear mapeo de campos

​

Configurar reglas de match

---

Las reglas definen cómo Matcher decide si dos transacciones son la misma. Puedes apilar múltiples reglas con diferentes prioridades. Matcher las evalúa en orden: solo las transacciones que no fueron conciliadas por la primera regla pasan a la siguiente.

​

Tipos de reglas

Regla	Qué hace	Cuándo usar
Exacta	Requiere valores idénticos en los campos seleccionados	Cuando los datos son limpios y los sistemas están sincronizados
Tolerancia	Permite pequeñas diferencias numéricas o de fecha	Cuando comisiones bancarias, redondeo o retrasos de procesamiento causan discrepancias menores
Fuzzy	Usa similitud normalizada de cadenas para las referencias. El monto, la moneda y la fecha coinciden de forma exacta por defecto, pero puedes configurar cada comprobación de forma independiente.	Cuando las referencias de texto libre o truncadas varían entre fuentes
Desfase de fecha	Permite una ventana de fecha configurable	Cuando las fechas de liquidación difieren entre sistemas

​

Configuración inicial recomendada

1. Prioridad 1 — Regla exacta en monto, moneda y fecha. Esto captura primero todos los matches perfectos.
2. Prioridad 10 — Regla de tolerancia con una tolerancia de monto pequeña (ej., 1%) y una ventana de 2 días. Esto captura casi-matches causados por comisiones o timing.

A medida que observes resultados con el tiempo, ajusta las reglas o agrega nuevas para mejorar tu tasa de conciliación.

Referencia de API: Crear regla de match

​

Ejecutar matching

---

Una vez que las fuentes están configuradas y los datos subidos, puedes ejecutar el motor de matching.

​

Previsualizar primero, confirmar después

Matcher soporta dos modos de ejecución:

Modo	Comportamiento
Dry run	Calcula matches y genera una vista previa sin persistir artefactos de match ni excepciones. Crea y completa un registro MatchRun.
Commit	Persiste los resultados: matches confirmados, puntajes de confianza y excepciones.

Siempre comienza con un dry run. Revisa la vista previa para verificar la calidad del matching antes de confirmar.

​

Entendiendo los puntajes de confianza

Cada match recibe un puntaje de confianza de 0 a 100:

Rango de puntaje	Significado	Acción requerida
90–100	Alta confianza	Elegible para confirmación automática, excepto los grupos FUZZY y DATE_LAG, que siempre requieren revisión
60–89	Confianza media	Marcado para revisión manual
Menor a 60	Baja confianza	No conciliado — se convierte en excepción

Los puntajes se derivan de los componentes conciliados y sus pesos configurados. Las reglas exactas y de tolerancia usan el mismo marco de ponderación; ningún tipo de regla produce puntajes inherentemente más altos.

Referencia de API: Ejecutar match | Listar grupos de ejecución

​

Resolver excepciones

---

Las excepciones son transacciones que Matcher no pudo emparejar automáticamente. Representan los elementos que necesitan atención humana.

​

Severidad de excepciones

Matcher clasifica cada excepción por severidad según el monto de la transacción y cuánto tiempo ha estado sin conciliar:

Severidad	Criterio	SLA sugerido
Crítica	Monto >= 100,000 o sin conciliar >= 120 horas	24 horas
Alta	Monto >= 10,000 o sin conciliar >= 72 horas	72 horas
Media	Monto >= 1,000 o sin conciliar >= 24 horas	5 días
Baja	Todos los demás	7 días

​

Opciones de resolución

• Forzar match — Emparejar manualmente la transacción con una contraparte cuando sabes que pertenecen juntas.
• Crear ajuste — Registrar un asiento de corrección para contabilizar la diferencia.
• Deshacer match — Si un match confirmado es incorrecto, deshacerlo para que ambas transacciones regresen al pool de no conciliadas.
• Despachar — Envía la excepción mediante su ruta configurada de JIRA o webhook. Esta acción dirigida por quien llama no cambia su estado.

Referencia de API: Listar excepciones | Deshacer match de grupo

​

Escenario de ejemplo

---

Una fintech concilia su extracto bancario diario contra registros internos del libro mayor.

Configuración:

• Contexto: “Conciliación Bancaria Diaria”, tipo 1:1, intervalo daily
• Dos fuentes: Extracto de Chase Bank (BANK) y Libro Mayor (LEDGER)
• Dos reglas: Match exacto (prioridad 1) y Match por tolerancia con 1% y ventana de 2 días (prioridad 10)

Flujo de trabajo diario:

1. Finanzas sube el extracto bancario y la exportación del libro mayor.
2. Matcher ejecuta un dry run. La vista previa muestra que el 95% de las transacciones fueron conciliadas con alta confianza.
3. El equipo revisa la vista previa y confirma los resultados.
4. Cinco transacciones quedan como excepciones: dos tienen pequeñas diferencias por comisiones, tres no tienen contraparte.
5. El equipo resuelve las excepciones de comisiones creando ajustes. Las tres transacciones faltantes se escalan para investigación.

​

Próximos pasos

---

Contextos y fuentes

Guía completa para configurar contextos de conciliación.

Reglas de match

Profundización en todos los tipos de reglas y opciones de configuración.

Mapeo de campos

Mapea diferentes formatos de archivo al esquema estándar de Matcher.

Resolver excepciones

Estrategias para manejar transacciones no conciliadas.