Actualización de la documentación de Matcher

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.

​

Lo que cambió

​

Guías

​

Visión general

• Qué es Matcher — Visión general del producto, arquitectura y dónde encaja Matcher en la plataforma Lerian
• Conceptos de Matcher — Conceptos clave: contexts, sources, rules, field mapping, matching runs, exceptions y disputes
• Arquitectura de Matcher — Arquitectura del sistema, módulos de dominio y flujo de datos

​

Primeros pasos

• Prerrequisitos — Requisitos y dependencias
• Instalación de Matcher — Configuración y deployment
• Comenzando con Matcher — Recorrido de extremo a extremo, desde la creación del context hasta la primera reconciliación

​

Configuración

• Contexts 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 reordenación
• Field mapping — Mapeando campos de origen al modelo canónico de Matcher
• Fee rules — Validación de fees y configuración de tolerancia
• Exception routing — Enrutando transacciones no conciliadas para revisión
• Modo multi-tenant — Aislamiento y configuración de tenants
• Configuración en runtime (Systemplane) — Parámetros de runtime y configuraciones a nivel de sistema

​

Reconciliación diaria

• Subiendo archivos — Importando datos de transacciones vía API
• Revisando matches — Inspeccionando resultados de matches y grupos
• Resolviendo exceptions — Workflows de exception y resolución
• Generando reports — Dashboard, reports de matched/unmatched/variance y exportaciones

​

Integraciones

• Integración con Midaz — Usando Matcher con datos del ledger Midaz
• Sources externos — Conectando estados de cuenta bancarios y sistemas de terceros
• Discovery — Auto-discovery de conexiones de datos externos
• Webhooks y callbacks — Notificaciones basadas en eventos

​

Referencia

• Confidence scoring — Cómo Matcher calcula la confianza del match
• Multi-currency — 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 Pix

​

Lerian Console

• Usando Matcher en Lerian Console — Visión general de la integración con el console
  • 19 páginas de console que cubren todo el módulo Matcher:
  • Contexts — Gestionando contexts, sources, rules y schedules
  • Reconciliation — Subiendo datos, ejecutando runs, revisando matches
  • Exceptions y disputes — Gestionando exceptions, detalles de exceptions, disputes
  • Governance — Mapeos de actor, audit logs y archivos
  • Operations — Dashboard, fee schedules, matching manual e historial operacional

​

Referencia de API

• Quick start para developers — Recorrido por la API desde la configuración del context 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:
  • Configuration — Contexts, sources, rules, field maps, schedules, fee rules, fee schedules
  • Ingestion — Import jobs, búsqueda de transacciones
  • Matching — Runs, match groups
  • Exceptions — Gestión de exceptions, comentarios, historial
  • Disputes — Ciclo de vida de disputes
  • Reporting — Métricas del dashboard (match rate, volumen, SLA, cash impact, source breakdown), reports de matched/unmatched/variance con exportación
  • Discovery — Connections, introspección de schema, extraction bridge
  • Governance — Audit logs, mapeos de actor, archivos
  • Export — Export jobs con descarga

​

Especificación OpenAPI

• Especificación OpenAPI 3.1 de Matcher — Especificación legible por máquina con los 117 endpoints, schemas y ejemplos — verificada contra el código fuente

​

Correcciones clave en esta versión

• Rutas de la API corregidas — Prefijos de rutas alineados con el registro real de rutas en Fiber
• Campos deprecados removidos — rateId removido de todos los schemas (rechazado por la API desde su deprecación)
• Schemas faltantes agregados — Arrays inline de sources y rules agregados a CreateReconciliationContextInput
• Spec YAML reforzada — Valores de enum con dos puntos (1:1, 1:N, N:M) correctamente entrecomillados para evitar interpretaciones erróneas del parser
• Ejemplos de las guías corregidos — URLs de endpoints incorrectas en ejemplos de curl corregidas en todos los idiomas