28 de abril de 2026 Actualización de documentación Revisión recomendadaDocumentation Index
Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
Use this file to discover all available pages before exploring further.
Afecta
Equipos que usan las guías, la referencia API o la documentación de Console de Matcher. Esta actualización se aplica al portal de documentación pública. No cambia el comportamiento del API en tiempo de ejecución, salvo que la documentación del producto enlazada indique lo contrario.
Qué cambió
La documentación de Matcher fue auditada por completo y alineada con la rama
main actual. Esta versión incluye 27 páginas de guías, 119 páginas de referencia API, 19 páginas de console y una especificación OpenAPI 3.1 verificada.
Qué cambió
Guías
Resumen
- Qué es Matcher — Resumen del producto, arquitectura y dónde encaja Matcher en la plataforma Lerian
- Conceptos de Matcher — Conceptos centrales: contextos, sources, reglas, mapeo de campos, ejecuciones de matching, excepciones y disputas
- Arquitectura de Matcher — Arquitectura del sistema, módulos de dominio y flujo de datos
Getting started
- Prerrequisitos — Requisitos y dependencias
- Instalando Matcher — Configuración y despliegue
- Comenzando con Matcher — Recorrido de extremo a extremo desde la creación de contextos hasta la primera reconciliación
Configuración
- Contextos y sources — Definiendo el alcance de la reconciliación y conectando sistemas
- Match rules — Tipos de reglas (exact, tolerance, date lag), orden de prioridad y reordenamiento
- Mapeo de campos — Mapeo de campos de source al modelo canónico de Matcher
- Fee rules — Validación de tarifas y configuración de tolerancia
- Enrutamiento de excepciones — Enrutamiento de transacciones no coincidentes para revisión
- Modo multi-tenant — Aislamiento y configuración de tenants
- Configuración en tiempo de ejecución (Systemplane) — Parámetros de runtime y ajustes a nivel de sistema
Reconciliación diaria
- Cargando archivos — Importando datos de transacciones vía API
- Revisando matches — Inspeccionando resultados y grupos de match
- Resolviendo excepciones — Flujos y resolución de excepciones
- Generando informes — Dashboard, informes de matched/unmatched/variance y exportaciones
Integraciones
- Integración con Midaz — Usando Matcher con datos de ledger de Midaz
- Sources externos — Conectando estados de cuenta bancarios y sistemas de terceros
- Discovery — Auto-descubrimiento de conexiones de datos externos
- Webhooks y callbacks — Notificaciones basadas en eventos
Referencia
- Confidence scoring — Cómo Matcher calcula la confianza del match
- Multi-moneda — Reconciliación entre monedas
- Split y aggregate — Patrones de matching 1:N y N:M
- Seguridad — Autenticación, autorización y protección de datos
Casos de uso
- Reconciliación de Pix — Guía paso a paso para reconciliar transacciones de Pix
Lerian Console
- Usando Matcher en Lerian Console — Resumen de la integración con Console
- 19 páginas de console que cubren el módulo completo de Matcher:
- Contextos — Gestión de contextos, sources, reglas y schedules
- Reconciliación — Cargando datos, ejecutando runs, revisando matches
- Excepciones y disputas — Gestión de excepciones, detalles de excepciones, disputas
- Gobernanza — Mapeos de actores, logs de auditoría, archivos
- Operaciones — Dashboard, fee schedules, matching manual, historial operativo
Referencia API
- Inicio rápido para desarrolladores — Recorrido de la API desde la configuración del contexto hasta la reconciliación
- Lista de errores — Referencia completa de códigos de error
- 119 páginas de referencia de endpoints que cubren toda la superficie de la API:
- Configuración — Contextos, sources, reglas, mapeos de campos, schedules, fee rules, fee schedules
- Ingestión — Jobs de importación, búsqueda de transacciones
- Matching — Runs, grupos de match
- Excepciones — Gestión de excepciones, comentarios, historial
- Disputas — Ciclo de vida de disputas
- Reportes — Métricas de dashboard (tasa de match, volumen, SLA, impacto de caja, desglose por source), informes matched/unmatched/variance con exportación
- Discovery — Conexiones, introspección de esquemas, bridge de extracción
- Gobernanza — Logs de auditoría, mapeos de actores, archivos
- Exportación — Jobs de exportación con descarga
Especificación OpenAPI
- Especificación OpenAPI 3.1 de Matcher — Especificación legible por máquina con los 117 endpoints, esquemas y ejemplos — verificada contra el código fuente
Correcciones clave en esta versión
- Rutas API corregidas — Prefijos de rutas alineados con el registro real de rutas Fiber
- Campos obsoletos eliminados —
rateIdeliminado de todos los esquemas (rechazado por la API desde su deprecación) - Esquemas faltantes agregados — Arrays inline
sourcesyrulesagregados aCreateReconciliationContextInput - Especificación API endurecida — Valores enum con dos puntos (
1:1,1:N,N:M) entrecomillados correctamente para evitar la mala interpretación del parser - Ejemplos de guías corregidos — URLs de endpoints incorrectas en ejemplos de curl corregidas en todos los idiomas
Impacto
Esta es una actualización de documentación. Las integraciones existentes no necesitan migración solo por esta nota de versión.

