> ## 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.
# Conciliación
> Compara tus propios registros contra bancos, PSP y ERP sin hojas de cálculo, y cierra el mes con un registro de auditoría.
Cada institución financiera compara sus propios registros contra extractos bancarios, procesadores de pago y ERP. La mayoría de los equipos hace ese trabajo en hojas de cálculo.
Una conciliación de Lerian es un motor más las piezas que eliges alrededor de él. Matcher compara dos conjuntos de datos independientes e informa qué coincide, qué no, y por qué. Concilia datos de Midaz, datos de otro ledger, o dos fuentes externas sin ningún ledger de por medio. Los datos llegan a Matcher mediante carga de archivos, extracciones programadas y webhooks de agregadores. Envías lo que no coincide a las herramientas de tickets que tu equipo ya usa.
## Lo que obtienes
***
Matcher aplica reglas exactas o de tolerancia, puntúa cada coincidencia de 0 a 100, y convierte en excepción lo que no puede emparejar. El motor de extracción integrado de Matcher extrae transacciones de sistemas externos, así que nadie mueve un archivo a mano.
Streaming Hub entrega hechos de Matcher, como una corrida de coincidencias completada, a un webhook, una cola o un cursor que consultas tú. También puede entregar eventos de la plataforma hacia Matcher a través de un webhook firmado que tú activas.
Midaz es el ledger cuyas exportaciones se convierten en un lado de una conciliación. Los dos productos siguen siendo servicios separados, y ningún conector corre entre ellos.
Lender consume el veredicto de una corrida de coincidencias completada y lo traduce en una acción de administración de cartera de préstamos.
## Cómo encajan las piezas
***
Matcher se ubica entre los datos que le entregas y los sistemas que actúan sobre el resultado.
```mermaid theme={null}
flowchart LR
Bank["Extractos bancarios
CSV, OFX, CNAB, camt.053"]
PSP["Gateways y ERP
Stripe, Adyen, SAP"]
Agg["Agregadores de Open Finance
Pluggy, Belvo"]
Midaz["Ledger de Midaz
tu sistema de registro"]
Matcher["Matcher
reglas, puntuaciones, excepciones"]
Tools["JIRA, ServiceNow,
tu propio endpoint"]
AI["Tu cliente de IA
sobre MCP"]
Hub["Streaming Hub
el borde de entrega"]
Lender["Lender
administración de cartera"]
Sink["Tu webhook o cola"]
Bank -.->|"carga o extracción por transporte"| Matcher
PSP -->|"el motor de extracción extrae"| Matcher
Agg -.->|"el webhook señala datos nuevos"| Matcher
Midaz -.->|"exporta, luego importa como fuente LEDGER"| Matcher
AI -->|"herramientas MCP"| Matcher
Matcher -->|"tú despachas una excepción"| Tools
Matcher -.->|"hechos en lerian.streaming.matcher"| Hub
Matcher -.->|"match_run.completed"| Lender
Hub -.->|"webhook, cola o pull"| Sink
Hub -.->|"webhook firmado, desactivado de forma predeterminada"| Matcher
classDef lerian fill:#fff8e1,stroke:#f4b400,color:#333;
classDef yours fill:#e8f0fe,stroke:#4285f4,color:#333;
classDef ext fill:#f1f3f4,stroke:#9aa0a6,color:#333;
class Matcher,Midaz,Hub,Lender lerian;
class AI,Tools,Sink yours;
class Bank,PSP,Agg ext;
```
1. Defines dos fuentes, una en cada lado de la coincidencia. Un archivo que subes, un transporte que Matcher extrae, una extracción del motor, o un webhook de agregador alimentan una fuente.
2. Los datos del ledger llegan de la misma forma. Exportas el período desde Midaz y lo importas como una fuente de tipo `LEDGER`. No existe ningún conector en vivo.
3. Matcher aplica tus reglas y puntúa cada candidato de 0 a 100. Confirma una coincidencia exacta o de tolerancia que puntúa 90 o más.
4. Una coincidencia difusa o una coincidencia por desfase de fecha siempre espera a una persona. Los ítems sin contraparte se convierten en excepciones, clasificadas por monto, antigüedad y señales de la fuente.
5. Despachas una excepción a JIRA, ServiceNow, o un endpoint HTTP que configuras. Cada solicitud nombra su propio destino, así que Matcher no escala nada por sí solo.
6. Matcher publica sus hechos en `lerian.streaming.matcher`. Streaming Hub los entrega a tu webhook, tu cola o tu cursor de pull.
7. Matcher registra cada cambio auditado en un registro de auditoría de solo anexado. Nadie puede editar ni eliminar una entrada.
Streaming Hub también puede entregar eventos de la plataforma hacia Matcher. Esas entregas llegan a un único endpoint firmado que deduplica por id de evento y permanece desactivado hasta que lo activas. Matcher no consume ningún evento de Kafka.
## Qué posee cada pieza
***
| Pieza | Fuente de verdad para | Se comunica con | Tú mantienes |
| ----------------------------------------- | --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------- |
| Matcher | las reglas, corridas, excepciones, disputas y el registro de auditoría de coincidencias | tus fuentes por HTTP, y la herramienta a la que despachas | tu ledger intacto. Matcher no abre ninguna conexión hacia Midaz |
| El motor de extracción, dentro de Matcher | sus conexiones con sistemas externos, y cada extracción que ejecutas | bases de datos, gateways y agregadores | tus credenciales hacia esos sistemas |
| Midaz | los saldos, cuentas y transacciones | nada dentro de Matcher. Los datos se mueven por exportación e importación | tu ledger, en tu propia base de datos |
| Streaming Hub | qué hechos de Matcher llegan a qué destino | el tema de Matcher, tus destinos, y el ingreso firmado opcional hacia Matcher | tus destinos y tus secretos de firma |
| Lender | la acción de administración de cartera tomada sobre un veredicto | consume `match_run.completed` del tema de Matcher | tus decisiones de crédito |
## Adóptalo pieza por pieza
***
Concilia un archivo bancario contra una exportación de ERP. Matcher funciona como un producto independiente, sin ningún ledger y sin ningún otro producto de Lerian a su lado.
Exporta el período que quieres conciliar e impórtalo como una fuente de tipo `LEDGER`. Tanto Midaz como otro ledger llegan de esta forma, porque Matcher no depende de ninguno de los dos. Consulta [Matcher y Midaz](/es/products/matcher/integrations/matcher-midaz-integration) para el flujo de exportación e importación.
Registra una conexión con el motor de extracción, y luego crea extracciones en lugar de subir archivos a mano. Para datos de Open Finance, conecta una cuenta de Pluggy o Belvo y genera un token de webhook para ella.
Apunta Matcher hacia JIRA, ServiceNow, o tu propio endpoint. Configura primero el destino de despacho, porque el despacho falla sin él. Verifica la firma HMAC en cada entrega que recibes.
Suscríbete a los hechos de Matcher en Streaming Hub. Cuando también ejecutas crédito, Lender consume `match_run.completed` y mueve la etapa de administración de cartera del préstamo. Consulta la [solución de gestión de préstamos](/es/solutions/loan-management-system).
## Trae lo tuyo
***
* **Cualquier ledger.** Matcher funciona con Midaz o con otro ledger, y no depende de ninguno de los dos.
* **Cualquier formato de fuente.** CSV, JSON, XML, ISO 20022 camt.053, además de formatos regionales como CNAB, OFX y archivos EDI de adquirentes.
* **Tus herramientas de tickets.** Los destinos de despacho son JIRA, ServiceNow y tu propio webhook HTTP.
* **Tu cliente de IA.** El [servidor MCP de Matcher](/es/products/matcher/mcp/matcher-mcp-overview) habla Streamable HTTP y transmite tu Bearer token sin registrarlo ni almacenarlo.
* **Tus pantallas de conciliación.** La [interfaz de Matcher](/es/products/matcher/ui/matcher-module) se distribuye como su propia aplicación web junto a la API de Matcher.
## Un ejemplo práctico
***
Este ejemplo concilia un día de Pix contra el extracto de liquidación de BACEN. El recorrido completo está en [Conciliación de Pix](/es/products/matcher/use-case-guides/matcher-pix-reconciliation).
1. La fuente A contiene las transacciones de Pix confirmadas del día, exportadas desde Midaz. La fuente B contiene el extracto de liquidación del SPI de BACEN.
2. Ambos mapas de campos apuntan `external_id` hacia `endToEndId`. Ese valor vincula una transacción de Midaz con su registro de liquidación en BACEN.
3. La primera regla compara referencia, monto, moneda y fecha, y puntúa 100.
4. Un Pix iniciado a las 23:58 se liquida en BACEN al día siguiente. La regla de desfase de fecha lo empareja con 85, y ese par siempre va a la cola de revisión.
5. Una transacción de Midaz sin ningún registro en BACEN se convierte en una excepción. Lo mismo ocurre con un registro de BACEN sin ninguna transacción de Midaz.
6. Una devolución lleva el id end-to-end original y una nueva identificación de retorno. Matcher la empareja contra el extracto de BACEN según esos identificadores.
## Empieza aquí
***
El motor de conciliación: reglas, puntuaciones de confianza, excepciones y registros de auditoría.
Ejecuta una primera conciliación, y luego revisa las coincidencias y las excepciones que produce.
Contextos, fuentes, mapas de campos, reglas y coincidencias, las cinco cosas que configuras.