Esfera.AI Logo

Esfera.ai Docs

Manual de uso

Análisis de precio unitarioActualizado Feb 2026

Importar mano de obra desde CSV

Importa múltiples registros de mano de obra simultáneamente usando un archivo CSV. Ideal para migrar catálogos completos o actualizar costos masivamente.

Importar mano de obra desde CSV

Proceso de importación

1

Descarga la plantilla CSV

Desde el módulo de mano de obra, haz clic en "Importar CSV" y descarga la plantilla para asegurar el formato correcto.

2

Completa el archivo CSV

Llena el archivo con los datos de tu mano de obra siguiendo la estructura indicada. Puedes usar Excel, Google Sheets o cualquier editor de texto.

3

Carga el archivo

Selecciona tu archivo CSV completado y súbelo a la plataforma. El sistema validará el formato automáticamente.

4

Revisa y confirma

Verifica el resumen de importación, corrige errores si los hay, y confirma para agregar los registros a tu catálogo.

Plantilla CSV

Plantilla de importación CSV para mano de obra

Estructura del archivo CSV

ColumnaDescripciónRequeridoEjemplo
codigoIdentificador únicoSíALB-OF-01
descripcionNombre del tipo de trabajadorSíOficial albañil
especialidadCategoría del trabajadorSíAlbañilería
costo_horaTarifa horaria con cargas socialesSí35.50
unidadUnidad de medidaSíHH
monedaDivisa del costoSíBs
categoriaClasificación (oficial, peón, etc.)NoOficial
notasObservaciones adicionalesNoIncluye cargas sociales

Ejemplo de archivo CSV

codigo,descripcion,especialidad,costo_hora,unidad,moneda,categoria,notas
ALB-OF-01,Oficial albañil,Albañilería,35.50,HH,Bs,Oficial,Incluye cargas sociales
ALB-PE-01,Peón albañil,Albañilería,25.00,HH,Bs,Peón,Ayudante general
ELE-OF-01,Oficial electricista,Electricidad,42.00,HH,Bs,Oficial,Certificado CNE
PL-OF-01,Oficial plomero,Plomería,38.50,HH,Bs,Oficial,Instalaciones sanitarias
SOLD-ESP-01,Soldador especializado,Soldadura,55.00,HH,Bs,Especializado,Certificación SMAW
CAP-01,Capataz general,Supervisión,48.00,HH,Bs,Supervisor,Experiencia +5 años

📋 Requisitos de formato

  • El archivo debe ser CSV (valores separados por comas)
  • La primera fila debe contener los nombres de las columnas exactamente como se muestran
  • Los códigos deben ser únicos (no repetir códigos existentes)
  • Los costos deben ser números decimales (usar punto, no coma)
  • La codificación del archivo debe ser UTF-8
  • No dejar filas vacías entre registros

⚠️ Validaciones del sistema

El sistema validará automáticamente:

  • Que todos los campos requeridos estén completos
  • Que los códigos sean únicos y no existan en el catálogo
  • Que los costos sean números válidos mayores a 0
  • Que la unidad sea válida (HH, HD, días, etc.)
  • Que la moneda coincida con las configuradas en el proyecto

Si hay errores, se mostrará un reporte detallado indicando qué filas tienen problemas.

💡Consejos para una importación exitosa

  • Trabaja primero en Excel/Sheets y exporta como CSV al final
  • Mantén una copia de respaldo antes de importar
  • Importa en lotes pequeños la primera vez para verificar el formato
  • Usa códigos que sigan un estándar consistente (ej: ESP-CAT-NUM)
  • Incluye cargas sociales y beneficios en el costo por hora
  • Documenta cualquier factor de rendimiento en las notas
  • Verifica que la moneda sea la misma para todos los registros
WhatsApp