GUÍA DE CONEXIÓN

Conecta tus ubicaciones con Google Sheets

Una pestaña por marca. Mantén tus datos en Sheets y crea o actualiza las sucursales desde Kromaps.

Qué permisos necesitas

Debes ser propietario de la hoja o tener permiso para publicarla. Leemos una pestaña publicada como CSV: no solicitamos acceso a tu cuenta de Google, no editamos la hoja y no abrimos archivos privados.

La pestaña publicada será accesible en Internet. Publica sólo información de sucursales destinada al público. Usa una hoja separada si el archivo contiene datos internos o personales.

Configuración paso a paso

Prepara tu pestaña.
Descargar plantilla CSV Usa Archivo → Importar → Subir en Sheets. Conserva los encabezados y reemplaza la fila de ejemplo.
Asigna un identificador estable.
Cada fila necesita un external_id único, como sucursal-001. No lo cambies al actualizar una dirección: identifica la sucursal existente.
Publica la pestaña como CSV.
Ve a Archivo → Compartir → Publicar en la Web. Selecciona sólo la pestaña de ubicaciones y Valores separados por comas (.csv). Pulsa Publicar y copia el enlace generado. Compartir como “lector” no sustituye este paso.
Comprueba el enlace.
Ábrelo en una ventana privada: debe descargar un CSV sin iniciar sesión. El administrador de Google Workspace puede haber deshabilitado la publicación.
Conecta la marca correcta.
En Kromaps, elige la marca y entra en Ubicaciones. Pega el enlace en Tu red desde Google Sheets y pulsa Guardar y sincronizar ahora. Verás cuántas filas se procesaron o cuál debes corregir.

Columnas y formato

Columnas	Qué poner
`external_id`	Obligatorio, único y estable por sucursal y marca.
`name, address, city, category`	Obligatorios: nombre, calle y número, ciudad y tipo de sucursal.
`lat, lng`	Obligatorios: coordenadas exactas con punto decimal, por ejemplo 32.5241 y -117.0131. Sheets no busca coordenadas automáticamente.
`state, country, postal_code`	Estado, país ISO de dos letras (MX, US…) y código postal. Usa formato de texto para conservar ceros iniciales.
`phone, whatsapp, hours`	Contacto y horarios. WhatsApp con código de país y sólo dígitos. Guarda teléfonos como texto.
`tags`	Valores separados por `\|`, por ejemplo `Refacciones\|Servicio`.
`active`	`true` para mostrar, `false` para ocultar.
`logo_url`	Opcional: URL HTTPS de una imagen pública.

Qué ocurre al sincronizar

Crea sucursales nuevas y actualiza las que tienen el mismo external_id.
Quitar una fila no elimina la sucursal: conserva la fila con active=false para ocultarla.
Una fila inválida detiene el lote completo; corrígela y vuelve a sincronizar.
Máximo 500 filas y 1 MB por CSV. Esta conexión no sincroniza inventario.
Google puede tardar unos minutos en actualizar el CSV. Activa “Volver a publicar automáticamente cuando se hacen cambios”.

Sincronización automática

Necesita un despliegue de producción con el proceso programado habilitado. Se ejecuta cada hora y procesa hasta diez marcas; una red mayor puede tardar varias horas. El dominio temporal de pruebas utiliza el botón manual.

¿Y una hoja privada?

Esta versión requiere publicación CSV. Una conexión privada necesitará autorización de Google; todavía no está disponible.

Instrucciones oficiales de Google

Alertas y recuperación de la conexión

Vista general y el panel de Sheets muestran la última actualización correcta y el último intento. Si falla, puedes reintentar la conexión guardada, revisar el CSV o pausar próximos intentos automáticos.

Un intento de más de 20 minutos sin resultado posterior se muestra por revisar; no asegura que el proceso siga ejecutándose. En producción, más de 24 horas sin una sincronización correcta genera un aviso. En la versión de pruebas, la automatización queda pendiente de producción.

Reintentar usa la conexión ya guardada. Editar el enlace y pulsar Guardar y sincronizar ahora cambia la fuente. Los procesos de una misma marca se serializan; si cambias la fuente mientras se lee, el lote anterior no se aplica. Pausar no interrumpe un proceso ya iniciado.

Los avisos se muestran dentro del workspace. El envío de correos requiere configurar el remitente; no está activado.