Maxpho Commerce 11 Gestión CSV Fecha: 20 Septiembre 2011 Versión : 1.1 Autor: Maxpho Ltd
Índice general 1 - Introducción... 3 1.1 - El archivo CSV... 3 1.2 - Módulo CSV en Maxpho... 3 1.3 - Módulo CSV Pro en Maxpho...4 2 - Características CSV...6 2.1 - Estructura de interfaz CSV...6 2.2 - Importación de productos...7 3 - Automatismos... 8 3.1 - Importaciones de productos...8 3.2 - Exportaciones de pedidos... 8 3.3 - Ejemplos...9 Pág. 2 de 9
1 Introducción Este documento presentará las opciones de uso y de interacción a través de los archivos CSV con el software Maxpho Commerce, en concreto con la importación de los registros de los productos y la exportación de la información de los pedidos. Maxpho tiene dos módulos para la interacción con los archivos CSV: Módulo CSV Módulo CSV Pro Las especificaciones técnicas de integración se pueden consultar en la dirección web siguiente: http://developers.maxpho.com/csv/ 1.1 El archivo CSV El CSV (Comma Separated Value) es un formato de almacenamiento de datos muy común basado en archivos de texto, utilizado normalmente para la importación y exportación de gran cantidad de datos archivados en una estructura tabular. Este formato es muy utilizado en el mundo web para el intercambio de información por dos motivos principales: Facilidad de uso, creación y manipulación de archivos CSV; Dimensión de archivo reducida con la consiguiente baja carga de red y alta velocidad de transmisión. 1.2 Módulo CSV en Maxpho Este módulo para la interacción simple de los CSV permite establecer el ajuste de importación y exportación de los archivos CSV directamente desde un panel en la administración. En lo que respecta a la importación de los registros, se pueden establecer algunos valores predeterminados en el sistema para acelerar la fase de importación como: Separador de los campos predeterminados (modificable en la importación individual); Separador de las cifras decimales predeterminadas (modificable en la importación individual); Pág. 3 de 9
Idioma predeterminado (modificable en la importación individual); Porcentaje de aumento de precios (se puede aplicar sobre cada precio en el CSV); Inclusión automática en la categoría ebay aconsejada para el producto; Número de líneas a importar simultáneamente (herramienta que permite acelerar la importación en algunos casos hasta 100 veces). En cuanto a la exportación de los pedidos se pueden establecer algunos valores predeterminados para indicar al sistema cómo extraer los datos: Campos a exportar. Codificación del salto de párrafo (Windows/Unix); Dirección del servidor FTP (servidor al que será exportado el CSV); Password del servidor FTP (servidor al que será exportado el CSV); Directory server (servidor en el que será exportado el CSV); 1.3 Módulo CSV Pro en Maxpho A través del uso del módulo más avanzado, llamado CSV Pro, se puede proporcionar al sistema una plantilla de importación para utilizarla en cada ocasión que necesitará importar un CSV ya conocido. El sistema guardará el título del CSV para poderlo reconocer en las siguientes importaciones sin pedir nuevamente al usuario que establezca la configuración para el CSV, de esta forma se pueden establecer también automatismos de importación. La configuración que se puede proporcionar en la creación de la plantilla de importación son: Asociación de los campos del título; Separador de campos; Separador de cifras decimales; Idioma predeterminado de importación; Nombre de la plantilla de importación; Importación automática de las categorías; Importación automática de los proveedores; Campos necesarios (que deben contener un valor) de modo que una fila se importe; Pág. 4 de 9
Campos a actualizar, es decir los campos que el sistema comprobará si han sido puestos al día o no de un producto; Filtro de categorías, de otro modo el sistema importará únicamente los productos asignados a determinadas categorías; Filtro de productores, de otra forma el sistema importará sólo los productos asignados a determinados productores; Recarga porcentual o fija para cada campo numérico del CSV; Filtro del umbral numérico, entonces el sistema importará sólo los productos cuyo valor numérico se encuentre entre el umbral establecido; url FTP o HTTP de importación del CSV, o el lugar donde el sistema descargará automáticamente el CSV; Usuario y contraseña FTP en el caso en que el CSV que se desea descargar se encuentre en un servidor FTP; Intervalo de importación, cantidad de veces que el sistema importará cada día el CSV. Pág. 5 de 9
2 Características CSV Un archivo CSV construido de acuerdo con las características de codificación y de estructuración del formato CSV puede ser utilizado en el ingreso a Maxpho para poblar su tienda online. En la fase de importación se pueden insertar: Los registros de los productos: todos los campos del producto (nombre, modelo, descripción, peso, etc...) y, si en la tienda online está disponible, las características asociadas al proveedor o fabricante que el comprador deberá indicar en la fase de compra; Categoría de la tienda: si se solicita, todas las categorías con las cuales son asignadas los productos que el sistema importa y que no están presentes en la base de datos de Maxpho serán creadas de modo automático y asignadas al artículo; Proveedores/fabricantes: como para las categorías, el sistema tiene la posibilidad de insertar de modo automático y asignar el proveedor/fabricante al producto en el caso en el cual esto no esté ya presente en la Administración de Maxpho. Maxpho no vincula las características en las cuales está estructurado el CSV puesto que la aplicación se instala sobre una plataforma Linux. Para evitar problemas de codificación de caracteres especiales se requiere que el CSV tenga codificación UTF 8. 2.1 Estructura de interfaz CSV Siendo el CSV un formato de archivación de los más comunes, este tipo de interacción ha estado desarrollado con la intención de proporcionar la posibilidad de interfaz con arquitecturas diferentes y dando la posibilidad al vendedor de no tener que alterar o modificar los instrumentos que actualmente utiliza. Para una interconexión de este tipo son necesarios pocos pasos que pueden ser indivizualizados en dos macroestructuras: Generación Data Feed: a partir de los instrumentos en posesión del comprador es necesario exportar del formato CSV todos los datos que se deben importar al interno de la aplicación de Maxpho. Siendo el CSV un formato de archivo muy común y conocido, la mayor parte de las aplicaciones dan la posibilidad de exportar la información en este formato, en el caso en que en cambio, la exportación no fuera posible directamente en formato CSV están presentes muchos instrumentos que manipulan el archivo exportado y proporcionan un CSV en salida; Pág. 6 de 9
Importación Data Feed: Una vez generado el sistema de alimentación de datos con toda la información de interés, a través de una interfaz user friendly viene pedido al vendedor las características estructurales del archivo para permitir el correcto análisis del sistema. Una vez completada esta primera fase, en modo totalmente automático, el sistema provee la inserción de todas las informaciones contenidas en la data feed. Una vez completado el proceso (la velocidad de inserción se reduce si el sistema tiene la necesidad de recuperar información online como la imagen del producto) se puede controlar el resultado de la importación en el interior de la ventana de artículos. 2.2 Importación de artículos La importación de artículos es un mecanismo desarrollado con el propósito de optimizar y reducir la posibilidad de errores en fase de implementación de la tienda online. Actualmente, el problema principal en la creación de una tienda online es la inserción de los artículos. La inserción de la descripción, de las imágenes y de las características de todos los datos relativos al producto requieren un esfuerzo notable humano con la consiguiente posibilidad de cometer errores. Mejorando esta fase gracias al uso de instrumentos standard y optimizados, la importación permite la creación y la renovación de la propia base de datos en una forma simple, rápida y reduciendo notablemente los errores en la inserción de datos. Este módulo está caracterizado por una elevada flexibilidad que puede ser identificada principalmente a través de algunas de las siguientes características: Carga Multilingüística: Los artículos son caracterizados en función del idioma. Si la tienda posee más de un idioma, para la publicación del artículo en fase de implementación mediante el archivo CSV, el vendedor tiene la posibilidad de proporcionar un valor para todos los idiomas en los que quiere que el producto se inserte. Gestión de atributos: Si para el almacén existe la posibilidad, es posible indicar en fase de carga del archivo CSV la variable de un artículo gestionando la cantidad sobre la característica que se está insertando. Carga de imágenes: Se puede indicar en el archivo CSV un url HTTP con el cual el sistema puede encontrar imágenes del artículo: en este caso el sistema dispone de un modo automático para descargar la imagen redimensionándola correctamente. Pág. 7 de 9
3 Automatismos Además de permitir el intercambio de archivos con el programa es posible automatizar las interacciones sin la necesidad de acceder al panel de Maxpho Commerce. De esta forma, las operaciones de agregar nuevos artículos y modificar los viejos productos es completamente transparente al usuario y puede ser cómodamente realizada, por ejemplo, durante la noche. 3.1 Importación de productos Mediante el sistema CSV Pro es posible automatizar la importación de los productos de un URL HTTP o de un servidor FTP. Para permitir que esto se produzca es suficiente establecer la configuración del CSV Pro directamente desde la administración de Maxpho Commerce. La información requerida será: URL donde está presente el archivo CSV; Nombre del usuario (solo en el caso de acceso FTP); Contraseña (solo en el caso de acceso FTP); directorio (solo en el caso de acceso FTP); El número de vueltas al día que el CSV debe ser descargado y puesto al día del sistema. 3.2 Exportación de los pedidos Los pedidos se pueden exportar de forma automática utilizando módulos CRON sobre el servidor existente. La exportación se puede hacer de dos modos: 1. El archivo se guarda en la carpeta pub/outgoing_data/ del servidor existente; 2. El archivo se guarda directamente en un directorio de un servidor externo gracias al protocolo FTP. Pág. 8 de 9
3.3 Ejemplos A continuación mostramos algunos ejemplos de uso de las metodologías descritas en el documento: Importación de una url HTTP diaria: Insertando la URL HTTP en la configuración del CSV Pro, el sistema cargará diariamente el archivo de la URL copiando el archivo en el servidor local donde está posicionado el sitio, como log del sistema, y cargando nuevos artículos y todas las modificaciones de los productos en administración. Si, por ejemplo, eligiésemos importar en automático las características, el sistema controlaría para cada una de las categorías presentes en el archivo CSV si la misma está presente también en el ecommerce, en caso contrario la introduciría automáticamente permitiendo así mostrar todos los nuevos productos sin la necesidad de una intervención humana y manual del sistema. Carga automática de un archivo existente sobre el servidor: Se puede automatizar la carga de un CSV que ha estado ya cargado directamente sobre el servidor y que alberga el dominio en la carpeta /pub/incoming_data del servidor. El sistema, a intervalos estables de la administración del negocio, controlará si en la carpeta hay nuevos archivos y las modificaciones de los productos de modo transparente al usuario, guardando así el CSV en la carpeta /pub/csv como log del sistema. Descarga de archivos de los pedidos de un sistema FTP: estableciendo las credenciales de acceso y una carpeta a un servidor FTP es posible descargar sobre el servidor, a intervalos regulares, un CSV de todos los pedidos. El automatismo permite crear archivos CSV que contienen solo los nuevos pedidos desde la última exportación y aquellos que han sufrido un cambio de estado, como por ejemplo de "En espera" a "Pago recibido". Pág. 9 de 9