Child pages
  • Parámetros de Importación de archivos CSV

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

La página de importación CSV le te permite introducir fácilmente una gran cantidad de productos a sutu catálogo, o importar datos que exportóexportaste y convertió convirtiste desde otra herramienta de comercio electrónico.

Info

CSV es un acrónimo de "valores separados por comas". Es es un un archivo de texto plano que se utiliza cuanto hay una necesidad de importar, exportar o simplemente almacenar datos en un formato no propietario. Puede Puedes obtener mayor información sobre el formato CSV en el siguiente enlace de la Wikipedia: http://es.wikipedia.org/wiki/CSV.

Image RemovedImage Added

 El proceso de importación requiere de la preparación del archivo CSV, y cumplimentar el formulario que presenta la configuración principal:

  • ¿Qué tipo de entidad desea quieres importar?. Las entidades son los tipos de datos que se pueden importar. Los "Campos disponibles" a la derecha son actualizados cuando se elige una entidad, así que debe debes conocer previamente la clase de datos que el archivo CSV debe contener.
    PrestaShop le te permite importar estos tipos de datos:
    • Categorías,
    • Productos,
    • Combinaciones,
    • Clientes,
    • Direcciones,
    • Fabricantes,
    • Proveedores,
    • Alias,
    • Pedidos a proveedores (si la Gestión avanzada de stock está activada),
    • Detalles de pedidos a proveedores (si la Gestión avanzada de stock está activada).
  • Elegir Selecciona un archivo CSV para importar. Puede Puedes importar más de un archivo a la vez, pero asegúrese asegúrate de que todos ellos contienen el mismo tipo de datos.

    Tip

    Puede Puedes descargar archivos de ejemplo para cada tipo de datos desde la sección de la derecha "Descargue ejemplos de archivos CSV". Estole te ayuda a comparar estos archivos de ejemplo consus tus propios archivos creados, de esta manera puede asegurarse puedes asegurarte de que los archivos que vas a importar están realmente preparados para ser importados a PrestaShop. Estos archivos se almacenan realmente en la carpeta /docs/csv_importde su tu instalación de PrestaShop.

  • Idioma del archivo. Los datos solamente pueden ser importados para un simple sólo idioma al mismo tiempo. Si sus tus datos utilizan más de un idioma, debe debes dividirlos en tantos archivos como idiomas tengatengas.

  • ¿Archivo codificado en ISO-8859-1?. De forma manera predeterminada, los archivos de importación deben utilizar la codificación UTF-8. Pero si sus tus archivos utilizan la norma ISO-8859-1, y prefiere prefieres no convertirlos, puede puedes marcar esta casilla.
  • Separador de campos. No todos los archivos CSV utilizan comas para separar sus valores: algunos utilizan tabulaciones, otros punto y coma, etc. Puede Puedes indicar qué separador se utiliza en el archivo CSV en este campo.
  • Separador de valor múltiple. Cuando un atributo puede soportar más de un valor, estos valores deben ser separados con un separador específico. Después de revisar sus tus archivos, indique su indica el separador utilizado aquí.
  • ¿Eliminar todos/as ___ antes de la importación?. Esta opción eliminará todas las entradas previamente existentes del tipo de datos que está estás importando. Esto le te ayuda a partir de cero.
  • ¿Usar ¿Utilizar la referencia del producto como clave?. Sólo para la importación de productos. Puede Puedes optar por dejar que PrestaShop determine la clave del producto, o que la clave del producto sea el ID del producto. En este caso, asegúrese asegúrate de que el archivo contiene la ID en todos los productos que quiera quieras importar.
  • No regenerar las Omitir la regeneración de miniaturas. Solamente para la importación de Categorías y Productos. Puede Puedes optar porque PrestaShop regenere las miniaturas que están vinculadas desde su tu archivo CSV (en los campos "URL de imagen" o "URLs de imágenes").
  • Forzar todas las ID's durante la importación. Puede todos los números ID. Puedes mantener los IDs importados, o dejar que el importador los autoincremente éstos.

Image Added

Cuando cambie cambias el ajuste Entidad, la sección de la derecha, titulada "Campos disponible", cambia para presentar presenta los campos de datos que se esperan. Aunque la herramienta de importación está diseñada para ayudar a PrestaShop a encontrar los campos en el archivo, debe esforzarse debes esforzarte para que la importación de datos sea lo más amigable posible, siguiendo el esquema de nombres y el orden de los campos presentados. En caso de que esto no sea asíse cumpla, la importación de datos será más tediosa, pero no imposible.
Algunos de estos campos tienen un pequeño icono de información (representados por un icono "i"), que muestran una ventana emergente si situa sitúas el cursor del ratón encima de ellos. La mayoría de ellos hacen referencia a la funcionalidad multitienda o al gestor avanzado deexistencias stock de PrestashopPrestaShop. Asegúrese Asegúrate de leer todas estas informaciones para crear / editar los archivos de datos de forma correcta.

Image Removed

Formato de datos

Los datos importados deben estar en un archivo de texto con extensión .csv, con los distintos valores de campos debidamente separados.  Le recomendamos Te recomendamos que utilice utilices un carácter punto y coma ";" como separador de campos. Si sus tus datos textuales (tales como descripción del producto) contienen carácteres caracteres punto y coma, deberá deberás eliminarlos o elegir otro separador en la opción "Separador de campos".

Puede Puedes crear un archivo de este tipo con cualquier editor de texto (como por ejemplo Notepad++: http://notepad-plus-plus.org/), pero le te aconsejamos que utilice utilices un programa que le te permita trabajar con hojas de cálculo, y posteriormente guarde su guardes tu trabajo en formato .CSV. En una hoja de cálculo puede puedes trabajar visualmente más rápido, en comparación con un archivo de texto plano. Puede Puedes utilizar un programa de pago como Microsoft Excel: http://office.microsoft.com/es-es/excel/, o bien una alternativa libre y gratuita como OpenOffice Calc: http://www.openoffice.org/.

Aquí tiene Este es un ejemplo de como cómo sería el resultado final de un archivo preparado para importar una lista de productos:

Code Block
html
html
"Enabled";"Name";"Categories";"Price";"Tax rule ID";"Buying price";"On sale";"Reference";"Weight";"Quantity";"Short desc.";"Long desc";"Images URL"
1;"Test";"1,2,3";130;1;75;0;"PROD-TEST";"0.500";10;"'Tis a short desc.";"This is a long description.";"http://www.myprestashop/images/product1.gif"
0;"Test 02";"1,5";110;1;65;0;"PROD-TEST2";"0.500";10;"'Tis also a short desc.";"This is a long description too.";"http://www.myprestashop/images/product2.gif"
1;"Test 03";"4,5";150;1;85;0;"PROD-TEST3";"0.500";10;"'Tis a short desc. again";"This is also a long description.";"http://www.myprestashop/images/product3.gif"

Note that this is only a regular sample files built for this demonstration; it is purposefully not optimized for PrestaShop importation. If you need a sample file you can learn from, use the ones you can download from the "Upload" button's form.

The first row should be a descriptive name for the data column (you will be able to skip it during the import process). There must be the same number of columns on each row.

You should remember that:

...

Ten en cuenta que este es un ejemplo de muestra; que no ha sido optimizado para su importación en PrestaShop. Si necesitas un archivo de ejemplo que te sirva como referencia, utiliza los que puedes descargar desde el botón del formulario "Descargue ejemplos de archivos CSV".

La primera línea debe ser un nombre descriptivo para la columna de datos (que posiblemente no se tome en cuenta durante el proceso de importación). Debe haber el mismo número de columnas en cada línea.

Debes recordar que:

  • La columna de precios utilizará la moneda predeterminada de tu tienda.
  • Las categorías son indicadas utilizando su identificador existente (por lo que es necesario importarlas primero), y separadas por comas (de manera predeterminada).
  • La dirección URL de las imágenes deben especificarse completamente. En otras palabras, el enlace que se utilice debe ser el que utiliza en el navegador para mostrar la imagen. Por ejemplo: http://www.myprestashopmiprestashop/imagesimagenes/productXXXproductoXXX.gif.
  • The file's character encoding should be La Codificación de caracteres del archivo debe ser UTF-8. If not, use o ISO-8859-1 and check the "ISO-8859-1 encoded file?" option.Dates use the ISO 8601 format, without a time zone designator (the time zone is the one for your store): en el peor de los casos.
  • Las fechas utilizan el formato ISO 8601, sin un designador de zona horaria (la zona horaria es la que utiliza tu tienda): 2013-06-21 15:07:27.

Uploading the file

Once you have all your data in CSV format, you can upload them to your store's database using the form in this page.

You have two ways to register files to import:

  • Using your browser: click the "Add file" button, find your file then validate. Do this as many times as necessary to list all your import files.
  • Using your FTP client: upload the files in the /admin-dev/import folder of your PrestaShop installation. Reload the import page: the "Choose from history/FTP" button should now indicate a number. Click the button to display the list of available files (including the ones you previously uploaded using the browser), then click the "Use" button for the file you wish to import.

Once your files are all listed in the "Select your CSV file" section, you can proceed with the rest of the form:

  1. Select the type of data contained in your file, using the drop-down list named "What kind of Entity would you like to import?". Once you have selected the type of data, the list of the available fields appears on the right, which helps you refine your CSV file – at least for the order of the columns, which will soon prove handy.
  2. Select the language of the imported content. If the target language is not available, you must install it first, in the "Languages" page under the "Localization" menu.
  3. Select the file encoding. Simply indicate if the file uses ISO-8859-1 or not. If not, then it is assumed the files use UTF-8.
  4. Select the field separators. We suggest that you leave the default values ("field separator" with a semicolon ";", "multiple value separators" with a comma ","). But obviously, if your CSV file is built differently, you should change these values accordingly.
  5. If you want to remove all the products in your catalog before importing, select the appropriate option.
  6. Once all your choices have been made, click "Next step".
Note

All import files are uploaded directly in the admin folder's /import sub-folder. If the CSV File drop-down menu gets too crowded, you can delete old imports directly using your FTP client.

When clicking the "Next step" button, the page reloads with the data mapping tool. This interface helps you map you file's data columns with the ones required by PrestaShop.

Image Removed

Presented in this table are the rows from your CSV file, placed under arbitrary columns matched to PrestaShop's database needs. It is up to you to make sure that all the columns from your CSV file are matched with the correct column header, using each header's drop-down selector, so as to import your content correctly.

For instance, with our sample file:

  • First column. We marked it as "Enabled", PrestaShop presents "ID" as a header. Click on the header's drop-down menu, and select "Active (0/1)".
  • Second column. Marked "Name", header indicates "Active (0/1)". Let's change the header for "Name *".
  • Third column. You get the idea...

The screen cannot contain more than 6 columns, so click the ">" and "<" buttons to see the other columns, and make sure to match them all correctly.

In our example, we used the first row as for column names. Since we do not want these imported, enter "1" in the "Lines to skip" text-field.

Once you are done matching your columns, click the "Import .CSV data" button (bottom right-hand corner of the screen), and PrestaShop will start the importing process. When the process is done, you are sent to the main screen, which should either confirm that everything has indeed been imported, or give you a notice of all the encountered problems. In this second case, you should review your CVS file and make sure to correct everything.

Mapping configurations

The mapping process can be a tedious task if you cannot customize your CSV files columns order according to that used by the PrestaShop importer, and even more so if you have to do that repeatedly or frequently. That is why PrestaShop includes a small tool to save the current mapping order that you have set up using all the headers drop-down selectors.

Image Removed

The tool is a simple field at the top of the matching tool. You can do the three basic actions (only one if there is no mapping configuration saved yet):

...

Cargar el archivo

Una vez que tengas todos los datos en formato CSV, puedes subirlos a la base de datos de tu tienda utilizando el formulario de esta página.

Tienes dos maneras de cargar los archivos a importar:

  • Utilizando tu navegador: Haz clic en el botón "Subir archivo", encuentra tu archivo y a continuación, valida tu selección. Haz esto tantas veces como sea necesario para listar todos los archivos de importación.
  • Utilizando tu cliente FTP: carga el archivo en la carpeta /admin-dev/import de tu instalación de PrestaShop. Recarga la página de importación: el botón "Seleccione desde historial/FTP", debe ahora indicar un número. Haz clic en el botón para mostrar la lista de archivos disponibles (incluyendo los que previamente habrás cargado utilizando el navegador), a continuación, haz clic en el botón "Utilizar" para importar el archivo deseado.

Una vez que tengas todos los archivos listados en la sección "Sus archivos CSV", puedes continuar rellenando los datos del formulario:

  1. Selecciona el tipo de datos contenidos en el archivo, utilizando la lista desplegable denominada "¿Qué tipo de entidad deseas importar?". Una vez seleccionado el tipo de datos, la lista de los campos disponibles aparecerá a la derecha, lo que te ayudará a refinar aún más tu archivo CSV – al menos en lo que respecta al orden de las columnas, lo que te será de utilidad próximamente.
  2. Selecciona el idioma del contenido importado. Si el idioma de destino no está disponible, debes instalarlo primero, desde la página "Idiomas" bajo el menú "Localización".
  3. Selecciona la codificación del archivo. Simplemente indica si el archivo utiliza o no la codificación ISO-8859-1. Si no la utilizas, entonces se asume que los archivos utilizan la codificación UTF-8.
  4. Selecciona los separadores de campos. Te sugerimos que dejes los valores predeterminados establecidos ("separador de campo" con un punto y coma ";", "separador de múltiples valores" con una coma ","). Pero, obviamente, si tu archivo CSV fue creado de manera diferente, debes cambiar estos valores en consecuencia.
  5. Si deseas eliminar todos los productos de tu catálogo antes de importarlos, selecciona la opción adecuada.
  6. Una vez hayas realizado todas tus selecciones, haz clic en el botón "Próximo paso".
Note

Todos los archivos de importación son enviados directamente a la subcarpeta /import que se encuentra dentro de la carpeta de administración. Si el menú de archivos CSV contiene demasiadas entradas, puedes eliminar las importaciones más antiguas utilizando un cliente FTP.

Al hacer clic en el botón "Próximo paso", la página será recargada mostrando la herramienta correspondiente. Esta interfaz te ayuda en el proceso de hacer coincidir las columnas utilizadas en el archivo importado, con los datos requeridos por PrestaShop.

Image Added

Los datos presentados en esta tabla son las columnas de tu archivo CSV, colocados de manera arbitraria bajo las columnas que la base de datos de PrestaShop necesita. Deberás asegurarte de que todas las columnas de tu archivo CSV, pertenecen realmente a la  columna que les corresponde, utilizando el menú desplegable de cada cabecera, para importar el contenido correctamente.

Por ejemplo, en nuestro archivo de ejemplo:

  • Primera columna. Marcada como "Activo", PrestaShop presenta "ID" como cabecera. Haz clic en el menú desplegable de la cabecera y selecciona "Activo (0/1)".
  • Segunda columna. Marcada como "Nombre", su cabecera indica "Activo (0/1)". Vamos a cambiar el encabezado por el de "Nombre *".
  • Tercera columna. Continúa el proceso sucesivamente, teniendo en cuenta el procedimiento seguido en las columnas anteriores.

La pantalla no puede mostrar todas las columnas de tus datos, por lo que deberás hacer clic en los botones ">>" y "<<" para moverte a través de todas las columnas, y hacer coincidir todos los datos correctamente.

En nuestro ejemplo, se utilizó la primera fila para los nombres de columnas. Dado que no queremos que estos nombres sean importados, introduce "1" en el campo de texto "Líneas a saltar".

Una vez que los datos de tu archivo estén establecidos en sus columnas correspondientes, haz clic en el botón "Importar datos CSV" (situado en la esquina inferior derecha de la pantalla), y PrestaShop iniciará el proceso de importación. Cuando el proceso se haya completado, serás redirigido a la pantalla principal, que deberá confirmarte que todos los datos han sido importados correctamente, o bien mostrarte una notificación de los problemas que se han encontrado durante la importación. En este segundo caso, deberás revisar de nuevo tu archivo CSV y asegurarte de corregir todos los errores notificados.

Configuraciones coincidentes

El proceso de configuración puede ser una tarea tediosa si tienes una y otra vez que seleccionar el orden de las columnas del archivo CSV para que coincidan con la utilizada por la herramienta de importación de PrestaShop. Es por eso que PrestaShop incluye una pequeña herramienta para guardar el orden actual de la configuración que hayas establecido en las cabeceras utilizando las listas desplegables.

Image Added

Esta herramienta es un campo sencillo situado en la parte superior de esta página de importación de archivos. Puedes realizar tres acciones básicas (solamente si no hay ninguna configuración de coincidencias guardada todavía):

  • Guardar. Introduce un nombre descriptivo en el campo, y haz clic en "Guardar". La interfaz se actualiza mostrando las configuraciones almacenadas en la lista desplegable.
  • Cargar. Selecciona una configuración coincidente en la lista desplegable y haz clic en "Cargar".
  • Eliminar. Selecciona una configuración coincidente en la lista desplegable y haz clic en "Eliminar".