Plantillas de importación
Resumen
Hay cinco plantillas: contactos, productos, servicios, proyectos y distribuidores. Cada una es el mismo Excel que baja el botón Exportar de su pantalla. Este es el detalle columna por columna; el paso a paso del asistente está en Importaciones.
Reglas comunes
| Regla | Detalle |
|---|---|
| Archivo | CSV, XLS o XLSX, hasta 10 MB. En Excel se lee solo la primera hoja; la primera fila son los nombres de las columnas. |
| Exportación | Hasta 10.000 filas, respetando vista, filtros y búsqueda. |
| Hojas del Excel | La hoja de datos, la hoja Instrucciones y una hoja oculta con los valores de los desplegables. |
| ID | Primera columna, en gris. No la edites ni la borres. Las filas nuevas van sin ID. |
| Acción | Segunda columna: Crear, Actualizar o Eliminar (vacía = lo que elijas en el asistente). Sale vacía al exportar. |
| Celda vacía | «No tocar este dato». Nunca borra. |
| Desplegables | Solo aceptan los valores de la lista. Otro texto se ignora (Excel avisa con Valor fuera de la lista). |
| Columnas en gris | Informativas: editarlas no cambia nada. |
| Números | Se aceptan formatos como 1.234,56, 189.900 o 1,234.56; los símbolos de moneda se ignoran. No se aceptan negativos. |
| Listas dentro de una celda | Separadas por coma (también sirven ;, ` |
Qué hace cada Acción:
| Acción | Si el registro existe | Si no existe |
|---|---|---|
| (vacía) | Se aplica la opción de duplicados del asistente (Omitir, Reemplazar, Crear igual o fila por fila) | Se crea |
| Crear | Se omite | Se crea |
| Actualizar | Se sobrescribe | Se crea |
| Eliminar | Baja lógica (se recupera desde la Papelera) | Se omite |
| Otro valor | Error: Acción no reconocida. Usa el desplegable: Crear, Actualizar o Eliminar. | — |
Tabla de referencia
Contactos (hoja «Contactos»)
Se considera el mismo contacto si coincide el ID, el email o el teléfono (en ese orden).
| # | Columna | Obligatoria | Valores y reglas |
|---|---|---|---|
| 1 | ID | No | Gris. Identificador interno. |
| 2 | Acción | No | Crear · Actualizar · Eliminar |
| 3 | Sí | Tiene que ser válido. | |
| 4 | Nombre | No | Texto. |
| 5 | Apellido | No | Texto. |
| 6 | Teléfono | Sí | No se pide en filas con Eliminar. El indicativo sale del propio número (+CC), de Código de país o del país por defecto del workspace (si no hay, +57). |
| 7 | Código de país | No | Por ejemplo +57. |
| 8 | Empresa | No | Por nombre, sin importar mayúsculas ni tildes. Si no existe se crea solo con permiso para crear empresas y el módulo Empresas encendido; si no, queda como texto con un aviso. BORRAR desvincula. |
| 9 | Empresa NIT/ID fiscal | No | Se busca primero por NIT. Un NIT sin nombre que no coincide deja al contacto sin empresa, con aviso. |
| 10 | Cargo | No | Texto. |
| 11 | Tipo de contacto | No | Persona · Empresa |
| 12 | Industria | No | Valor del desplegable. |
| 13 | Tamaño de empresa | No | Solo yo (1 persona) · 2 – 5 empleados · 6 – 10 empleados · 11 – 25 empleados · 26 – 50 empleados · 51 – 100 empleados · 101 – 200 empleados · 201 – 500 empleados · Más de 500 empleados |
| 14 | Ciudad | No | Texto. |
| 15 | País | No | Texto. Si falta al crear, queda Colombia. |
| 16 | Estado | No | Prospecto · Cliente · Perdido |
| 17 | Origen | No | Manual · Importación de archivo · Formulario web · Integración externa · API · Sincronización CRM · Landing page · Otro |
| 18 | Canal de adquisición | No | Meta Ads · Google Ads · Búsqueda orgánica · Referido · Email marketing · WhatsApp · Llamada · Evento · Sitio web · Social orgánico · Aliado · Otro |
| 19 | Medio | No | CPC · Social · Email · Landing page · Formulario · Mensaje directo · Llamada · Referido directo · QR · Otro |
| 20 | Campaña | No | Texto libre. |
| 21 | Comercial (email) | No | Email de un miembro activo del equipo (desplegable). Si no lo es, el comercial no cambia y queda un aviso. BORRAR deja sin comercial. |
| 22 | Tipo de cliente | No | Texto libre (hasta 80 caracteres). |
| 23 | Calificación | No | Caliente · Tibio · Frío. Lo que escribas cuenta como decisión manual: la clasificación con IA ya no lo cambia. |
| 24 | Etiquetas | No | Separadas por coma, hasta 50. Reemplazan las del contacto. Las que no existen se crean solo con permiso (tag.create); si no, se omiten con aviso. BORRAR quita todas. |
| 25 | Listas | No | Igual que Etiquetas; crear listas pide contacts.createList. BORRAR saca de todas las listas. |
| 26 | Segmentos | — | Gris, solo lectura. Se calcula con las reglas de cada segmento y no se importa. |
| 27 | Notas | No | Texto. |
BORRAR se reconoce sin importar mayúsculas; también valen eliminar,
quitar, ninguna, ninguno y -.
Productos (hoja «Productos»)
Se considera el mismo producto si coincide el ID o el SKU.
| # | Columna | Obligatoria | Valores y reglas |
|---|---|---|---|
| 1 | ID | No | Gris. |
| 2 | Acción | No | Crear · Actualizar · Eliminar |
| 3 | SKU | Sí | Se guarda en mayúsculas. |
| 4 | Nombre | Sí* | |
| 5 | Marca | No | Desplegable con las marcas del workspace. Tiene que existir: si no, la fila falla (Esa marca no existe. Créala primero en el catálogo y vuelve a importar.). |
| 6 | Precio | Sí* | Número mayor o igual a 0. |
| 7 | Descripción | No | |
| 8 | Precio mayorista | No | Número mayor o igual a 0. |
| 9 | Precio e-commerce | No | Número mayor o igual a 0. |
| 10 | Estado de stock | No | Disponible · No disponible · Bajo pedido |
| 11 | Imagen principal (URL) | No | Enlace público http(s); se descarga a la plataforma. JPG, PNG, WebP, GIF o AVIF de hasta 15 MB. BORRAR elimina la imagen. |
| 12 | Galería imágenes (URLs) | No | Hasta 10 enlaces separados por coma. Reemplaza la galería. BORRAR la vacía. |
| 13 | Galería videos (URLs) | No | Hasta 5 enlaces, de hasta 100 MB cada uno, MP4, WebM o MOV. YouTube y Vimeo no sirven. Reemplaza los videos. BORRAR los vacía. |
| 14 | Ficha técnica (URL) | — | Gris, solo lectura. |
| 15 | Código de barras | No | |
| 16 | Modelo | No | |
| 17 | Nombre técnico | No | |
| 18 | País de origen | No | |
| 19 | Sitio web | No | |
| 20 | Ref. e-commerce | No | |
| 21 | Proveedor | No | Texto libre. |
*No se piden en filas con Eliminar.
Las categorías, subcategorías, familias y canales de venta no están en la plantilla: se asignan desde el catálogo.
Los enlaces de Google Drive sirven si el archivo está compartido como «Cualquier persona con el enlace». Las imágenes y videos se procesan después de la importación; si alguno falla, queda un aviso en el reporte.
Servicios (hoja «Servicios»)
Se considera el mismo servicio si coincide el ID o el Nombre (exacto).
| # | Columna | Obligatoria | Valores y reglas |
|---|---|---|---|
| 1 | ID | No | Gris. |
| 2 | Acción | No | Crear · Actualizar · Eliminar |
| 3 | Nombre | Sí | |
| 4 | Descripción | No | |
| 5 | Precio | No | Número mayor o igual a 0. |
| 6 | Duración | No | Texto libre. |
| 7 | Moneda | No | Texto libre. |
| 8 | Garantía | No | |
| 9 | Imagen (URL) | No | Se guarda el enlace tal cual. |
| 10 | Casos de éxito (URLs) | — | Gris, solo lectura. |
Proyectos (hoja «Proyectos»)
Se considera el mismo proyecto si coincide el ID o el Nombre (exacto).
| # | Columna | Obligatoria | Valores y reglas |
|---|---|---|---|
| 1 | ID | No | Gris. |
| 2 | Acción | No | Crear · Actualizar · Eliminar |
| 3 | Nombre | Sí | |
| 4 | Descripción | No | |
| 5 | Precio mínimo | No | Número mayor o igual a 0. |
| 6 | Precio máximo | No | Número mayor o igual a 0; no puede ser menor que el mínimo. |
| 7 | Moneda | No | Texto libre. |
| 8 | Imagen (URL) | No | Se guarda el enlace tal cual. |
| 9 | Galería imágenes (URLs) | — | Gris, solo lectura. |
| 10 | Galería videos (URLs) | — | Gris, solo lectura. |
| 11 | Características | — | Gris, solo lectura. |
Distribuidores (hoja «Distribuidores»)
Se considera el mismo distribuidor si coincide el ID o el Nombre (sin distinguir mayúsculas).
| # | Columna | Obligatoria | Valores y reglas |
|---|---|---|---|
| 1 | ID | No | Gris. |
| 2 | Acción | No | Crear · Actualizar · Eliminar |
| 3 | Nombre | Sí | En el asistente se llama Nombre o razón social. |
| 4 | NIT | No | |
| 5 | Referencia | No | |
| 6 | Correo | No | Se valida si viene. En el asistente se llama Email. |
| 7 | Teléfono | No | +CC número, con un espacio después del indicativo. Sin +, se toma como número de Colombia (+57). |
| 8 | Dirección | No | |
| 9 | Ciudad | No | |
| 10 | Departamento | No | |
| 11 | Sitio web | No |
Notas
- Permisos: exportar pide el permiso de ver (
<módulo>.read); importar, incluidas las filas con Eliminar, pide el de crear (<módulo>.create). - El reporte de la importación guarda como máximo 1.000 errores y 1.000 avisos.
- Una importación grande sigue en segundo plano aunque cierres la ventana.