Artículos de Importador
Configuración
Casos prácticos
ReferenciaNivel avanzado4 min de lecturaRevisado el
Funciones y opciones del editor avanzado del transformador
Referencia de las funciones de transformación, la concatenación, los valores fijos, el switch de equivalencias y las entidades dinámicas.
El Editor Avanzado se abre al hacer clic sobre un campo del objeto de salida de un transformador, sin tener un origen seleccionado. Tiene tres pestañas: Transformaciones, Concatenar y Valor Fijo. Los cambios se aplican con Actualizar.
En WeSyncro:ImportadorTransformadores
Transformaciones#
En Secuencia de Ejecución agregas funciones con Agregar función. Se aplican en el orden en que aparecen, y cada paso muestra su Resultado con el dato de ejemplo.
| Función | Qué hace | Ejemplo |
|---|---|---|
| Texto a minúscula | Pasa todo a minúsculas. | "JUAN" queda "juan" |
| Texto a mayúscula | Pasa todo a mayúsculas. | "juan" queda "JUAN" |
| Capitalizar | Primera letra en mayúscula y el resto en minúsculas. | "jUAN pérez" queda "Juan pérez" |
| Limpiar RUT (Sin puntos/Guion) | Deja solo dígitos y la letra K, en mayúscula. | "76.123.456-k" queda "76123456K" |
| Quitar espacios extra | Quita los espacios al inicio y al final. | " abc " queda "abc" |
| Convertir a entero | Convierte a número entero. Si no es un número, deja 0. | "250" queda 250 |
| Convertir a decimal | Convierte a número con decimales. Si no es un número, deja 0. | "12.5" queda 12.5 |
| Convertir a texto | Convierte el valor a texto. | 72000 queda "72000" |
| Fecha ISO (Luxon) | Interpreta fechas en formato ISO, aaaa-mm-dd o dd/mm/aaaa y las entrega en formato ISO con la zona horaria de Chile continental. | "15/03/2026" queda como fecha ISO del 15 de marzo de 2026 |
| Switch / Equivalencias | Reemplaza valores según una tabla de casos. | Ver más abajo. |
| Función Personalizada (JS) | Ejecuta un código JavaScript propio. | Ver más abajo. |
Dos reglas generales:
- Si la celda viene vacía, las funciones no se aplican y el campo queda sin valor.
- La conversión a decimal espera punto como separador. Un valor como "12,5" se lee como 12.
Switch de equivalencias#
Sirve para traducir códigos de tu planilla a los valores que espera el destino. En Configurar Switch agregas filas con Agregar caso:
| Case | Salida |
|---|---|
| UN | unidad |
| KG | kilogramo |
| CJ | caja |
Si el valor de entrada no coincide con ningún caso, se mantiene el valor original. La comparación es exacta: "kg" y "KG" son valores distintos, por lo que conviene aplicar antes Texto a mayúscula.
Función personalizada#
En Programar Función Personalizada escribes el cuerpo de una función que recibe el valor en la variable val y debe devolver el valor transformado con return.
// Deja solo los dígitos de un teléfono
return val.toString().replace(/[^0-9]/g, "");
Guarda con Guardar y Aplicar. Si el código falla al ejecutarse, el valor pasa sin cambios.
Concatenar#
Une varios campos de origen en un solo campo de salida. En Campos Concatenados buscas y agregas cada campo adicional, y defines su Separador, que por defecto es un espacio.
Valor fijo#
En Establecer un valor fijo escribes un valor que será el mismo para todas las filas, ignorando cualquier mapeo. Es útil para campos obligatorios del destino que no existen en tu archivo, como una moneda.
Si escribes un objeto JSON válido, se guarda como objeto en vez de texto.
Entidades dinámicas#
Las entidades permiten completar un registro con datos que ya existen en WeSyncro. Por ejemplo: tu planilla trae el RUT del cliente y el destino necesita su identificador interno.
Se configuran en la pestaña Entidades del objeto de entrada, con el botón Agregar.
- ID de la EntidadTextoObligatorio
Nombre con que la usarás en el mapeo, por ejemplo
cliente_data.- Tipo de EntidadListaObligatorio
Cliente, Dealers (Wesyncro), Producto o Vendedor.
- Campo de Búsqueda (en WeSyncro)ListaObligatorio
Por qué dato se busca. Para Cliente: RUT, correo o identificador externo, entre otros. Para Producto: SKU o identificador externo. Para Vendedor: identificador externo o correo.
- Ruta del valor origenTextoObligatorio
La columna de tu archivo que contiene el dato a buscar.
- Transformaciones Previas a la BúsquedaLista
Funciones que se aplican al dato antes de buscar, por ejemplo Limpiar RUT.
La búsqueda es por coincidencia exacta dentro de tu cuenta y trae un solo registro. Una vez creada la entidad, sus campos aparecen en la pestaña Visual bajo Entidades dinámicas (enriquecimiento) y se unen a los campos de salida igual que una columna.
En Previsualizar, la pestaña Entidades muestra qué encontró cada búsqueda. Si aparece "No se encontraron entidades para mostrar.", el dato de ejemplo no existe en tu cuenta o el formato no coincide.
Mensajes del editor#
| Mensaje | Qué significa |
|---|---|
| "Debes agregar al menos una equivalencia." | Guardaste un switch sin casos. |
| "Error al identificar el campo base. Debes homologar un campo primero o usar un valor fijo." | Intentaste aplicar funciones a un campo que todavía no tiene origen. |
| "Todos los campos son obligatorios" | Falta un dato al guardar una entidad. |