Además de crear clientes y sitios manualmente, puede cargarlos desde un archivo CSV. Esto es útil cuando ya tiene una base de datos con una gran cantidad de clientes. La carga le permitirá ahorrar tiempo en la creación y actualización de clientes existentes.


CSV (Comma-Separated Values – valores separados por comas) es un formato de texto diseñado para representar datos en forma de tabla. Se puede exportar desde la mayoría de los programas modernos de hojas de cálculo.


Abra la página Direcciones.

Para cargar un archivo, haga clic en el botón de carga junto a los botones de añadir clientes y sitios.


Aquí verá la descripción de todas las columnas disponibles.

Descargue un archivo de ejemplo y formatee su archivo CSV de clientes según este modelo.


Si utiliza la primera fila de la tabla como "encabezado", marque la opción "Omitir la fila de encabezado ". También puede seleccionar la codificación del archivo CSV. Las más comunes son UTF-8 y CP-1251. Si tiene otra codificación, cámbiela por una de las disponibles.

Después de seleccionar el archivo, haga clic en el botón "Cargar". Dependiendo de la cantidad de datos, el sistema puede tardar algunos minutos en completar la carga.



En la fila superior se mostrará el resultado de la carga. En este caso, la carga fue exitosa, se crearon dos nuevos clientes y un trabajo.

Los clientes cargados se mostrarán en la página Direcciones → Clientes, y los sitios en Direcciones → Sitios.

Si el archivo tiene un formato incorrecto o errores, en lugar de los resultados de la carga, aparecerá un mensaje de error.


Compare su archivo con el ejemplo, verifique la codificación y intente cargar la tabla nuevamente. 


Preparación del archivo CSV

Para crear el archivo, utilice cualquier programa de hojas de cálculo. En este ejemplo, usaremos Google Sheets.

Descargue el ejemplo de archivo.  Ábralo y copie el "encabezado" en su propia tabla.

external_id;organization;first_name;last_name;middle_name;organization_name;contact_name;cell_phone;work_phone;email;site_address;site_address_country;site_address_apartment;site_address_floor;site_address_entrance_no;site_address_description;template_name;job_external_id

También puede importar/abrir directamente el archivo de ejemplo si su programa lo permite.

La tabla tendrá este formato.



Cada campo tiene su valor:

  • external_id — identificador del cliente en el sistema externo.
  • organization — indicador de entidad legal (t o f). Este campo es obligatorio.
  • first_name — nombre (para personas físicas).
  • last_name — apellido (para personas físicas).
  • middle_name — segundo nombre (para personas físicas).
  • organization_name — nombre (para entidades legales).
  • contact_name — persona de contacto (para entidades legales).
  • cell_phone — teléfono móvil (use el formato E.164 para un funcionamiento adecuado de SMS).
  • work_phone — teléfono de trabajo.
  • email — correo electrónico.
  • site_address — dirección.
  • site_address_country — país (código de dos letras, por ejemplo, Rusia — ru).
  • site_address_apartment — número de apartamento.
  • site_address_floor — piso.
  • site_address_entrance_no — número de entrada.
  • site_address_description — descripción de la dirección.

Rellene las columnas con los datos de sus clientes. Si el cliente es una persona física, ingrese f en la columna organization. No es necesario completar las columnas organization_name para clientes personas físicas.

Si el cliente es una empresa, ingrese t en la columna organization. Para las empresas, las columnas first_name, last_name y middle_name deben dejarse en blanco.


⚠️Si planea actualizar los datos de los clientes en el futuro mediante la carga de un archivo CSV, deberá completar la columna de identificador externo (external_id). Por ejemplo, durante la primera carga, se creará un cliente con el identificador 1. En las cargas posteriores, si el archivo contiene el mismo identificador, en lugar de crear un nuevo cliente, se actualizarán los campos del cliente existente con el identificador 1.


Una vez que haya completado la tabla, descárguela como archivo CSV.


Compare el archivo resultante con el archivo de ejemplo. Si el formato coincide, puede cargar el archivo en Planado. 


⚠️Tenga en cuenta que el delimitador entre los campos debe ser punto y coma (;). Al guardar desde algunos programas, en lugar de punto y coma, puede usarse solo una coma. Un archivo con este formato no podrá cargarse. 


Posibles problemas.

1. Los campos tienen un límite máximo de caracteres. Si al cargar el archivo hay más caracteres de los permitidos, aparecerá un error. 

Si necesita ayuda, deje una solicitud o escríbanos a support@planado.app.