Importar una planilla de productos con un esquema

Caso resuelto: una librería carga la lista de precios de su proveedor creando el esquema, el transformador y el destino, y revisa los errores.

El caso

Una librería recibe cada mes una planilla de 120 productos de su proveedor y la envía a la API de su catálogo, convirtiendo códigos, nombres y unidades.

Librería El Tintero recibe cada mes la lista de precios de su proveedor en Excel y debe cargarla en el catálogo de su tienda, que recibe productos por una API. Hacerlo a mano toma una tarde. Con el Importador lo deja configurado una vez y después solo sube el archivo. Los datos y la dirección de la API son inventados; las pantallas y los campos son los reales.

Datos del caso#

Primeras filas de lista_precios_octubre.xlsx

sku	nombre	categoria	unidad	precio_neto
lap-001	lápiz grafito hb	Escritura	UN	250
cua-014	cuaderno universitario 100 hojas	Cuadernos	UN	1490
res-500	resma carta 500 hojas	Papel	CJ	3990

Los títulos están en minúsculas y sin espacios a propósito: así coinciden con los campos del esquema.

El catálogo espera cada producto con esta forma:

{
  "codigo": "LAP-001",
  "titulo": "Lápiz grafito hb",
  "categoria": "Escritura",
  "unidad": "unidad",
  "precio": 250,
  "moneda": "CLP"
}

Paso 1: crear el destino#

En WeSyncro:ImportadorDestinos

Haz clic en Nuevo Destino y completa:

Destino

Campo	Valor
Título del Destino	Catálogo tienda
Tipo de Destino	API (HTTP Request)
Método	POST
URL del Endpoint	`https://api.ejemplo.cl/v1/productos`
Cabecera: Clave	Authorization
Cabecera: Valor	La clave que entrega el catálogo

Guarda con Guardar Configuración de Destino.

Paso 2: crear el transformador#

En WeSyncro:ImportadorTransformadores

Crea y carga la entrada
Haz clic en Nuevo Transformador, nómbralo "Productos proveedor a catálogo" y usa Importar Excel con la planilla. Verás "Excel importado: 5 campos detectados."
Define la salida
En el objeto de salida, pestaña Visual, pega la estructura que espera el catálogo en Estructura de Salida Deseada (JSON).
Une los campos
Haz clic en sku y luego en codigo. Repite con nombre y titulo, categoria y categoria, unidad y unidad, precio_neto y precio.
Agrega las funciones
Abre el Editor Avanzado de cada campo de salida y aplica lo que indica la tabla siguiente.

Ajustes por campo de salida

Campo de salida	Origen	Ajuste en el Editor Avanzado
codigo	sku	Quitar espacios extra y luego Texto a mayúscula
titulo	nombre	Capitalizar
categoria	categoria	Ninguno
unidad	unidad	Switch / Equivalencias: UN a unidad, CJ a caja
precio	precio_neto	Convertir a entero
moneda	(ninguno)	Pestaña Valor Fijo: CLP

Haz clic en Previsualizar. La pestaña JSON de Resultado Probable debe mostrar el primer producto con la forma esperada: código "LAP-001", título "Lápiz grafito hb", unidad "unidad" y precio 250. Luego presiona Guardar Transformador.

Paso 3: ejecutar la importación y crear el esquema#

En WeSyncro:ImportadorImportaciones

Abre el asistente
Haz clic en Nueva Importación.
Crea el esquema
En Buscar esquema... elige Crear nuevo esquema. Escribe el nombre "Productos proveedor" y sube la planilla en Opción Rápida: Detectar desde Excel. Verás "Detectadas 5 columnas." Cambia el tipo de precio_neto a Número (Number) y presiona Guardar Esquema.
Elige las tres piezas
Selecciona el esquema "Productos proveedor", el transformador "Productos proveedor a catálogo" y, en Destino de Datos, "Catálogo tienda [API]". Haz clic en Continuar.
Sube el archivo
En Subir Archivo Excel/CSV elige la planilla. Verás "120 filas cargadas en memoria."
Revisa y procesa
En Previsualización de Datos las cinco columnas del esquema traen valores y ninguna aparece como (Ignorada). Haz clic en Procesar 120 Registros.

Aparece "Importación registrada correctamente." y vuelves al historial.

Paso 4: revisar el resultado#

La fila de la importación avanza sola hasta mostrar en Progreso 120 / 120 con la etiqueta roja "2 errores". Haz clic en Detalles.

Contadores del detalle

Total	Pendientes	Exitosos	Errores
120	0	118	2

En la tabla, las dos filas con Error muestran en Mensaje / Log destino lo que respondió el catálogo: en este caso, que el precio debe ser mayor que cero. Al mirar Datos origen se ve que esas dos filas venían con precio_neto vacío.

Paso 5: descargar el resultado#

En el detalle haz clic en Configurar descarga y crea estas columnas:

Columnas del Excel de resultado

Columna Excel	Fuente	Ruta
SKU	Datos origen	`sku`
Estado	Registro completo	`status`
Error	Registro completo	`errorMessage`
ID en catálogo	Respuesta / log destino	`response.data.id`

Presiona Guardar configuración y luego Descargar Excel. El archivo trae las 120 filas con su estado y, en las correctas, el identificador que les asignó el catálogo.

Resultado#

118 productos quedaron cargados en el catálogo.
Los 2 con error se corrigen en la planilla del proveedor, se dejan solos en un archivo nuevo y se importan otra vez con las mismas tres piezas.
El próximo mes solo hay que repetir el paso 3 desde "Elige las tres piezas": el esquema, el transformador y el destino ya existen.