Skip to main content
Después de ejecutar un job de coincidencia, tendrás que revisar los resultados. Esta guía explica cómo interpretar los resultados de coincidencia, entender las puntuaciones de confianza y rechazar grupos de coincidencias propuestos o revocar los confirmados.

​
Ciclo de vida del estado de la coincidencia

Las coincidencias avanzan por un ciclo de vida definido:
  • Cuando el motor de coincidencias encuentra un par de transacciones que van juntas, crea una coincidencia en estado PROPOSED.
  • Las coincidencias elegibles creadas por el motor (puntuación de 90 o más) a partir de reglas EXACT y TOLERANCE se confirman automáticamente de inmediato. Las coincidencias manuales empiezan en estado CONFIRMED. Las coincidencias FUZZY y DATE_LAG siguen en PROPOSED y nunca se confirman automáticamente.
  • Las coincidencias que no se confirman automáticamente siguen en PROPOSED. La API pública de grupos de coincidencias no expone la confirmación manual, pero puedes rechazar un grupo propuesto con la operación de deshacer coincidencia y un motivo obligatorio.
  • Rechazar un grupo PROPOSED devuelve sus transacciones al conjunto de no conciliados. Puedes revocar un grupo CONFIRMED solo cuando Matcher también puede revertir cada efecto de residual/partida abierta que aplicó la confirmación. Si tiene éxito, esos cambios y la devolución de las transacciones ocurren de forma atómica.
Las coincidencias FUZZY y DATE_LAG nunca se confirman automáticamente. La confirmación automática con puntuación ≥ 90 aplica a las coincidencias elegibles EXACT y TOLERANCE creadas por el motor. Una coincidencia manual empieza en estado CONFIRMED. Una coincidencia producida por una regla FUZZY o DATE_LAG se queda en PROPOSED, sin importar su puntuación, incluso una coincidencia FUZZY con 90+. Puedes rechazarla mediante la operación de deshacer coincidencia. No existe una operación pública de confirmación manual. Consulta Puntuación de confianza.
Ciclo de vida del estado de la coincidencia

Ciclo de vida del estado de una coincidencia.

​
Definiciones de estado

​
Franjas de confianza

Matcher asigna una puntuación de confianza (0-100) a cada coincidencia propuesta. La puntuación determina qué le ocurre a la coincidencia.

​
Niveles de confianza

​
Entender la puntuación

Matcher calcula la puntuación de confianza a partir de componentes ponderados: Ejemplo de desglose de puntuación:

​
Entender las variaciones

Cuando las coincidencias tienen diferencias, revisa los detalles de la variación:

​
Variación de monto

Causas comunes de la variación de monto:
  • Comisiones bancarias
  • Diferencias de conversión de moneda
  • Diferencias de redondeo
  • Pagos parciales

​
Variación de fecha

Causas comunes de la variación de fecha:
  • Tiempos de liquidación
  • Diferencias de zona horaria
  • Fecha de contabilización frente a fecha de transacción
  • Procesamiento en fines de semana/feriados

​
Candidatos de coincidencia, partidas abiertas y ajustes

Matcher te da tres superficies para trabajar una cola de revisión: candidatos de coincidencia, partidas abiertas y ajustes.

​
Listar candidatos de coincidencia

Recupera las propuestas de candidatos ordenadas que el motor consideró para una transacción, el “porqué” detrás de una coincidencia propuesta, con las contribuciones por componente.
cURL
GET /v1/matching/candidates acepta los parámetros de consulta contextId, transactionId y limit, y devuelve un CandidateProposalsResponse. El limit es 50 de forma predeterminada y acepta valores de 1 a 200. El selector de candidatos escanea como máximo 5,000 transacciones no conciliadas del lado opuesto y devuelve solo candidatos 1:1. Aplica el puntuador compartido a los datos crudos de la transacción, sin la normalización de comisiones en tiempo de ejecución ni la coincidencia por bandas de variación de FX que usa una ejecución de coincidencia.

​
Listar partidas abiertas

Las partidas abiertas son saldos residuales que quedan cuando una transacción se netea solo en parte. Haz seguimiento de ellas para mostrar los montos que aún necesitan compensación o que superaron su umbral de antigüedad.
cURL
GET /v1/matching/contexts/{contextId}/open-items admite un filtro status, además de paginación con limit/cursor.

​
Estados de la partida abierta

El ciclo de vida normal fluye OPEN → PARTIALLY_CLEARED → CLEARED, y cualquier partida aún abierta puede pasar a AGED una vez que supera el umbral de antigüedad. Deshacer con éxito la coincidencia de un grupo confirmado retira los efectos residuales de ese grupo. Si no queda ninguna contribución viva detrás de la obligación, la partida termina en WITHDRAWN. Ese estado significa que la operación de deshacer coincidencia recuperó la partida. No significa que la partida se compensó ni envejeció.

​
Crear un ajuste

Registra un ajuste contable para contabilizar una variación (comisión bancaria, diferencia de FX, redondeo, baja contable, etc.) contra un grupo de coincidencias o una transacción.
cURL
POST /v1/matching/adjustments requiere el parámetro de consulta contextId. Campos del cuerpo:
​
String
requerido
Monto del ajuste
​
String
requerido
Cadena de moneda no vacía. Matcher no valida la pertenencia a ISO 4217 para este ajuste.
​
String
requerido
DEBIT o CREDIT
​
String
requerido
BANK_FEE, FX_DIFFERENCE, ROUNDING, WRITE_OFF o MISCELLANEOUS
​
String
requerido
Motivo de negocio del ajuste
​
String
requerido
Descripción legible por humanos
​
UUID
Grupo de coincidencias al que aplica el ajuste
​
UUID
Transacción a la que aplica el ajuste
Envía al menos uno de matchGroupId o transactionId.
Referencia de API:

​
Rechazar o revocar grupos de coincidencias

Usa la operación de deshacer coincidencia para rechazar un grupo PROPOSED o revocar un grupo CONFIRMED. Después de una operación exitosa, Matcher devuelve las transacciones del grupo a UNMATCHED. La siguiente ejecución puede volver a hacerlas coincidir. Usa DELETE /v1/matching/groups/{matchGroupId} con el parámetro de consulta contextId obligatorio y un reason en el cuerpo de la solicitud (operationId unmatch):
cURL
Una operación de deshacer coincidencia exitosa devuelve 204 No Content. El campo reason es obligatorio y no debe estar vacío. Para un grupo CONFIRMED, Matcher verifica la reversión del residual/partida abierta antes de cambiar el grupo o sus transacciones. Una operación exitosa agrega de forma atómica los asientos compensatorios del ledger, revoca el grupo y devuelve sus transacciones a UNMATCHED.
La operación de deshacer coincidencia requiere un motivo no vacío. Para un grupo confirmado, o revierte los efectos de residual/partida abierta junto con el grupo y sus transacciones, o devuelve 409 Conflict antes de cambiar nada. Un asiento vivo posterior sobre el residual bloquea la reversión anterior. Una obligación viva más nueva sobre la misma identidad también la bloquea cuando restaurar una partida terminal generaría conflicto.

​
Cuándo rechazar o revocar

Escenarios comunes para rechazar o revocar un grupo:
  • Coincidencia incorrecta confirmada: las transacciones de un grupo confirmado pertenecen a registros distintos
  • Información nueva: datos adicionales muestran que la coincidencia está mal
  • Corrección en la fuente: el sistema de origen emitió una corrección o una reversión
  • Transacción duplicada: una de las transacciones es un duplicado que se recomienda eliminar

​
Qué ocurre después de deshacer la coincidencia

Cuando deshaces la coincidencia de un grupo:
  1. Los residuales confirmados van primero: Matcher verifica que puede revertir cada efecto de residual/partida abierta de un grupo CONFIRMED. Si un asiento posterior o una obligación más nueva en conflicto lo bloquea, la operación devuelve 409 Conflict y deja sin cambios el grupo, las transacciones y las partidas abiertas.
  2. Cambia el estado de la coincidencia: un grupo CONFIRMED pasa a REVOKED. Un grupo aún en PROPOSED pasa a REJECTED.
  3. Transacciones devueltas: si tiene éxito, todas las transacciones asociadas vuelven al estado UNMATCHED.
  4. Efectos de partida abierta revertidos: al deshacer la coincidencia de un grupo confirmado, los asientos compensatorios del ledger retiran los efectos residuales del grupo en la misma transacción. Si eso deja sin contribución viva a una obligación, esta pasa a WITHDRAWN terminal y no se arrastra.
  5. Motivo registrado: el grupo guarda el motivo de rechazo o revocación proporcionado.
  6. Evento de streaming emitido: un evento match_group.unmatched se emite solo cuando el grupo estaba antes en CONFIRMED.
  7. Nueva coincidencia posible: después de deshacer la coincidencia con éxito, la siguiente ejecución puede volver a hacer coincidir las transacciones.

​
Mejores prácticas

Revisa primero las coincidencias con las puntuaciones de confianza más bajas. Estas coincidencias son las que tienen más probabilidad de estar mal. Dales la mayor atención.
Los umbrales de confianza no cambian. Las coincidencias elegibles EXACT y TOLERANCE creadas por el motor con puntuaciones de 90 o más se confirman automáticamente. Las coincidencias manuales empiezan en CONFIRMED. Las puntuaciones entre 60 y 89 siguen en PROPOSED, y las puntuaciones por debajo de 60 se convierten en excepciones. Estos valores no son configurables por contexto.Las coincidencias FUZZY y DATE_LAG son la excepción: nunca se confirman automáticamente y siguen en PROPOSED, sin importar la puntuación.Usa el ajuste de reglas (prioridad, valores de tolerancia) para influir en cuántas coincidencias caen en cada franja.
Proporciona un motivo específico al rechazar un grupo propuesto o al revocar un grupo confirmado. La operación de deshacer coincidencia lo requiere y lo guarda con el grupo.
Revisa el grupo y sus transacciones de origen antes de usar la operación de deshacer coincidencia. Matcher expone esta operación por grupo. No expone la confirmación masiva.
Sin importar la puntuación de confianza, dale atención extra a las coincidencias de alto valor. El impacto de una coincidencia incorrecta es proporcional al monto.

​
Próximos pasos

Resolver excepciones

Maneja las transacciones sin coincidencia automática.

Puntuación de confianza

Profundiza en cómo Matcher calcula las puntuaciones de confianza.