En Pro Nacional y Enterprise podemos escribir cada semana publicada en archivos en un almacenamiento de tu empresa: un bucket de Amazon S3 o de Google Cloud Storage, un contenedor de Azure Blob Storage o una carpeta de un servidor SFTP. Tu almacén de datos, tu lakehouse o tu plataforma de datos de clientes los carga desde ahí con su propio calendario; si prefieres no montar esa carga, las tablas también podemos cargarlas nosotros (cargas en tu almacén de datos). En Enterprise, los webhooks llevan los cambios mensaje a mensaje (webhooks para una plataforma de datos).
Quién lo configura
Los administradores de la cuenta, en la página de cada conector en Conectores, con el segundo factor confirmado en los últimos 15 minutos. Una cuenta puede tener hasta 10 conexiones de cada tipo, y no se admiten dos en el mismo bucket y prefijo, contenedor y prefijo, o servidor y carpeta. El secreto de cada una se guarda cifrado, solo se usa para escribir y no se vuelve a mostrar.
Se configura en cuatro pasos (Configurar una conexión de almacenamiento). Conecta guarda el lugar y el secreto, en pausa y con todos los datos que ofrece tu plan. Da acceso enumera lo que tienes que preparar, y Comprobar hace la prueba hasta el punto que elijas. Elige los datos acota lo que recibe la conexión. En Prueba y activa, Probar la conexión escribe con el secreto y las reglas de los envíos semanales un archivo de texto pequeño en mercamap/_test/, que se queda ahí porque nunca borramos nada; si lo consigue, aparece Activar. Hasta que la actives, el recuadro dice «A medio configurar» y no se escribe nada. Una cuenta admite 60 comprobaciones y pruebas por hora entre todas sus conexiones, y menos en un mismo lugar.
Qué escribimos
| Datos que recibe | Carpeta | Cada fila es |
|---|---|---|
| Instantánea del lineal | shelf_snapshot |
una de tus referencias en una semana de tienda que el recorrido miró, vista o no |
| Huecos de distribución | gaps |
un hueco abierto en la semana, o uno que se cerró en ella, y cómo |
| Incidencias de lineal | issues |
una incidencia que se abrió o se resolvió en la semana |
| Cambios de precio | price_changes |
un precio tuyo que cambió un 5 % o más, y al menos 5 céntimos, frente al anterior observado en la tienda |
| Resultados de promociones | promotion_results |
el resultado de una promoción seguida en una semana de tienda |
| Promociones en riesgo (previsiones) | promotion_risks |
la previsión de una tienda antes de una promoción seguida |
Cada fila lleva la semana y las columnas de tienda y de referencia de los eventos de datos: nuestros identificadores; la tienda, con su cadena, dirección, código postal, localidad, código INE de la provincia, coordenadas, tu código, el número que le da la cadena y su GLN; y la referencia, con su variante, marca, tamaño, categoría, tu código y su EAN. Las previsiones y lo que no trata de una referencia, como una incidencia de una categoría, dejan vacías las columnas de referencia.
Los datos se ofrecen tal como los muestran tu plan y tus módulos: los huecos mientras estén abiertos para la cuenta, las incidencias con el módulo de campo, los resultados de promociones con su seguimiento y las promociones en riesgo con las previsiones. Las filas solo nombran semanas, nunca el momento de un recorrido, una persona, una foto, una nota ni un producto de la competencia: del lugar de una promoción nombran las marcas que lo compartían.
La estructura
Todo va en mercamap/, dentro de tu carpeta o de tu prefijo, si indicas uno:
PREFIX/mercamap/price_changes/week=2026-W44/part-0000.csv.gz
PREFIX/mercamap/price_changes/week=2026-W44/manifest.json
PREFIX/mercamap/price_changes/week=2026-W44/_SUCCESS
PREFIX/mercamap/flat/mercamap_price_changes_2026-W44-0000.csv.gz
Cada semana de cada conjunto de datos tiene su propia carpeta. Sus partes son CSV en UTF-8 con una línea de cabecera, comas, comillas ", finales de línea de un solo LF y sin marca de orden de bytes, comprimidas con gzip; hasta 100.000 filas por parte, y ningún archivo pasa de 64 MB. Una semana sin filas tiene igualmente su primera parte, solo con la cabecera. Una celda vacía no tiene valor; un sí o un no es true o false; un precio va en céntimos; un texto que empieza por =, +, - o @ lleva delante un apóstrofo. manifest.json enumera las partes con sus filas, sus bytes y su SHA-256, las columnas y la versión del esquema; _SUCCESS, vacío, se escribe el último. Carga una semana solo cuando su _SUCCESS ya esté.
mercamap/flat/ guarda otra vez cada parte, con los mismos bytes, una junto a otra y sin manifiesto ni marca entre ellas, para las herramientas que leen una sola carpeta o distinguen los datos de un archivo por el principio de su nombre. Cada copia se escribe justo después de su parte, así que esta carpeta puede tener una semana a medias mientras dura un envío. Las columnas de cada versión del esquema no cambian nunca; una columna nueva llega con una versión nueva, que el manifiesto indica.
Cuándo
La mañana siguiente a la publicación de una semana, cada conexión activa recibe un envío de esa semana, y el portal lo escribe poco después. Una conexión que se activa más tarde recibe la última semana publicada a la mañana siguiente, no las anteriores. Un envío con resultados de promociones espera, como mucho 12 horas, a que se evalúe la semana. Un envío que se corta sigue donde se quedó y solo escribe lo que falta.
Cuando falla la escritura
La página dice por qué, con nuestras palabras. Un envío fallido se vuelve a intentar hasta 6 veces, primero a los 5 minutos y después cada vez más espaciado, hasta 1 día entre intentos; si el último también falla, queda como «Fallido» y esa semana no se vuelve a escribir. Tras 3 intentos fallidos seguidos, los administradores reciben un correo; tras 10, otro, y la conexión se desactiva sola hasta que un administrador corrija la causa, la pruebe y la vuelva a activar. Un fallo nuestro se reintenta igual, pero no cuenta. Pausar la detiene sin perder sus ajustes, y Activar la reanuda; de las semanas publicadas entretanto solo recibe la última. Su registro (semana, estado, archivos, filas y tamaño) se guarda 90 días; los archivos siguen en tu almacenamiento mientras los conserves.
Adónde pueden ir los archivos
Son datos de tu cuenta bajo la licencia de datos: a tus propios sistemas y a los de los encargados que actúan por ti, nunca a una cadena, a su red de publicidad en tienda ni a un vendedor de datos. Un servidor SFTP en uno de sus dominios se rechaza. Borrar una conexión borra su secreto y sus envíos; lo que escribió sigue siendo tuyo. Los campos del directorio de tiendas van sin sus líneas de atribución: si los reproduces en un documento, añádelas (atribuciones).
Nuestro equipo puede desactivar una conexión que incumpla las condiciones o esté en un dominio rechazado, y con ella las demás de tu cuenta en el mismo lugar: aparece como Desactivado por el equipo de MercaMap, con el motivo, y solo se puede borrar; los administradores reciben un correo. Ese lugar sigue retenido aunque la borres, hasta que levantemos la desactivación: escríbenos desde Soporte.