Fuentes de datos
Historial de sincronización
El historial te muestra qué hizo de verdad una fuente de datos cada vez que corrió, cuántas filas leyó, cuántas encontró y cuántas cambió.
El historial de sincronización te dice qué hizo de verdad una de tus fuentes de datos, corrida por corrida. Cada vez que una fuente va y trae el archivo de tu proveedor, te deja una línea aquí. Esa línea trae los números de esa corrida: cuántas filas tenía tu archivo, cuántas de ellas encontraron un registro en tu catálogo y cuántas de esas aterrizaron.
Lo abres por una de tres razones. Una corrida dice que funcionó y no ves ninguna diferencia en tu catálogo. Los números de un proveedor dejaron de llegarte sin avisar. O uno de tus productos no está tomando su precio y necesitas el motivo de esa fila en concreto.
Lo encuentras en tu lista de fuentes de datos. Ve a Importar/Exportar, entra a la pestaña Fuentes de datos y pulsa Historial entre los botones que están al final de la fila de una fuente. Se abre un diálogo sobre la página con una tabla de las corridas de esa fuente, la más reciente arriba, hasta llegar a la primera de todas.
Hay una idea que ordena todo lo que ves ahí adentro: una sola corrida te deja dos líneas, no una. Descarga es el viaje al archivo de tu proveedor. Mapeo es la escritura en tu catálogo. Pueden fallar por separado, así que se cuentan por separado, y una lista desplegable arriba del diálogo es como pasas de una a la otra.
Antes de empezar
Qué te permite hacer tu rol
El historial de sincronización está dentro de la pestaña Fuentes de datos, y esa pestaña es de rol Gerente para arriba. Con rol Administrador o Gerente puedes abrir el historial de cualquier fuente, descargar el archivo que leyó una corrida y descargar su reporte fila por fila.
Quien tiene rol Editor no ve la pestaña, así que aquí no hay nada que pueda abrir. Los roles se asignan en equipo, roles y permisos.
El detalle de una corrida no dura para siempre
El reporte fila a fila y la copia guardada del archivo de tu proveedor duran 30 días. La línea de la corrida y sus contadores se quedan. Después, los dos botones se niegan en vez de darte algo vacío.
Así que un reporte que quizá necesites después es uno que descargas mientras sigue ahí. Una vez que lo descargaste te sigue funcionando, cosa que explica la sección dedicada a él.
Cómo leer una corrida
Abre el historial de sincronización
Desde
Importar/Exportar, entra a la pestañaFuentes de datosy busca tu fuente en la tabla. PulsaHistorialentre los botones que están al final de su fila.Elige la fase que te interesa
La lista desplegable que está junto al título del diálogo dice
DescargaoMapeo. Déjala enDescargapara ver qué llegó de tu proveedor. Cámbiala aMapeopara ver qué alcanzó tu catálogo.Encuentra la corrida
Tus corridas salen de la más reciente a la más vieja, y la columna
Iniciadodice hace cuánto empezó cada una. Pulsa el encabezado de una columna para ordenar por esa columna.Lee el estado y los contadores
La columna
Estadodice cómo terminó esa fase. Todas las columnas que siguen cuentan filas. Pasa el cursor por el encabezado de una columna y una línea corta te dice qué cuenta.Abre el detalle
En una línea de
Mapeo, pulsaResultadosentre los botones del final de la fila para armar un reporte con una fila por registro. En una línea deDescarga, pulsaDescargar archivopara obtener el archivo que mandó tu proveedor.
Esa es toda la pantalla. Un estado Completada, con números en las columnas que esperabas, es una corrida que salió bien y ya puedes cerrar el diálogo.
Todo lo que sigue explica las dos fases, cada contador de cada una y las dos descargas. No necesitas nada de eso para ver si tu corrida funcionó.
Cada opción en detalle
Las dos líneas que deja cada corrida
Recibes una línea por fase porque las dos fases pueden fallar por separado. Descarga sale a buscar a tu proveedor, lee el archivo y guarda sus filas. Mapeo toma esas filas guardadas, encuentra el registro de tu catálogo del que habla cada una y escribe tus valores dentro.
El orden entre las dos es fijo, y por eso a veces recibes una sola línea. Solo llegas a tener una línea de mapeo porque una de descarga le puso filas enfrente.
Esa última fila es la forma de un flujo tranquilo y sano, y hay que reconocerla antes de salir a buscar un problema. No cambió nada, así que no se te contó nada.
Cómo pasar de una fase a la otra
La lista desplegable está junto al título del diálogo, arriba de todo. Descarga y Mapeo son sus dos opciones, y cada una te da su propia tabla con sus propias columnas.
Cada lado guarda además tu orden, tus filtros y tu página por separado. Un filtro que pones en Descarga no te sigue a Mapeo, así que cambiar de lado nunca te esconde filas sin querer.
La fase es parte de la dirección de la página que está detrás del diálogo. Copia esa dirección mientras miras Mapeo y a quien se la mandes se le abre también en Mapeo.
Las tres columnas que comparten los dos lados
En la fase que tengas puesta en la lista desplegable, tu tabla abre con las mismas tres columnas.
Todas las demás columnas de cualquiera de los dos lados cuentan filas, y los dos lados cuentan cosas distintas.
En todas esas columnas de conteo ves un guion en vez de un cero. Así que una celda con número siempre es algo que de verdad les pasó a tus filas. Una línea llena de guiones es una corrida tranquila, no una rota.
Qué cuentan los contadores de descarga
Del lado Descarga de la lista desplegable, estas cinco columnas cuentan filas del archivo de tu proveedor. De este lado todavía nada miró tu catálogo.
Eliminados lo recibes una sola vez, en la corrida donde esas filas dejaron de llegar, y después vuelve a nada. Una fuente que perdió 400 de tus filas la semana pasada hoy no te muestra nada. Qué les pasa a los productos mismos está en fuentes de datos.
De este lado no hay columna Errores. Una descarga funcionó o no funcionó. Cuando no, recibes el motivo como una frase en la insignia de Estado en lugar de un número en una columna. Los errores de filas sueltas se te cuentan del otro lado.
Qué cuentan los contadores de mapeo
Del lado Mapeo, dos de las columnas son totales acumulados y todo lo demás habla solo de esta corrida. Es lo que más se malinterpreta en toda la pantalla, así que léelo dos veces. Coincidentes y Sin coincidencia te dicen cuánto de tu flujo tiene hoy un registro en tu catálogo, contado entre todas las corridas que ha habido. Ninguna de las dos describe el trabajo de esta corrida.
Coincidentes y Sin coincidencia son dónde está parado todo tu flujo ahora mismo. Cada otra columna de este lado cuenta solo lo que hizo esta corrida.
Perdidos es la columna que hay que vigilar. Filas que antes apuntaban a uno de tus productos ya no lo hacen. Esos productos dejaron de recibir los números de ese proveedor, y nada más en esta pantalla te lo va a decir.
Una corrida con advertencias y sin errores queda Completada, no Parcial. Una advertencia quiere decir que tu escritura aterrizó y que una parte de la fila no se pudo usar, como un nombre de marca que tu catálogo no tiene. Tu registro igual se quedó con todo lo demás de esa fila.
Cómo ordenar, filtrar y buscar tus corridas
Arriba de la tabla hay cuatro botones de texto. Te funcionan igual de los dos lados.
Puedes ordenar y filtrar por cualquier columna, y pulsar el encabezado de una la ordena. En una columna de conteo tu condición pide un número. Pon Errores en mayor que (>) y 0 y te quedas con todas las corridas que fallaron alguna fila. Ponla en es igual a (=) y 0 y recibes las que no fallaron ninguna, que es lo que representa el guion de esa columna.
La condición de Estado es una lista desplegable, y solo te ofrece los estados que esta fuente alcanzó de verdad. Una lista corta es normal y no quiere decir que te falte nada.
Recibes 50 corridas a la vez, y el pie de la tabla te ofrece 25 o 100.
Qué recuerda la tabla de cómo la acomodaste
Arrastra el encabezado de una columna de lado para reordenar tus columnas, y arrastra su borde para hacerla más ancha. Lo que dejes puesto, junto con qué columnas muestra Columnas y en qué está Densidad, vuelve la próxima vez que abras el historial en la computadora que estás usando.
Descarga y Mapeo recuerdan por separado, porque los dos lados te dan columnas distintas. Nada de eso cambia lo que ve el resto de tu equipo.
Cómo descargar el archivo que leyó una corrida
Descargar archivo, entre los botones del final de una línea de Descarga, te devuelve el archivo de tu proveedor tal como lo recibió esa corrida. Ahí no eliges formato, porque es el archivo que mandó tu proveedor.
Tu archivo llega nombrado con el momento en que empezó la corrida, como feed_2026-08-04-14-30-05.csv. Ábrelo cuando una corrida contó algo que no esperabas y quieres ver qué llegó de verdad.
Hay dos casos que dejan el botón inactivo, y pasar el cursor por él te dice en cuál estás. Mientras la corrida sigue todavía no hay nada que entregarte. Pasados 30 días de la corrida tu copia guardada ya no está, y el mensaje te manda a Ejecutar ahora en la fila de la fuente para traer un archivo nuevo.
Cómo pedir el reporte fila por fila
Resultados, entre los botones del final de una línea de Mapeo, te arma un reporte con una fila por cada registro que miró esa corrida. Es el único lugar donde la corrida se explica registro por registro. Ábrelo cuando un contador te dice que algo falló y necesitas saber cuál de tus filas fue.
Al pulsarlo se abre un diálogo pequeño llamada Selecciona el formato de archivo con dos tarjetas, CSV y Excel. Elige una y tu reporte empieza a armarse.
Armarlo toma un momento y el diálogo te lo dice. La puedes cerrar: cerrarla no cancela nada, y tu descarga arranca sola cuando el reporte está listo. Si tarda más de 2 minutos recibes un mensaje que te pide intentar de nuevo en un rato. Tu reporte sigue armándose mientras tanto, así que pulsar Resultados otra vez un poco después casi siempre te lo entrega de inmediato.
Un reporte que ya pediste se guarda. Se arma una vez y se conserva, así que pedirlo de nuevo te da el mismo archivo sin espera. O sea que un reporte que bajaste dentro de los 30 días se te sigue descargando mucho después de que el detalle detrás de él ya no exista.
El botón queda inactivo en una corrida que sigue andando y en una que no miró ningún registro. Pasar el cursor por él te dice cuál de las dos.
Límites
Lo que el historial de sincronización no puede hacer
Qué te están diciendo los números
Por qué los contadores no suman tu archivo
Del lado Descarga, Nuevos, Actualizado y Sin cambios te suman Filas del archivo solo cuando el archivo de tu proveedor no repitió nada y todas las filas se guardaron.
Dos filas con los mismos valores en cada columna que lee esta fuente cuentan como una sola, y gana la última de las dos. Así que un archivo que reparte uno de tus productos en varias filas te muestra un hueco en una corrida que salió perfecta.
Eliminados queda fuera de esa suma, así que nunca lo sumes. Cuenta productos que dejaron de llegar, no filas que llegaron.
La otra razón de un hueco son las filas que no se pudieron guardar. Esa deja tu corrida en Parcial.
Por qué un flujo asentado casi no muestra nada
Cada corrida revisa todas las filas que tienen un registro en tu catálogo, no solo las que cambiaron. Tus contadores, en cambio, solo cuentan las filas sobre las que la corrida tenía algo que decir.
Una fila cuyos valores siguen de acuerdo con tu catálogo, y cuyo último resultado fue igual a este, se revisa y después se queda fuera de tus conteos por completo. También se queda fuera de tu reporte de Resultados. Así que un flujo asentado de 60.000 filas te muestra un puñado de números, y eso es tu flujo funcionando y no tu flujo detenido. Qué revisa cada corrida está en fuentes de datos.
Cuando un éxito esconde un campo perdido
Cuando una fila coincide con una variante de un producto que tiene varias, los campos compartidos del producto se descartan. Solo entran los valores de esa variante, no se levanta ningún error y la fila cuenta en Éxitos.
Saber el motivo te deja deducir el siguiente caso por tu cuenta. Si no fuera así, la fila de una variante reescribiría tu producto compartido en nombre de todas sus hermanas. Una fila que habla de tu camiseta roja talla chica le estaría poniendo el título, la descripción y las categorías a la azul talla grande.
Todos los campos que descarta una coincidencia por variante
Se van Título, Slug, Estado, Descripción y Características. También Condición, Tipo de producto, Marcas, Categorías, Categoría de Shopify y Etiquetas. Y también Especificaciones, Fuentes de información, Notas internas, Meta título, Meta descripción y URLs de recursos.
Todo lo demás de tu fila es de la variante y entra normal: su precio, su costo, sus existencias, sus medidas y sus códigos de barras.
Las imágenes son la excepción. URL de imagen principal y URLs de galería se dirigen a la variante que coincidió en vez de descartarse. Una celda vacía ahí borra las imágenes de esa sola variante y de ninguna otra.
Así que un flujo que quieres que sea dueño de los campos compartidos de un producto tiene que coincidir a nivel de producto, por Slug o por Título. Un flujo que coincide por un SKU o un código de barras es un flujo por variante, pongas lo que pongas en sus columnas, y fuentes de datos cubre cuáles de tus reglas coinciden de cada forma.
Qué trae adentro el reporte de resultados
El reporte que te arma Resultados, desde una línea de Mapeo, tiene una fila por cada registro que miró esa corrida. Sus columnas se arman con la corrida misma, y salen en este orden.
Tus propias columnas de coincidencia son la razón para abrir este archivo en una fila que no encontró nada. La pantalla te dice que una fila no coincidió. Tu archivo te muestra el valor que la corrida comparó de verdad, que casi siempre es tu respuesta. Un SKU con un espacio adentro, una celda vacía, un código que tu proveedor cambió sin avisarte.
match y result contestan dos preguntas distintas, y leerlas juntas es lo que hace que valga la pena abrir tu archivo. Una fila puede ser existing y error, o sea que conservó su registro y tu escritura falló. Una fila puede ser new y success, que es tu caso bueno de siempre.
El contador No coincidentes de la pantalla y el de Perdidos llegan los dos a tu archivo como un result de not_matched. La columna match es la que te los separa.
Los nombres de columna del propio reporte siempre vienen en inglés, y también los valores de match y de result. Tus columnas conservan los nombres que traía el archivo de tu proveedor.
Cuando algo falla
Qué significa cada estado
La columna Estado es la primera de los dos lados, y trae una de cuatro palabras.
Lo que separa Parcial de Fallida es si algo llegó a pasar. Del lado de la descarga, si se guardó alguna de tus filas. Del lado del mapeo, si se escribió alguno de tus registros. Que no pase nada es Fallida.
Parcial es una corrida sana. Tu archivo llegó y la maquinaria funcionó, y algunas filas de adentro no. No cuenta para que tu fuente se apague sola, cosa que fuentes de datos cubre desde el lado de la salud.
Cómo saber por qué falló una corrida
Pasa el cursor por la insignia de Estado de una línea Fallida y una frase te dice por qué. Esa frase es toda tu explicación, y no hay un segundo lugar donde buscarla.
Cuando una corrida no termina nunca
Una línea no se queda en En curso para siempre. Una fase que deja de avanzar durante 30 minutos se cierra como Fallida por ti, con un mensaje en la insignia que dice que no hubo avance. Tu fuente la retoma su próxima corrida programada.
Eso importa más de lo que parece, porque Ejecutar ahora en la fila de la fuente queda inactivo mientras hay una corrida andando. Una corrida que se murió a medias te dejaría ese botón trabado hasta que lo notaras.
Cuando Resultados o Descargar archivo no funcionan
Los dos botones están al final de la fila, y los dos se te apagan en más de un caso.
Dos cosas que pasan sin aviso
Nada en pantalla te avisa de ninguna de las dos, así que conviene conocerlas.
Tu reporte de Resultados se detiene en 50.000 filas. Una corrida que miró más registros que eso te da los primeros 50.000 y ninguna nota que diga que se detuvo.
Y una fila que coincidió con una variante de un producto con varias variantes pierde los campos compartidos del producto, y aun así te cuenta dentro de Éxitos.
A dónde ir después
Fuentes de datos
La configuración detrás de estas corridas, y qué le hace una celda vacía a tu catálogo.
Prioridades de campos
Qué fuente gana un campo cuando dos lo mandan.
Variantes
Por qué una coincidencia por variante no puede escribir los campos que comparte un producto.
Identificadores
Los valores que compara una regla de coincidencia, y qué hace que uno sea ambiguo.