Esfera.AI Logo

Esfera.ai Docs

Manual de uso

Análisis de precio unitarioActualizado Feb 2026

Importar equipos, maquinarias y herramientas desde CSV

Importa múltiples equipos, maquinarias y herramientas simultáneamente usando un archivo CSV. Ideal para migrar catálogos completos o actualizar costos de tu parque de equipos.

Importar equipos desde CSV

Proceso de importación

1

Descarga la plantilla CSV

Desde el módulo de equipos, 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 tus equipos 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 equipos a tu catálogo.

Plantilla CSV

Plantilla de importación CSV para equipos

Estructura del archivo CSV

ColumnaDescripciónRequeridoEjemplo
codigoIdentificador únicoSíMAQ-EXC-320
descripcionNombre completo del equipoSíExcavadora hidráulica 320 HP
tipoCategoría del recursoSíMaquinaria pesada
marcaFabricante del equipoNoCaterpillar
modeloModelo específicoNo320D
costo_horaCosto total por hora de usoSí450.00
unidadUnidad de medidaSíHM
monedaDivisa del costoSíUSD
capacidadCapacidad de trabajoNo2.5 m³
potenciaPotencia del motorNo320 HP
disponibilidadPropiedad del equipoNoPropio
notasObservaciones adicionalesNoIncluye operador certificado

Ejemplo de archivo CSV

codigo,descripcion,tipo,marca,modelo,costo_hora,unidad,moneda,capacidad,potencia,disponibilidad,notas
MAQ-EXC-320,Excavadora hidráulica 320 HP,Maquinaria pesada,Caterpillar,320D,450.00,HM,USD,2.5 m³,320 HP,Propio,Incluye operador certificado
MAQ-MOT-140,Motoniveladora 140 HP,Maquinaria pesada,John Deere,672G,380.00,HM,USD,3.7 m,140 HP,Propio,Mantenimiento al día
EQ-MEZC-01,Mezcladora de concreto 1 saco,Equipo,Carmix,3.5TT,25.00,HM,Bs,350 L,9 HP,Propio,Portátil
EQ-VIBR-01,Vibrador de concreto 2.5 HP,Equipo,Wacker,M2500,8.50,HM,Bs,35mm,2.5 HP,Propio,Cabezal 35mm
HTA-AND-01,Andamio metálico tubular,Herramienta,Nacional,,2.50,HM,Bs,5m altura,,Alquilado,Por módulo
HTA-COMP-01,Compresor de aire 185 CFM,Herramienta,Atlas Copco,XAS185,45.00,HM,USD,185 CFM,115 HP,Alquilado,Incluye mangueras

📋 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
  • Los tipos válidos son: Maquinaria pesada, Equipo, Herramienta

⚠️ 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 (HM, HD, días, etc.)
  • Que la moneda coincida con las configuradas en el proyecto
  • Que el tipo de equipo sea uno de los valores permitidos

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

Componentes del costo por hora

Recuerda que el costo_hora debe incluir todos los componentes:

DEPRECIACIÓN
(Valor compra - Valor residual) / Vida útil horas
MANTENIMIENTO
Preventivo + Correctivo + Repuestos
COMBUSTIBLE
Consumo horario × Precio combustible
OPERADOR
Costo operador si aplica (maquinaria pesada)

💡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
  • Calcula el costo horario completo antes de importar
  • Usa códigos que identifiquen tipo y capacidad (MAQ-EXC-320)
  • Incluye especificaciones técnicas en la descripción si son relevantes
  • Distingue entre equipos propios (con depreciación) y alquilados (tarifa directa)
  • Documenta disponibilidad para gestión de recursos en proyectos
  • Verifica que la moneda sea consistente según tipo de equipo
WhatsApp