Skip to main content
No hay un conector directo de Matcher a Midaz. Matcher es un servicio de conciliación independiente. No abre una conexión en vivo con Midaz y no tiene configuración específica de Midaz. Esta página explica cómo los dos productos funcionan juntos en el plano conceptual.
Matcher y Midaz son servicios de Lerian separados, con tareas distintas:
  • Midaz es el ledger, el sistema de registro de saldos y asientos.
  • Matcher es el motor de conciliación. Compara dos conjuntos de datos independientes e informa qué coincide, qué no y por qué.
Son complementarios, no acoplados. Obtienes valor de Midaz más Matcher al conciliar los datos del ledger contra un conjunto de datos externo (un extracto bancario, un informe de liquidación de un gateway). Los datos se mueven entre ellos por exportación e importación, no por un enlace en tiempo real.

​
Cómo encajan

Un flujo de conciliación típico de Lerian:
  1. Midaz registra los asientos. Midaz contabiliza las transacciones en el ledger como de costumbre.
  2. Exportas los datos del ledger del período que quieres conciliar (por ejemplo, los asientos de la cuenta de caja de un día).
  3. Importas esa exportación a Matcher como un lado de un contexto, una fuente de tipo LEDGER.
  4. Importas los datos de la contraparte (el extracto bancario o el informe del gateway) como el otro lado.
  5. Matcher empareja los dos lados con tus reglas de coincidencia y expone las excepciones para revisión.
Midaz es el origen de un conjunto de datos. El banco o el gateway es el origen del otro. Matcher nunca habla con Midaz directamente. Trabaja a partir de los datos exportados que le entregas.

​
Modelar Midaz como una fuente

Dentro de un contexto de Matcher, los datos del ledger de Midaz se representan con una fuente de tipo LEDGER. LEDGER es la categoría de Matcher para los datos de “ledger interno / sistema contable”. No es un driver de Midaz.
Referencia de API: Crear una fuente
El otro lado del contexto es el conjunto de datos externo contra el que concilias, por lo general una fuente BANK o GATEWAY en el side opuesto. Tipos de fuente disponibles en Matcher:

​
Llevar los datos del ledger a Matcher

Matcher ingiere los datos que exportas de Midaz igual que ingiere cualquier otra fuente. No hay un transporte específico de Midaz.
  • Subida de archivos. Exporta los asientos del ledger (CSV/JSON) y sube el archivo a la fuente. Este es el camino más común.
  • Canal de consulta del motor de Discovery. Para las fuentes vinculadas al canal query, Matcher trae filas mediante una conexión del motor de Discovery en lugar de un archivo. Este es un canal de ingesta genérico, no un conector de Midaz.
En cualquiera de los dos casos, después defines un mapa de campos que renombra las columnas exportadas a los campos canónicos de Matcher (external_id, amount, currency, date y los opcionales description, fee_amount, fee_currency).
Referencia de API: Subir un archivo de transacciones

​
Mapeo de campos personalizado

La mayoría de las columnas del ledger se mapean de forma directa. Las búsquedas del mapa de campos son planas. Un valor de mapeo debe nombrar una columna que exista en el nivel superior de la fila exportada, así que un valor que vive dentro de los metadatos de la transacción debe exportarse como su propia columna plana antes de que Matcher pueda emparejar con él. Por ejemplo, el endToEndId de Pix en Brasil se almacena en los metadatos de la transacción de Midaz. Para conciliar con él, expórtalo como una columna plana (aquí endToEndId) y mapea external_id a esa columna. external_id es la referencia que el motor de coincidencia compara entre fuentes, así que ambos lados del contexto deben mapearla a un valor que compartan (la clave description es solo de visualización y nunca alimenta la coincidencia):
Cada mapa de campos debe declarar de forma explícita las cuatro claves canónicas obligatorias (external_id, amount, currency, date). No ocurre ningún mapeo automático. Consulta Mapeo de campos para el vocabulario canónico completo.

​
Bases compartidas de la plataforma

Aunque no hay integración en vivo, Matcher está construido para la misma plataforma que Midaz y replica varios de sus patrones:
  • Autenticación. Matcher usa el stack de autenticación compartido de Lerian, así que aplican el mismo proveedor de identidad y los mismos tokens que se usan en toda la plataforma.
  • Multi-tenancy. Matcher sigue un modelo de aislamiento de pool por tenant (una base de datos dedicada por tenant) en línea con el resto del stack, y mantiene separados los datos de cada tenant.
Estos son puntos en común en el nivel de la plataforma, no un canal de datos de Matcher a Midaz.

​
Qué no es esta integración

  • Matcher no tiene una opción MIDAZ_BASE_URL ni MIDAZ_GRPC_ADDRESS.
  • No hay modo de sincronización en tiempo real ni account_filter para una fuente de Midaz.
  • Matcher no se suscribe a eventos de Midaz ni abre una conexión gRPC/HTTP con Midaz.
Conciliar datos de Midaz significa exportarlos e importarlos a Matcher como cualquier otra fuente.

​
Mejores prácticas

Exporta solo las cuentas del ledger y el período que realmente necesitas conciliar. Las exportaciones más pequeñas y dirigidas mantienen los contextos rápidos y la coincidencia precisa.
Si concilias a diario, exporta a diario. Ajusta la programación de exportación a la disponibilidad de los datos de la contraparte (el extracto bancario).
Los mapas de campos renombran columnas pero no transforman valores. Genera exportaciones cuyos montos, fechas y códigos de moneda ya tengan las formas que tus reglas de coincidencia esperan.
Incluye referencias estables (números de factura, IDs externos) como columnas en la exportación para que las reglas de coincidencia puedan usarlas como clave y lograr tasas de coincidencia más altas.

​
Próximos pasos

Fuentes externas

Conecta el lado del banco o del gateway de la conciliación.

Mapeo de campos

Mapea las columnas exportadas del ledger a los campos canónicos de Matcher.