ℹ️ | En este artículo se explica cómo preparar un fichero “ordersitems” para importarlo con Splio.
Representando los productos en los recibos o carritos abandonados, las líneas de recibos se utilizan para rellenarlos de contenidos.
Los registros del alcance “ordersitems” no se actualizan. En su lugar, tendrás que volver a importar todas las líneas de recibos para cada “order_id” que actualices en el alcance “orders” o “abandonedcarts”. Las actualizaciones de estos dos alcances siempre darán lugar a que Splio elimine todas las líneas de recibos asociadas (es uno de los pasos iniciales de importación).
Si importas un nuevo archivo de líneas de recibo vinculado a un recibo existente, añadirá las líneas a las líneas existentes del order (si lo hay).
Encontrarás un ejemplo de un fichero para este alcance al final del artículo.
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 “ordersitems” en el fichero de configuración
Preparación de un un fichero de líneas de recibo/carrito
Edita el fichero de importación con tu editor de texto de UTF-8 preferido. Si es necesario, controla el número y posición de las columnas con un software de hoja de cálculo que te guste. Es la mejor herramienta para eliminar cualquier columna que no desees importar.
💡 | Recuerda guardar siempre utilizando la codificación UTF-8 sin BOM.
⚠️| 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).
⚠️ | Recuerda que, si el Datahub encuentra un nombre de columna que no reconoce, no procesará el archivo.
Para el fichero “ordersitems”, están disponibles las siguientes columnas:
Columna |
Obligatorio |
Tipo de dato / Longitud máxima |
Descripción |
order_id |
Sí |
Texto (máx. 50 caracteres) |
Identificador externo de un recibo/carrito. Esta columna asocia líneas de “ordersitems” con “orders” (o “abandonedcarts”). Es obligatoria y debería hacer referencia a un pedido/carrito ya existente, de lo contrario, se creará una entrada “orders” en blanco en la bdd de Splio. |
product_id |
Sí |
Texto |
Id externo del producto del recibo/carrito. Esta columna es obligatoria. Si el producto no existe todavía en la base de datos, Splio creará un registro (vacío) por defecto. La actualización de productos no borra líneas de recibos asociadas. |
unit_price |
No |
Decimal |
El precio cargado para una sola unidad de producto. Este campo será el que se tome en cuenta en cualquier regla Loyalty basada en el precio del producto. |
discount_amount |
No |
Decimal |
La cantidad de descuento total. |
tax_amount |
No |
Decimal |
El importe tasas total. |
total_line_amount |
No |
Decimal |
El importe total de esta línea de pedido. |
currency |
Sí |
Texto (máx. 3 caracteres) |
El código de 3 letras para la divisa del carrito abandonado; se aplica a todos los valores de importe. Si no aparece ninguna divisa, Splio asumirá la divisa por defecto del universo. |
quantity |
No |
Entero sin signo |
La cantidad de producto. Este campo será el que se tome en cuenta en cualquier regla Loyalty basada en la cantidad del producto. |
card_code |
No |
Texto |
el código de una tarjeta loyalty, crea un vínculo entre el producto y la tarjeta loyalty. |
c0 |
No |
Texto (máx. 255 caracteres) |
Una columna personalizada definida en tu universo para líneas de recibos. Puedes incluir hasta 32 columnas denominadas «c0» a «c31». |
📗| 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.
⚠️ | Las columnas “order_id”, “product_id” y “store_id” son obligatorias. Si el Datahub no las detecta, la importación fallará.
💡 | Puedes importar la columna “card_code” tanto con ficheros “orders”, como por ficheros “ordersitems” para eventos loyalty. Recuerda poner en el fichero de “ordersitems” la columna “card_code” si quieres utilizar reglas loyalty basadas en los productos presentes en los recibos.
Consulta la sección «Recibos Loyalty» en Datahub - Recibos.
📗 | Para los números decimales, puedes utilizar «.» como separador.
⚠️ | Para los precios, pon siempre dos decimales después del punto (separador decimal aceptado – p. ej. 10.99)
Ejemplo de un fichero de líneas de recibo/carrito
Analiza el siguiente ejemplo de un archivo que contiene 3 productos que pertenecen al mismo pedido:
order_id;product_id;unit_price;quantity;tax_amount;total_line_amount;currency;c3
"70x1bMhtt-1531745300";"00131300020004";"182.49";"1";"36.50";"218.99";"EUR";"Accessories"
"70x1bMhtt-1531745300";"0027011018374";"9.16";"5";"9.16";"54.96";"EUR";"Food"
"70x1bMhtt-1531745300";"0077890206324";"154.50";"2";"61.80";"370.80";"Accessories"
📗 | Los campos representan al único identificador del recibo, identificador del producto, su precio neto, cantidad, tasa aplicada, suma total de cada línea y un campo de categoría personalizado.
Nombre del fichero
Para guardar tu archivo, utiliza un nombre compuesto por el nombre del universo, el alcance (“ordersitems”), la subsecuencia y la fecha actual. Por ejemplo:
myuniverse_ordersitems_pets_20210225.csv
Este nombre de archivo pertenece al universo “myuniverse”, subsecuencia “pets” definido para carritos y su fecha es el 25 de febrero de 2021.
Si deseas más información, consulta la sección «Reglas de nomenclatura de ficheros» en el articulo Datahub - Información general.
Ahora puedes subir el fichero al SFTP/FTPS.