Información sobre Actualización / Importación de artículos desde ficheros CSV
| AVISOS | ||
| - Para la generación o edición del archivo CSV de importación recomendamos el uso de Open Office o Libre Office. - El fichero final debe guardarse en el siguiente formato: tipo CSV, conjunto de caracteres Unicode (UTF-8), delimitador de campo ; (punto y coma), delimitador de valores de campo " (dobles comillas). |
||
| En el panel de administración dispones de plantillas para Excel y Libre Office en Catálogo > Artículos > solapa Imp./Exp. | ||
| !Aviso! Si necesitas incluir " (dobles comillas) como valor de un campo de texto o html es necesario indicarlo duplicando este caracter "" (dos veces dobles comillas), p.e. <font color=""red""> | ||
| !Aviso! La primera fila debe contener los [identificadores de campo]. Sólo es necesario indicar los campos que vayas a actualizar. | ||
Identificadores de campo válidos para la Actualización / Importación desde archivos CSV de nuevos artículos en tu catálogo o modificar los que ya existan
IDENTIFICADORES DE CAMPO DE ARTICULO [Código]
| CAMPO | INFORMACIÓN | IDIOMA | EXTRA |
| [Código] | Código único del producto base o referencia que agrupa las referencias de las variaciones del producto. | ||
| [Activo] | 0 = desactivado, 1 = activo, -1 = no accesible, -2 = eliminado, vacio = activo | ||
| [Categorías] | Códigos de la categorías finales a las que pertenece el producto separados por coma. Sólo se tendrán en cuenta los 20 primeros caracteres por categoría. LA PRIMERA DE ELLAS SERÁ TOMADA COMO CATEGORIA PRINCIPAL. | ||
| [reccat] | Indica si el producto esta recomendado en la(s) categoría(s) indicada(s) en el campo [Categorías]. 0 = no recomendado, 1 = recomendado, vacio = no se actualiza. Los valores deben ir separados por coma y deben guardar el mismo orden que los valores en el campo [Categorías] | ||
| [ordencat] | Indica el orden del producto en la(s) categoría(s) indicada(s) en el campo [Categorías] si vacio = no se actualiza. Los valores deben ir separados por coma y deben guardar el mismo orden que los valores en el campo [Categorías] | ||
| [catorden_XXXX] | Indica el orden del producto en la categoría indicada por XXXX. Puede ser una categoría NO FINAL. | XXXX es el código de la categoría. | |
| [Nombre] | Nombre producto. Recomendado máximo 65-70 caracteres. | ||
| [Desc.Breve] | Frase concisa o promocional de 5-10 palabras para destacar lo mejor del artículo. Opcional. | ||
| [Descripción] | Descripción de las características del producto utilizando palabras clave. Recomendado mínimo 300 caracteres. | ||
| [TextoLibre] | |||
| [Mini-Imagen] | Está en desuso, no se utiliza. | ||
| [Imagen-Ficha] | Nombre de archivo de la imagen principal del producto que se muestra en la ficha en tamaño Grande. Si el archivo indicado está en el mismo servidor no es necesario indicar la ruta de los otros tamaños. | S | |
| [Imagen-Ficha_icon] | Ruta externa del archivo de la imagen principal del producto que se muestra en la ficha en tamaño Icon (utilizado para filtros de productos). | S | |
| [Imagen-Ficha_small] | Ruta externa del archivo de la imagen principal del producto que se muestra en la ficha en tamaño Mini (utilizado en escaparate y listados). | S | |
| [Imagen-Ficha_medium] | Ruta externa del archivo de la imagen principal del producto que se muestra en la ficha en tamaño Media (utilizado en ficha de articulo). | S | |
| [Marca] | Indicar el código de la marca. | ||
| [Proveedor] | Código del proveedor. | ||
| [Link] | Enlace a otra página con más información sobre el artículo (catálogo en PDF, instrucciones de montaje, etc.). | ||
| [tipoFicha] | Indicar el código del modelo de ficha de producto. | ||
| [ListadoArtRelac] | Indicar el código de la estructura del Listado para sus Artículos Relacionados. | ||
| [Campos] |
Indica que el producto tiene campos adicionales separados por @_@ según el patrón CODIGO#_#VALOR#_#IMPORTE (el único parámetro obligatorio es CODIGO, p.e. cod1@_@cod2@_@cod3). Si la tienda soporta multidivisa el IMPORTE deberá indicarse en las cantidades de cada divisa según el siguiente patrón id_divisa#$#importe_divisa#@# |
||
| [ArtRelac] | Indicar los códigos de los artículos relacionados separados por coma. | ||
| [GaleriaImgs] | Nombre de los ficheros de las imágenes extras o adicionales separados por coma. Tamaño Grande. Opcional. Nota: Puedes añadir un nombre a cada imagen como se indica en el campo [nomgaleriaimgs] que también se utilizará como atributo alt de la imagen. | S | |
| [GaleriaImgs_icon] | Ruta externa de los ficheros de las imágenes extras o adicionales separados por coma. Tamaño Icon. | S | |
| [GaleriaImgs_small] | Ruta externa de los ficheros de las imágenes extras o adicionales separados por coma. Tamaño Mini. | S | |
| [GaleriaImgs_medium] | Ruta externa de los ficheros de las imágenes extras o adicionales separados por coma. Tamaño Media. | S | |
| [Tecnologias] | Códigos de las tecnologías separados por coma. | ||
| [Escaparate] | Indica si el artículo se muestra en la selección escaparate o home (0=NO, 1=SI) | ||
| [OrdenEscap] | Indica el orden en que se mostrará en la selección escaparate o home (orden descendente). | ||
| [MasVendidos] | Indica si el artículo se muestra en la selección +vendidos (0=NO, 1=SI) | ||
| [Novedades] | En desuso. Se activa si está cumplimentada la fecha en el campo [fnovedad]. | ||
| [nomimgficha] | Nombre asociado a la imagen principal del producto. Opcional. | S | |
| [descimgficha] | Descripción asociada a la imagen principal del producto. Opcional. | S | |
| [eti] | Palabras clave o etiquetas separadas por coma que servirán para relacionar artículos que contengan las mismas etiquetas | ||
| [descargas] | Indica que el producto tiene ficheros descargables separados por @_@ según el patrón CODIGO#_#DIAS (el único parámetro obligatorio es CODIGO, p.e. cod1@_@cod2@_@cod3). | ||
| [nomgaleriaimgs] | Nombres separados por @_@ asociados a las imagenes extras o adicionales del producto en otro idioma. Se debe respetar el mismo orden indicado en el campo [GaleriaImgs]. Opcional | S | |
| [descgaleriaimgs] | Descripciones separadas por @_@ asociadas a las imagenes extras o adicionales del producto en otro idioma. Se debe respetar el mismo orden indicado en el campo [GaleriaImgs]. Opcional | S | |
| [canonical] | Indicar el código de otro producto si es preciso generar la url canonical con la de ese otro producto, dejar vacio para generar la suya propia o indicar # para NO generar ninguna canonical. | ||
| [grupo] | Códigos de grupo separados por coma para agrupar artículos del mismo tipo en los resultados de búsqueda y en la ficha de artículo. | ||
| [fnovedad] | Indica la fecha en que el artículo dejará de aparecer como Novedad (formato AAAA-mm-dd). | ||
| [falta] | Indica la fecha y hora en que el artículo se ha dado de alta (formato AAAA-mm-dd hh:mm:ss p.e. 2016-02-21 10:35:05). Sólo es aplicable para el modo de importación update. | ||
| [fcountdown] | Indica la fecha y hora fin del temporizador en que el artículo dejará de aparecer en la tienda (formato AAAA-mm-dd hh:mm:ss p.e. 2016-04-25 12:00:00). | ||
| [nombre_XX] | Nombre del artículo en otro idioma. | S | XX es el código ISO del idioma. |
| [tlibre_XX] | Texto libre del artículo en otro idioma. | S | XX es el código ISO del idioma. |
| [permalink_XX] | Permalink del artículo en otro idioma. Sólo indicar las palabras del link separadas por guión, no inidicar .html (p.e.: comprar-este-articulo) | S | XX es el código ISO del idioma. |
| [dbreve_XX] | Descripción breve del artículo en otro idioma. | S | XX es el código ISO del idioma. |
| [dextra_XX] | Descripción extra del artículo en otro idioma. Texto extra para poder incluir videos, imágenes extras, más texto, etc del producto y que se muestra con el módulo Descripción Extra disponible en las estructuras de fichas de Artículo. Opcional. | S | XX es el código ISO del idioma. |
| [damp_XX] | Descripción ampliada del artículo en otro idioma. | S | XX es el código ISO del idioma. |
| [dmovil_XX] | Descripción ampliada del artículo para dispositivos móviles en otro idioma. | S | XX es el código ISO del idioma. |
| [metatitle_XX] | Contenido de la etiqueta meta title del artículo en otro idioma. | S | XX es el código ISO del idioma. |
| [metadesc_XX] | Contenido de la etiqueta meta description del artículo en otro idioma. | S | XX es el código ISO del idioma. |
| [metakeywords_XX] | Contenido de la etiqueta meta keywords del artículo en otro idioma. | S | XX es el código ISO del idioma. |
| [metas_XX] | Contenido de otras etiquetas meta del artículo en otro idioma. | S | XX es el código ISO del idioma. |
| [descuentos] |
Indica que el producto tiene descuentos por cantidad separados por @_@ según el patrón GLOBAL#_#TARIFAS#_#REFERENCIAS#_#CANTIDAD#_#TIPO#_#DESCUENTO GLOBAL (0 = no, 1 = si, para indicar si se tiene en cuenta o no la suma de unidades de distintas referencias del mismo artículo) Por ejemplo: 1#_##_##_#5#_#porcentaje#_#10@_@1#_##_##_#10#_#porcentaje#_#15 0#_#VIP#_#XC34R#_#5#_#importe#_#2.5 Si la tienda soporta multidivisa y el descuento es por importe se deberá indicar las cantidades de cada divisa según el siguiente patrón id_divisa#$#importe_divisa#@# AVISO: Los distintos rangos de descuento/cantidad de un mismo artículo deben tener el mismo valor GLOBAL (0 o 1). |
IDENTIFICADORES DE CAMPO DE VARIACIÓN [Ref.]
| CAMPO | INFORMACIÓN | IDIOMA | EXTRA |
| [Ref.] | Referencia única para cada variación del producto. Si sólo existe una variación del producto puede ser la misma que el código [Código]. | ||
| [Visible] | 0 = no visible, 1 = visible. | ||
| [Representativa] | 1 = para indicar que es la ref. representativa del artículo | ||
| [Imagen Ref.] | Imagen propia de cada variación del producto. Opcional. Indicar # si se quiere eliminar el valor de este campo. | ||
| [Peso Kg.] | |||
| [Estado] | |||
| [IVA] | impuesto en la divisa principal | ||
| [IVA_Y] | Si la tienda soporta multidivisa, indicar en la cabecera el id de la divisa en el formato [IVA_Y]. Indica el impuesto de la referencia en esa divisa. | Y corresponde al id de la divisa. | |
| [Tipo IVA] | Identificador del tipo de impuesto en la divisa principal aplicado a la variación del producto (general, reducido, superreducido). Vacío = general. | ||
| [Tipo IVA_Y] | Si la tienda soporta multidivisa, indicar en la cabecera el id de la divisa en el formato [Tipo IVA_Y]. Indica el identificador del tipo de impuesto en esa divisa aplicado a la variación del producto (general, reducido, superreducido). Vacío = general. | Y corresponde al id de la divisa. | |
| [PVCoste] | precio de coste en la divisa principal | ||
| [PVCoste_Y] | Si la tienda soporta multidivisa, indicar en la cabecera el id de la divisa en el formato [PVCoste_Y]. Indica el precio de coste de la referencia en esa divisa. | Y corresponde al id de la divisa. | |
| [PVR] | precio de venta recomendado en la divisa principal | ||
| [PVR_Y] | Si la tienda soporta multidivisa, indicar en la cabecera el id de la divisa en el formato [PVR_Y]. Indica el precio de venta recomendado de la referencia en esa divisa. | Y corresponde al id de la divisa. | |
| [PVP] | precio de venta en la divisa principal | ||
| [PVP_Y] | Si la tienda soporta multidivisa, indicar en la cabecera el id de la divisa en el formato [PVP_Y]. Indica el precio de venta de la referencia en esa divisa. | Y corresponde al id de la divisa. | |
| [PVPOferta] | precio de venta en oferta en la divisa principal | ||
| [PVPOferta_Y] | Si la tienda soporta multidivisa, indicar en la cabecera el id de la divisa en el formato [PVPOferta_Y]. Indica el precio de venta en oferta de la referencia en esa divisa. | Y corresponde al id de la divisa. | |
| [OrdenVar] | |||
| [Mosaico] | |||
| [PNF] | Indicar el número de producto o referencia del fabricante. Opcional. | ||
| [EAN] | Indicar los digitos del código de barras del producto. Opcional. | ||
| [Stock] | Cantidad de unidades disponibles. Opcional. | ||
| [StockMin] | |||
| [Reponer] | |||
| [Uds.Pedidas] | |||
| [DtoPuntos] | 0 = no permite descuento, 1 = el cliente pueda descontar puntos de su saldo en el pedido por la compra de esta referencia | ||
| [Promocion] | 1 = permite descuento asignando puntos, 2 = permite descuento asignando un % sobre el precio final | ||
| [PuntosGan] | Indicar el número de puntos asignados por la compra de esta referencia | ||
| [MaxPuntosDesc] | Indicar el máximo número de puntos asignados por la compra de esta referencia | ||
| [DtoPrecio] | Indicar el % de descuento a aplicar sobre el precio final por la compra de esta referencia | ||
| [MaxPrecioDesc] | Indicar el máximo % de descuento a aplicar sobre el precio final por la compra de esta referencia | ||
| [prop_XX] |
Indicar en la cabecera el id de la propiedad en el formato [prop_XX] y en los valores el id del valor asignado a la variación. Si la propiedad es de tipo Imagen Ref/Var. el valor de la celda debe ser 1. IMPORTANTE: sólo está permitido usar caracteres en minúsculas, números, el guión (-) y el guión bajo (_). Cualquiera otro carácter no permitido será eliminado en el proceso de conversión y no se tendrá en cuenta tanto en el id de la propiedad como en el id del valor asignado a la variación. Tampoco está permitido el uso de las siguientes palabras reservadas por el sistema para el id de propiedad: en_stock, p_desde, p_hasta, m_marcas, u_publicadores, s_cats |
||
| [ref-prov] | Referencia del proveedor para cada variación del producto. | ||
| [umc] | Indica el número mínimo de unidades para permitir la compra de la referencia en la divisa principal. | ||
| [umc_Y] | Si la tienda soporta multidivisa, indicar en la cabecera el id de la divisa en el formato [umc_Y].Indica el número mínimo de unidades para permitir la compra de la referencia en esa divisa. | Y corresponde al id de la divisa. | |
| [ubicación] | Indica la ubicación del artículo en almacén para facilitar su localización. | ||
| [disponibilidad] | |||
| [var-pack] | Indica que la referencia es un pack de artículos (p.e. cod_var1:2,cod_var2:1 indica que está compuesto de 2 unidades de la referencia cod_var1 + 1 unidad de cod_var2). | ||
| [tar_XX] | Indicar en la cabecera el id de la tarifa en el formato [tar_XX] y en los valores el PVP en la divisa principal correspondiente a la tarifa. | XX corresponde al id de tarifa. | |
| [tar_XX_Y] | Si la tienda soporta multidivisa, indicar en la cabecera el id de la tarifa y de la divisa en el formato [tar_XX_Y] y en los valores el PVP en esa divisa correspondiente a la tarifa. | XX corresponde al id de tarifa, Y corresponde al id de la divisa. | |
| [oferta_XX] | Indicar en la cabecera el id de la tarifa en el formato [oferta_XX] y en los valores el precio Oferta de esa tarifa. | XX corresponde al id de tarifa. | |
| [oferta_XX_Y] | Si la tienda soporta multidivisa, indicar en la cabecera el id de la tarifa y de la divisa en el formato [oferta_XX_Y] y en los valores el precio Oferta en esa divisa correspondiente a la tarifa. | XX corresponde al id de tarifa, Y corresponde al id de la divisa. | |
| [imgtexto_XX] | Propiedad de la imagen de variación en modo texto utilizado en la cesta y en los pedidos. Recomendado cumplimentar cuando existe una propiedad del tipo Imagen Ref/Var. asignada al artículo. | S | XX es el código ISO del idioma. |
| [img_XX] | Imagen de la variación para otros idiomas. | S | XX es el código ISO del idioma. |
| [publicar_XX] | 0 = no publicar, 1 = publicar, vacio = no publicar. Hace referencia al estado de publicación de la variación en el portal Amazon MarketPlaces donde XX es el código del portal Amazon (p.e. [publicar_amazon_es_MFN]). Puedes encontrar el código en la ficha del marketplace en Catálogo > Publicar-Marketing > solapa Amazon Marketplaces. IMPORTANTE: incluya este campo para actualizar alguna otra información relacionada con Amazon Marketplaces | XX es el código del portal Amazon. | |
| [sku_XX] | Identificador SKU de la variación en el portal Amazon MarketPlaces donde XX es el código del portal Amazon (p.e. [sku_amazon_es_MFN]). Puedes encontrar el código en la ficha del marketplace en Catálogo > Publicar-Marketing > solapa Amazon Marketplaces. | XX es el código del portal Amazon. | |
| [ajustestock_XX] | vacio = 0. Indica el ajuste a aplicar sobre el stock actual de la variación en el portal Amazon MarketPlaces donde XX es el código del portal Amazon (p.e. [ajustestock_amazon_es_MFN]). Puedes encontrar el código en la ficha del marketplace en Catálogo > Publicar-Marketing > solapa Amazon Marketplaces. (p.e. si el valor del campo es -2 y el stock actual es 5 se pasará 3 como stock a Amazon de esa variación). | XX es el código del portal Amazon. | |
| [ajusteprecio_XX] | vacio = 0. Indica el ajuste a aplicar sobre el precio actual de la variación en el portal Amazon MarketPlaces donde XX es el código del portal Amazon (p.e. [ajusteprecio_amazon_es_MFN]). Puedes encontrar el código en la ficha del marketplace en Catálogo > Publicar-Marketing > solapa Amazon Marketplaces. | XX es el código del portal Amazon. | |
| [asin_XX] | Identificador ASIN de la variación en el portal Amazon MarketPlaces donde XX es el código del portal Amazon (p.e. [asin_amazon_es_MFN]). Puedes encontrar el código en la ficha del marketplace en Catálogo > Publicar-Marketing > solapa Amazon Marketplaces. | XX es el código del portal Amazon. | |
| [asin_parent_XX] | Identificador ASIN_PARENT de la variación en el portal Amazon MarketPlaces donde XX es el código del portal Amazon (p.e. [asin_parent_amazon_es_MFN]). Puedes encontrar el código en la ficha del marketplace en Catálogo > Publicar-Marketing > solapa Amazon Marketplaces. | XX es el código del portal Amazon. | |
| [status_XX] | Identificador de ESTADO de la variación en el portal Amazon MarketPlaces donde XX es el código del portal Amazon (p.e. [status_amazon_es_MFN]). Puedes encontrar el código en la ficha del marketplace en Catálogo > Publicar-Marketing > solapa Amazon Marketplaces. | XX es el código del portal Amazon. |
Puedes descargar un modelo de plantilla csv de importación desde Catálogo > Artículos > solapa Imp/Exp.
IMPORTANTE:
- Recomendamos que cuando se trate de una actualización de ofertas se incluyan tanto el PVP como el PV Oferta para evitar posibles desajustes de precios
ANTES DE UTILIZAR ESTA FUNCIONALIDAD ASEGURATE DE QUE LOS DATOS CONTENIDOS EN EL CSV SON CORRECTOS
Supuestos de Modos de Restauración / Actualización
REPLACE - Si el producto existe lo elimina y lo vuelve a dar de alta con los datos del CSV. Si el producto no existe se da de alta.
Si el CSV sólo contiene:
[Código] genera la ficha del producto con la información de campos de artículo. AVISO: elimina la información de variaciones que pudiera existir.
[Código] + [Ref.] genera la ficha del producto con la información de campos de artículo + campos de variación.
[Ref.] generará un error de validación de fichero porque es necesario indicar también el campo [Código]
UPDATE - El fichero CSV debe contener el sufijo -update al final del nombre de archivo (p.e. 2016cat2-update.csv). Sólo se actualizan los campos que contienen valores en el CSV, los campos con celdas vacias o sin valor no se actualizan. Si el producto no existe se da de alta.
AVISO: si no se indica el sufijo -update se eliminará toda la información del producto y será sustituida por los datos que se incluyan en el csv.
Si el CSV sólo contiene:
[Código] + [Ref.] actualiza los valores del producto con la información de campos de artículo + campos de variación.
[Código] actualiza los valores del producto con la información de campos de artículo.
[Ref.] actualiza los valores del producto con la información de campos de variación.
Los modos SQL y NEW sólo pueden ser utilizados desde archivos generados por el sistema.