Cómo importar/exportar los productos del carrito

Best practice > Paso 1 - Ajustes > Sección Avanzadas > Carrito de la compra >

Cómo importar/exportar los productos del carrito

Previous pageReturn to chapter overviewNext page

Después de haber creado un carrito de la compra de comercio electróncio puede ser útil tener la posibilidad de exportar el catálogo de los productos para poder, por ejemplo, introducirlo de nuevo en otro Proyecto o utilizarlo en otros programas, por ejemplo programas dedicados a la gestión de la facturación. Obviamente, en sentido opuesto, es igualmente importante tener la posibilidad de importar el catálogo de productos para no tener que crearlo desde cero.

En WebSite X5 es posible llevar a cabo estas operaciones de importación y exportación a través de comandos al efecto disponibles en la barra de herramientas de la ventana Carrito de la compra | Lista de productos. La exportación del catálogo de productos produce un archivo en formato .TXT o .CSV que puede ser fácilmente abierto y modificado mediante un editor de texto normal (por ejemplo, el Bloc de Notas de Windows) o Microsoft Excel.

Para modificar manualmente el archivo obtenido por la exportación del catálogo de productos o crear uno nuevo para importarlo, es preciso atenerse a las siguientes reglas:

La primera línea debe contener el encabezado de los campos y debe presentar los siguientes elementos:

ID;Category;Name/Code;Description;Price;Enable VAT;VAT Value;Weight;Options;Enable Discounts;Discounts

Eliminar un campo del encabezado equivale a eliminar el dato para todos los productos. Como es lógico, los campos obligatorios Category, Name/Code, Description y Price no se pueden eliminar del encabezado.
Cada línea que sigue al encabezado debe corresponder a un producto.
Todos los parámetros se deben indicar separados por el carácter ";".
Para cada producto se debe indicar obligatoriamente: el nombre de la categoría, el nombre del producto, la descripción del producto y el precio del producto. Todos los demás campos son opcionales y pueden omitirse (simplemente no escribiendo nada entre los caracteres ";" para el campo en cuestión).
El ID del producto debe ser generado por el programa y no manualmente: si se añade un nuevo producto, es lo correcto dejar vacío el campo del ID.
Los espacios eventualmente insertados, si son superfluos, serán eliminados automáticamente en la fase de importación.

En particualr, los parámetros existentes en los archivos .TXT o .CSV son:

Parámetro: ID

Obligatorio

No

Descripción

Es un identificador unívoco para el producto

Valor

Es generado y asociado al producto automáticamente por el programa.

En el caso que se desee actualizar un archivo .TXT o .CSV obtenido mediante una exportación anterior, es mejor no modificar los ID ya asignados y dejar vacío el campo para posibles nuevos productos adicionales. También en el caso de que se cree un archivo .TXT o .CSV desde cero, para importar el catálogo en el carrito no hay que crear manualmente los ID de los productos. En efecto, en la fase de importación el programa compara los ID para no tener duplicados y genera los que faltan.

Parámetro: Category

Obligatorio

Descripción

Es la categoría en la que se incluye el producto.

Valor

Es posible reproducir la ruta de acceso de categorías y sub-categorías utilizando el carácter ">".

Por ejemplo, si el producto es una camiseta que en el catálogo está incluida en la sub-categoría "Informal" de la categoría "Ropa para hombre", en el archivo .TXT o .CSV se puede citar la ruta del siguiente modo:

... ; Ropa para hombre > Informal ; ...

Con este tipo de notación es posible insertar todas las sub-categorías necesarias.

Parámetro: Name/Code

Obligatorio

Descripción

Es el nombre o el código asignado al producto.

Valor

En caso de exportación del catálogo a .TXT o .CSV, este parámetro se toma del campo Nombre/Código de la ventana Configuración del producto | General.

Parámetro: Description

Obligatorio

Descripción

Es la descripción asociada al producto.

Valor

En caso de exportación del catálogo a .TXT o .CSV, este parámetro se toma del campo Descripción de la ventana Configuración del producto | General.

Parámetro: Price

Obligatorio

Descripción

Es el precio asociado al producto.

Valor

En caso de exportación del catálogo a .TXT o .CSV, este parámetro se toma del campo Precio de la ventana Configuración del producto | General.

Parámetro: Enable VAT

Obligatorio

No

Descripción

Indica si para el producto se contempla la aplicación de un IVA especial.

Valor

En caso de exportación del catálogo a .TXT o .CSV, este parámetro se toma de la opción IVA (%) de la ventana Configuración del producto | General. Esta opción está disponible solo si en Carrito de la compra | Disponibilidad ha sido elegido el Tipo "IVA incluido en el precio" para la Configuración IVA y sirve para asociar al producto un IVA especial, diferente del de el resto de los productos del catálogo. En estos casos los precios se presentan sin IVA.

Este parámetro puede asumir sólo dos valores: 0 o 1, respectivamente, para los casos en los que no ha sido activada o ha sido activada la opción IVA (%) arriba citada.

Parámetro: VAT Value

Obligatorio

No

Descripción

Es el valor del IVA en el caso en que se contemple la aplicación de un impuesto especial sobre el precio del producto.

Valor

En caso de exportación del catálogo a .TXT o .CSV, este parámetro se toma de la opción IVA (%) de la ventana Configuración del producto | General que, como se ha dicho para el parámetro anterior, está disponible solo si en Carrito de la compra | Disponibilidad ha sido elegido el Tipo "IVA incluido en el precio" para la Configuración IVA.

Si la opción IVA (%) de la ventana Configuración del producto | General es activada pero no se especifica ningún valor, se toma el Valor predet. (%) especificado en Configuración del producto | Disponibilidad.

Parámetro: Weight

Obligatorio

No

Descripción

Es el peso del producto.

Valor

En caso de exportación del catálogo a .TXT o .CSV, este parámetro se toma del campo Peso de la ventana Configuración del producto | General.

Parámetro: Options

Obligatorio

No

Descripción

Es la lista de las variantes previstas para el producto.

Valor

En caso de exportación del catálogo a .TXT o .CSV, este parámetro se toma del campo Lista de opciones principales de la ventana Configuración del producto | Opciones.

En caso de creación de un archivo .TXT. o .CSV para importar, en cambio, la lista de las variantes del producto puede ser introducida utilizando el carácter "|", de la siguiente manera:

... ; Variante1 |Variante2 | Variante3 ; ....

Con este tipo de notación es posible insertar todas las variantes necesarias.

Parámetro: Enable Discounts

Obligatorio

No

Descripción

Indica si para el producto está previsto un descuento por cantidad.

Valor

En caso de exportación del catálogo a .TXT o .CSV, este parámetro se toma de la opción Activar descuento por cantidad de la ventana Configuración del producto | Descuento.

Este parámetro puede asumir sólo dos valores: 0 o 1, respectivamente, para los casos en los que no ha sido activada o ha sido activada la opción Activar descuento por cantidad arriba citada.

Parámetro: Discounts

Obligatorio

No

Descripción

Es la lista de los descuentos por cantidad que se aplican al producto, si se contemplan.

Valor

En caso de exportación del catálogo a .TXT o .CSV, este parámetro se toma, como el anterior, de la opción Activar descuento por cantidad de la ventana Configuración del producto | Descuento.

En cambio, en caso de creación de un archivo .TXT o .CSV a importar, la lista de los descuentos por cantidad que se aplican debe ser escrita respetando la siguiente notación:

... ; cantidad : descuento | cantidad : descuento ; ...

Así, si para pedidos superiores a 20 unidades está previsto un descuento del 10% y para pedidos superiores a 50 unidades está previsto un descuento del 15%, es preciso introducir los datos escribiendo:

... ; 20 : 10 | 50 : 15 ; ...

Utilizando el carácter "|" se pueden introducir todos los descuentos por cantidad necesarios.

Después de haber importado un archivo .TXT o .CSV obtenido de una exportación anterior o creado manualmente, es muy probable que este sea actualizado por el Programa: por ejemplo con el añadido de los ID de producto que falten. Por esta razón, si se desea tener una copia actualizada del archivo .TXT o .CSV, es necesario efectuar una nueva exportación del catálogo de productos.

 


Best practice:

-

Cómo definir los contenidos del correo electrónico de notificación