Mapeadores de Importación
Categoría:
Temas en este documento:
- Dónde encontrar los Mapeadores
- Tipos de Mapeadores de Importación
- Agregar un nuevo Mapeador de Importación
- Ejemplo de caso de uso
- Resumen de pestañas disponibles
- Mejores prácticas
Los mapeadores de importación en Tridens Monetization le permiten transformar y alinear datos externos (CSV, archivos planos, etc.) en formatos compatibles con el sistema. Ya sea importando datos de pago, eventos o transacciones bancarias, los mapeadores de importación aseguran que el sistema interprete e ingiera correctamente los datos estructurados de plataformas externas.
Dónde encontrar los Mapeadores
Navegue a:Business Configuration > Import
Figura 1: Página predeterminada de Mapeadores de Importación
Tipos de Mapeadores de Importación
En la parte superior de la pantalla de Import Mappers, encontrará cuatro pestañas, cada una de las cuales representa un dominio de datos diferente. Todas las pestañas comparten la misma estructura de configuración:
- Payment Mappers
- Direct Debit Mappers
- Event Mappers
- Bank Mappers
Cada pestaña le permite Add a new mapper utilizando un formulario como el que se muestra en la captura de pantalla.
Agregar un nuevo Mapeador de Importación
Haga clic en el botón Add en cualquiera de las cuatro pestañas para abrir el formulario Create Mapper. Los campos que debe completar son idénticos para todos los tipos de mapeadores.
Campos requeridos
Tabla 1: Campos requeridos
| Campo | Descripción |
|---|---|
| Name | Un nombre único y descriptivo para el mapeador (p. ej., Bankart Payment Mapper) |
| Code | Un identificador de sistema utilizado internamente (p. ej., BANKART_01) |
| Description | Opcional. Agregue notas sobre el propósito o la fuente de este mapeador |
| Prefix | Opcional. Se utiliza para añadir valores únicos durante el mapeo |
| Import Mode | Define la estructura del archivo de entrada. Opciones: Single o Multi |
| Delimiter | Delimitador de archivo, normalmente coma ,, tabulación \t o punto y coma ; |
| File | Cargue el archivo de plantilla de mapeo (normalmente en formato CSV o TXT) |
Figura 2: Página de creación de Mapeador de Importación
Ejemplo de caso de uso
Está importando un archivo CSV de un proveedor de pagos (p. ej., Stripe) que incluye columnas para el ID de transacción, el ID del cliente, el importe y el estado.
Creará un Payment Mapper para alinear esas columnas con los campos esperados en Tridens.
Resumen de pestañas disponibles
Cada pestaña bajo Import Mappers acepta los mismos campos:
1. Mapeadores de Pago
Se utiliza para importar datos de transacciones sin procesar de sistemas de pago externos.
2. Mapeadores de Débito Directo
Mapea los datos de órdenes de débito o mandatos de bancos o PSP (ang. Payment Service Provider).
3. Mapeadores de Eventos
Importa eventos (p. ej., eventos de uso, disparadores) que afectan a la lógica de clasificación o cobro.
4. Mapeadores Bancarios
Se utiliza para integrar estados de cuenta bancarios importados o archivos de conciliación.
Mejores prácticas
Info “Consejo” - Utilice convenciones de nomenclatura coherentes para códigos y prefijos. - Pruebe siempre su archivo de mapeo en un entorno sandbox antes del uso en producción. - Elija el delimitador correcto según su fuente de datos (CSV, TSV, etc.). - Guarde copias de seguridad de las plantillas de mapeo y los archivos de prueba.
