Tipos de fuente admitidos
Matcher admite cinco tipos de fuente. Cada uno representa una categoría de origen de datos:
Métodos de ingesta
Los datos de transacciones llegan a Matcher por varias rutas:
Ingesta basada en archivos
El método más común para extractos bancarios y exportaciones de ERP.
Subida manual
Usa el endpoint de subida de archivos para importar archivos de transacciones a mano.Conexiones bancarias
Formato bancario estándar
La mayoría de los bancos entregan extractos en un formato que Matcher parsea de forma nativa (CSV, OFX, camt.053 o los layouts brasileños CNAB):El objeto
config es metadato descriptivo de forma libre. Matcher lo almacena pero no interpreta claves como bank_name o statement_format. En su lugar, Matcher actúa sobre estas claves reservadas cuando las defines: dialect, fail_on_error_rate_percent, duplicate_policy, duplicate_key, blank_external_id, camt053, connection_id y connection_config_name.Conexiones con ERP y personalizadas
Usa el tipo de fuente
CUSTOM para sistemas ERP (SAP, Oracle, NetSuite, etc.) y cualquier otra fuente de datos que no encaje en las categorías BANK, LEDGER o GATEWAY.
Ejemplo: fuente de ERP
Conexiones con procesadores de pago
Stripe
Adyen
Redes de tarjetas
Para los archivos de liquidación de redes de tarjetas (Visa, Mastercard, Elo), usa el tipo de fuenteCUSTOM:
Seguridad de las conexiones
Firmas de webhook
Matcher verifica los webhooks entrantes de los agregadores con una firma HMAC-SHA256 o una lista de IP de origen permitidas, como describe Conexiones con agregadores. Las entidades de fuente no tienen una configuraciónsettings.webhook.
Requisitos de formato de datos
Campos obligatorios
Los mapas de campos usan un vocabulario canónico cerrado: las claves del mapeo son fijas y los valores nombran la columna en crudo de la fuente. Estas claves canónicas son obligatorias:Campos opcionales
Matcher no acepta ninguna otra clave.
Usa
direction cuando un archivo marca cada fila como débito o crédito en una columna separada. column nombra esa columna, y debit y credit son los valores que contiene. Matcher importa una fila de débito con un monto negativo y una fila de crédito con un monto positivo. Cuando mapeas direction, las celdas de monto no pueden llevar signo. Un monto con signo, una celda de dirección vacía o un valor de dirección desconocido rechaza la fila. Matcher aplica direction solo a entradas CSV, JSON y XML.
Mapeo de campos
Administra los mapas de campos con el endpoint dedicado (no con el objetoconfig de la fuente). El cuerpo de la solicitud es un único objeto mapping de pares { canonicalKey: sourceColumnName }:
cURL
Mejores prácticas
Valida los archivos antes de subirlos
Valida los archivos antes de subirlos
Verifica que los archivos subidos contengan columnas para los campos canónicos obligatorios (external_id, amount, currency, date) antes de subirlos. Esto evita errores de ingesta.
Usa formatos de archivo consistentes
Usa formatos de archivo consistentes
Estandariza un único formato (CSV, JSON o XML) por fuente para simplificar el mapeo de campos y reducir errores.
Protege bien las credenciales
Protege bien las credenciales
Nunca incluyas credenciales en los payloads de configuración.
Prueba primero con datos de muestra
Prueba primero con datos de muestra
Valida el mapeo de campos y la calidad de los datos con archivos de muestra antes de subir datos de producción.
Próximos pasos
Mapeo de campos
Configura cómo se mapean los campos de origen a Matcher.
Subida de archivos
Procedimientos de subida manual de archivos.