Importador - Actualizando e importando productos
La aplicacióinformación dispone de unayuda importadorpara de productos al que se accede desde laésta sección delestá menúdisponible delen gestorla Herramientas->Importador .
En estapropia sección del gestor se incluye detallada información para modificaciones de productos a partir de hoja de cálculo descargada. No obstante la reflejamos en este manual.
Desde el panel derecho de esta pantalla además de realizar la importación, puede descargar un archivo de importación de muestra o acceder al generador de archivos de importación, en el cual podrá generar automáticamente el archivo excel con los datos de los productos seleccionados.
Importante:Esta herramienta sirve tanto para exportar/importar como para actualizar precios. Cuando exportas un producto, este se exporta con información en las celdas correspondientes al identificador del elemento (producto, característica, valor). Cuando este identificador está presente, el sistema entiende que estas solicitando una actualización del producto existente en el sistema. Si lo que necesitas es importarlo como un producto nuevo, abre el archivo exportado con tu programa favorito y deja vacía la celda. de identificador de producto.
Especificaciones sobre el archivo
Novedades en la versión 3
Con la última actualización de Proshop, hay cambios en el importador, por lo que será necesario que actualice sus productos exportados para continuar empleándolos.
A continuación, se muestra una tabla con los cambios más reseñables
| |
| |
El archivo de importación debe ser de formato .csv, especificando como separador ";"
Se pueden definir 3 tipos de elementos: productos, características de producto y valor de las características de producto. Es muy importante que se mantenga el orden, es decir primero definiremos el producto, en la siguiente línea definiremos la característica del producto y a continuación los valores de dicha característica (si los tiene).
Se debe respetar las tabulaciones del archivo para cada elemento y el orden de los campos. Así mismo se debe añadir la cabecera en la línea previa a definir las propiedades de cada elemento, excepto cuando definimos valores de la característica, que se define la cabecera y a continuación la especificación de todos los valores de dicha característica. Por ejemplo:

Las campos de las cabeceras que hacen referencia al id son los marcados con #.
Puede descargar un archivo de muestra desde el panel derecho, o generar un archivo de importación de productos existentes para su actualización.
Consideraciones generales
La herramienta de importación emplea los campos de id como utilidad para identificar cuándo estás intentando actualizar un producto o creando uno nuevo.
Si debajo de la celda que incluye el símbolo # se incluye el identificador unico del elemento a importar y que corresponde con la base de datos, se entenderá que quieres actualizarlo.Por ejemplo, queremos actualizar el producto con el ID 16 a través del importador; en la celda debajo del símbolo indicado aparecerá 16, en la fila correspondiente a la información del producto. El sistema lo reconocerá y entenderá que lo que debe hacer es actualizar el producto con id 16, en lugar de crear uno nuevo.No tienes por qué saber cual es el identificador. Estos datos se rellenan automáticamente cuando exportas uno o varios productos desde la plataforma.
Es importante tener en cuenta que para actualizar un producto, si se facilitan los identificadores, tienen que estar todos correctos. Si falta el identificador del producto, se tratará toda la información como un producto nuevo.
Definición del producto
Precio BaseSi se define debe ser el valorsin impuestos.Precio Fijo y VariableLos precios definidos deben sersin impuestos.Son opcionales, si se definen pueden ser un número o un rango de precios. Para definir el rango de precios deberemos introducir los datos de la siguiente forma:ranges: Especifica los rangos configurados.Por cada rango de precio debemos definir la siguiente estructura:{"min": 0, "max":10, "price": 10}min: se refiere al valor mínimo del rango, a la hora de evaluarlo para determinar el precio a aplicar, la condición será que la cantidad del producto seamayorque el valor mínimo.max: se refiere al valor máximo del rango, a la hora de evaluarlo para determinar el precio a aplicar, la condición será que la cantidad del producto seamenor o igualque el valor máximo.price: indica el precio a aplicar en ese rango.Los rangos deben estarordenadospor min y max, es decir, elprimer rango definidodeberá tener"min":0, del mismo modo elúltimo rango definidodeberá tener"max":null(hasta infinito). El valor "min":0 y "max":null siempre deben estar presentes en los rangos.Los rangos deben sercorrelativos, es decir, si el primer rango tiene como "max":50, el segundo rango tendrá como min ese mismo valor ("min":50), y así sucesivamente.Los rangos deben estar envueltos entre corchetes[]y separados entre sí por comas,
Ejemplos:Un único precio:10.2Un único precio (definiendo rango):{"ranges":[{"min":0, "max":null, "price":10.2}]}Los dos ejemplos anteriores tienen el mismo resultadoVarios rangos:{"ranges":[{"min":0, "max":50, "price":10.2},{"min":50, "max":100, "price":9.8},{"min":150, "max":null, "price":9.2}]}
ImpuestosDeberemos indicar el id delimpuesto existente. Puede consultarlos en el apartadoimpuestos.En el caso de queno se definaimpuesto, se asociará elimpuesto por defectoPUBLICADO/¿SERVIR EN PANELES?/REQUIERE ARCHIVO/DISEÑADOR HABILITADO0 - No1 - Sí
ESTRATEGIA DE STOCKIndica el comportamiento cuando no hay stock del producto0 - Denegar:Los clientes no podrán comprar el producto cuando el stock esté vacío.1 - Permitir:Se puede comprar aunque no tenga stock2 - Heredar de la configuración global (Denegar):
VISUALIZACIÓN VALOR INCOMPATIBLEDetermina el comportamiento para la visualización de valores incompatibles a los usuarios0 - Ocultar:Los valores incompatibles no se mostrarán al usuario1 - Mostrar desactivado:Los valores incompatibles se mostrarán desactivados al usuario2 - Heredar de la configuración global (Mostrar desactivado):
COMPORTAMIENTO DEL CÁLCULO DE PRECIOSDetermina el comportamiento del cálculo de precios del producto1 - Cálculo de precios por características y combinaciones:Si una combinación predefinida coincide, usará su precio. En caso contrario, se seguirá con el cálculo normal2 - Sólo combinaciones:Utiliza únicamente combinaciones predefinidas para obtener el precio del producto. Los precios o porcentajes indicados en los valores de las características serán ignorados
MARCA/PROVEEDORSe indicará el nombre de la marca y/o proveedor. Si estos no existen en el sistema se crearán automáticamente.CATEGORÍASSe definirán todas las categorías asociadas a un producto separadas por|. La primera categoría definida será definida como lacategoría por defecto.Se deberá indicar lajerarquía completade la categoría (excluyendo la categoría "Inicio") separadas por/. Si no existe una categoría con ese nombre y esa jerarquía se creará en el sistema.En el ejemplo que se indica a continuación, la categoría por defecto es "Pegatinas personalizadas", y también se asociará el producto a la categoría "Inicio" y a "Camisetas manga corta", esta última tiene definida como categoría padre "Camisetas Personalizadas"Pegatinas personalizadas|Inicio|Camisetas Personalizadas/Camisetas manga cortaTRANSPORTISTASSe definirán todas los transportistas asociados a un producto separados por|. Si el transportistano existe, se creará en el sistemadeshabilitado, asignandole elimpuesto marcado por defectoy elcomportamiento "gratis". Podrá habilitar y personalizar posteriormente la configuración del transportista desde el apartadotransportistas.Para que el producto esté disponible entodos los transportistasdel sistema,nose debedefinir la asociacióncon ningún transportista.
DEFINICIÓN DE CARACTERÍSTICA
IDVacíoNúmero entero correspondiente al identificador de la característica del producto (si ya existe).
Importante:Si el id definido no corresponde a una característica existente en ese producto, se creará como una nueva característica.TIPO VISTAIDNombre1Radio2Seleccionar3Cajas opcionales4Cantidad5Imágenes6Color7Tiempo de producción9Archivo Pdf para contar las páginas10Operación matemática11Tabla12Productos relacionados13Tamaño14MaterialesDATOSHay datos que se pueden añadir a cualquier tipo de caracteŕitica y otros que sólo tienen efecto para un tipo en concretoDATOS COMUNESCARACTERÍSTICA OCULTAPodemos indicar que una característica esté oculta a los usuarios. Para ello debemos añadirlo en este campo de la siguiente forma:{"hidden":1}La característica de tipooperación matemática siempre está oculta al usuario, por lo que no es necesario añadir este parámetro.Si queremos hacer oculta una característica que por su tipo ya contiene información en el campo datos, deberemos añadirlo a estos. Por ejemplo, si queremos determinar que una característica de cantidad esté oculta, lo indicaríamos de la siguiente forma:{"freeMode":1,"lowLimit":1,"highLimit":10,"showTable":0,"hidden":1}
DATOS EN TIPO "CANTIDAD"Este valor esrequeridosi se trata de una característica de tipo"Cantidad".Debe tener el siguiente formato:{"freeMode":1,"lowLimit":1,"highLimit":10,"showTable":0}{"freeMode":0,"lowLimit":1,"highLimit":100,"showTable":0, "quantities":[10,20,30,40,50]}freeMode: Si se permite introducir la cantidad (1) o debe seleccionar de unas cantidades predefinidas (0).lowLimit: Si freeMode es igual a 1, la cantidad mínima que el usuario puede introducir.highLimit: Si freeMode es igual a 1, la cantidad máxima que el usuario puede introducir.showTable: Si freeMode es igual a 0 y se ha definido una característica de tipo "Tiempos de producción", mostrar cada característica individualmente (0) o mostrar una tabla de precios por cantidad y tiempos de producción (1)quantities: Si freeMode es igual a 0 es necesario definir las cantidades que va a poder seleccionar el usuario (separadas por comas).
DATOS EN TIPO "OPERACIÓN MATEMÁTICA"En la característica de tipo operación matemática, el primer operando de la operación será el valor indicado en "Recibir cantidad de". Si este campo no se define el primer operando será 1. En el campo data definiremos la operación, el puerto y el segundo operando.Este valor esrequeridosi se trata de una característica de tipo"Operación matemática".{"operation":1,"operand":"Cantidad","port":0}{"operation":2,"operand":25,"port":0}operation: Hace referencia a la operación a realizar. Existen las siguientes opciones:IDNombre1Suma2Resta3Multiplicación4Divisiónoperand: Hace referencia al operando de la operación matemática. Este puede ser un valor numérico o el nombre de una característica del producto.port: En caso de que el operando haga referencia a una característica del producto, indicaremos el puerto de dicha característica que queremos asociar como segundo operando.(Ver sección puerto para conocer los posibles valores). Si se trata de un operando numérico, el puerto será 0.
DATOS EN TIPO "TAMAÑO"En este caso, todos los datos relacionados con las medidas predefinidas o con la configuración de esta característica, se definen aquí.A continuación, vemos un ejemplo de una configuración en la que se permite al usuario emplear medidas personalizadas y al mismo tiempo se han proporcionado preajustes{ "allowCustom": true, "bounds": { "minWidth": "", "minHeight": "", "maxWidth": "", "maxHeight": "" }, "defaultSize": { "width": "100", "height": "100" }, "presets": [ { "width": "21", "height": "29,7", "name": "A4" }, { "width": "21,7", "height": "29", "name": "A4" }, { "width": "21", "height": "14,8", "name": "A5" }, { "width": "50", "height": "40", "name": "A6" } ] }Veamos en detalle qué es cada elemento:allowCustom: Es un valor buleano, lo que significa que debe ser verdadero (1 o true) o falso (0 o false). Determina cuando el usuario debe poder introducir sus medidas.bounds: es un conjunto de valores que especifican los límites de medidas. Si no quiere especificar los límites, establezca el valor a nada."". Es necesario que todos estén presentes, aunque su valor sea nulodefaultSize: contiene las medidas que serán seleccionadas por defecto cuando se presente el formulario de medidaspresets: Aquí se definen, si lo necesitas, las medidas prestablecidas que estarán disponibles para los usuarios. Cada rama se compone de 3 elementos, que son el ancho, el alto y el nombre. Si no definimos el nombre, el sistema generará una etiqueta basada en el ancho y el alto
DATOS EN TIPO "TABLA"La característica de tipo tabla nos permite que el cliente configure varios productos con la misma configuración pero con variaciones en dos características y personalización de la cantidad de cada selección.Sólo se permite un característica de tipo tabla en cada producto.Para configurar la tabla necesitamos determinar las características que aparecerán en los ejes x e y. Para ello indicaremos en nombre de característica del producto para cada uno de los ejes.Las características seleccionadasno pueden serde tipocantidad,pdf,checkbox,operación matemáticani obviamentetabla.productFeatureX: Indica la característica que se mostrará en el ejexde la tabla (horizontal)productFeatureY: Indica la característica que se mostrará en el ejeyde la tabla (vertical)showUnitaryPrice: Indica si se debe mostrar en la tabla el precio unitario aún cuando la cantidad sea 0. Los valores permitidos son1para activarlo y0para desactivarlo.
{ "productFeatureX": "NombreCaracterísticaEjeX", "productFeatureY": "NombreCaracterísticaEjeY", "showUnitaryPrice": 1 }DATOS EN TIPO "PRODUCTOS RELACIONADOS"La característica de productos relacionados nos permite presentar un conjunto de productos como si fuese una característica, con la diferencia de que al hacer click nos llevará a la página del producto en el que hemos hecho click.Sólo se permite un característica de tipo productos relacionados en cada producto.ids: Indica los ids de los productos relacionados que se mostrarán. Estos valores se indican entre corchetes[]y separados por comas,entre sí.targetBlank: Indica si se debe abrir el enlace del producto en una nueva pestaña del navegador. Los valores permitidos son1para abrir el enlace en una nueva pestaña y0para abrirlo en la pestaña actual.
{"ids":[5,52,87,113],"targetBlank":1}RECIBIR CANTIDAD DENombre de la característica del producto de la cual se recibirá la cantidad para calcular el precio.Estas característicasno pueden serde tipocheckboxnitabla.PUERTOAsociado al atributo "Recibir cantidad de". Hace referencia a la cantidad de entrada que va a utilizar la característica para el cálculo del precio. Los puertos que se detallan a continuación,sólotienen efecto cuando"Recibir cantidad de"tiene asociado una característica deltipo indicado entre paréntesis.Las opciones para el puerto son las siguientes:IDNombre0Cantidad calculada1Cantidad introducida por el usuario2Páginas del archivo pdf3Superficie: Introducido por el usuario4Superficie: Calculado5Perímetro: Introducido por el usuario6Perímetro: Calculado7Ancho: Introducido por el usuario8Alto: Introducido por el usuario9Unidades de material10Unidades de material: Calculado11Cortes del material12Cortes del material: Calculado13Elementos por unidad de material seleccionado: CalculadoREDONDEORedondeo que se aplicará a la cantidad recibida antes del cálculo del precio.0 - Sin redondeo1 - Normal (Redondeo matemático)2 - Al alza3 - A la baja
BLOQUEADO0 - No1 - Sí
DEFINICIÓN DE VALOR DE CARACTERÍSTICA
IDVacío*xx: Número entero precedido de asterisco para definir un identificador temporal al valor que se va a crear (no existe en el sistema), que luego nos permite definir incompatibilidades haciendo referencia a este valor.Número entero correspondiente al identificador de la característica del producto (si ya existe).
Importante:Si el id definido no corresponde a un valor de característica existente en ese producto, se creará como un nuevo valor.PRECIO FIJO Y VARIABLELos precios definidos deben sersin impuestos.Son opcionales, si se definen pueden ser un número o un rango de precios. Para definir el rango de precios deberemos introducir los datos de la siguiente forma:ranges: Especifica los rangos configurados.Por cada rango de precio debemos definir la siguiente estructura:{"min": 0, "max":10, "price": 10}min: se refiere al valor mínimo del rango, a la hora de evaluarlo para determinar el precio a aplicar, la condición será que la cantidad del producto seamayorque el valor mínimo.max: se refiere al valor máximo del rango, a la hora de evaluarlo para determinar el precio a aplicar, la condición será que la cantidad del producto seamenor o igualque el valor máximo.price: indica el precio a aplicar en ese rango.Los rangos deben estarordenadospor min y max, es decir, elprimer rango definidodeberá tener"min":0, del mismo modo elúltimo rango definidodeberá tener"max":null(hasta infinito). El valor "min":0 y "max":null siempre deben estar presentes en los rangos.Los rangos deben sercorrelativos, es decir, si el primer rango tiene como "max":50, el segundo rango tendrá como min ese mismo valor ("min":50), y así sucesivamente.Los rangos deben estar envueltos entre corchetes[]y separados entre sí por comas,
Ejemplos:Un único precio:10.2Un único precio (definiendo rango):{"ranges":[{"min":0, "max":null, "price":10.2}]}Los dos ejemplos anteriores tienen el mismo resultadoVarios rangos:{"ranges":[{"min":0, "max":50, "price":10.2},{"min":50, "max":100, "price":9.8},{"min":150, "max":null, "price":9.2}]}
POR DEFECTOIndica el valor que estará seleccionado por defecto en la característica. Sólo se permite un valor por defecto, por lo que si hay más de 1 definido, sólo se marcará el primero de ellos.0 - No1 - Sí
DATOSEste campo es requerido y tiene efecto si se trata de un valor de tipo"Color".Debe tener el siguiente formato:{"color": "#ffffff"}En caso de querer usar una imagen como textura del color, se indicará de la siguiente forma:{"color": "image"}color: el valor hexadecimal del color (ejemplos: blanco #ffffff, negro #000000) o valor fijo 'image'.
INCOMPATIBILIDADESSólo podrán importarse las incompatibilidades de tipo VALOR DE CARACTERÍSTICA o de TIPO CANTIDAD vinculadas con la característica de CANTIDAD PRINCIPAL.Se indicarán las incompatibilidades conotros valoresindicando su id. Se podrán añadir todas las que se deseen separadas por|.*3|*1: Incompatibilidad con los valores marcados con id temporal *3 y *1.198|*1|*3: Incompatibilidad con el valor existente con id 198 y con los valores marcados con id temporal *1 y *3.198|202: Incompatibilidad con los valores existentes con id 198 y 202.Para definir incompatibilidades con una característica de cantidad indicaremos intervalo de cantidad entre las cuales será incompatible el valor, marcando el máximo+xxy el mínimo-xxseparados por:.Las incompatibilidades de cantidad van directamente asociadas a otra característica, pues necesitan saber con qué cantidad van a ser incompatibles. Para ello, es necesario cumplir el siguiente formato, en el que se indica el id de la característica antes de los valores de máximo y mínimo.(10/-10:+50): Incompatibilidad con los valores de cantidad comprendidos entre 10 y 50 basándose en la cantidad que emite la característica 10.Si se desea definir un grupo de incompatibilidades se agruparan las incompatibilidades del grupo mediante[]separadas por:[*1:*2]|[(12/-10:+50):*2]
IMPORTACIÓN DE IMÁGENES
Productos, características y valores de características admiten imágenes. Puede indicar tantas imágenes como desee separadas por |. La primera imagen será tomada como cover o imagen principal.
La ruta de la imágen puede ser una url o la ruta a un archivo alojado en su dispositivo.
http://example.com/images/1.jpg|home/downloads/file1.jpg
Si quiere determinar un texto para el alt de la imagen, deberá indicarlo a continuación de la ruta entre corchetes [].
http://example.com/images/1.jpg[Imagen principal]|home/downloads/file1.jpg[Otra imagen]
Si desea eliminar una imagen existente en el sistema deberá especificarlo añadiendo d: antes de los datos de la imagen a eliminar.
En el siguiente ejemplo indicamos que queremos eliminar la imagen 58, para lo que facilitamos la ruta a una de sus tamaños. En este caso, la dimensión ori. No importa el el tamaño, se extraerá el identificador de esta automáticamente.
https://mydomain.com/images/gallery/5/7/57-ori.jpg|d:https://mydomain.com/images/gallery/5/8/58-ori.jpg
CÓMO IMPORTAR DESDE ARCHIVODesde el panel derecho de esta pantalla además de realizar la importación, puede descargar un archivo de importación de muestra o acceder al generador de archivos de importación, en el cual podrá generar automáticamente el archivo excel con los datos de los productos seleccionados.
Importante: Esta herramienta sirve tanto para exportar/importar como para actualizar precios. Cuando exportas un producto, este se exporta con información en las celdas correspondientes al identificador del elemento (producto, característica, valor). Cuando este identificador está presente, el sistema entiende que estas solicitando una actualización del producto existente en el sistema. Si lo que necesitas es importarlo como un producto nuevo, abre el archivo exportado con tu programa favorito y deja vacía la celda. de identificador de producto.ESPECIFICACIONES SOBRE EL ARCHIVONOVEDADES EN LA VERSIÓN 3Con la última actualización de Proshop, hay cambios en el importador, por lo que será necesario que actualice sus productos exportados para continuar empleándolos.
A continuación, se muestra una tabla con los cambios más reseñables
VERSIÓN CAMBIO3.0.0 Desaparecen varios atributos del producto. Ahora estos valores pertenecen a la característica de medidasmaximum_widthmaximum_heightminimum_widthminimum_heightminimum_surfacepanelsmode3.0.0 mode:1 o mode:2 ya no son necesarios dentro de las definiciones de los rangos de precios. Desaparecen los modos y solo se puede operar con cantidad.3.0.0 Las incompatibilidades ahora operan con todos los valores de cantidad y sus puertos. Es necesario definir el puerto a la hora de importarEl archivo de importación debe ser de formato .csv, especificando como separador ";"
Se pueden definir 3 tipos de elementos: productos, características de producto y valor de las características de producto. Es muy importante que se mantenga el orden, es decir primero definiremos el producto, en la siguiente línea definiremos la característica del producto y a continuación los valores de dicha característica (si los tiene).
Se debe respetar las tabulaciones del archivo para cada elemento y el orden de los campos. Así mismo se debe añadir la cabecera en la línea previa a definir las propiedades de cada elemento, excepto cuando definimos valores de la característica, que se define la cabecera y a continuación la especificación de todos los valores de dicha característica. Por ejemplo:
Cabecera de productoEspecificaciones de productoCabecera de característicaDatos de característica sin valoresCabecera de característicaDatos de característica con valoresCabecera de valores de característicaDatos valor 1Datos valor 2Datos valor 3...
Las campos de las cabeceras que hacen referencia al id son los marcados con #.
Puede descargar un archivo de muestra desde el panel derecho, o generar un archivo de importación de productos existentes para su actualización.
CONSIDERACIONES GENERALESLa herramienta de importación emplea los campos de id como utilidad para identificar cuándo estás intentando actualizar un producto o creando uno nuevo.
Si debajo de la celda que incluye el símbolo # se incluye el identificador unico del elemento a importar y que corresponde con la base de datos, se entenderá que quieres actualizarlo.Por ejemplo, queremos actualizar el producto con el ID 16 a través del importador; en la celda debajo del símbolo indicado aparecerá 16, en la fila correspondiente a la información del producto. El sistema lo reconocerá y entenderá que lo que debe hacer es actualizar el producto con id 16, en lugar de crear uno nuevo.No tienes por qué saber cual es el identificador. Estos datos se rellenan automáticamente cuando exportas uno o varios productos desde la plataforma.
Es importante tener en cuenta que para actualizar un producto, si se facilitan los identificadores, tienen que estar todos correctos. Si falta el identificador del producto, se tratará toda la información como un producto nuevo.DEFINICIÓN DE PRODUCTOPRECIO BASESi se define debe ser el valor sin impuestos.
PRECIO FIJO Y VARIABLELos precios definidos deben ser sin impuestos.
Son opcionales, si se definen pueden ser un número o un rango de precios. Para definir el rango de precios deberemos introducir los datos de la siguiente forma:
ranges: Especifica los rangos configurados.Por cada rango de precio debemos definir la siguiente estructura: {"min": 0, "max":10, "price": 10}min: se refiere al valor mínimo del rango, a la hora de evaluarlo para determinar el precio a aplicar, la condición será que la cantidad del producto sea mayor que el valor mínimo.max: se refiere al valor máximo del rango, a la hora de evaluarlo para determinar el precio a aplicar, la condición será que la cantidad del producto sea menor o igual que el valor máximo.price: indica el precio a aplicar en ese rango.Los rangos deben estar ordenados por min y max, es decir, el primer rango definido deberá tener "min":0, del mismo modo el último rango definido deberá tener "max":null (hasta infinito). El valor "min":0 y "max":null siempre deben estar presentes en los rangos.Los rangos deben ser correlativos, es decir, si el primer rango tiene como "max":50, el segundo rango tendrá como min ese mismo valor ("min":50), y así sucesivamente.Los rangos deben estar envueltos entre corchetes [] y separados entre sí por comas ,Ejemplos:Un único precio: 10.2Un único precio (definiendo rango): {"ranges":[{"min":0, "max":null, "price":10.2}]}Los dos ejemplos anteriores tienen el mismo resultadoVarios rangos:{"ranges":[{"min":0, "max":50, "price":10.2},{"min":50, "max":100, "price":9.8},{"min":150, "max":null, "price":9.2}]}IMPUESTOSDeberemos indicar el id del impuesto existente. Puede consultarlos en el apartado impuestos.
En el caso de que no se defina impuesto, se asociará el impuesto por defecto
PUBLICADO/¿SERVIR EN PANELES?/REQUIERE ARCHIVO/DISEÑADOR HABILITADO0 - No1 - SíESTRATEGIA DE STOCKIndica el comportamiento cuando no hay stock del producto
0 - Denegar:Los clientes no podrán comprar el producto cuando el stock esté vacío.
1 - Permitir:Se puede comprar aunque no tenga stock
2 - Heredar de la configuración global (Denegar):VISUALIZACIÓN VALOR INCOMPATIBLEDetermina el comportamiento para la visualización de valores incompatibles a los usuarios
0 - Ocultar:Los valores incompatibles no se mostrarán al usuario
1 - Mostrar desactivado:Los valores incompatibles se mostrarán desactivados al usuario
2 - Heredar de la configuración global (Mostrar desactivado):COMPORTAMIENTO DEL CÁLCULO DE PRECIOSDetermina el comportamiento del cálculo de precios del producto
1 - Cálculo de precios por características y combinaciones:Si una combinación predefinida coincide, usará su precio. En caso contrario, se seguirá con el cálculo normal
2 - Sólo combinaciones:Utiliza únicamente combinaciones predefinidas para obtener el precio del producto. Los precios o porcentajes indicados en los valores de las características serán ignorados
MARCA/PROVEEDORSe indicará el nombre de la marca y/o proveedor. Si estos no existen en el sistema se crearán automáticamente.
CATEGORÍASSe definirán todas las categorías asociadas a un producto separadas por |. La primera categoría definida será definida como la categoría por defecto.
Se deberá indicar la jerarquía completa de la categoría (excluyendo la categoría "Inicio") separadas por /. Si no existe una categoría con ese nombre y esa jerarquía se creará en el sistema.
En el ejemplo que se indica a continuación, la categoría por defecto es "Pegatinas personalizadas", y también se asociará el producto a la categoría "Inicio" y a "Camisetas manga corta", esta última tiene definida como categoría padre "Camisetas Personalizadas"
Pegatinas personalizadas|Inicio|Camisetas Personalizadas/Camisetas manga cortaTRANSPORTISTASSe definirán todas los transportistas asociados a un producto separados por |. Si el transportista no existe, se creará en el sistema deshabilitado, asignandole el impuesto marcado por defecto y el comportamiento "gratis". Podrá habilitar y personalizar posteriormente la configuración del transportista desde el apartado transportistas.
Para que el producto esté disponible en todos los transportistas del sistema, no se debe definir la asociación con ningún transportista.
DEFINICIÓN DE CARACTERÍSTICAIDVacíoNúmero entero correspondiente al identificador de la característica del producto (si ya existe).Importante: Si el id definido no corresponde a una característica existente en ese producto, se creará como una nueva característica.
TIPO VISTAID Nombre1 Radio2 Seleccionar3 Cajas opcionales4 Cantidad5 Imágenes6 Color7 Tiempo de producción9 Archivo Pdf para contar las páginas10 Operación matemática11 Tabla12 Productos relacionados13 Tamaño14 MaterialesDATOSHay datos que se pueden añadir a cualquier tipo de caracteŕitica y otros que sólo tienen efecto para un tipo en concreto
DATOS COMUNESCARACTERÍSTICA OCULTAPodemos indicar que una característica esté oculta a los usuarios. Para ello debemos añadirlo en este campo de la siguiente forma:
La característica de tipo operación matemática siempre está oculta al usuario, por lo que no es necesario añadir este parámetro.
Si queremos hacer oculta una característica que por su tipo ya contiene información en el campo datos, deberemos añadirlo a estos. Por ejemplo, si queremos determinar que una característica de cantidad esté oculta, lo indicaríamos de la siguiente forma:
{"freeMode":1,"lowLimit":1,"highLimit":10,"showTable":0, "hidden":1}
DATOS EN TIPO "CANTIDAD"Este valor es requerido si se trata de una característica de tipo "Cantidad".
Debe tener el siguiente formato:
{"freeMode":1,"lowLimit":1,"highLimit":10,"showTable":0}
{"freeMode":0,"lowLimit":1,"highLimit":100,"showTable":0, "quantities":[10,20,30,40,50]}
freeMode: Si se permite introducir la cantidad (1) o debe seleccionar de unas cantidades predefinidas (0).lowLimit: Si freeMode es igual a 1, la cantidad mínima que el usuario puede introducir.highLimit: Si freeMode es igual a 1, la cantidad máxima que el usuario puede introducir.showTable: Si freeMode es igual a 0 y se ha definido una característica de tipo "Tiempos de producción", mostrar cada característica individualmente (0) o mostrar una tabla de precios por cantidad y tiempos de producción (1)quantities: Si freeMode es igual a 0 es necesario definir las cantidades que va a poder seleccionar el usuario (separadas por comas).
DATOS EN TIPO "OPERACIÓN MATEMÁTICA"En la característica de tipo operación matemática, el primer operando de la operación será el valor indicado en "Recibir cantidad de". Si este campo no se define el primer operando será 1. En el campo data definiremos la operación, el puerto y el segundo operando.
Este valor es requerido si se trata de una característica de tipo "Operación matemática".
{"operation":1,"operand":"Cantidad","port":0}
{"operation":2,"operand":25,"port":0}
operation: Hace referencia a la operación a realizar. Existen las siguientes opciones:ID Nombre1 Suma2 Resta3 Multiplicación4 Divisiónoperand: Hace referencia al operando de la operación matemática. Este puede ser un valor numérico o el nombre de una característica del producto.port: En caso de que el operando haga referencia a una característica del producto, indicaremos el puerto de dicha característica que queremos asociar como segundo operando.(Ver sección puerto para conocer los posibles valores). Si se trata de un operando numérico, el puerto será 0.
DATOS EN TIPO "TAMAÑO"En este caso, todos los datos relacionados con las medidas predefinidas o con la configuración de esta característica, se definen aquí.
A continuación, vemos un ejemplo de una configuración en la que se permite al usuario emplear medidas personalizadas y al mismo tiempo se han proporcionado preajustes
{ "allowCustom": true, "bounds": { "minWidth": "", "minHeight": "", "maxWidth": "", "maxHeight": "" }, "defaultSize": { "width": "100", "height": "100" }, "presets": [ { "width": "21", "height": "29,7", "name": "A4" }, { "width": "21,7", "height": "29", "name": "A4" }, { "width": "21", "height": "14,8", "name": "A5" }, { "width": "50", "height": "40", "name": "A6" } ]}
Veamos en detalle qué es cada elemento:
allowCustom: Es un valor buleano, lo que significa que debe ser verdadero (1 o true) o falso (0 o false). Determina cuando el usuario debe poder introducir sus medidas.bounds: es un conjunto de valores que especifican los límites de medidas. Si no quiere especificar los límites, establezca el valor a nada. "". Es necesario que todos estén presentes, aunque su valor sea nulodefaultSize: contiene las medidas que serán seleccionadas por defecto cuando se presente el formulario de medidaspresets: Aquí se definen, si lo necesitas, las medidas prestablecidas que estarán disponibles para los usuarios. Cada rama se compone de 3 elementos, que son el ancho, el alto y el nombre. Si no definimos el nombre, el sistema generará una etiqueta basada en el ancho y el alto
DATOS EN TIPO "TABLA"La característica de tipo tabla nos permite que el cliente configure varios productos con la misma configuración pero con variaciones en dos características y personalización de la cantidad de cada selección.
Sólo se permite un característica de tipo tabla en cada producto.
Para configurar la tabla necesitamos determinar las características que aparecerán en los ejes x e y. Para ello indicaremos en nombre de característica del producto para cada uno de los ejes.
Las características seleccionadas no pueden ser de tipo cantidad, pdf, checkbox, operación matemática ni obviamente tabla.
productFeatureX: Indica la característica que se mostrará en el eje x de la tabla (horizontal)productFeatureY: Indica la característica que se mostrará en el eje y de la tabla (vertical)showUnitaryPrice: Indica si se debe mostrar en la tabla el precio unitario aún cuando la cantidad sea 0. Los valores permitidos son 1 para activarlo y 0 para desactivarlo.
{ "productFeatureX": "NombreCaracterísticaEjeX", "productFeatureY": "NombreCaracterísticaEjeY", "showUnitaryPrice": 1}
DATOS EN TIPO "PRODUCTOS RELACIONADOS"La característica de productos relacionados nos permite presentar un conjunto de productos como si fuese una característica, con la diferencia de que al hacer click nos llevará a la página del producto en el que hemos hecho click.
Sólo se permite un característica de tipo productos relacionados en cada producto.
ids: Indica los ids de los productos relacionados que se mostrarán. Estos valores se indican entre corchetes [] y separados por comas , entre sí.targetBlank: Indica si se debe abrir el enlace del producto en una nueva pestaña del navegador. Los valores permitidos son 1 para abrir el enlace en una nueva pestaña y 0 para abrirlo en la pestaña actual.
{"ids":[5,52,87,113],"targetBlank":1}RECIBIR CANTIDAD DENombre de la característica del producto de la cual se recibirá la cantidad para calcular el precio.
Estas características no pueden ser de tipo checkbox ni tabla.
PUERTOAsociado al atributo "Recibir cantidad de". Hace referencia a la cantidad de entrada que va a utilizar la característica para el cálculo del precio. Los puertos que se detallan a continuación, sólo tienen efecto cuando "Recibir cantidad de" tiene asociado una característica del tipo indicado entre paréntesis.
Las opciones para el puerto son las siguientes:
ID Nombre0 Cantidad calculada1 Cantidad introducida por el usuario2 Páginas del archivo pdf3 Superficie: Introducido por el usuario4 Superficie: Calculado5 Perímetro: Introducido por el usuario6 Perímetro: Calculado7 Ancho: Introducido por el usuario8 Alto: Introducido por el usuario9 Unidades de material10 Unidades de material: Calculado11 Cortes del material12 Cortes del material: Calculado13 Elementos por unidad de material seleccionado: CalculadoREDONDEORedondeo que se aplicará a la cantidad recibida antes del cálculo del precio.
0 - Sin redondeo1 - Normal (Redondeo matemático)2 - Al alza3 - A la bajaBLOQUEADO0 - No1 - SíDEFINICIÓN DE VALOR DE CARACTERÍSTICAIDVacío*xx: Número entero precedido de asterisco para definir un identificador temporal al valor que se va a crear (no existe en el sistema), que luego nos permite definir incompatibilidades haciendo referencia a este valor.Número entero correspondiente al identificador de la característica del producto (si ya existe).Importante: Si el id definido no corresponde a un valor de característica existente en ese producto, se creará como un nuevo valor.
PRECIO FIJO Y VARIABLELos precios definidos deben ser sin impuestos.
Son opcionales, si se definen pueden ser un número o un rango de precios. Para definir el rango de precios deberemos introducir los datos de la siguiente forma:
ranges: Especifica los rangos configurados.Por cada rango de precio debemos definir la siguiente estructura: {"min": 0, "max":10, "price": 10}min: se refiere al valor mínimo del rango, a la hora de evaluarlo para determinar el precio a aplicar, la condición será que la cantidad del producto sea mayor que el valor mínimo.max: se refiere al valor máximo del rango, a la hora de evaluarlo para determinar el precio a aplicar, la condición será que la cantidad del producto sea menor o igual que el valor máximo.price: indica el precio a aplicar en ese rango.Los rangos deben estar ordenados por min y max, es decir, el primer rango definido deberá tener "min":0, del mismo modo el último rango definido deberá tener "max":null (hasta infinito). El valor "min":0 y "max":null siempre deben estar presentes en los rangos.Los rangos deben ser correlativos, es decir, si el primer rango tiene como "max":50, el segundo rango tendrá como min ese mismo valor ("min":50), y así sucesivamente.Los rangos deben estar envueltos entre corchetes [] y separados entre sí por comas ,Ejemplos:Un único precio: 10.2Un único precio (definiendo rango): {"ranges":[{"min":0, "max":null, "price":10.2}]}Los dos ejemplos anteriores tienen el mismo resultadoVarios rangos:{"ranges":[{"min":0, "max":50, "price":10.2},{"min":50, "max":100, "price":9.8},{"min":150, "max":null, "price":9.2}]}POR DEFECTOIndica el valor que estará seleccionado por defecto en la característica. Sólo se permite un valor por defecto, por lo que si hay más de 1 definido, sólo se marcará el primero de ellos.0 - No1 - SíDATOSEste campo es requerido y tiene efecto si se trata de un valor de tipo "Color".
Debe tener el siguiente formato:
{"color": "#ffffff"}
En caso de querer usar una imagen como textura del color, se indicará de la siguiente forma:
{"color": "image"}
color: el valor hexadecimal del color (ejemplos: blanco #ffffff, negro #000000) o valor fijo 'image'.INCOMPATIBILIDADESSólo podrán importarse las incompatibilidades de tipo VALOR DE CARACTERÍSTICA o de TIPO CANTIDAD vinculadas con la característica de CANTIDAD PRINCIPAL.
Se indicarán las incompatibilidades con otros valores indicando su id. Se podrán añadir todas las que se deseen separadas por |.
*3|*1: Incompatibilidad con los valores marcados con id temporal *3 y *1.
198|*1|*3: Incompatibilidad con el valor existente con id 198 y con los valores marcados con id temporal *1 y *3.
198|202: Incompatibilidad con los valores existentes con id 198 y 202.
Para definir incompatibilidades con una característica de cantidad indicaremos intervalo de cantidad entre las cuales será incompatible el valor, marcando el máximo +xx y el mínimo -xx separados por :.
Las incompatibilidades de cantidad van directamente asociadas a otra característica, pues necesitan saber con qué cantidad van a ser incompatibles. Para ello, es necesario cumplir el siguiente formato, en el que se indica el id de la característica antes de los valores de máximo y mínimo.
(10/-10:+50): Incompatibilidad con los valores de cantidad comprendidos entre 10 y 50 basándose en la cantidad que emite la característica 10.
Si se desea definir un grupo de incompatibilidades se agruparan las incompatibilidades del grupo mediante [] separadas por :
[*1:*2]|[(12/-10:+50):*2]IMPORTACIÓN DE IMÁGENESProductos, características y valores de características admiten imágenes. Puede indicar tantas imágenes como desee separadas por |. La primera imagen será tomada como cover o imagen principal.
La ruta de la imágen puede ser una url o la ruta a un archivo alojado en su dispositivo.
http://example.com/images/1.jpg|home/downloads/file1.jpg
Si quiere determinar un texto para el alt de la imagen, deberá indicarlo a continuación de la ruta entre corchetes [].
http://example.com/images/1.jpg[Imagen principal]|home/downloads/file1.jpg[Otra imagen]
Si desea eliminar una imagen existente en el sistema deberá especificarlo añadiendo d: antes de los datos de la imagen a eliminar.
En el siguiente ejemplo indicamos que queremos eliminar la imagen 58, para lo que facilitamos la ruta a una de sus tamaños. En este caso, la dimensión ori. No importa el el tamaño, se extraerá el identificador de esta automáticamente.
https://mydomain.com/images/gallery/5/7/57-ori.jpg|d:https://mydomain.com/images/gallery/5/8/58-ori.jpg