Este artículo explica cómo preparar ficheros de importación para la categoría “orders”. Los datos de esta categoría corresponden a los pedidos efectuados en las tiendas, que se completan con los datos de “ordersitems”.

Los datos de la categoría “orders” pueden actualizarse con una importación sucesiva. Si se importa un pedido que tiene el mismo ID que un pedido existente, el nuevo sustituirá al existente y se eliminarán todos los artículos de pedido vinculados a él. Splio descartará todos los datos de los artículos de pedido si el pedido asociado aún no se ha creado.

Prerrequisitos

Conocimientos básicos del formato CSV y de la codificación UTF-8.
Un editor de texto compatible con UTF-8.
Un programa de hoja de cálculo.
La subsecuencia debe estar definida en el fichero de configuración en la sección “orders”.

Preparar un fichero de pedidos

Modifica el archivo de importación con tu editor de texto UTF-8 de preferencia. Si es necesario, comprueba el número y la posición de las columnas con una hoja de cálculo de tu elección. Esta es la mejor herramienta para eliminar las columnas que no desea importar.

🚧

Acuérdate de uardar siempre usando codificación UTF-8 sin BOM.

Limita el tamaño del archivo a 200K objetos.

Header y Columnas

La primera línea del fichero se denomina header. Debe contener únicamente los nombres de las columnas de la tabla siguiente.

📘
Ten en cuenta que si Splio encuentra un nombre de columna que no logra reconocer, se saltará el archivo.

Las siguientes columnas están disponibles en la sección “orders”:

Columna	Obligatorio	Tipo de datos / Longitud máxima	Descripción
order_id	Sí	Texto (máx. 50 caracteres)	El identificador externo del pedido importado (el número único de un pedido). Este valor tiene que ser único para cada pedido.
customer_key	Sí	Texto	Columna específica utilizada por Splio para identificar los contactos en la base de datos. Si es una dirección de correo electrónico, debe escribirse en minúsculas.
card_code	No	Texto	Código de tarjeta de Loyalty. El código crea un vínculo entre el pedido y la tarjeta de fidelidad. Para más detalles, consulta la sección “Pedidos de Loyalty”.
store_id	Sí	Texto (máx. 50 caracteres)	ID externo de la tienda donde se realizó el pedido. Este identificador crea una relación entre “pedidos” y “tiendas”. Los valores de esta columna deben referirse a las tiendas que ya se han importado.
order_date	No	Fecha	Fecha en la que se realizó el pedido. Para más detalles sobre el formato, véase «Fechas» más abajo. Para evitar errores, introduce siempre horas, minutos y segundos.
shipping_amount	No	Decimal	Representa el importe que se debe como pago por el envío del pedido.
discount_amount	No	Decimal	Importe total del descuento aplicado al pedido.
tax_amount	No	Decimal	El importe total de los impuestos (IVA, impuesto sobre las ventas) aplicados al pedido.
total_amount	No	Decimal	El importe total pagado por los artículos del pedido (y gastos de envío), menos el descuento.
currency	No	Texto (máx. 3 caracteres)	Código de 3 letras para la divisa del pedido.
salesperson	No	Texto (máx. 120 caracteres)	El comercial que gestiona el pedido.
c0	No		Una columna personalizada definida en tu universo para los pedidos. Puedes añadir hasta 32 columnas denominadas “c0” a “c31”.

📘

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

La columna customer_key identifica los contactos en la base de datos de tu universo Splio.

Te recordamos que Splio revisa los ficheros de importación para comprobar la presencia de columnas obligatorias. Tienes que incluir «order_id», «customer_key», y «store_id» para que la importación se realice correctamente.

Ejemplo 1: Clave de Cliente Predefinida

Las primeras líneas de un archivo de importación de «pedidos» que utiliza la clave de cliente por defecto (correo electrónico del contacto) serían así:

order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bMhtt-1531745300";"[email protected]";"Internet";"2018-06-22 11:30:00;173.00";"EUR"
"70x1byTRJ-1531778200";"[email protected]";"Internet";"2018-06-21 12:10:00";"244.99";"EUR"
"70xb1KLio-1531723300";"[email protected]";"Internet";"2018-06-20 17:33:00;25.50";"EUR"

Cada fila consta exactamente de 6 columnas. El “order_id” sirve para distinguir los pedidos, la “customer_key” vincula el pedido al contacto que lo compró.

Ejemplo 2: Personalizar las columnas come Clave de Cliente

Veamos un fichero de importación que utiliza una columna personalizada como clave de cliente:

order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bKkUt-1531738300";"PPL000000045732";"MGZOO;2018-06-27 12:17:27;225.00";"EUR"
"70x1bKooY-1531738300";"PPL000000007633";"MGZOO;2018-06-27 12:19:23;17.00";"EUR"
"70x1bu9Gt-1531756600";"PPL000000045661";"MGZOO;2018-06-27 12:22:07;112.50";"EUR"

Esta importación es muy parecida a la del ejemplo 1, siendo la mayor diferencia el tipo de valor de la columna “customer_key”. Siempre se debe utilizar el mismo tipo de clave de cliente definida en el universo Splio.

Nombrar el fichero

Para guardar el fichero, utiliza un nombre compuesto por el nombre del universo, la categoría (“orders”), la subsecuencia y la fecha actual. Por ejemplo:

myuniverse_orders_zoo_20210225.csv

Este fichero pertenece al universo “myuniverse”, a la subsecuencia “zoo” definida para los pedidos y tiene fecha 25 de febrero de 2021.

Fechas

Todas las fechas utilizadas en los archivos de importación para las suscripciones deben tener el siguiente formato: 4 dígitos para el año, 2 para el mes y 2 para el día, seguidos de horas, minutos y segundos, cada uno con 2 dígitos. El formato correcto para la fecha 9 de agosto de 2018, 10:00:05 tiene el siguiente formato:

2018-08-09 10:00:05

La fecha y la hora están separadas por un espacio. Si decides utilizar solo la fecha, sin la hora, Splio considerará automáticamente la medianoche como la hora de ese día. Por lo tanto,

2018-09-09 equivale a 2018-09-09 00:00:00

🚧

El uso de fechas sin hora nunca puede ser alternativa para fechas y horas: 00:00:00 corresponde a medianoche y Splio procesará la fecha como tal. Esto podría dar lugar a errores y un mal funcionamiento de los triggers asociados a las fechas. Además, los datos de Loyalty se manejan como una información de carácter económico por lo que tú y tu empresa sois responsables de su exactitud, así como de cualquier otro detalle. Otra ventaja de utilizar fechas completas es que podrá buscar y filtrar por fecha con mayor precisión.

Cuando importas fechas y horas, no olvides utilizar siempre la zona horaria CEST.

Más detalles: NULL y cancelación de datos

NULL es un valor específico que indica a la base de datos que el campo correspondiente está vacío.

Puedes configurar tu universo Splio para que interprete los valores NULL como instrucciones para vaciar los campos.

Puedes configurar tu universo Splio para que interprete los valores NULL como instrucciones para vaciar los campos. Esta función te permite borrar datos almacenados en la base de datos. Asegúrate de que el valor importado es exactamente NULL, sin espacios adicionales al principio o al final, de lo contrario " NULL" o “NULL” serán tratados como valores de cadena.

Si no se habilita esta opción, Splio conservará los valores de los campos en los que el valor importado sea 'NULL'.

Diferencia entre NULL y cadena vacía

“” es una cadena vacía. En la mayoría de los casos, tanto NULL como “” se importarán como valores vacíos.

En particular, la cadena vacía "" nunca se considera como un valor NULL, por lo que no provoca la eliminación de un valor existente.