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
En la plataforma Coolset, seleccione la categoría que desea subir.
Haga clic en “Importar” en la esquina superior derecha.
Descargue la plantilla CSV proporcionada para esa categoría.

Abrir la plantilla CSV en Microsoft Excel
La plantilla es un .csv archivo.
Para abrirlo con las columnas mostradas correctamente en Excel:
Abra Microsoft Excel.
Vaya a la pestaña Datos.
Haga clic en Obtener datos → Desde Texto/CSV.
Seleccione su archivo de plantilla descargado y cargue los datos.
Su archivo ahora aparecerá en una estructura de columnas clara.

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:
Vaya al elemento al que desea subir.
Haga clic en “Importar” en la esquina superior derecha.
Arrastre y suelte su archivo en el área de carga, o haga clic en el cuadro para explorar su computadora.
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.

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 |