> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Revisar coincidencias > Revisa las coincidencias después de una ejecución. Entiende la puntuación de confianza de 0–100, sus cuatro componentes ponderados, las causas de variación y cómo rechazar o revocar un grupo de coincidencias. 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](/es/products/matcher/reference/matcher-confidence-scoring#fuzzy-matches-never-auto-confirm). Ciclo de vida del estado de la coincidencia ### Definiciones de estado | Estado | Descripción | Acciones siguientes | | ----------- | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------- | | `PROPOSED` | Coincidencia identificada por el sistema pero no confirmada | Revisar o rechazar mediante la operación de deshacer coincidencia | | `CONFIRMED` | La coincidencia se confirmó automáticamente o se creó como coincidencia manual | Revocar mediante la operación de deshacer coincidencia si es incorrecta | | `REJECTED` | La coincidencia fue rechazada | Las transacciones vuelven al conjunto de no conciliados | | `REVOKED` | Una coincidencia confirmada antes fue revocada | Las transacciones vuelven al conjunto de no conciliados | ## 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 | Franja | Rango de puntuación | Comportamiento | | ------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Elegible para confirmación automática | 90-100 | Las coincidencias elegibles EXACT y TOLERANCE creadas por el motor se confirman automáticamente sin revisión manual. Las coincidencias manuales se crean como `CONFIRMED`; las coincidencias FUZZY y DATE\_LAG siguen en `PROPOSED`. | | Necesita revisión | 60-89 | Las coincidencias de confianza media siguen en `PROPOSED`. Puedes revisarlas y rechazarlas, pero la API pública no expone la confirmación manual. | | Sin coincidencia | Menos de 60 | Los candidatos de baja confianza no se proponen como coincidencias y se convierten en excepciones. | ### Entender la puntuación Matcher calcula la puntuación de confianza a partir de componentes ponderados: | Componente | Peso | Qué mide | | -------------------------- | ---- | ---------------------------------------------------- | | Coincidencia de monto | 40% | Qué tan cerca están los montos de las transacciones | | Coincidencia de moneda | 30% | Si las monedas son iguales | | Tolerancia de fecha | 20% | Qué tan cercanas son las fechas de las transacciones | | Coincidencia de referencia | 10% | Si las referencias de las transacciones coinciden | **Ejemplo de desglose de puntuación:** ``` Match: BANK-001 ↔ LED-001 Amount: $1,000.00 vs $1,000.00 → 100% × 40% = 40 points Currency: USD vs USD → 100% × 30% = 30 points Date: 2024-01-15 vs 2024-01-15 → 100% × 20% = 20 points Reference: PAY-001 vs PAY-001 → match → 10 points ───────────────────────── Total Confidence: 100 points ``` ## 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. ```bash cURL theme={null} curl -X GET "https://api.matcher.example.com/v1/matching/candidates?contextId={contextId}&transactionId={transactionId}&limit=20" \ -H "Authorization: Bearer $TOKEN" ``` `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. ```bash cURL theme={null} curl -X GET "https://api.matcher.example.com/v1/matching/contexts/{contextId}/open-items?status=OPEN&limit=50" \ -H "Authorization: Bearer $TOKEN" ``` `GET /v1/matching/contexts/{contextId}/open-items` admite un filtro `status`, además de paginación con `limit`/`cursor`. #### Estados de la partida abierta | Estado | Cuándo ocurre | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OPEN` | Residual nuevo — la partida tiene un saldo remanente y ningún tramo ha neteado contra ella todavía. | | `PARTIALLY_CLEARED` | Al menos un tramo ha neteado contra el saldo, pero aún queda un residual. | | `CLEARED` | El residual se neteó por completo dentro de la tolerancia. | | `AGED` | La partida siguió abierta más allá de su umbral de antigüedad, medido desde la fecha hábil de la obligación o desde el tiempo de primera vista heredado. | | `WITHDRAWN` | Deshacer la coincidencia de un grupo confirmado eliminó la última contribución viva detrás de la obligación. La partida permanece como historial, pero es terminal y no se puede netear ni arrastrar. | 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. ```bash cURL theme={null} curl -X POST "https://api.matcher.example.com/v1/matching/adjustments?contextId={contextId}" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "amount": "10.50", "currency": "BRL", "direction": "DEBIT", "type": "BANK_FEE", "reason": "Variance due to bank processing fee", "description": "Bank wire fee adjustment", "matchGroupId": "019c96a0-0b74-768c-8d25-2bf065dca2f8" }' ``` `POST /v1/matching/adjustments` requiere el parámetro de consulta `contextId`. Campos del cuerpo: Monto del ajuste Cadena de moneda no vacía. Matcher no valida la pertenencia a ISO 4217 para este ajuste. `DEBIT` o `CREDIT` `BANK_FEE`, `FX_DIFFERENCE`, `ROUNDING`, `WRITE_OFF` o `MISCELLANEOUS` Motivo de negocio del ajuste Descripción legible por humanos Grupo de coincidencias al que aplica el ajuste Transacción a la que aplica el ajuste Envía al menos uno de `matchGroupId` o `transactionId`. Referencia de API: * [Listar candidatos de coincidencia](/es/reference/products/matcher/list-match-candidates) * [Listar partidas abiertas](/es/reference/products/matcher/list-open-items) * [Crear ajuste](/es/reference/products/matcher/create-adjustment) ## 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`): ```bash cURL theme={null} curl -X DELETE "https://api.matcher.example.com/v1/matching/groups/{matchGroupId}?contextId={contextId}" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "reason": "incorrect match - amounts do not match" }' ``` 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 *** Maneja las transacciones sin coincidencia automática. Profundiza en cómo Matcher calcula las puntuaciones de confianza.