Ir a la app

Integraciones

Extracción

Una extracción es el PIM leyendo una integración conectada en su propio horario para anotar lo que encontró, así tu producto queda tal como lo dejaste.

Una extracción es el PIM leyendo una de tus integraciones conectadas y anotando lo que encontró. Corre con un horario propio. No te pide nada, y ningún botón de ninguna pantalla inicia una.

Casi siempre se llega a esta página por una de dos razones. Algo cambió en la integración y estás esperando a que llegue al PIM. O apareció un punto de color en uno de tus productos y quieres saber qué encontró la última lectura.

Lo que una extracción hace con lo que encuentra es la parte que hay que aprender, y la respuesta es la misma en todas las integraciones. Una extracción reporta. Anota en qué estado va tu publicación, qué opina de ella la integración y cuántas existencias hay allá, y deja intacto todo lo que escribiste. Tu catálogo de aquí es la versión que cuenta, y la publicación es lo que la manda para allá.

Los resultados los ves en dos lugares. Pulsa una tarjeta en Integraciones, en la barra lateral izquierda, y el diálogo que se abre sobre la página te muestra la hora de Última extracción. Abre un producto desde Catálogo y pasa el cursor sobre el logo de una integración, arriba del editor, y un panel te dice qué encontró la última extracción sobre ese producto.

Antes de empezar

Hay una cosa que decide qué puedes ver aquí. Todo lo demás de esta página puede esperar hasta que lo necesites.

Qué te permite hacer tu rol

RolAbrir IntegracionesLeer el panel de un productoApagar Sincronizar en un producto
Administrador
GerenteNo
EditorNo

Por debajo de Administrador, Integraciones ni siquiera aparece en tu barra lateral, así que Última extracción queda fuera del alcance de casi todo tu equipo. El panel de un producto no. Cualquier persona que pueda abrir un producto puede pasar el cursor sobre un logo y leer qué encontró la última extracción. Los roles se asignan en equipo, roles y permisos.

Cómo ver qué trajo una extracción

  1. Abre el producto

    Pulsa Catálogo en la barra lateral izquierda, que abre en Productos, y pulsa la fila que quieras. El editor se abre encima de tu tabla.

  2. Ubica los logos de las integraciones

    Están en la fila de arriba del editor, a la derecha de tu título y de la insignia de puntaje. Recibes un logo por cada integración que tu organización tenga conectada, haya llegado o no este producto hasta ella.

  3. Pasa el cursor sobre el logo que te interesa

    Debajo se abre un panel pequeño, con una tarjeta por cada cuenta que tengas en esa integración.

  4. Lee las filas del panel

    Estado de sincronización te dice en qué punto va este producto con el PIM. Estado en la integración te dice qué dice la integración misma sobre la publicación. Última extracción te dice cuándo se leyó esa integración por última vez, y Avisos solo aparece cuando hay algo que decir sobre un campo.

Ese es todo el flujo. El punto de color del logo te dice lo mismo de un vistazo, así que un punto verde significa que nada de esa cuenta te necesita.

Todo lo que sigue explica qué devuelve cada integración y qué hacer cuando una línea de ese panel te avisa que algo salió mal. No necesitas nada de eso para leer un panel.

Cada opción en detalle

Cuándo corre una extracción

Una extracción corre cada 30 minutos, una vez por cada destino que tengas encendido. Un destino es la parte de una de tus cuentas que de verdad sincroniza. Significa algo distinto en cada integración, y eso te lo explica integraciones.

La pasada se salta un destino que apagaste, y también una cuenta pausada, en error o que necesita que la vuelvas a autorizar. Una suscripción vencida en tu organización las detiene todas a la vez. La tabla de estados de la cuenta, y qué limpia cada uno, la encuentras en integraciones.

Donde una integración puede avisar de un cambio de existencias en el momento en que ocurre, ese conteo te llega en segundos y no en media hora. El PIM relee entonces solo eso, no tu tienda entera.

IntegraciónQué avisa en el momento en que ocurre
ShopifyUn conteo de existencias que se movió
BigCommerceUn conteo de existencias que se movió
SquareUn conteo de existencias que se movió
AmazonNada. Cada lectura espera la pasada programada
GoogleNada. Cada lectura espera la pasada programada

Cómo leer el panel de una integración en un producto

Pasa el cursor sobre el logo de una integración, arriba del editor de productos, y recibes un panel sobre ese producto en esa integración. Qué filas recibes depende de lo que pasó. Un producto sano te muestra tres o cuatro, y un producto con un problema te muestra más.

FilaQué te dice
Estado de sincronizaciónEn qué punto va este producto con el PIM, en una frase corta
Estado en la integraciónQué dice la integración misma sobre la publicación
Estado por varianteUna línea por variante, con su SKU, el estado que reporta la integración, FBA o FBM en Amazon, y en qué punto va su envío
PublicadasCuántas de tus variantes llegaron, como 3 de 4 variantes. Solo aparece donde una variante es una publicación, y en un producto con más de una
Último envíoHace cuánto le escribió el PIM
Última extracciónHace cuánto se leyó esa integración
RestriccionesUna regla de la integración está impidiendo que se muestre este producto, y la línea dice cuál
Problemas al enviarUna línea por cada campo que la última publicación no pudo mandar tal como estaba
AvisosUna línea por cada campo que hay que revisar pero que no detiene nada
Error al leerLa última lectura falló en este producto, y este es el motivo

Tu nombre para la cuenta está arriba del panel, con un interruptor Sincronizar al lado. Ese interruptor es sobre publicar y no sobre leer. Pulsar el logo abre tu publicación en la integración, en una pestaña nueva, que es la forma más rápida de ir a ver lo que la extracción estaba leyendo.

Cómo se ve el panel cuando tienes dos cuentas en una misma integración

Con una sola cuenta, la línea de arriba del panel es esa cuenta. Se lee como el nombre de la integración y después tu nombre para la cuenta, y el interruptor Sincronizar está en esa línea.

Con dos o más, la línea de arriba es solo la integración. Cada cuenta recibe entonces una línea propia debajo, con su punto, su estado y su interruptor.

El punto del logo es el peor estado entre tus cuentas a las que este producto sí llegó. Una cuenta tuya a la que nunca llegó no arrastra el punto hacia abajo, así que una cuenta gris nunca tapa una verde. Pulsar el logo abre la publicación en una de tus cuentas, no en la que elijas.

Qué reporta de vuelta cada integración

Ninguna extracción escribe dentro de tu catálogo. Todas reportan, y en qué reportan es donde se diferencian.

IntegraciónQué escribe una extracción en tu catálogoQué solo reporta
ShopifyNada, una vez terminada la primera sincronizaciónSi la publicación sigue ahí, las existencias de la tienda y las locaciones de la tienda
BigCommerceNada, una vez terminada la primera sincronizaciónSi la publicación sigue ahí y las existencias de la tienda
SquareNada, una vez terminada la primera sincronizaciónLas existencias del mostrador y las locaciones del comerciante
AmazonNadaEl estado de la oferta, su ASIN, quién la despacha y las existencias que tiene Amazon
GoogleNadaSi cada producto puede mostrarse, y por qué no

El PIM es quien decide qué dicen tus productos, en todas partes. Así que una extracción lee de vuelta el resultado y ahí se detiene. Un artículo que alguien cree en tu tienda de Shopify, en tu tienda de BigCommerce o en Square después de conectar nunca aparece solo en tu catálogo. Si lo quieres aquí, créalo aquí.

Amazon reporta tu oferta y nada del producto. Lee de vuelta qué tan sana está tu oferta, el ASIN de ese marketplace y si la publicación la despacha Amazon o tú. En una publicación que despacha Amazon, además copia la cantidad de Amazon como un número de solo lectura. Esas existencias son de Amazon, y el PIM nunca las escribe.

Google reporta un veredicto. Publicar en Google responde de inmediato incluso cuando tu producto no puede mostrarse, y la decisión de verdad llega minutos después. La extracción existe para ir a buscarla. Lo que Google objete nombra el campo del que se trata. Un producto que Google no va a mostrar en absoluto aparece en Restricciones, y uno que muestra con menos prominencia aparece en Avisos.

Las cinco respuestas que da Google sobre un producto
Qué dice Estado en la integraciónQué significa
AprobadoTu producto puede mostrarse
LimitadoSe muestra con menos prominencia, y los motivos te llegan como líneas en Avisos
En revisiónGoogle todavía no decide
RechazadoNo puede mostrarse, y los motivos te llegan como líneas en Restricciones
DesconocidoGoogle respondió con algo que el PIM no reconoce

Un problema con tu cuenta y no con un producto no aparece aquí. Va a una tarjeta titulada Configuración de la cuenta, arriba del diálogo de tu cuenta, y integraciones cubre cómo leerla.

Qué no trae una primera sincronización

Las existencias se quedan fuera en todas partes, y la sección de abajo explica a dónde van en su lugar.

Una primera sincronización de Square sí trae las imágenes del comerciante a tus recursos. También convierte las categorías de Square en categorías del PIM, para que después tu publicación reutilice esas mismas y no arme un segundo conjunto al lado.

Una primera sincronización de BigCommerce trae las imágenes que están sobre un producto de tu tienda, y deja dos cosas atrás. Los campos personalizados no vienen, porque un nombre y un valor sueltos no se pueden convertir de vuelta en una especificación del PIM. Las imágenes atadas a una sola variante tampoco vienen, solo las del producto.

Qué trae la primera sincronización

La primera sincronización corre una vez, cuando conectas una cuenta, y no se puede volver a correr. Arranca sola en cuanto la conexión existe. Un diálogo se abre frente a ti y cuenta lo que pasó, y integraciones cubre ese diálogo. Lo que le hace a tu catálogo cambia según la integración.

IntegraciónQué hace la primera sincronización
ShopifyLee tu tienda entera, empareja lo que puede con productos que ya tienes e importa el resto. Todos los estados de Shopify vienen, así que los borradores y los archivados también llegan
BigCommerceLee tu tienda entera una vez. Un producto que puede emparejar por SKU, y después por código de barras, queda vinculado al tuyo, y lo que no logra emparejar se vuelve un producto nuevo del PIM
SquareLee los artículos del comerciante una vez, emparejando igual
AmazonNo importa nada. Lee tus publicaciones y adopta cada oferta cuyo ASIN ya coincide con una de tus variantes
GoogleNo importa nada. Google solo guarda lo que el PIM le mandó, así que una cuenta nueva lee de vuelta una respuesta vacía

Un emparejamiento vincula los dos y no cambia nada tuyo. Tu versión es la que sale de vuelta después. Conectar una segunda tienda a un catálogo que ya armaste aquí no sobrescribe lo que armaste. Solo un producto que la primera sincronización no logró emparejar se vuelve un producto nuevo en tu catálogo.

Un artículo sobre el que la primera sincronización no puede decidir se omite. Eso pasa cuando los identificadores de un artículo apuntan a dos productos distintos del PIM, o cuando el producto del PIM que emparejó ya estaba tomado. Esos te llegan en el reporte de errores que descargas desde el diálogo de la primera sincronización. Una moneda que no coincide detiene todo antes de empezar, y integraciones te da ese aviso.

Nada de lo que llega en una primera sincronización trae sus existencias. Una variante importada llega con Rastrear inventario apagado, en la sección Inventario del editor de productos. Los conteos reales de la integración aparecen al lado como números de solo lectura que no puedes editar. Enciende Rastrear inventario cuando quieras que el PIM publique una cantidad propia, algo que trabaja inventario.

Esta es la única vez que el contenido de una integración se vuelve contenido tuyo. Todo lo que viene después corre en la otra dirección.

Dónde terminan las existencias que lee una extracción

Una extracción nunca escribe tu número de existencias. Todo lo que una integración reporta sobre cantidades va al lado de tu número y no dentro de él. Tu número sigue siendo el que pusiste, y los dos quedan uno junto al otro para que veas la diferencia.

Abre un producto desde Catálogo, baja a la sección Inventario, y debajo de Rastrear inventario recibes una tabla con una fila por locación. Las columnas que recibes son Ubicación, Integración, Disponible, Comprometido y Entrante. Cada número de ahí es de solo lectura, y nada de lo que escribas en otro lado lo cambia.

Qué locaciones ves en esa tabla también viene de la extracción. Shopify, Square y BigCommerce reportan las locaciones que tienes con ellos. Amazon agrega una por cada marketplace donde guarda tus existencias. Una locación que la integración deja de usar se marca inactiva aquí en vez de desaparecerte.

Si una locación cuenta o no para la cantidad de stock físico que el PIM publica lo decides tú, desde la lista Locaciones del diálogo de la cuenta, algo que cubre integraciones.

Límites

QuéLímite
Tiempo entre lecturas programadas30 minutos
Primeras sincronizaciones por cuenta1
Productos que lee una extracciónSin límite

Lo que una extracción no puede hacer

No puedesHaz esto en su lugar
Leer una integración cuando tú quierasEspera la siguiente pasada
Correr una primera sincronización por segunda vezNada la vuelve a correr. Una conexión nueva corre una primera sincronización propia
Revisar qué hicieron las extracciones anterioresLee Última extracción en el diálogo de la integración, y Avisos en el producto
Detener la lectura sin detener la publicaciónApaga el destino en el diálogo de la cuenta, lo que detiene las dos direcciones
Traer a tu catálogo una edición hecha en la integraciónHaz la edición aquí, y deja que la publicación la lleve
Traer un artículo creado en la integración después de conectarCréalo en tu catálogo del PIM y deja que la publicación lo lleve

Qué pasa con lo que escribiste

Cuando alguien edita en la integración

Tu versión es la que se queda, siempre. Una edición que alguien haga en el panel de Shopify, en tu tienda de BigCommerce, en Square o en Amazon nunca se lee de vuelta a tu catálogo. Se queda en esa integración hasta que el PIM publica ese producto otra vez, y esa publicación escribe tu producto entero encima.

Así que no hay carrera que ganar ni horas que comparar. Si quieres un cambio que alguien hizo allá, haz el mismo cambio aquí.

Las marcas y etiquetas que crea la primera sincronización

Un producto de Shopify tiene un proveedor y un conjunto de etiquetas, y tu catálogo tiene Marcas y Etiquetas propias. Así que una primera sincronización que se topa con un proveedor que tu catálogo no tiene te crea la marca. Con las etiquetas pasa igual: una que tu catálogo nunca vio se crea también. Las encuentras las dos en Catálogo, dentro de Marcas y de Etiquetas, y su columna Creado por dice Integración en lugar del nombre de una persona.

Las categorías nunca van en esta dirección. Una colección de Shopify no se vuelve una categoría del PIM, corran las sincronizaciones que corran, así que tu árbol de categorías siempre es solo lo que armaste tú.

Un proveedor o una etiqueta de más de 100 caracteres se omite en vez de crearse, y recibes una línea en Avisos del producto que te lo dice.

Un producto que eliminaste aquí no vuelve

Eliminar un producto del PIM en una cuenta cuyo ajuste de eliminación es Archivar o Conservar deja tu publicación viva en la integración, que es lo que pediste al elegir ese ajuste en la configuración de la integración.

Lo que el PIM hace entonces es olvidarla. El vínculo entre tu producto eliminado y esa publicación se va, nada de aquí apunta ya a esa publicación, y ninguna pasada posterior la lee de vuelta. Así que un producto que eliminas se queda eliminado, le hayas dicho lo que le hayas dicho a la integración sobre lo que estaba publicando.

Una publicación que eliminaste allá vuelve sola

Cada extracción que termina encola una publicación por cada producto tuyo cuyo SKU falte en esa integración. Eliminar una publicación en el panel de Shopify, en tu tienda de BigCommerce o en Square no es la forma de sacar un producto de una integración. Vuelve en media hora, y integraciones explica lo mismo desde el lado de la publicación.

La forma de sacar un producto de una cuenta es el interruptor Sincronizar de la tarjeta de esa cuenta en el panel de tu producto. Productos cubre qué te pregunta ese interruptor cuando tu publicación ya está viva.

Apagar Sincronizar detiene la publicación. Un producto que sacaste de una cuenta queda fuera de todo lo que el PIM manda allá. La publicación que dejaste ahí conserva su lugar en el panel, así que puedes seguir entrando a ella desde la integración.

Cuando algo falla

La insignia de un producto

El punto del logo de una integración tiene un color, y la fila Estado de sincronización del panel te deletrea ese color en palabras. Estas son las que produce una extracción.

Qué dice Estado de sincronizaciónQué significa
SincronizadoNada de esta cuenta te necesita
2 campos necesitan atenciónEsa cantidad de campos tiene algo que decir, y Avisos te los lista
Falló la lecturaLa última lectura no pudo tomar este producto, y Error al leer te da el motivo
La publicación necesita atenciónLa integración dice que tu publicación no está del todo viva
Rechazado por la integraciónLa integración se negó a mostrarla

Gana el peor, así que un estado rojo tapa uno naranja debajo. Las demás frases que puedes encontrar en esa fila vienen del lado de la publicación o del estado de tu cuenta, y productos e integraciones las cubren.

Las notas sobre un campo

Avisos te da una línea por cada campo que hay que revisar. Cada línea abre con el nombre del campo, escrito como lo escribe tu editor de productos. Así que un título que se pasó de largo en la primera sincronización se lee Título superaba el máximo de 300 caracteres; se acortó para que cupiera.

Cómo termina la líneaQué pasó
se acortó para que cupiera.El valor entró, recortado hasta el límite
no se importó.El valor no se pudo usar, así que el campo llegó vacío
se asignó uno único.Otro producto ya tenía ese Handle de URL, así que el tuyo recibió otro
se asignaron SKUs temporales.Otro producto ya tenía esos SKU
que se eliminaron.Se quitaron caracteres invisibles y el resto entró
se omitió.No se pudo descargar un archivo, así que el producto llegó sin él

De dónde salió la línea decide cómo se limpia. En Shopify todas son notas de la primera sincronización, y se limpian la próxima vez que ese producto se publique con éxito, porque esa publicación manda tu versión del producto entero. En Amazon y en Google la línea es el veredicto de la integración misma, así que corrige el valor allá y la siguiente extracción la limpia por ti.

Cuándo te escribe el PIM

Una extracción que sigue fallando en una cuenta te manda un correo cuyo asunto nombra el problema de sincronización y la integración. No te pide hacer nada. La siguiente pasada lo vuelve a intentar, y la primera extracción que termine lo cierra sin que toques nada.

Una autorización que expiró o fue revocada te manda otro correo distinto, pidiéndote que reconectes. Los dos están en Notificaciones, dentro de tu configuración, en el grupo Integraciones y sincronización, como Errores de sincronización y Problemas de conexión. Ahí puedes apagar cualquiera de los dos.

Dos cosas que pasan sin aviso

Nada en pantalla te avisa de ninguna de las dos, así que conviene conocerlas.

Un producto de Shopify cuyas imágenes la tienda todavía está preparando espera en vez de llegar sin ellas. Si al cabo de un rato siguen sin estar listas, el producto entra con las que sí lo están, y una línea en Avisos nombra lo que quedó fuera. Nada trae el resto después, así que esos son archivos que subes tú aquí.

Mientras corre una importación de catálogo tuya, el PIM retiene las publicaciones que una extracción encolaría para los productos que faltan en un canal. Se encolan cuando tu importación termina, así que media hora tranquila después de subir un archivo grande es lo esperado.

A dónde ir después