Este artículo explica cómo preparar un fichero para el ámbito “carritos abandonados”.

Los ficheros del ámbito “carritos abandonados” son muy parecidos a los ficheros “pedidos”, ya que los carritos abandonados representan pedidos de compra que nunca se han completado. Además, como en el caso de los pedidos, si hay artículos en los carritos, tendrás que importarlos como “ordersitems”.

Los datos de carritos abandonados suelen ser recopilados por las tiendas online, puesto que necesitan almacenar las elecciones de los clientes en carritos de compra virtuales y pueden identificar fácilmente los carritos que nunca se han tramitado como pedidos.

Los datos de carritos abandonados pueden actualizarse con importaciones posteriores. Splio rechazará los objetos “orderitems” que estén vinculados a un pedido que aún no exista en la base de datos.

🚧
Ten en cuenta que Splio comienza a procesar las importaciones desde el ámbito "carrito abandonado" borrando primero todos los "orderitems" para cada "order_id" encontrado en el archivo de importación.

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 el ámbito “abandonedcarts”.

Preparar un fichero de carritos abandonados

Edita el archivo de importación con tu editor de texto de preferencia compatible con UTF-8. Si es necesario, utiliza un programa de hojas de cálculo que ya conozcas para controlar el número y la posición de las columnas.

🚧

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

Por favor, limita el tamaño de tu archivo a 200K líneas.

Header y Columnas

La primera línea del fichero, denominada header, se utiliza para determinar el contenido de las líneas siguientes. Por lo tanto, debe construirse únicamente a partir de los nombres de las columnas.

🚧
Si ricorda che se Splio trova un nome di colonna non riconoscibile, salterà il file.

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

Columna	Obligatoria	Tipo de datos / Longitud máxima	Descripción
order_id	Sí	Texto (máx. 50 caracteres)	El identificador externo del carrito abandonado importado. Este valor debe ser único para cada carrito.
customer_key	Sí	Texto	Columna específica utilizada por Splio para identificar los contactos en la base de datos.
card_code	No	Texto	Código de una tarjeta Loyalty, crea un vínculo entre el carrito abandonado y la tarjeta Loyalty.
store_id	Sí	Texto (máx. 50 caracteres)	id externo de la tienda donde el carrito fue creado y abandonado, relaciona “abandonedcarts” y “stores”. Los valores de esta columna deben referirse a tiendas ya importadas.
order_date	No	Fecha	Fecha asociada al carrito abandonado. Consulta “Fechas” a continuación para obtener más detalles sobre el formato. Para evitar errores, introduce siempre horas, minutos y segundos.
shipping_amount	No	Decimal	Representa el importe debido como pago por el envío del pedido.
discount_amount	No	Decimal	El importe total del descuento aplicado al carrito.
tax_amount	No	Decimal	El importe total de los impuestos (IVA, impuesto sobre las ventas) aplicados al carrito.
total_amount	No	Decimal	El importe total pagado por los artículos de la cesta (y el envío), menos el descuento.
currency	No	Texto (máx. 3 caracteres)	Código de 3 letras para la divisa del pedido. Si no se indica ninguna divisa, Splio adoptará la divisa predefinida del universo.
salesperson	No	Texto (máx. 120 caracteres)	El comercial que gestiona del 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 “abandonedcarts” que utiliza la Clave de Cliente predefinida (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 línea consta exactamente de 6 columnas. El “order_id” se utiliza para distinguir entre diferentes carritos, la “customer_key” vincula el pedido con el contacto que creó y abandonó el carrito.

Ejemplo 2: Personalizar las columnas come Clave de Cliente

Compara un archivo de importación que utiliza una columna personalizada como clave de cliente con el Ejemplo 1 aquí arriba:

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"

Ambas importaciones son muy similares, solo el tipo de valores en "customer_key” es diferente. Siempre tienes que utilizar la Clave de Cliente que es requerida por tu universo Splio.

Nombrar el fichero

Para guardar el fichero, utiliza un nombre compuesto por el nombre del universo, la sección (“abandonedcarts”), la subsecuencia y la fecha actual. Por ejemplo:

myuniverse_orders_zoo_20210226.csv

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

Ahora puedes subir el archivo a SFTP/FTPS.

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 15 de marzo de 2021, 01:37 PM tiene el siguiente formato:

2021-03-15 13:37:00

La fecha y la hora están separadas por un espacio. Puedes omitir la hora, y usar solo la fecha. 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.

Al importar fechas con hora, asegúrate de usar siempre la misma zona horaria (es GMT+1 para clientes fuera de China, y GMT+8 para clientes chinos).

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.