Introducción
La importación de datos de productos es el primer paso para gestionar su inventario y catálogo en Vendably. Puede traer sus productos de dos formas: conectando directamente su plataforma de comercio electrónico mediante OAuth para sincronización automática, o importando un archivo de datos en formato CSV, XML o JSON. Esta guía le explica cómo funcionan ambos métodos, cómo se asignan los campos de datos a la estructura estándar de Vendably, y qué esperar en cada etapa del proceso.
Métodos de importación de datos
Existen dos enfoques principales para llevar datos de productos a Vendably:
Conexión directa de plataformas mediante OAuth
La conexión directa vincula su tienda en línea con Vendably de forma automática. Los datos se sincronizan en tiempo real cada vez que realiza cambios en su plataforma de origen. Las plataformas soportadas incluyen:
- Shopify
- WooCommerce
- BigCommerce
Cuando conecta una plataforma, Vendably establece una conexión segura mediante OAuth. Esto significa que usted autoriza a Vendably a acceder a sus datos de productos sin compartir contraseñas. La conexión permanece activa y recibe actualizaciones automáticas cada vez que modifican precios, disponibilidad, nombres de productos o agregan nuevos artículos.
Importación de archivos
Puede importar datos de productos mediante archivos en los siguientes formatos:
- CSV (valores separados por comas)
- XML (lenguaje de marcado extensible)
- JSON (notación de objetos JavaScript)
Los archivos pueden importarse manualmente en un momento específico, o puede configurar una extracción automática por FTP en intervalos programados. Esta opción es útil si sus productos provienen de un sistema de gestión de inventario personalizado, un proveedor mayorista o una plataforma no soportada directamente.
Sincronización en tiempo real mediante webhooks
Una de las ventajas principales de conectar una plataforma directamente es la sincronización en tiempo real mediante webhooks. Un webhook es una notificación automática que su plataforma de origen envía a Vendably cada vez que ocurre un cambio.
Cuando se activa un webhook, Vendably recibe información sobre:
- Cambios de precio
- Actualizaciones de disponibilidad de stock
- Nuevos productos añadidos
- Cambios en descripciones o títulos
- Eliminación de productos
Esto significa que sus datos en Vendably permanecen siempre actualizados sin que usted tenga que hacer nada. No depende de importaciones programadas ni de archivos enviados manualmente. Los cambios que realiza en su tienda se reflejan en Vendably automáticamente.
Mapeo de campos de datos
Cuando importa datos de productos, ya sea desde una plataforma conectada o desde un archivo, Vendably debe entender qué significa cada campo de datos. El mapeo de campos es el proceso de asignar los campos de su fuente de datos a los campos estándar de Vendably.
Cómo funciona la detección automática
Vendably analiza automáticamente los campos en su fuente de datos e intenta detectar qué representa cada uno. Por ejemplo, si su archivo CSV tiene una columna llamada 'precio', Vendably la reconocerá como el campo price. Si tiene una columna 'código SKU', la asignará al campo mpn (número de parte del fabricante).
Esta detección automática funciona bien en la mayoría de los casos, pero no siempre es perfecta. Algunos campos pueden tener nombres no estándar o ambiguos.
Ajuste manual del mapeo
Si la detección automática no es correcta, puede ajustar el mapeo manualmente. Esto significa que puede decirle a Vendably exactamente qué campo de su fuente de datos corresponde a cada campo estándar de Vendably.
Por ejemplo, si su archivo tiene una columna llamada 'stock_disponible' que debería mapearse al campo availability, puede especificar esa asignación. El mapeo se guarda con la fuente de datos, por lo que las importaciones futuras utilizarán la misma configuración.
Los campos estándar de Vendably incluyen:
| Campo | Descripción | Obligatorio |
|---|---|---|
| id | Identificador único del producto | Sí |
| title | Nombre del producto | Sí |
| description | Descripción del producto | No |
| price | Precio del producto | Sí |
| availability | Estado de disponibilidad (disponible, agotado, etc.) | No |
| mpn | Número de parte del fabricante o SKU | No |
| gtin | Código de barras (EAN, UPC, ISBN) | No |
| brand | Marca del producto | No |
| condition | Condición del producto (nuevo, reacondicionado, usado) | No |
| image_link | URL de la imagen principal del producto | No |
| product_type | Categoría o tipo de producto | No |
| google_product_category | Categoría de Google Merchant Center | No |
| item_group_id | Identificador para agrupar variantes | No |
| link | URL del producto en su tienda | No |
Etapas del proceso de importación
Cuando importa datos de productos, Vendably sigue una serie de etapas para procesar, validar y preparar sus datos. Entender estas etapas le ayuda a diagnosticar problemas y optimizar sus importaciones.
1. Obtención (Fetch)
En esta etapa, Vendably obtiene los datos de su fuente. Si está conectando una plataforma, Vendably extrae los datos a través de la API de esa plataforma. Si está importando un archivo, Vendably lee el archivo CSV, XML o JSON que usted ha proporcionado o que se ha descargado por FTP.
2. Importación (Import)
Vendably procesa los datos sin procesar y los ingiere en su base de datos. Esto incluye la validación básica para asegurar que los datos tienen el formato correcto y que contienen los campos obligatorios. Si hay errores de formato, Vendably los registra y puede pausar la importación para que los corrija.
3. Postprocesamiento (Post-process)
En esta etapa, Vendably limpia y estandariza los datos. Esto puede incluir:
- Eliminar espacios en blanco innecesarios
- Convertir valores a los tipos de datos correctos (números, fechas, etc.)
- Normalizar campos como disponibilidad o condición
- Procesar imágenes y URLs
4. Análisis (Analyse)
Vendably analiza la calidad y completitud de sus datos. Identifica campos faltantes, valores inválidos o incoherencias. Este análisis le proporciona un informe de la salud de sus datos, mostrándole qué productos tienen información incompleta o problemática.
5. Aplicación de superposiciones de suplemento (Apply supplement overlays)
Esta etapa permite que datos de múltiples fuentes se combinen. Si tiene información de productos en varias fuentes (por ejemplo, datos básicos en Shopify e información de inventario en un archivo CSV), Vendably puede fusionarlos. Los datos de suplemento rellenan campos faltantes o actualizan campos específicos sin sobrescribir toda la información del producto.
6. Finalización (Complete)
En la etapa final, los datos están listos para usar. Los productos aparecen en el Product Hub y están disponibles para exportación a canales, aplicación de reglas de feed y otras operaciones. En este punto, la importación se considera completada con éxito.
Dónde acceder a las importaciones
Las importaciones de datos se gestionan en dos ubicaciones principales de Vendably:
DataHub
DataHub es el centro de control para gestionar todas sus fuentes de datos. Aquí puede:
- Ver todas las fuentes conectadas (plataformas y archivos)
- Crear nuevas conexiones o importaciones
- Configurar el mapeo de campos
- Ver el historial de importaciones
- Descargar informes de errores
Sources (Fuentes)
La sección Sources le muestra un resumen de cada fuente de datos conectada, incluyendo:
- Fecha de la última sincronización
- Número de productos importados
- Estado de la conexión (conectado, error, etc.)
- Configuración de la fuente
Permisos y acceso
Diferentes roles en Vendably tienen diferentes permisos para trabajar con importaciones de datos:
| Rol | Crear/Editar fuente | Importación manual | Ver datos importados |
|---|---|---|---|
| Owner | Sí | Sí | Sí |
| Admin | Sí | Sí | Sí |
| Editor | No | Sí | Sí |
| Viewer | No | No | Sí |
- Owner y Admin pueden crear nuevas fuentes de datos, editar configuraciones de mapeo y ejecutar importaciones manuales.
- Editor puede ejecutar importaciones manuales en fuentes ya existentes, pero no puede crear ni editar fuentes.
- Viewer puede navegar y ver los datos de productos importados, pero no puede realizar importaciones ni modificar fuentes.
Esta estructura de permisos asegura que solo los usuarios autorizados realicen cambios en la configuración de importación, mientras que todo el equipo puede acceder a los datos de productos.
Proceso paso a paso: Conexión de una plataforma
Para conectar su tienda Shopify, WooCommerce o BigCommerce:
- Acceda a DataHub en Vendably.
- Haga clic en 'Nueva fuente' o 'Conectar plataforma'.
- Seleccione la plataforma (Shopify, WooCommerce o BigCommerce).
- Será redirigido a la página de autorización de esa plataforma.
- Autorize a Vendably a acceder a sus datos de productos.
- Regrese a Vendably, donde la conexión se establecerá automáticamente.
- Revise el mapeo de campos sugerido y ajuste si es necesario.
- Haga clic en 'Iniciar sincronización' para traer sus productos.
- Espere a que se completen las etapas de procesamiento.
- Verifique que sus productos aparezcan en el Product Hub.
Una vez completado, su tienda estará conectada y recibirá actualizaciones automáticas.
Proceso paso a paso: Importación de un archivo
Para importar un archivo CSV, XML o JSON:
- Acceda a DataHub.
- Haga clic en 'Nueva fuente' o 'Importar archivo'.
- Seleccione el formato de archivo (CSV, XML o JSON).
- Cargue su archivo o proporcione detalles de FTP si desea importaciones automáticas programadas.
- Vendably analizará el archivo y sugerirá un mapeo de campos.
- Revise y ajuste el mapeo según sea necesario.
- Especifique cualquier configuración adicional (delimitador CSV, hoja de cálculo, etc.).
- Haga clic en 'Importar' para procesar el archivo.
- Monitoree el progreso a través de las etapas de importación.
- Revise el informe de errores si hay problemas.
- Verifique que los productos aparezcan correctamente en el Product Hub.
Si configura FTP, las importaciones futuras ocurrirán automáticamente según el cronograma que establezca.
Validación y resolución de problemas
Después de una importación, es importante validar que sus datos se hayan importado correctamente:
Verificar el mapeo de campos
Revise que cada campo de su fuente se haya mapeado al campo correcto de Vendably. Los errores de mapeo son la causa más común de datos incorrectos en el Product Hub. Por ejemplo, si su precio se mapeó al campo title, verá números en lugar de nombres de productos.
Revisar el informe de importación
Vendably genera un informe detallado después de cada importación. Este informe incluye:
- Número de productos importados exitosamente
- Número de productos con errores
- Campos obligatorios faltantes
- Valores inválidos o fuera de rango
- Advertencias sobre datos incompletos
Inspeccionar productos en el Product Hub
Navegue al Product Hub y revise una muestra de productos importados. Verifique que:
- Los títulos, descripciones y precios sean correctos
- Las imágenes se hayan cargado
- La disponibilidad y el stock sean precisos
- Los campos personalizados contengan los datos esperados
Corregir errores
Si encuentra errores, puede:
- Ajustar el mapeo de campos y reimportar
- Corregir los datos en su fuente y volver a importar
- Editar productos individuales en el Product Hub (solo para correcciones puntuales, no para cambios masivos)
Integración con otros procesos
Una vez que sus datos de productos están en Vendably, puede utilizarlos en otros procesos:
- Aplicar reglas de feed para filtrar y transformar productos en exportación
- Gestionar alojamiento de imágenes y cumplimiento de canales mediante CDN
- Enriquecer contenido con la biblioteca de contenidos y generación con IA
Resumen
Importar datos de productos en Vendably es un proceso flexible que se adapta a su infraestructura. Si usa Shopify, WooCommerce o BigCommerce, la conexión directa mediante OAuth le proporciona sincronización automática en tiempo real sin esfuerzo adicional. Si sus productos provienen de otra fuente, la importación de archivos CSV, XML o JSON le permite traer datos manualmente o en un cronograma automático.
El mapeo de campos es el elemento clave que asegura que sus datos se interpreten correctamente. La detección automática funciona bien en la mayoría de los casos, pero siempre puede ajustarla manualmente si es necesario.
Una vez importados, sus datos pasan por varias etapas de procesamiento (obtención, importación, postprocesamiento, análisis, aplicación de superposiciones y finalización) antes de estar listos para usar. Validar que los datos se hayan importado correctamente mediante la revisión del mapeo, los informes de importación y una inspección manual del Product Hub le asegura que sus productos estén listos para exportación y distribución en canales.
Los permisos de rol garantizan que solo los usuarios autorizados gestionen las fuentes de datos, mientras que todo el equipo puede acceder a los productos importados. Con esta base sólida de datos de productos, puede proceder con confianza a las siguientes etapas: enriquecimiento de contenido, aplicación de reglas de feed y distribución a canales de venta.