> ## Documentation Index
> Fetch the complete documentation index at: https://docs.readyforcommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Ready for Commerce is an ecosystem that currently contains two products, PIM and Repricer, standing on one shared foundation: one identity, one organization, one team, one bill. Do not call it a platform with features, and never hint at an unreleased product.
> PIM connects to Shopify, Amazon, Square, Google Merchant Center and BigCommerce. Repricer connects to Amazon, Walmart, Shopify, BigCommerce, eBay and Square. The two products do not share one list, and each integration is authorized separately inside each product. The roster grows on purpose, so describe what the product does and let a table carry which integrations do it today, instead of counting them or writing that only one does something.
> Integration is the word this product uses, and it is the default in the documentation: the connection, the account, the Integrations screen, the per-account settings and the sync state are all integrations. Channel is reserved for the narrow sense of a destination where a listing lives, as in a product being live on a channel or archived on the channel.
> Newegg is not a supported channel. Do not describe it.
> On Amazon, PIM manages the offer only: price, availability and condition. It does not publish listing content such as titles, descriptions, images or specifications.
> Sign-in is passwordless: a single-use code emailed to the user, or Google. There are no passwords anywhere, so never describe a password, a sign-up with a password, or an email confirmation link.
> There is no public API for customers and no customer-facing webhooks. There is no organization-wide activity feed and no audit export, but the PIM does keep version history on products, brands, categories, tags and specifications, with who changed what and a restore, so never write that changes are not recorded or that an edit cannot be undone. Do not describe capabilities that are not documented here.
> Never write that the products have no AI, and never write that anything is AI-powered. Both are wrong. The PIM's image Optimizer runs AI-backed transforms the seller starts on purpose: Upscale, Remove background, and the region selection behind Refine. The Repricer reads competitor prices off web pages on the server. No control, badge or tooltip in either product names AI, and the seller never writes a prompt, so describe what the buttons do in the app's own words instead of reaching for the word.
> A PIM product, brand, category or variant can be switched off per connected integration account. Hover the channel badge and the switch is beside the account name in the card that opens. It carries no visible caption, so never call it the Sync switch: Sync is only its accessible name. On a variant-grained provider, Amazon today, the switch moves into the variant editor. On a product it asks whether to delete it from the channel, archive it there, or leave it live. Disabling stops publishing, not reading. There is still no per-field sync toggle.
> The PIM's image Optimizer replaced a feature called Squarify, which no longer exists. It resizes to an aspect ratio or to exact dimensions, removes backgrounds, upscales, trims the transparent margin around a cutout and re-centers it, pads, fills and re-encodes, and it always publishes a new asset instead of changing the original. Nothing crops into the picture: the subject is always contained whole.
> The PIM has no repricing engine and never reacts to a competitor's price. It does build the price it publishes to each integration account from the seller's own fields, configured in that account's settings, so do not write that the PIM has no pricing rules.
> Neither product has an in-app notification center, bell or inbox. Notifications are delivered by email only.
> Billing is per organization and per product, and only the organization owner can see or change it. Team members are free and uncounted, so never describe seats or per-user pricing.
> The seller never picks a plan. Each product has twelve price tiers assigned automatically from usage: the PIM from catalog product count, which includes drafts and archived products, and the Repricer from trailing 30-day sales. Nothing is feature-gated by plan and exceeding a tier never blocks work, so never write that a feature requires a higher plan.
> A subscription that is past due or paused makes the product read-only, which stops repricing and blocks edits without deleting data. Only a canceled subscription locks the seller out. Nothing is ever charged without a payment method on file.
> Pages containing the text 'This page has not been written yet', or its Spanish equivalent 'Esta página todavía no está escrita', are placeholders. Do not treat their headings as documented behavior.
# 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
| Rol | Abrir `Integraciones` | Leer el panel de un producto | Apagar `Sincronizar` en un producto |
| --- | --- | --- | --- |
| `Administrador` | Sí | Sí | Sí |
| `Gerente` | No | Sí | Sí |
| `Editor` | No | Sí | Sí |
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](/es/team#qué-puede-hacer-cada-rol-del-pim).
## Cómo ver qué trajo una extracción
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.
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.
Debajo se abre un panel pequeño, con una tarjeta por cada cuenta que tengas en esa integración.
`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](/es/pim/integrations).
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](/es/pim/integrations).
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ón | Qué avisa en el momento en que ocurre |
| --- | --- |
| Shopify | Un conteo de existencias que se movió |
| BigCommerce | Un conteo de existencias que se movió |
| Square | Un conteo de existencias que se movió |
| Amazon | Nada. Cada lectura espera la pasada programada |
| Google | Nada. 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.
| Fila | Qué te dice |
| --- | --- |
| `Estado de sincronización` | En qué punto va este producto con el PIM, en una frase corta |
| `Estado en la integración` | Qué dice la integración misma sobre la publicación |
| `Estado por variante` | Una 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 |
| `Publicadas` | Cuá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ío` | Hace cuánto le escribió el PIM |
| `Última extracción` | Hace cuánto se leyó esa integración |
| `Restricciones` | Una regla de la integración está impidiendo que se muestre este producto, y la línea dice cuál |
| `Problemas al enviar` | Una línea por cada campo que la última publicación no pudo mandar tal como estaba |
| `Avisos` | Una línea por cada campo que hay que revisar pero que no detiene nada |
| `Error al leer` | La ú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.
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ón | Qué escribe una extracción en tu catálogo | Qué solo reporta |
| --- | --- | --- |
| Shopify | Nada, una vez terminada la primera sincronización | Si la publicación sigue ahí, las existencias de la tienda y las locaciones de la tienda |
| BigCommerce | Nada, una vez terminada la primera sincronización | Si la publicación sigue ahí y las existencias de la tienda |
| Square | Nada, una vez terminada la primera sincronización | Las existencias del mostrador y las locaciones del comerciante |
| Amazon | Nada | El estado de la oferta, su ASIN, quién la despacha y las existencias que tiene Amazon |
| Google | Nada | Si 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`.
| Qué dice `Estado en la integración` | Qué significa |
| --- | --- |
| `Aprobado` | Tu producto puede mostrarse |
| `Limitado` | Se muestra con menos prominencia, y los motivos te llegan como líneas en `Avisos` |
| `En revisión` | Google todavía no decide |
| `Rechazado` | No puede mostrarse, y los motivos te llegan como líneas en `Restricciones` |
| `Desconocido` | Google 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](/es/pim/integrations) cubre cómo leerla.
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](/es/pim/assets). 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](/es/pim/integrations) cubre ese diálogo. Lo que le hace a tu catálogo cambia según la integración.
| Integración | Qué hace la primera sincronización |
| --- | --- |
| Shopify | Lee 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 |
| BigCommerce | Lee 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 |
| Square | Lee los artículos del comerciante una vez, emparejando igual |
| Amazon | No importa nada. Lee tus publicaciones y adopta cada oferta cuyo ASIN ya coincide con una de tus variantes |
| Google | No 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](/es/pim/integrations) 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](/es/pim/catalog/inventory).
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](/es/pim/integrations).
### Límites
| Qué | Límite |
| --- | --- |
| Tiempo entre lecturas programadas | 30 minutos |
| Primeras sincronizaciones por cuenta | 1 |
| Productos que lee una extracción | Sin límite |
### Lo que una extracción no puede hacer
| No puedes | Haz esto en su lugar |
| --- | --- |
| Leer una integración cuando tú quieras | Espera la siguiente pasada |
| Correr una primera sincronización por segunda vez | Nada la vuelve a correr. Una conexión nueva corre una primera sincronización propia |
| Revisar qué hicieron las extracciones anteriores | Lee `Última extracción` en el diálogo de la integración, y `Avisos` en el producto |
| Detener la lectura sin detener la publicación | Apaga 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ón | Haz la edición aquí, y deja que la publicación la lleve |
| Traer un artículo creado en la integración después de conectar | Cré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](/es/pim/integrations/settings).
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](/es/pim/integrations) 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](/es/pim/catalog/products) 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ón` | Qué significa |
| --- | --- |
| `Sincronizado` | Nada de esta cuenta te necesita |
| `2 campos necesitan atención` | Esa cantidad de campos tiene algo que decir, y `Avisos` te los lista |
| `Falló la lectura` | La última lectura no pudo tomar este producto, y `Error al leer` te da el motivo |
| `La publicación necesita atención` | La integración dice que tu publicación no está del todo viva |
| `Rechazado por la integración` | La 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](/es/pim/catalog/products) e [integraciones](/es/pim/integrations) 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ínea | Qué 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
La otra dirección, qué la inicia y qué acepta cada integración.
Cuentas, destinos, locaciones y los estados que detienen una extracción.
Tu cantidad de existencias, y los números de solo lectura que una extracción escribe al lado.
El editor, los logos de arriba y el interruptor que está dentro del panel.