| Tabla de Contenido |
|
|
Instrucciones para cargar y actualizar configuraciones de múltiples Branches de forma simultánea mediante un archivo CSV.
1. ¿Para qué sirve la actualización masiva?
La actualización masiva de Branches permite modificar:
- Nombre comercial
- Dirección de los locales
- Cantidad de códigos de activación de varios Branches al mismo tiempo, sin necesidad de entrar a editar cada uno individualmente.
Este proceso es especialmente útil cuando:
- Ya existen comercios creados en la consola y es necesario agregarles la configuración de terminales Kushki One.
- Es necesario actualizar la dirección o nombre de decenas de locales a la vez.
2. Identificar los Branches de Kushki One
Los Branches que tienen configuración de terminales Kushki One aparecen en el listado con una etiqueta especial llamada CP - Kushki One. Se puede filtrar por esta etiqueta y reconocer los branches que son Kushki One, aparecerán así:
Animación: Cómo identificar y filtrar Branches con etiqueta CP - Kushki One
3. Seleccionar los Branches a actualizar
- En el listado de Branches, se seleccionan dos o más Branches con la etiqueta CP - Kushki One usando las casillas de selección.
- Al seleccionar dos o más, aparece el botón Gestión masiva de terminales en la parte superior del listado.
- Se hace clic en ese botón. Se abre un modal que carga la pantalla de actualización masiva.
Animación: Selección de Branches y apertura del modal de gestión masiva
4. Descargar y completar la plantilla CSV
4.1 Descargar la plantilla
Al abrir el modal de actualización masiva, la pantalla genera automáticamente un archivo CSV con los datos de los Branches seleccionados. Se descarga este archivo haciendo clic en el botón de descarga.
4.2 Estructura del archivo
El archivo CSV viene precargado con los siguientes datos de los Branches seleccionados:
| Columna | ¿Precargada? | Descripción |
|---|---|---|
| ID del Branch / Merchant ID | Sí | Identificador único del Branch. No debe modificarse. |
| Nombre del comercio | Sí (hasta el nombre) | Nombre comercial o nombre fantasía que aparece en los vouchers. Debe completarse o verificarse. |
| Dirección | No | Dirección física del local donde operarán las terminales. Debe completarse. |
| Cantidad de códigos de activación | No | Número de terminales que operará ese Branch. Debe completarse. |
Ejemplo de estructura del archivo CSV para la actualización masiva de Branches
4.3 Consideraciones para completar el archivo
- No modifiques el ID del Branch ni el orden de las columnas.
- Completa la dirección con la dirección física exacta del local (no la dirección fiscal del comercio, sino la ubicación donde está la terminal).
- La cantidad de códigos de activación debe ser un número entero igual al número de terminales que se instalarán en ese local.
- Si un Branch ya tiene códigos activos, el sistema solo generará los códigos faltantes para cubrir el total indicado.
- Guarda el archivo en formato CSV UTF-8 para evitar problemas con caracteres especiales (tildes, ñ, etc.).
5. Subir y validar el archivo
- En el modal de actualización masiva, se usa el botón de carga para seleccionar el archivo CSV completado.
- El sistema valida automáticamente el archivo antes de procesarlo.
- Si la validación es exitosa, se mostrará un mensaje indicando que todos los registros están correctamente creados y el número de Branches que serán actualizados.
- Si hay errores, el sistema los lista indicando la fila y el campo que tiene el problema. Corrígelos en el CSV y vuelve a subirlo.
6. Enviar y confirmar
- Una vez validado el archivo, se hace clic en el botón Enviar códigos (o Procesar, según la versión de la consola).
- El sistema procesa el archivo en segundo plano: actualiza los datos de cada Branch y genera los códigos de activación para las terminales.
- Aparece un mensaje en pantalla confirmando que el archivo se ha enviado y que recibirás una notificación por correo cuando el proceso esté listo.
Pantalla de confirmación tras enviar el archivo CSV
Preguntas frecuentes (FAQ)
¿Puedo actualizar Branches de diferentes Customers en el mismo archivo?
Sí. Al seleccionar Branches de distintos Customers en el listado general, el archivo CSV incluirá todos ellos y es posible actualizarlos en un solo proceso.
¿Puedo actualizar la dirección o el nombre comercial de un Branch sin generar nuevos códigos?
Sí. Si el campo de cantidad de códigos ya tiene el valor correcto o no se necesitan más terminales, se puede dejar ese campo con el mismo número que ya tiene. El sistema actualizará los datos del Branch pero no generará códigos adicionales.