Recua · Ayuda← Volver al admin

Importar CSV

Si vienes de un TMS antiguo (AndSoft, Dashdoc, KaleidoTrans...) o de un Excel donde llevabas el control de tu flota, puedes subir un CSV y Recua crea los registros de golpe.

Donde esta el boton

Cada catálogo tiene su propio boton "Importar CSV" junto al boton "Nuevo X":

  • Clientes → boton "Importar CSV" arriba de la tabla, al lado de "Nuevo cliente".
  • Vehiculos → idem al lado de "Nuevo vehículo".
  • Conductores → idem al lado de "Nuevo conductor".

Decidimos meter la importacion dentro de cada catálogo en vez de en una página aparte porque casi siempre la haces mientras estas mirando la ficha concreta — obligar a salirse del contexto era friccion sin valor.

Que se puede importar

  • Conductores: nombre, PIN (opcional, se genera uno de 4 dígitos si no lo especificas). Recua genera el código de acceso automaticamente.
  • Clientes: nombre, dirección, ciudad, teléfono, email.
  • Vehiculos: matricula cabeza, matricula remolque (opcional).

No se puede importar todavia:

  • Portes (es complejo: requiere mapear cargador, destinatario, vehiculo, fechas y estado, y reconstruir el e-CMR).
  • Facturas (las queremos numerar desde tu primer registro en Recua para que la AEAT no se confunda con la numeracion previa).
  • Tarifas y gastos.

Si necesitas migrar portes historicos, hola@recua.app — lo hacemos a mano caso por caso.

Formato del CSV

UTF-8, separador coma (,) o punto y coma (;). Primera fila con los nombres de columna. Recua no distingue mayúsculas de minúsculas (nombre = NOMBRE), pero no normaliza acentos — usa los nombres de columna tal cual aparecen en las plantillas de abajo (sin tildes) para que la columna se reconozca seguro.

Plantilla de conductores

nombre,pin
Juan García,1234
María López,
  • nombre obligatorio.
  • pin: opcional, de 4 a 10 dígitos. Si lo dejas vacío, Recua genera uno.

Al terminar la importacion, el modal te muestra una tabla con los códigos de acceso y PINs generados. Se los entregas a los conductores para que entren en la app Android; también quedan visibles en la tabla de conductores por si los necesitas después.

Cada fila cuenta para el límite de conductores activos de tu plan. Si el CSV trae más conductores de los que caben, las filas que sobran salen en el resumen con el motivo "límite de X conductores del plan alcanzado" — sube de plan desde Mi cuenta → Plan si necesitas dar de alta más.

Plantilla de clientes

nombre,dirección,ciudad,teléfono,email
ACME Logistics SL,Calle Mayor 12,Madrid,915 123 456,facturas@acme.es
Beta Distribuidora SA,Av. Diagonal 123,Barcelona,933 000 000,
  • nombre obligatorio.
  • El resto opcional. El email conviene rellenarlo: con email, el cliente recibe la carta de porte (POD) al facturar y tiene acceso al portal de seguimiento.

Plantilla de vehiculos

matricula_cabeza,matricula_remolque
1234ABC,R-5678
9999XYZ,
  • matricula_cabeza obligatorio.
  • matricula_remolque opcional. Cada vehiculo es una pieza independiente (más detalle): si rellenas ambas columnas, la fila da de alta dos piezas — una cabeza y un remolque generico, sin subtipo asignado — que despues puedes enganchar juntas o por separado en cualquier porte.
  • Las dimensiones del vehiculo (altura, ancho, peso), el subtipo de remolque (frigorifico, cisterna...) y los documentos (ITV, seguro...) NO se importan — se anaden a mano despues, editando cada ficha. Sin dimensiones, Recua usa los defaults legales españoles para el cálculo de ruta truck.

Proceso de importacion

  1. Abres el catálogo correspondiente (Clientes, Vehiculos o Conductores).
  2. Pulsas "Importar CSV" en la esquina superior derecha. Se abre un modal con la guia específica de esa entidad.
  3. Descargas la plantilla vacía con el botón "Plantilla" si la necesitas. La rellenas en Excel/LibreOffice/Numbers.
  4. Eliges el archivo CSV y pulsas "Importar".
  5. Recua valida cada fila:
    • Nombres duplicados, formato inválido o caracteres raros → fila omitida con motivo. Lo ves en el resumen.
  6. Resumen: X filas insertadas, Y filas con error (con la lista de motivos por fila).

Plantillas descargables

Dentro del modal de importacion hay un botón "Plantilla" que te descarga un CSV vacío con la cabecera correcta de esa entidad y dos filas de ejemplo:

  • plantilla-conductores.csv
  • plantilla-clientes.csv
  • plantilla-vehiculos.csv

Rellena la plantilla en Excel/LibreOffice/Numbers, exporta como CSV UTF-8, y subelo.

Lo que se puede romper

  • Codificacion: si el CSV tiene acentos raros (Garc�a en vez de García), conviertelo a UTF-8 antes (en Excel: Archivo → Guardar como → "CSV UTF-8 (delimitado por comas)").
  • Separador: Recua acepta coma , y punto y coma ; indistintamente. La configuración regional española suele usar ; — funciona igual.
  • Comillas dobles: si un campo contiene comas (ej. una dirección "Calle Mayor, 12"), envuelvelo en comillas dobles "Calle Mayor, 12".
  • Tamaño: máximo 5 MB para clientes, 2 MB para vehículos y conductores. Si tienes más, parte el archivo en dos.

Despues de importar

  • Conductores: reparte los códigos+PIN a los conductores (también quedan visibles en la tabla de conductores).
  • Clientes: sube su sello si lo tienes (boton "Sello" en cada fila). Si tienen email, reciben la carta de porte al facturar y acceso al portal de seguimiento.
  • Vehiculos: rellena las dimensiones (altura, ancho, peso) si quieres rutas truck precisas. Sin dimensiones, Recua usa los defaults legales españoles.

Migracion grande (>500 conductores o >5.000 clientes): el limite por archivo es 2 MB para conductores y vehiculos, 5 MB para clientes. Para volumenes muy grandes, hola@recua.app — lo hacemos a mano caso por caso.