En este artículo se explica cómo preparar un fichero “products” para importarlo con Splio.
Los registros de la tabla “products” representan los artículos que se pueden comprar. La tabla de productos (“products”) está relacionada con la de recibos (“orders”) a través de la tabla de líneas de recibo (“ordersitems”).
Encontrarás un ejemplo de un fichero para este alcance al final del artículo.
Ten en cuenta que “products” es uno de los alcances que se puede actualizar. Los datos existentes se pueden cambiar en futuras importaciones.
Requisitos previos
- Conocimiento básico del formato CSV y la codificación UTF-8
- Un editor de texto UTF-8
- Un software de hoja de cálculo
- Creación de la subsecuencia para la tabla “products” en el fichero de configuración
Preparación del fichero de productos
Comprueba el fichero que estás preparando para ver si contiene toda la información que deseas importar. Utiliza un software de hoja de cálculo para organizar columnas y eliminar las que no puedes (o no deseas) importar. Recuerda siempre guardar como (o exportar a) archivo CSV con codificación UTF-8 sin BOM y utiliza punto y coma (“;”) para separar las columnas.
Utiliza tu editor de texto favorito para abrir y modificar el archivo de importación CSV.
⚠️| Por favor, limita el tamaño del archivo a 200K.
Cabecera y columnas
La primera línea del archivo, llamada cabecera, se utiliza para determinar el contenido de las líneas siguientes. Por lo tanto, debería contener únicamente los nombres de los campos (uno por cada columna).
Para el fichero “products”, están disponibles las siguientes columnas:
Columna |
Obligatorio |
Tipo de dato / Longitud máxima |
Descripción |
product_id |
Sí |
Texto (máx. 50 caracteres) |
Identificador externo del producto importado. Al ser la clave única de la tabla de productos, esta columna es obligatoria. El Datahub saltará todas las líneas que no tengan un valor “product_id”. |
name |
No |
Texto (máx. 120 caracteres) |
Nombre del producto. |
brand |
No |
Texto (máx. 120 caracteres) |
Nombre de la marca del producto. |
description |
No |
Texto (máx. 120 caracteres) |
Breve descripción del producto (asegúrate de considerar la longitud del campo). |
price |
No |
Decimal, «.» (punto) como separador decimal. Siempre expresado en la divisa por defecto de tu universo. |
Precio del producto. |
category |
No |
Texto (máx. 120 caracteres) |
Categoría del producto. |
img_url |
No |
Texto (máx. 2048 caracteres) |
URL de una imagen del producto. |
sku |
No |
Texto (máx. 120 caracteres) |
SKU del producto. |
c0 |
No |
Texto (máx. 255 caracteres) |
Una o más columnas correspondientes a los campos personalizados de producto en tu universo. Puedes incluir hasta 180 columnas denominadas o por l’id del campo (de “c0” a “c179”) o per el nombre del campo. |
📗| Ten en cuenta que todos los nombres de campos de sistema se escriben siempre en minúscula y que los nombres de los campos son case sensitive.
Recuerda que la importación fallará si no incluyes la columna obligatoria (“product_id”) o si nombras las columnas de forma diferente a como están los campos en Splio (cada campo personalizado en Splio se tiene que poner exactamente igual en el fichero).
⚠️ | Para los precios, pon siempre dos decimales después del punto (separador decimal aceptado – p. ej. 10.99)
Ejemplo de fichero
Un fichero pequeño que contenga algunos productos para mascotas tendría el siguiente aspecto:
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;name;brand;price. Los valores correspondientes a cada columna están ubicados en las siguientes filas.
Nombre del fichero
Guarda tu fichero con un nombre compuesto por el nombre del universo, el alcance (“products”), la subsecuencia y la fecha actual. Por ejemplo:
myuniverse_products_zoo_20180416.csv
Este nombre de fichero pertenece al universo “myuniverse”, subsecuencia “zoo” definida para productos, y su fecha es el 16 de abril de 2018.
Si deseas más información, consulta la sección «Reglas de nomenclatura de ficheros» en el En el articulo Datahub - Información general.
Ahora puedes subir el fichero al SFTP/FTPS.
Información avanzada
Esta parte del documento contiene información adicional que complementa la guía anterior.
Formato del fichero
Nombre fichero |
|
<universe>_products_<subsequence>_<date>(_<id>).csv |
Codificación |
|
UTF-8 sin BOM |
Formato |
|
CSV (no multilínea) |
Separador de columna |
|
; (punto y coma) |
Cualificador de texto |
|
“ (doble comilla, opcional) |
Carácter de escape |
|
\ (barra inversa) |
Final de línea |
|
\n o \r\n |
Separador decimal |
|
. (punto) |
Logs
Después de cada import, podrás encontrar la siguiente información en los logs:
- El status de la importación: si se ha procesado el fichero con existo o, si falló, la razón (columna desconocida, falta columna de id externo, campo personalizado desconocido)
- El número de líneas tratadas (importadas+saltadas)/importadas/saltadas
- El número de registros nuevos y actualizados
- La razón por la que cada línea se saltó (product_id NULL, demasiadas/no suficientes columnas)
Podrás encontrar el fichero de logs en la subcarpeta /logs.