(es) Productos
Este artículo explica cómo preparar un fichero de importación para la categoría “productos”.
Los datos de esta categoría representan los artículos disponibles para la compra. A continuación, los “productos” se vinculan a los “orders” mediante las “order lines” (los artículos individuales de cada pedido).
Ten en cuenta que "productos" es una de las categorías que se pueden actualizar: los datos existentes pueden ser modificados por futuras importaciones.
Prerrequisitos
- Conocimientos básicos del formato CSV y de la codificación UTF-8.
- Un editor de texto compatible con UTF-8.
- Un programa para hojas de cálculo.
- La subsecuencia debe definirse en el fichero de configuración, en la sección “productos”.
Preparar un fichero de productos
Revisa el fichero que estás preparando y comprueba que contenga toda la información que quieres importar.
Utiliza tu programa de hoja de cálculo para organizar las columnas y eliminar las que no puedas (o no quieras) importar. Recuerda siempre guardar (o exportar) el archivo en formato CSV con codificación UTF-8 sin lista de materiales y utilizar punto y coma (';') para separar las columnas.
Utiliza un editor de texto de tu preferencia para abrir y editar el archivo CSV a importar.
Por favor, limita el tamaño del archivo a 200K líneas.
Header y Columnas
La primera línea del fichero es el header. Asegúrate de que solo contenga los nombres de las columnas, de lo contrario la importación fallará.
Las siguientes columnas están disponibles en los ficheros “productos”:
- product_id -- el identificador externo del producto; esta columna es obligatoria y tiene que ser unívoca para cada producto.
- name -- el nombre del producto que se visualizará en Splio.
- brand -- la marca del producto.
- description -- la descripción del producto - información adicional que se mostrarán en Splio.
- price -- el precio nominal del producto, expresado siempre como un número con dos decimales (por ejemplo, 2,50), en la moneda por defecto del universo Splio.
- category -- el nombre de la categoría asociada al producto.
- img_url -- el URL de una imagen que representa el producto.
- sku -- (Stock Keeping Unit); el código único utilizado para hacer un seguimiento de las existencias de productos.
- Una columna personalizada, si está definida para los productos de su universo Splio.
Ten en cuenta que todas las columnas relativas a los campos de sistema deben estar en minúsculas.
La importación fallará si no se incluye la columna obligatoria (product_id) o si se utiliza una columna no reconocida por Splio (es decir, ni una de las columnas por defecto ni una columna correctamente personalizada).
Importante: Cuando subas los precios de los productos, asegúrate de introducir dos decimales después del punto (por ejemplo, 10,99).
Ejemplo de un fichero
Un archivo corto con la lista algunos productos para mascotas podría ser así;
product_id;name;brand;price
"0013130002004";"Dog Treats";"Milk Bone";"182.49"
"8003299918256";"Tigrito Cat Bowl";"Alessi";"38.50"
"0871864006190";"Hot Diggity Dog Dog Toy Size Medium";"Petstages";"85.25"
"0721343632993";"Maximum Absorbency Dog Puppy Pads Size 100 Package;Zanies";"119.91"
"0045663188931";"Dog Diaper Garment Size Medium";"Topdawg Pet Supply";"115.61"
El ejemplo utiliza cuatro columnas estándar: product_id, nombre, marca y precio. Los datos de cada columna figuran en las filas siguientes.
Nombrar un fichero
Guarda tu fichero con un nombre compuesto por el nombre del universo, la categoría (“productos”), la subsecuencia y la fecha actual. Por ejemplo:
myuniverse_products_zoo_20180416.csv
Este fichero pertenece al universo “myuniverse”, a la subsecuencia “zoo” definida para los productos y tiene fecha 16 de abril de 2018.
Ahora puedes subir el archivo a SFTP/FTPS.
Información Avanzada
Esta parte del artículo contiene información adicional relacionada con la guía anterior y ofrece más detalles.
Formato del fichero
| Nombre del fichero | products().csv |
|---|---|
| Codifica | UTF-8 sin BOM |
| Formato | CSV (sin multilínea) |
| Separador de columnas | ; (semicolumna) |
| Calificador de texto | " (comillas, opcionales) |
| Caracteres de escape | \ (backslash) |
| Fin de la línea | \n or \r\n |
| Separador decimal | . (punto) |
Columnas
La siguiente tabla contiene información detallada sobre todas las columnas (campos) del campo “productos”.
Ten en cuenta que los nombres de las columnas deben escribirse poniendo atención a las mayúsculas y las minúsculas. Por esta razón, por defecto, los nombres están todos en minúsculas.
| Columna | Obligatorio | Tipo de datos / Longitud máxima | Descripción |
|---|---|---|---|
| product_id | Sí | Texto (máx. 50 caracteres) | Esta columna tiene que incluir el identificador externo del producto importado. Dado que es la clave primaria de la tabla «productos», esta columna es obligatoria, con lo cual, si falta, la importación será interrumpida. Además, Splio ignorará todas las líneas que no contengan un valor 'product_id'. |
| name | Sí | Texto (máx. 120 caracteres) | Nombre del producto |
| brand | No | Texto (máx. 120 caracteres) | Indica el nombre de la marca del producto. |
| description | No | Texto (máx. 120 caracteres) | Incluye una breve descripción del producto (asegúrate de respetar el tamaño limitado del campo). |
| price | No | Los números decimales utilizan el «.» (punto) como separador decimal y siempre se expresan en la divisa principal de tu universo. | El precio del producto. |
| category | No | Texto (máx. 120 caracteres) | La categoría del producto. |
| img_url | No | Texto (máx. 2048 caracteres) | El URL de una imagen del producto |
| sku | No | Texto (máx. 120 caracteres) | El código identificativo del producto |
| Product custom field | No | Texto (máx. 255 caracteres) | Véase abajo |
En el sistema de Splio, puedes importar datos utilizando campos personalizados configurados en tu universo. Puedes identificar estos campos utilizando su nombre original como header de columna o la abreviación "c" seguida de su ID numérico.
Por ejemplo, si tienes un campo llamado «categoría» en la tabla «productos» y su ID es 2, puedes utilizar tanto «categoría» como «c2» como nombre de columna.
Es esencial que Splio reconozca el nombre de la columna para importar correctamente el fichero.
Logs
Aquí se muestra la información proporcionada por Splio tras importar los datos.
Indica si hubo algún problema durante la importación y, en caso afirmativo, especifica la causa (columna desconocida, falta de ID externo, campo personalizado no especificado).
- Número total de líneas procesadas (importadas + omitidas) / importadas / omitidas
- Número de datos nuevos añadidos y datos actualizados
- Motivo por el que se ha omitido cada fila (product_id NULL, demasiadas/insuficientes columnas)
Normalmente, encontrarás un archivo de registro en la misma carpeta en la que subiste el archivo de importación.
Updated 20 days ago