Saltar al contenido principal
Antes de usar Matcher, confirma que tienes lo que describe esta página.

Opcional: conciliar datos de Midaz


Matcher se combina con Midaz Ledger, pero no hay un conector en vivo entre ellos. Matcher no abre ninguna conexión con Midaz. Conciliar datos de Midaz es del todo opcional. Matcher funciona como un producto independiente que concilia cualquier fuente de datos.

Cuándo conciliar datos de Midaz

Concilia los datos del ledger de Midaz si:
  • Usas Midaz como tu sistema de ledger
  • Quieres conciliar los asientos de Midaz contra fuentes externas (extractos bancarios, informes de gateway)

Cuándo Midaz no participa

Matcher funciona de forma independiente cuando:
  • Se concilia entre sistemas externos (bancos, ERP, procesadores de pago)
  • Se usa otro sistema de ledger
  • Se importan datos del ledger mediante archivos CSV/JSON/XML

Cómo funciona

Matcher concilia los datos de Midaz igual que ingiere cualquier fuente (por importación, no por consulta en vivo):
  1. Exporta los datos del ledger del período que quieres conciliar.
  2. Importa esa exportación a un contexto de Matcher como una fuente de tipo LEDGER.
  3. Importa los datos de la contraparte (extracto bancario o informe de gateway) como el otro lado.
  4. Matcher empareja los dos lados con tus reglas de coincidencia.
Consulta la guía Matcher y Midaz para el flujo completo.

Autenticación


Access Manager emite el token y verifica los permisos de quien llama.

Permisos obligatorios

Permisos granulares controlan el acceso a las funciones de Matcher:

Formatos de importación genéricos


Los importadores genéricos de Matcher aceptan CSV, JSON y XML. Los parsers integrados también admiten CAMT.053, CNAB 240/400, OFX, varios formatos de adquirentes y formatos de cuentas por cobrar. Consulta el catálogo de formatos de importación para el inventario completo. Cada formato genérico tiene requisitos estructurales específicos para una ingesta correcta.

CSV (valores separados por comas)

De uso común para extractos bancarios y exportaciones. Requisitos:
  • El archivo debe tener una fila de encabezado
  • Codificación UTF-8 (configurable)
  • Delimitador de coma (configurable)
  • Campos entre comillas para valores que contienen delimitadores
Ejemplo:

JSON (notación de objetos javascript)

Recomendado para integraciones basadas en API. Requisitos:
  • Un arreglo de objetos o un solo objeto
  • Codificación UTF-8 (configurable)
  • Nombres de campo consistentes en todos los registros
Ejemplo:

XML (lenguaje de marcado extensible)

Común en integraciones empresariales y bancarias. Requisitos:
  • Un único elemento raíz
  • Codificación UTF-8 (configurable)
  • Estructura de elementos consistente
Ejemplo:

Límites de tamaño de archivo

Requisitos de red


Acceso a Matcher

Tus sistemas y usuarios acceden a la API de Matcher y al módulo Matcher de la Lerian Console en las direcciones que provee Lerian.

Acceso a tus sistemas

Para estas fuentes, Matcher se conecta al sistema que indicas, y ese sistema debe aceptar conexiones de Matcher: Las conexiones de agregador necesitan tu cuenta en Pluggy o Belvo. La entrega de eventos es opcional. Cuando Lerian la habilita para ti, Matcher publica los eventos de Eventos de Matcher como CloudEvents.

Lista de verificación


Antes de empezar, confirma que:
  • Las credenciales están disponibles: tienes un token de Access Manager
  • El acceso de red funciona: los sistemas que registras aceptan conexiones de Matcher
  • Hay un navegador disponible: lo usas para abrir el módulo Matcher de la Lerian Console
  • Los datos de prueba están listos: tienes archivos de transacciones para tu primera prueba (consulta Inicio rápido)

Próximos pasos


Inicio rápido

Ejecuta tu primera conciliación.