Imprimir

<< Anterior 16 / 16

Actualizar lista clientes via full / avanzado<h1>Actualización Avanzada de Clientes mediante Archivo CSV</h1>
La Actualización Avanzada de Clientes permite modificar en forma masiva la información de clientes existentes utilizando un archivo CSV.
El sistema identifica cada registro mediante el ID del cliente, por lo que no crea nuevos clientes, sino que únicamente actualiza los datos existentes.
<hr />
<h1>Reglas importantes</h1>
<ul>
<li>
El campo <code>cliente_id</code> es obligatorio.
</li>
<li>
Debe existir en el encabezado del archivo y contener un valor en cada registro.
</li>
<li>
Todos los demás campos son opcionales.
</li>
<li>
Puede eliminar del archivo todas las columnas que no necesite modificar. Esto ayuda a evitar errores involuntarios.
</li>
<li>
El sistema utilizará automáticamente la empresa de la sesión activa.
</li>
</ul>
<blockquote>
Importante: Solo se modificarán los campos presentes en el archivo CSV.
</blockquote>
<hr />
<h1>Formato del archivo</h1>
El archivo debe cumplir las siguientes condiciones:
<ul>
<li>
Formato CSV.
</li>
<li>
Separador de campos: punto y coma ( ; ).
</li>
<li>
La primera fila debe contener los nombres de las columnas.
</li>
<li>
La primera columna debe ser siempre <code>cliente_id</code>.
</li>
</ul>
<h3>Ejemplo mínimo</h3>
<pre><code class="language-csv">cliente_id;cliente_razon_social;cliente_rut
123;Comercial ABC Ltda;76123456-7
456;Transportes del Sur SpA;77234567-8
</code></pre>
<hr />
<h1>Cómo preparar el archivo</h1>
<ol>
<li>
Genere o descargue la plantilla base. (Exportar a Excel Full)
</li>
<li>
Mantenga siempre la columna <code>cliente_id</code>.
</li>
<li>
Elimine todas las columnas que no necesite actualizar.
</li>
<li>
Agregue únicamente los campos que desea modificar.
</li>
<li>
Guarde el archivo en formato CSV separado por punto y coma ( ; ).
</li>
<li>
Cargue el archivo desde la opción Actualización Avanzada de Clientes.
</li>
</ol>
<hr />
<h1>¿Cómo funciona la actualización?</h1>
Durante la importación el sistema realiza automáticamente las siguientes acciones:
<ul>
<li>
Lee los encabezados del archivo CSV.
</li>
<li>
Verifica que la primera columna sea <code>cliente_id</code>.
</li>
<li>
Busca cada cliente utilizando dicho identificador.
</li>
<li>
Genera una actualización (<code>UPDATE</code>) únicamente para las columnas incluidas en el archivo.
</li>
<li>
Solo actualiza columnas existentes en la tabla de clientes. No modifiques los encabezados.
</li>
<li>
Registra el estado anterior y posterior de cada modificación para fines de auditoría e historial.
</li>
</ul>
<hr />
<h1>Advertencias importantes</h1>
⚠️ Si una columna está presente en el archivo y su valor viene vacío, el sistema reemplazará el valor existente por un valor vacío en la base de datos.
Por este motivo se recomienda incluir únicamente las columnas que realmente desea modificar.
Asimismo:
<ul>
<li>
No es necesario incluir todas las columnas de la ficha del cliente.
</li>
<li>
El orden de las columnas (excepto <code>cliente_id</code>) no es relevante, siempre que los encabezados sean correctos.
</li>
<li>
El archivo solo actualizará clientes pertenecientes a la empresa activa.
</li>
</ul>
<hr />
<h1>Ejemplo práctico</h1>
Archivo CSV:
<pre><code class="language-csv">cliente_id;cliente_email;cliente_tel
1001;ventas@empresa.cl;222345678
1002;contacto@cliente.cl;987654321
</code></pre>
Resultado:
<ul>
<li>
El cliente 1001 actualizará su correo electrónico y teléfono.
</li>
<li>
El cliente 1002 actualizará su correo electrónico y teléfono.
</li>
<li>
Ningún otro dato de la ficha del cliente será modificado.
</li>
</ul>
<hr />
<h1>Resumen</h1>
✅ <code>cliente_id</code> es obligatorio.
✅ Solo deben incluirse las columnas que desea modificar.
✅ Los valores vacíos sobrescriben la información existente.
✅ El orden de las columnas no afecta la importación mientras los encabezados sean correctos.

Actualizar lista clientes via full / avanzado

https://www.obuma.pe/ayuda/articulo/800

Actualización Avanzada de Clientes mediante Archivo CSV

La Actualización Avanzada de Clientes permite modificar en forma masiva la información de clientes existentes utilizando un archivo CSV.

El sistema identifica cada registro mediante el ID del cliente, por lo que no crea nuevos clientes, sino que únicamente actualiza los datos existentes.

Reglas importantes

El campo cliente_id es obligatorio.
Debe existir en el encabezado del archivo y contener un valor en cada registro.
Todos los demás campos son opcionales.
Puede eliminar del archivo todas las columnas que no necesite modificar. Esto ayuda a evitar errores involuntarios.
El sistema utilizará automáticamente la empresa de la sesión activa.

Importante: Solo se modificarán los campos presentes en el archivo CSV.

Formato del archivo

El archivo debe cumplir las siguientes condiciones:

Formato CSV.
Separador de campos: punto y coma ( ; ).
La primera fila debe contener los nombres de las columnas.
La primera columna debe ser siempre cliente_id.

Ejemplo mínimo

cliente_id;cliente_razon_social;cliente_rut
123;Comercial ABC Ltda;76123456-7
456;Transportes del Sur SpA;77234567-8

Cómo preparar el archivo

Genere o descargue la plantilla base. (Exportar a Excel Full)
Mantenga siempre la columna cliente_id.
Elimine todas las columnas que no necesite actualizar.
Agregue únicamente los campos que desea modificar.
Guarde el archivo en formato CSV separado por punto y coma ( ; ).
Cargue el archivo desde la opción Actualización Avanzada de Clientes.

¿Cómo funciona la actualización?

Durante la importación el sistema realiza automáticamente las siguientes acciones:

Lee los encabezados del archivo CSV.
Verifica que la primera columna sea cliente_id.
Busca cada cliente utilizando dicho identificador.
Genera una actualización (UPDATE) únicamente para las columnas incluidas en el archivo.
Solo actualiza columnas existentes en la tabla de clientes. No modifiques los encabezados.
Registra el estado anterior y posterior de cada modificación para fines de auditoría e historial.

Advertencias importantes

⚠️ Si una columna está presente en el archivo y su valor viene vacío, el sistema reemplazará el valor existente por un valor vacío en la base de datos.

Por este motivo se recomienda incluir únicamente las columnas que realmente desea modificar.

Asimismo:

No es necesario incluir todas las columnas de la ficha del cliente.
El orden de las columnas (excepto cliente_id) no es relevante, siempre que los encabezados sean correctos.
El archivo solo actualizará clientes pertenecientes a la empresa activa.

Ejemplo práctico

Archivo CSV:

cliente_id;cliente_email;cliente_tel
1001;ventas@empresa.cl;222345678
1002;contacto@cliente.cl;987654321

Resultado:

El cliente 1001 actualizará su correo electrónico y teléfono.
El cliente 1002 actualizará su correo electrónico y teléfono.
Ningún otro dato de la ficha del cliente será modificado.

Resumen

✅ cliente_id es obligatorio.

✅ Solo deben incluirse las columnas que desea modificar.

✅ Los valores vacíos sobrescriben la información existente.

✅ El orden de las columnas no afecta la importación mientras los encabezados sean correctos.