Este artículo explica cómo preparar archivos para su importación en el apartado “ordersitems”. Se trata de los artículos específicos de los pedidos o carritos individuales y se utilizan para completarlos o llenarlos.

Los datos del apartado “orderitems” no se pueden actualizar y es necesario reimportar todos los artículos de los pedidos para cada “order_id” que se modifique en los apartados “orders” y “abandonedcarts”. Una vez se han actualizado estos dos apartados, Splio siempre elimina todos los artículos asociados al pedido (esto es uno de los primeros pasos de la importación).

Si importas un archivo de artículos asociados a un pedido ya existente, estos artículos serán añadidos a los que ya figuran en el pedido (si los hay).

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 “orders” (pedidos).

Preparación de un fichero Ordersitems

Prepara y modifica el fichero con la hoja de cálculo o el editor de texto UTF-8 que prefieras. La hoja de cálculo es la herramienta que debes utilizar siempre que necesites cortar o mover las columnas.

🚧

No olvides guardar siempre con codificación UTF-8 sin BOM.

Por favor, limita el tamaño del archivo a 200K objetos.

Header y Columnas

La primera línea del fichero, denominada header, se utiliza para determinar el contenido de las líneas siguientes. Por este motivo, solo debe constar de los nombres de las columnas.

🚧
Ten en cuenta que si Splio encuentra un nombre de columna que no reconoce, se saltará el archi

Columna	Obligatorio	Tipo de datos / Máxima longitud	Descripción
order_id	Sí	Texto (máx. 50 caracteres)	Identificador externo de un pedido, esta columna asocia los “ordersitems” a “orders” específicos (o “abandonedcarts”); esta columna es obligatoria y debe hacer referencia a un pedido existente, de lo contrario se creará una entrada vacía de “orders”.
product_id	Sí	Texto	ID externo del producto en el pedido o en el carrito. Esta columna es obligatoria. Si el producto aún no existe en la base de datos, Splio creará por defecto un dato (vacío). La actualización de los productos no elimina los artículos de los pedidos asociados.
unit_price	No	Decimal	El precio aplicado a una unidad de producto. Este campo será el que se tenga en cuenta para cualquier regla de Loyalty basada en el precio del producto.
discount_amount	No	Decimal	Importe total del descuento
tax_amount	No	Decimal	El importe total de los impuestos
total_line_amount	No	Decimal	El importe total de esta línea de pedido.
currency	Sí	Texto (máx. 3 caracteres)	Código ISO de tres letras de la moneda en la que se indican todos los precios e importes. Si falta, se utiliza el valor por defecto del universo.
quantity	No	Número entero sin signo	La cantidad del producto. Este campo será el que se tenga en cuenta para cualquier regla de Loyalty basada en la cantidad de producto.
card_code	No	Texto	El código de una tarjeta de Loyalty crea un vínculo entre el artículo y la tarjeta.
c0	No	Texto (máx. 255 caracteres)	Una columna personalizada definida en el universo para los artículos del pedido. Se pueden incluir hasta 32 columnas, denominadas “c0” a “c31”.

📘

Ten en cuenta que todos los nombres de columnas se escriben siempre en minúsculas.

Recuerda que Splio revisa los ficheros de i2mportación en función de las columnas obligatorias. Es fundamental incluir tanto "order_id" como "product_id" para que la importación se realice correctamente.

La columna "card_code" se utiliza para asociar un artículo de pedido a un código de tarjeta de Loyalty. Puedes insertarla en los ficheros "orders" o "ordersitems" para generar eventos de Loyalty. Sin embargo, si deseas aplicar reglas de Loyalty basadas en productos, tienes que importar los códigos de tarjeta con los archivos "ordersitems".

Para los números decimales, también puedes utilizar '.' como separador.

🚧
Importante: Al cargar los precios de los productos, incluye siempre dos decimales después del separador (punto), como en '10.99'.

Ejemplo de un fichero Ordersitems

Examinemos el siguiente ejemplo de un fichero que contiene 3 artículos pertenecientes 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 el identificador único del pedido, el identificador del producto, el precio neto, la cantidad, los impuestos aplicados, el total de cada línea y un campo de categoría personalizado.

Nombrar el fichero

Al guardar el archivo, utiliza un nombre formado por el nombre del universo, la sección («ordersitems»), la subsecuencia y la fecha actual. Por ejemplo:

myuniverse_ordersitems_pets_20180712.csv

Este nombre de archivo pertenece al universo "myuniverse", de la subsecuencia "pets" definida para los pedidos y tiene fecha 12 de julio de 2018. Ten en cuenta que esta fecha que sirve para distinguir los archivos, no tiene por qué coincidir con la de los artículos. Si deseas saber más, consulta la sección “Directrices para la denominación de los archivos” en el documento Visión general.