Ir a la app

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

  1. Abre el historial de sincronización

    Desde Importar/Exportar, entra a la pestaña Fuentes de datos y busca tu fuente en la tabla. Pulsa Historial entre los botones que están al final de su fila.

  2. Elige la fase que te interesa

    La lista desplegable que está junto al título del diálogo dice Descarga o Mapeo. Déjala en Descarga para ver qué llegó de tu proveedor. Cámbiala a Mapeo para ver qué alcanzó tu catálogo.

  3. Encuentra la corrida

    Tus corridas salen de la más reciente a la más vieja, y la columna Iniciado dice hace cuánto empezó cada una. Pulsa el encabezado de una columna para ordenar por esa columna.

  4. Lee el estado y los contadores

    La columna Estado dice 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.

  5. Abre el detalle

    En una línea de Mapeo, pulsa Resultados entre los botones del final de la fila para armar un reporte con una fila por registro. En una línea de Descarga, pulsa Descargar archivo para 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.

Qué pasóQué ves
Tu descarga fallóUna línea de descarga, y ninguna línea de mapeo
Tu descarga funcionóDos líneas, una de cada lado de la lista desplegable
Tu descarga funcionó y el archivo no traía nada nuevoDos líneas, y los contadores por corrida de la línea de mapeo salen en guion

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.

ColumnaQué te muestra
EstadoCómo terminó esa fase
IniciadoHace cuánto empezó la fase, contado en minutos, horas o días
DuraciónCuánto tardó, escrito como 35.8s, 2m 15s o 1h 4m. Vacía mientras tu corrida sigue

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.

ColumnaQué cuenta
Filas del archivoFilas que traía tu archivo esta vez
NuevosFilas con algo que esta fuente nunca había visto
ActualizadoFilas que ya conocía y cuyo contenido cambió
Sin cambiosFilas idénticas a las de tu descarga anterior
EliminadosProductos que estaban en tu descarga anterior y no llegaron en esta

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.

ColumnaQué cuenta
CoincidentesFilas de tu flujo que ahora mismo tienen un registro en tu catálogo
Sin coincidenciaFilas de tu flujo que ahora mismo no tienen ninguno
Recién coincidentesFilas que ganaron un registro en esta corrida, incluida una que ahora apunta a otro
PerdidosFilas que tenían un registro y ya no
ÉxitosFilas coincidentes que esta corrida escribió sin problemas
No coincidentesFilas que esta corrida miró y no encontraron nada donde escribir
AdvertenciasFilas coincidentes que esta corrida escribió con un aviso al lado
ErroresFilas coincidentes que esta corrida no logró escribir

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.

BotónQué hace por ti
BuscarSolo mira la columna Estado, y no reconoce las palabras en español. Usa Filtrar para acotar por estado
FiltrarAbre un panel donde armas una condición sobre cualquier columna
ColumnasOculta y muestra columnas
DensidadHace tus filas más altas o más bajas

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

QuéLímite
Filas de un reporte de Resultados50.000
Cuánto dura el detalle fila por fila30 días
Cuánto dura la copia guardada de tu archivo30 días
Cuánto dura la línea de una corridaSin límite
Corridas que ves a la vez50
Espera antes de que el reporte te pida reintentar2 minutos
Tiempo sin avance antes de cerrar una corrida30 minutos

Lo que el historial de sincronización no puede hacer

No puedesHaz esto en su lugar
Deshacer una corrida, ni dejar tu catálogo como estaba antes de unaCorrige los valores a mano, o con una importación
Ver qué le cambiaría una corrida a tu catálogo antes de correrlaCórrela y lee su línea aquí
Detener una corrida que ya empezóEspérala, y pulsa Pausar en la fuente para que no arranque la siguiente
Eliminar la línea de una corrida, ni vaciar el historial de una fuenteEliminar la fuente se lleva su historial
Recibir un correo cuando una corrida termina con filas falladasAbre esta pantalla. El correo cubre solo las fallas de archivo completo
Leer el historial de todas tus fuentes en un mismo lugarAbre Historial en una de tus fuentes a la vez
Descargar el reporte de una corrida de hace más de 30 díasPulsa Ejecutar ahora en la fuente y lee tu corrida nueva

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.

ColumnaQué trae
record_idLa fila guardada de la que salió esta línea
Tus columnas de coincidenciaLas columnas que leyeron tus reglas, con los valores que vio la corrida
Tus columnas de valoresLas columnas que alimentan campos de tu catálogo, con los valores que vio la corrida
matched_entity_type y matched_entity_handleCon qué coincidió, y con cuál
matchCómo cambió el vínculo: new, existing, lost o none
resultsuccess, warning, error o not_matched
messageTodos los avisos y errores de esa fila, unidos

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.

EstadoQué significa
En cursoLa fase sigue andando
CompletadaTerminó sin nada mal
ParcialTerminó, y una parte no funcionó
FallidaTerminó y no funcionó nada

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.

Qué te dice el mensajeQué hacer
No se pudo conectar, o el servidor tardó demasiado en responderRevisa el host, el puerto y si el servidor está arriba. Un tiempo agotado se reintenta solo en tu próxima corrida
No se pudo iniciar sesión en el servidorRevisa el usuario y la contraseña de tu fuente
Tu archivo no apareció, o el acceso fue rechazadoRevisa la ruta o el enlace. Un enlace que pide iniciar sesión aparte no funciona aquí
Tu archivo se descargó vacío, o no se pudo leerPregúntale a tu proveedor qué mandó. Una fuente de datos lee CSV y XLSX
Tu archivo pesa más que el límitePide uno más chico, o pártelo. Fuentes de datos tiene el número
A tu fuente le falta una parte de su configuraciónAbre la fuente y termínala: el enlace, el host, el usuario, las reglas de coincidencia o los mapeos de campos
Las columnas de tu archivo ya no coinciden con la configuraciónVuelve a abrir la fuente y elige la columna nueva para cada campo marcado en rojo, cosa que fuentes de datos te explica paso a paso
Algo salió mal de nuestro ladoNo hay nada que corregir de tu parte. Tu próxima corrida lo intenta de nuevo

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.

Qué pulsasteQué recibesPor qué
Resultados en una línea que sigue andandoUn botón inactivoTu reporte necesita el resultado terminado de cada registro
Resultados en una corrida que no miró ningún registroUn botón inactivoNo hay nada que poner en un reporte
Resultados pasados 30 días de la corrida«Los resultados detallados de esta sincronización ya no están disponibles: el detalle por registro se conserva 30 días.»Salvo que ya hubieras descargado ese reporte una vez
Descargar archivo en una descarga que sigue andandoUn botón inactivoTu archivo se guarda cuando la fase termina
Descargar archivo pasados 30 días de la corridaUn botón inactivo que te manda a Ejecutar ahoraTu copia guardada ya no está

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