Afecta a
Equipos que usan las guías, la referencia de API o la documentación de Console de Matcher. Esta actualización aplica al portal de documentación pública. No cambia el comportamiento de la API en tiempo de ejecución, salvo que la documentación de producto enlazada indique lo contrario.
Qué cambió
La documentación de Matcher se auditó por completo y se alineó con la branch
main actual. Esta versión incluye 27 páginas de guías, 119 páginas de referencia de API, 19 páginas de consola 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, fuentes, reglas, mapeo de campos, ejecuciones de coincidencia, excepciones y disputas
- Arquitectura de Matcher — Arquitectura del sistema, módulos de dominio y flujo de datos
Primeros pasos
- Requisitos previos — Requisitos y dependencias
- Instalación de Matcher — Configuración y despliegue
- Primeros pasos con Matcher — Recorrido de extremo a extremo desde la creación del contexto hasta la primera conciliación
Configuración
- Contextos y fuentes — Definir el alcance de la conciliación y conectar sistemas
- Reglas de coincidencia — Tipos de regla (exacta, tolerancia, desfase de fecha), orden de prioridad y reordenamiento
- Mapeo de campos — Mapear los campos de la fuente al modelo canónico de Matcher
- Reglas de comisiones — Validación de comisiones y configuración de tolerancia
- Enrutamiento de excepciones — Enrutar las transacciones no conciliadas para su revisión
- Modo multi-tenant — Aislamiento y configuración de tenants
- Configuración en tiempo de ejecución (Systemplane) — Parámetros de tiempo de ejecución y ajustes en el nivel del sistema
Conciliación diaria
- Carga de archivos — Importar datos de transacciones a través de la API
- Revisión de coincidencias — Inspeccionar los resultados y los grupos de coincidencia
- Resolución de excepciones — Workflows de excepciones y resolución
- Generación de informes — Dashboard, informes de conciliados/no conciliados/diferencias y exportaciones
Integraciones
- Integración con Midaz — Usar Matcher con datos del ledger de Midaz
- Fuentes externas — Conectar extractos bancarios y sistemas de terceros
- Discovery — Descubrimiento automático de conexiones de datos externas
- Webhooks y callbacks — Notificaciones basadas en eventos
Referencia
- Puntuación de confianza — Cómo calcula Matcher la confianza de una coincidencia
- Multimoneda — Conciliación entre monedas
- División y agregación — Patrones de coincidencia 1:N y N:M
- Seguridad — Autenticación, autorización y protección de datos
Casos de uso
- Conciliación de Pix — Guía paso a paso para conciliar transacciones de Pix
Lerian Console
- Uso de Matcher en Lerian Console — Resumen de la integración con la consola
- 19 páginas de consola que cubren todo el módulo Matcher:
- Contextos — Gestión de contextos, fuentes, reglas y programaciones
- Conciliación — Cargar datos, lanzar ejecuciones, revisar coincidencias
- Excepciones y disputas — Gestión de excepciones, detalles de excepciones, disputas
- Gobernanza — Mapeos de actores, registros de auditoría, archivados
- Operaciones — Dashboard, programaciones de comisiones, coincidencia manual, historial operativo
Referencia de API
- Inicio rápido para desarrolladores — Recorrido por la API desde la configuración del contexto hasta la conciliació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, fuentes, reglas, mapas de campos, programaciones, reglas de comisiones, programaciones de comisiones
- Ingesta — Trabajos de importación, búsqueda de transacciones
- Coincidencia — Ejecuciones, grupos de coincidencia
- Excepciones — Gestión de excepciones, comentarios, historial
- Disputas — Ciclo de vida de la disputa
- Informes — Métricas del dashboard (tasa de coincidencia, volumen, SLA, impacto en caja, desglose por fuente), informes de conciliados/no conciliados/diferencias con exportación
- Discovery — Conexiones, introspección de esquemas, puente de extracción
- Gobernanza — Registros de auditoría, mapeos de actores, archivados
- Exportación — Trabajos de exportación con descarga
Especificación OpenAPI
- Especificación OpenAPI 3.1 de Matcher — Especificación legible por máquina con todos los 117 endpoints, esquemas y ejemplos — verificada contra el código fuente
Correcciones principales de esta versión
- Rutas de API corregidas — Los prefijos de ruta se alinearon con el registro real de rutas de Fiber
- Campos obsoletos eliminados —
rateIdse eliminó de todos los esquemas (la API lo rechaza desde que quedó obsoleto) - Esquemas faltantes agregados — Se agregaron los arreglos en línea
sourcesyrulesaCreateReconciliationContextInput - Especificación de API reforzada — Los valores de enum que contienen dos puntos (
1:1,1:N,N:M) ahora van entre comillas para evitar que el parser los interprete mal - Ejemplos de las guías corregidos — Se corrigieron las URL de endpoint incorrectas en los ejemplos de curl en todos los idiomas
Impacto
Esta es una actualización de documentación. Las integraciones existentes no necesitan una migración solo por esta nota de versión.
Qué debes hacer
1
Revisa la documentación renovada de Matcher antes de planificar trabajo nuevo de implementación de Matcher.