Manual de uso · Configuración

Paso a paso

Sincronizar el catálogo de productos a BigQuery

Es una herramienta de administración de plataforma, no una pantalla de cliente: copia los productos activos de los proveedores de una empresa hacia una tabla de BigQuery (mercado_publico.supplier_catalogs) para que el resto de la plataforma pueda consultarlos sin recorrer Firestore entero. Vive en Configuración → Catálogo BQ, y sólo la ve una cuenta con el atributo de administrador de plataforma.

Los pasos

Parte 1 · Leer el estado de sincronización

1. Entra en Configuración desde el menú lateral y abre la pestaña Catálogo BQ.

   

   Qué deberías verLas quince pestañas normales de Configuración más las cinco de administración de plataforma en rojo. Al entrar, Catálogo BQ abre directamente el panel «Migración de catálogos de proveedor a BigQuery», con la nota de que ejecuta una empresa a la vez para no chocar con los límites de BigQuery.
   No confundas el candado con «no lo puedo usar» El candado rojo aparece igual para ti, que sí tienes acceso: es el aviso de que la pestaña es de administración de plataforma, no un estado deshabilitado. Lo que de verdad decide si la ves es el atributo admin de tu cuenta, no un rol de la empresa activa.

2. Lee los tres contadores de arriba a la derecha y la fila de tu propia empresa en la tabla.

   

   Qué deberías verTres badges — sincronizadas, parciales y pendientes — que suman el total de empresas de la plataforma, y debajo la tabla con cada una: estado, fecha de la última sincronización, proveedores procesados y el botón de acción. Cada fila sincronizada además muestra cuántos productos se insertaron y cuántos quedaron sin cambios.
   Después de la primera vez, se mantiene soloLa propia pantalla lo dice al pie de la tabla: tras la migración inicial de una empresa, las altas, ediciones y bajas de productos de sus proveedores se replican a BigQuery automáticamente, con un disparador de Firestore (syncSupplierCatalogProductToBigQuery). Esta pantalla no es el camino de todos los días — es la migración inicial y el rescate cuando algo quedó a medias.

3. Filtra la tabla por estado: pulsa Pendientes.

   

   Qué deberías verSólo las empresas que nunca se han sincronizado: guion en Última sync y en Proveedores, y el botón de acción dice Migrar en vez de Re-sync. Todas, Sincronizadas y Parciales funcionan igual, y el número entre paréntesis de cada botón es el total de esa categoría.

Parte 2 · Disparar una sincronización — hasta el aviso

Migrar mueve datos de verdad: lee el catálogo de la empresa desde Firestore y lo escribe en BigQuery. Por eso este manual no confirma ninguna de las tres ventanas siguientes — las abre, las captura y las cancela. Lo que hay debajo de Sí, migrar/Sí, continuar/Sí, sincronizar no se documenta aquí porque no se disparó.

4. En una fila pendiente, pulsa Migrar.

   

   Qué deberías verUna ventana ¿Migrar catálogo de esta empresa? con el nombre y el ID de la empresa, y el aviso de que se sincronizarán todos los proveedores activos de esa empresa a BigQuery. Sí, migrar dispara el callable syncSupplierCatalogToBigQueryOnCall; mientras corre, la fila pasa a Sincronizando… y el resto de los botones de la tabla se bloquean.
   Este manual cancela aquíNo hay una manera de deshacer una migración ya confirmada desde la pantalla — sólo puedes volver a correrla (Re-sync) para que se recalcule. En una empresa de verdad, con proveedores de verdad, eso es tiempo y cuota de BigQuery que no conviene gastar sólo para hacer una captura.

5. Para procesar varias de una vez, pulsa Migrar pendientes / parciales.

   

   Qué deberías verUna ventana ¿Migrar empresas pendientes? que dice cuántas empresas hay en la cola y aclara que las ya sincronizadas se omiten. Confirmar las procesa una por una, en orden — no en paralelo —, así que con trece empresas pendientes es una tanda larga: cada fila muestra su propio spinner cuando le toca el turno.
   No hay pausa ni cancelar a mitad de caminoUna vez confirmada, la tanda corre hasta el final; no hay botón para detenerla ni para saltarte una empresa. Es otra razón para no confirmarla sólo por curiosidad.

6. Baja a Sync puntual y elige un proveedor de tu empresa activa.

   

   Qué deberías verUn selector con los proveedores de tu empresa activa — no de la que estés mirando en la tabla de arriba —, con su nombre y RUT. Es la vía para actualizar un solo proveedor sin recorrer el resto del catálogo de la empresa.

7. Pulsa Sincronizar este proveedor.

   

   Qué deberías verUna ventana ¿Sincronizar un proveedor? que repite la empresa activa y el proveedor elegido, y aclara que sólo actualiza el snapshot de ese proveedor. Es la acción más acotada de las tres — un proveedor, una empresa — y aun así este manual la cancela por la misma razón que las otras dos.

Lo que todavía no hace

• No depende de Mercado Público, al contrario de lo que el resto del módulo hace pensar. Esta pantalla no llama al portal ni al scraper de Compra Ágil: lee productos ya guardados en Firestore y los escribe en BigQuery. El callable (syncSupplierCatalogToBigQueryOnCall) y el disparador automático (syncSupplierCatalogProductToBigQuery) están desplegados en QA (marko-devenv) igual que en producción, y nueve empresas de la plataforma —incluida ALIMENTOS SPA— ya tienen una sincronización real con fecha (mayo de 2026). Este manual no confirmó ninguna migración nueva, pero la pantalla no está caída.
• El detalle de proveedores fallidos no sobrevive a un refresco. El botón ▼ de cada fila sólo muestra motivos de error cuando el resultado vive en la memoria de la sesión que acaba de migrar. Si recargas la página o pulsas Actualizar lista, la fila puede seguir marcada Parcial, pero el detalle desaparece: no hay manera de ver, un día después, por qué fallaron esos proveedores.
• No hay reversa. Ninguna acción de esta pantalla borra lo ya sincronizado en BigQuery ni deshace una migración confirmada. Lo único que existe es volver a correrla (Re-sync), que reemplaza el snapshot con lo que haya en Firestore en ese momento.
• Nada indica cuánto falta. Ni en una migración individual ni en la tanda masiva hay barra de progreso o tiempo estimado: el único aviso es el spinner Sincronizando… en la fila que le toca el turno.
• La lista de errores se corta en 15. Si una empresa tiene más de quince proveedores fallidos, el detalle sólo enumera los primeros quince y agrega «… y N más», sin forma de ver el resto desde la pantalla.

Para consultar después

Cuando algo no sale