Integraciones

Problemas de sincronización

Un producto puede verse terminado en tu catálogo y aun así faltar en una integración, y aquí el PIM anota el motivo y qué tienes que cambiar.

Un problema de sincronización es el PIM avisándote de que uno de tus productos no llegó a una de tus integraciones, o llegó y volvió con una queja. Cada problema es de un producto en una cuenta, y el PIM lo anota en ese producto.

Vienes aquí porque nada de esto se anuncia solo. Un producto puede verse terminado en tu catálogo y no estar en una tienda donde vendes, o estar allá sin precio. La única señal es un punto de color, y esta página es cómo lees ese punto, encuentras la frase que hay detrás y averiguas qué cambiar.

Todo lo que necesitas está en el producto. Abre uno desde Catálogo y verás una fila de logos de integración arriba del editor, junto al título, un logo por cada integración que tengas conectada. Cada logo lleva un punto de color pequeño, y al pasar el cursor por el logo se abre un panel que dice con palabras qué significaba ese color.

Esa misma fila de logos también está en una marca y en una categoría, así que todo lo de abajo se lee igual en esas.

Antes de empezar

Tu rol	Qué puedes hacer aquí
`Administrador`	Leer cualquier insignia, arreglar el producto, y reconectar o resincronizar una cuenta
`Gerente`, `Editor`	Leer cualquier insignia y arreglar el producto

Los roles se asignan en equipo, roles y permisos.

Nada te avisa por correo cuando un producto no logra publicarse. Un producto puede dejar de venderse en una integración y quedarse así hasta que alguien lo abra y mire el punto.

Cómo averiguar por qué un producto no está en una integración

Abre el producto
Pulsa Catálogo en la barra lateral, que abre en la tabla Productos, y pulsa la fila del producto que estás revisando. Se abre el editor, con una fila de logos de integración arriba, junto al título.
Busca el punto que no esté en verde
Cada logo tiene un punto de color pequeño en la esquina. El verde significa que esa integración no necesita nada de ti. El rojo y el naranja son los dos colores que hay que abrir.
Abre el panel
Pasa el cursor por ese logo. Se abre un panel con una sección por cada cuenta que tengas en esa integración, y la primera fila de cada sección, Estado de sincronización, escribe el color con palabras.
Lee el motivo
Debajo de Estado de sincronización, el panel escribe qué pasó. Una fila Problemas al enviar significa que una parte de lo que mandaste no pudo salir. Una fila Restricciones significa que una regla de la integración está frenando el producto. Una fila Avisos o Error al leer significa que la integración devolvió algo.
Cambia lo que nombra el mensaje y guarda
Arregla el campo que nombra el mensaje, en cualquier parte del editor de producto, y pulsa Guardar. Guardar vuelve a poner ese producto en cola en todas las integraciones, y la insignia se mueve sola.

Ese es todo el flujo. Casi todos los problemas de sincronización son un campo de un producto, y guardar es todo el reintento que hay, porque no existe ningún botón que repita el mismo envío.

Todo lo que sigue es la lista completa de lo que puede decir la insignia, qué pide cada tipo de mensaje, y a dónde ir cuando la respuesta no está en el producto. No necesitas nada de eso para un mensaje que nombra un campo.

Cada opción en detalle

Qué significa el color del punto

El punto es lo más rápido de leer de la página, y cinco colores son todo el vocabulario.

Color	Qué te está diciendo
Verde	Tu producto está en esa integración y nada te necesita
Azul	El PIM lo está publicando ahora, o está esperando su turno
Gris	Ahí no se está publicando nada, y no hay ningún problema detrás
Naranja	Tu producto está publicado y una parte no es la que mandaste
Rojo	Tu producto no está publicado, o la integración no lo quiere mostrar

Solo se muestra un estado a la vez, y el panel elige el más grave que tenga. Así que un estado naranja puede estar debajo de uno rojo y aparecer recién cuando resuelvas el rojo. Arregla lo que te muestre el panel, guarda, y vuelve a mirar.

Un logo cubre todas las cuentas que tengas en esa integración, y su punto te muestra la peor de ellas. Dos tiendas de Shopify donde una está limpia y la otra está fallando te dan un punto rojo, y el panel de abajo trae una sección por cada una para que sepas cuál es.

El azul y el gris son los estados donde el PIM está trabajando o donde le dijiste que no. Envío los lista todos, junto con qué pone un producto en cada uno.

Los estados que te piden cambiar algo

Estos son los rojos. Tu producto no se vende en esa cuenta hasta que resuelvas uno de ellos.

Qué dice `Estado de sincronización`	Qué pasó	Qué hacer
`Falló`	El último envío fue rechazado y no se escribió nada	Lee `Problemas al enviar`, cambia lo que nombra, y guarda
`3 variantes fallaron`	El producto pasó y esa cantidad de variantes no	Lee `Problemas al enviar`, que nombra cada variante por su SKU
`Bloqueado`	Una regla de la integración detuvo el envío antes de que saliera nada	Lee `Restricciones`, que nombra la regla
`Falló la lectura`	La primera sincronización no pudo tomar este producto	Lee `Error al leer`, arregla ese campo aquí, y el siguiente envío que pase lo limpia
`Rechazado por la integración`	La integración tiene tu producto y se niega a mostrarlo	Lee `Restricciones`, que te da el veredicto y el campo detrás de él
`Necesita volver a autenticarse`	La conexión venció o fue revocada	Reconecta la cuenta en la pantalla de integraciones
`Error en la cuenta`	La cuenta se apagó tras algo de lo que no puede recuperarse	Elimínala y conecta una nueva, en esa misma pantalla

Los dos últimos son de la conexión y no de tu producto, así que todos los productos de esa cuenta están detenidos igual y ninguno se moverá hasta que arregles la cuenta.

Los estados que son solo una advertencia

Estos son los naranjas. Tu producto está publicado, y algo de él no es lo que mandaste.

Qué dice `Estado de sincronización`	Qué pasó	Qué hacer
`Necesita atención`	El envío llegó y una parte de lo que mandaste se cambió o se descartó	Lee `Avisos`
`4 campos necesitan atención`	Esa cantidad de campos tiene algo que decir	Lee `Avisos`, que extracción explica línea por línea
`La publicación necesita atención`	La integración tiene tu producto y no lo está mostrando completo	Arréglalo en el panel de esa integración

Una insignia naranja hay que leerla y casi nunca es urgente. El caso común es un precio. Una cuenta cuyas fuentes de precio no resolvieron nada se queda con el precio que ya tenía, así que la publicación sigue viva con el número viejo. En el panel te enteras de que el nuevo nunca salió.

Qué integraciones pueden decir que una publicación requiere atención, y cuáles pueden rechazarla

Solo dos de ellas reportan algo sobre una publicación, y son las dos donde otra persona decide si tu producto se muestra.

En Amazon, la fila Estado por variante del panel te da el estado de cada variante: Publicado cuando se ve y se puede comprar, No se puede comprar cuando la gente la ve y no la puede comprar, No aparece en búsquedas cuando la puede comprar y no la encuentra, Inactivo cuando no pasa ninguna de las dos, y Desconocido cuando Amazon no describe nada. Ninguno de ellos pone tu insignia en naranja por sí solo, porque cada uno dice en qué punto va tu oferta y no que algo esté mal. Lo que sí la pone en rojo es que Amazon se niegue a llevar el producto, y eso se lee Bloqueado.

En Google, Limitado se lee como La publicación necesita atención y Rechazado se lee como Rechazado por la integración. Esos dos son los únicos estados de publicación, en cualquiera de los dos productos, que mueven la insignia por sí solos.

Shopify, Square y BigCommerce publican lo que les mandas y nunca devuelven un veredicto, así que un producto tuyo o está en ellas o no está.

Qué te pide cambiar un mensaje

Cada mensaje nombra la integración que lo produjo, así que siempre sabes a qué tienda ir a mirar. Hay cinco tipos, y el tipo te dice dónde está el arreglo.

El mensaje	Qué significa	Dónde lo arreglas
Un campo con nombre fue rechazado	El valor salió y la integración no lo quiso tomar	El campo, en tu editor de producto
Falta algo que la integración necesita	Tu producto no tiene ningún valor que la integración pueda usar ahí	El campo, o la configuración de la cuenta para que salga otro
Se llegó a un límite del lado de la integración	La integración pone un tope, y tu producto o tu tienda ya lo pasó	El producto, o el panel de la integración
Un valor se acortó o se descartó al salir	El envío llegó y ese valor no llegó completo	El campo, si prefieres que salga completo
La integración desaprobó tu producto	Lo tiene todo y aun así no lo va a mostrar	El panel de esa integración

Lee la primera palabra del mensaje. Te dice si el arreglo es tuyo. Un mensaje que abre con el nombre de la integración es esa integración rechazando un valor, como un precio o un código de barras que no aceptó. Un mensaje que abre con «No hay precio disponible» o «Google requiere» es tu producto al que le falta algo, y ese siempre te toca llenarlo a ti.

Qué exige cada integración antes de aceptar un producto

Casi todas las fallas son una de estas, y cada una es siempre el mismo mensaje.

Integración	Sin esto no publica
Shopify	Un handle de URL que ningún otro producto de la tienda use, y un precio en el primer envío. Acepta como máximo 3 opciones por producto
BigCommerce	Un nombre, un precio, un SKU y un slug de URL que acepte
Amazon	Una coincidencia con un ASIN, más un precio, una cantidad de existencias y una condición que acepte
Square	Un nombre, un precio y una moneda que acepte
Google	Una imagen, un título, un SKU en la variante, un precio mayor que cero, y una dirección para la página del producto

La dirección de Google sale del sitio web que configuraste en la cuenta, no del producto, y su mensaje te lleva directo a la configuración de esa cuenta. Google también rechaza una cuenta cuya moneda no sea la de tu catálogo.

Sea cual sea el identificador que una cuenta manda como SKU, tiene que tener valor y tiene que ser único. Cambia cuál es en Elige qué identificador recibe la integración, dentro de configuración.

Por qué unos pocos mensajes llegan en inglés

Casi todos los mensajes están escritos en el idioma que estás usando. Unos pocos no, y son los que vienen de fuera del producto mismo: una marca o una categoría que no logró publicarse, y una falla de la conexión o de la moneda.

Esos llegan como una frase en inglés dentro de Problemas al enviar. Cuando pasa, tu producto no tiene nada malo, y la frase igual nombra qué cambiar.

Volver a enviar después de arreglarlo

Guardar el producto es el reintento. Cambia lo que nombraba el mensaje, pulsa Guardar, y el PIM vuelve a encolar ese producto en todas las integraciones unos segundos después. La insignia pasa a Pendiente de actualizar, y de ahí a Sincronizado o de vuelta a Falló si el arreglo no era el correcto.

Nada reintenta una insignia roja por su cuenta. El PIM reintenta un problema pasajero varias veces antes de rendirse, y una insignia que llegó a Falló significa que dejó de intentar. Así que la respuesta a una insignia roja siempre es cambiar algo y nunca esperar.

Cuando el arreglo es una configuración y no un campo, guardar el producto no basta, porque esa configuración decide qué arma el envío. Abre la cuenta desde la pantalla de integraciones, pulsa Configuración, guarda tu cambio, y responde Resincronizar ahora cuando te pregunte. Eso encola todos los productos de esa cuenta, incluidos los que fallaron. Esa pantalla solo la ve quien tiene rol Administrador.

Ver a cuántos productos les pasa

El panel de un producto te habla de ese producto y de ningún otro. Para un conteo de todo tu catálogo, pulsa Reportes en la barra lateral y abre la tarjeta Integraciones.

Qué te muestra	Qué cuenta
`Envíos fallidos`	Publicaciones cuyo último envío fue rechazado, en todas las cuentas
`Fallidos` y `Pendientes`, en la tabla por proveedor	Los mismos dos conteos, separados por integración
`Resultados de envío`	Todos los intentos de envío de tu rango de fechas, según cómo terminaron
`Cuentas que necesitan atención`	Cuentas con error, que necesitan reautenticación, o pausadas

Esa tarjeta aparece recién cuando conectas una cuenta, y solo la abre quien tiene rol Administrador. Los conteos son números y no listas, así que úsalos para saber si tienes un problema, y después ve a los productos mismos.

Límites

Qué	Límite
Mensajes que muestra el panel antes de decir `+N más`	5
Veces que se reintenta un problema pasajero antes de pasar a `Falló`	3
Intentos anteriores que puedes leer en un producto	Ninguno

Lo que no puedes hacer aquí

No puedes	Haz esto en su lugar
Listar los productos que están fallando	Abre el reporte de Integraciones para un conteo, y revisa los productos que cambiaste hace poco
Reintentar un envío desde la insignia	Arregla lo que nombra el mensaje y guarda el producto
Reintentar todos los envíos fallidos de una vez	Guarda la configuración de la cuenta y responde `Resincronizar ahora`
Leer los mensajes que un producto recibió la semana pasada	Nada. El panel guarda solo el último intento
Leer el texto completo de un mensaje que el panel acortó	Nada. Arregla los 5 que te muestra y guarda, y el resto llega después
Recibir un correo cuando un producto falla	Nada. Abre el producto y lee la insignia
Filtrar u ordenar tu tabla `Productos` por estado de sincronización	Nada. El estado está solo en el editor de producto

Qué guarda el panel

El panel guarda el último intento y nada de antes

Cada envío sobrescribe lo que dejó el anterior. Así que un producto que falló dos veces por dos motivos distintos te muestra el segundo motivo, y el primero ya no está.

Eso importa sobre todo cuando arreglas una cosa y detrás falla otra. Un Falló que vuelve enseguida después de guardar suele ser un segundo problema y no el mismo, así que lee el mensaje de nuevo en lugar de dar por hecho que tu arreglo no entró.

Un mensaje se resuelve solo cuando el siguiente intento sale limpio

En el PIM nada se resuelve a mano, y no hay nada que descartar. Arregla el valor, guarda, y el mensaje se va cuando el envío que sigue no dice nada de él.

Lo mismo pasa al revés. Un mensaje que devolvió la integración se resuelve en la siguiente extracción que encuentre el valor sano. Así que una publicación que arreglaste en Merchant Center o en Seller Central se pone verde aquí en la próxima extracción y no antes.

Cuando algo falla

Una insignia roja que no se resuelve

Revisa estas cuatro en orden. La primera que aplique es tu respuesta.

Revisa	Qué significa si es cierto
`Estado de sincronización` dice `Necesita volver a autenticarse`, `Error en la cuenta`, `Cuenta pausada` o `Desconectando la cuenta`	Arregla la cuenta primero. Nada de lo que cambies en el producto lo va a mover
El mensaje nombra un campo que tú no cambiaste	Ese es un segundo problema que el primero estaba tapando
El mensaje nombra una configuración	Cámbiala en configuración y responde `Resincronizar ahora`
El mensaje nombra algo de la integración	Arréglalo allá. La próxima extracción trae el veredicto de vuelta

Una insignia naranja después de arreglarla

Vuelve a guardar el producto. Una advertencia la escribe un envío, así que se queda en el producto hasta que el siguiente envío la reemplace. Un producto que editaste en el panel de otra integración no ha tenido ningún envío desde entonces.

Si sigue ahí después de guardar, léela de nuevo. Las dos advertencias que se ven idénticas antes y después de un arreglo son un precio que sigue sin resolverse y una imagen que la integración sigue sin aceptar.

Nada te avisa cuando se resuelve

Una insignia que se pone verde es todo el aviso que recibes, y tienes que estar mirando el producto para verla. No hay ningún mensaje en la app, porque el PIM te avisa las cosas por correo y un producto que no logró publicarse no manda ninguno.

Lo que sí te manda un correo es la conexión misma. Tres cosas te llegan así: una extracción que sigue fallando en una cuenta, una autorización que venció, y una moneda que no coincide. Las tres las controlas desde Notificaciones, dentro de tu configuración, en el grupo Integraciones y sincronización, como Errores de sincronización y Problemas de conexión. Puedes apagar cualquiera de los dos interruptores ahí.