Guía de importación para cargas CSV

Last updated: November 13, 2026

En la plataforma Coolset puedes cargar los siguientes elementos en bloque utilizando una carga csv:

  • Productos,

  • Proveedores,

  • Artículos de pedido (pedidos de compra o venta)

  • Orígenes.

Antes de empezar

Cada categoría tiene sus propias columnas requeridas y tipos de datos.
Es importante usar los nombres exactos de las columnas y llenar con los tipos de datos correctos como se muestra en la plantilla o en la tabla proporcionada a continuación.

Puedes:

  • Crea tu propio archivo CSV siguiendo la estructura requerida, o

  • Descarga una plantilla preformateada directamente desde la plataforma.

Descargar la plantilla

  1. En la plataforma Coolset, seleccione la categoría que desea subir.

  2. Haga clic en “Importar” en la esquina superior derecha.

  3. Descargue la plantilla CSV proporcionada para esa categoría.

Captura de pantalla 2025-10-09 a las 16.37.11.png

Abrir la plantilla CSV en Microsoft Excel

La plantilla es un .csv archivo.
Para abrirlo con las columnas mostradas correctamente en Excel:

  1. Abra Microsoft Excel.

  2. Vaya a la pestaña Datos.

  3. Haga clic en Obtener datos → Desde Texto/CSV.

  4. Seleccione su archivo de plantilla descargado y cargue los datos.

Su archivo ahora aparecerá en una estructura de columnas clara.

Captura de pantalla 2025-10-09 a las 16.39.40.png

Completar la plantilla

Al completar la plantilla (o crear la suya), siga las tablas al final de esta página para obtener orientación:

  • Nombre de columna – Los nombres exactos que se deben usar para las columnas en su archivo.

  • Tipo de datos – El formato de datos esperado en cada columna (p. ej., texto, número).

  • Descripción – Explica qué información proporcionar.

  • Requerido – Indica si la columna debe completarse para una carga exitosa.

Cargar el archivo CSV

Una vez que su archivo CSV esté listo:

  1. Vaya al elemento al que desea subir.

  2. Haga clic en “Importar” en la esquina superior derecha.

  3. Arrastre y suelte su archivo en el área de carga, o haga clic en el cuadro para explorar su computadora.

  4. Una vez que su archivo esté seleccionado, haga clic en “Importar” para iniciar la carga.

Antes de cargar el archivo, comprueba dos cosas:

  • Guarda el archivo como CSV UTF-8. Coolset solo puede leer archivos CSV guardados con codificación UTF-8. Excel suele guardar los archivos CSV en un formato regional, y esta es la razón más común por la que falla una carga. En Excel, ve a Archivo → Guardar como y elige CSV UTF-8 (delimitado por comas) (.csv) como tipo de archivo.

  • Un error detiene toda la carga. Si alguna fila de tu archivo contiene un error, no se importa nada del archivo, incluidas las filas correctas. Corrige la fila que falló y vuelve a cargar el archivo completo.

  • ¿Qué ocurre cuando vuelvo a cargar el mismo archivo? Una reimportación actualiza los registros existentes y añade otros nuevos. Nunca elimina nada. Coolset relaciona cada fila con un registro existente mediante su external_id.

Captura de pantalla 2025-10-09 a las 16.51.46.png

Columnas requeridas y descripciones

Productos

Nombre de la columna

Tipo de datos

Descripción

Obligatorio

external_id

texto

Identificador único del producto de tu sistema externo (p. ej., ERP, CRM). Se utiliza para vincular datos entre sistemas.

TRUE

name

texto

El nombre del producto.

TRUE

description

texto

Información descriptiva adicional sobre el producto.

FALSE

hs_code

Número entero de un máximo de 6 dígitos (sin decimales)

El código del Sistema Armonizado (SA) que identifica el producto para su clasificación aduanera.

TRUE

commodity

texto

La categoría de productos básicos a la que pertenece el producto (p. ej., cattle, cocoa, coffee, palm_oil, rubber, soya y wood).

TRUE

scientific_name

texto

El nombre científico de la especie. Obligatorio únicamente para productos derivados de la madera.

FALSE

common_name

texto

El nombre común (no científico) de la especie. Obligatorio únicamente para productos derivados de la madera.

FALSE

sku

texto

La unidad de mantenimiento de existencias (SKU) del producto.

TRUE

type

texto

Indica si el producto se produce, se compra o se fabrica.

TRUE

bill_of_materials

texto

Lista de external_ids, separados por comas, de los productos que componen la lista de materiales de este producto (si se fabrica).

FALSE

Proveedores

Nombre de la columna

Tipo de datos

Descripción

Obligatorio

external_id

text

ID único de tu ERP o CRM

TRUE

company_name

text

Nombre legal del proveedor

TRUE

description

text

Notas opcionales sobre el proveedor

FALSE

country_code

text (2 caracteres)

Código ISO 3166-1 alfa-2 (p. ej., NL, DE)

TRUE

is_self_managed

TRUE o FALSE

Establece TRUE si realizas la autodeclaración en nombre de este proveedor

FALSE

contact_name

text

Persona de contacto principal; déjalo en blanco si gestionas el proceso por tu cuenta

FALSE

contact_email

text

Correo electrónico de contacto utilizado para las invitaciones; déjalo en blanco si gestionas el proceso por tu cuenta

FALSE

additional_contact_emails

text

Direcciones de correo electrónico adicionales que se invitarán del mismo proveedor, además del contacto principal.

FALSE

type

text

El tipo de socio de la cadena de valor. Escribe siempre "supplier"

TRUE

Elementos del pedido

Nombre de la columna

Tipo de datos

Descripción

Obligatorio

external_id

text

Identificador único del artículo del pedido procedente de tu sistema externo (p. ej., ERP, CRM). Se utiliza para vincular datos entre sistemas.

TRUE

action

text

El tipo de actividad de este pedido. Action puede ser 'buying' o 'selling'.

TRUE

border_cross_country_code

text

Código del país de la UE donde las mercancías entran o salen de la UE, es decir, NL, DE.

TRUE

order_external_id

text

Identificador del pedido asociado. Todos los artículos pertenecientes al mismo pedido comparten este ID.

TRUE

order_created_at

date

La fecha en que se creó el pedido (formato: YYYY-MM-DD).

TRUE

order_arrival_at

date

La fecha en que se espera que llegue el pedido (formato: YYYY-MM-DD).

FALSE

value_chain_external_id

text

ID externo del proveedor (que coincide con el external_id del proveedor importado).

TRUE

buyer_product_external_id

text

ID externo del producto (que coincide con el external_id del producto importado).

TRUE cuando action es buying

seller_product_external_id

text

ID externo del producto (que coincide con el external_id del producto importado).

TRUE cuando action es selling

volume

Un número con decimales

Cantidad de producto incluida en el artículo del pedido.

TRUE

unit

text (máximo 3 caracteres)

Unidad de medida del producto: kg.

TRUE

Orígenes

Nombre de la columna

Tipo de datos

Descripción

Obligatorio

external_id

texto

Identificador único de tu sistema externo (p. ej., ERP, CRM). Se utiliza para vincular datos entre sistemas.

FALSE

name

texto

Nombre legible del área u origen

TRUE

description

texto

Texto opcional que describe el origen

FALSE

country_code

texto (máx. 2 caracteres)

Código alfa-2 de ISO 3166-1 (p. ej., NL, FR, US)

VERDADERO

coordenadas

texto

(formato GeoJSON)

Matriz de coordenadas en el orden [longitud, latitud]; puede representar un punto o el límite de un polígono.

VERDADERO