> ## 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.
# Búsqueda
> La búsqueda es una casilla que encuentra lo que sea de tu catálogo por nombre o por SKU, y al pulsar un resultado llegas directo a él.
La búsqueda es una sola casilla que revisa todo tu catálogo a la vez y te lleva directo al registro que nombras. Escribes unas cuantas letras y vuelve una lista agrupada: primero tus productos, después tus marcas, después tus categorías, y seis tipos más detrás de ellas. Pulsa una fila y se abre.
Casi siempre se recurre a la búsqueda cuando sabes cómo se llama algo, o sabes su SKU, y recorrer el catálogo tardaría más que escribirlo. También es la vía más rápida para llegar a otra parte del PIM, porque esa misma lista te ofrece un puñado de destinos junto a tus registros. Nada de lo que haces aquí cambia tu catálogo, así que no hay nada que romper al escribir en ella.
La búsqueda se abre desde `Buscar`, el botón del extremo derecho de la cabecera, y ese botón está en todas las pantallas. La búsqueda entonces se apodera de la página: una casilla reemplaza al título y tus resultados llenan todo lo de abajo.
## Antes de empezar
Todas las personas de tu organización buscan sobre el mismo catálogo. Tu rol no te esconde un producto, una marca ni un archivo, y tampoco cambia con qué coincide la búsqueda. Lo que sí cambia es a dónde te puede llevar un resultado después.
Dos filas de tu lista son solo para el rol `Administrador`. Una es el resultado de una integración, que abre la cuenta conectada que hay detrás. La otra es el destino `Integraciones`, que abre tu pantalla de integraciones. Con cualquier otro rol sigues viendo las dos, y pulsar cualquiera de ellas te deja en tu pantalla de inicio. Los roles se asignan en [equipo, roles y permisos](/es/team#qué-puede-hacer-cada-rol-del-pim).
## Cómo buscar
Pulsa `Buscar`, el botón del extremo derecho de la cabecera, desde la pantalla en la que estés. `Ctrl+K` hace lo mismo desde cualquier parte del PIM, o `⌘K` en Mac.
Una casilla reemplazó al título de la página, arriba a la izquierda, y tu cursor ya está dentro. Escribe al menos 2 caracteres, porque debajo de eso no se busca nada.
Tus resultados llegan juntos y agrupados. Primero van tus propios registros, un grupo por tipo, y después los destinos a los que puedes saltar.
Pulsa cualquier fila. La primera ya viene resaltada, así que con `Enter` abres la coincidencia más cercana sin tocar el mouse.
Ese es todo el flujo. Abrir un resultado cierra la búsqueda y abre el registro o la pantalla que elegiste. Tu búsqueda se suma a una lista corta que ves la próxima vez que tu casilla esté vacía.
Todo lo que sigue explica qué lee la búsqueda, qué te dice cada fila y dónde se detiene. No necesitas nada de eso para encontrar un producto por su nombre.
## Cada opción en detalle
### Cómo abrir y cerrar la búsqueda
`Buscar` está en el extremo derecho de la cabecera, después de los controles de tu página y antes del acceso a las apps, y está en todas las pantallas. Junto a la palabra hay una tecla pequeña que dice `Ctrl+K`, o `⌘K` en Mac. Esa tecla se esconde en un teléfono, y el botón no.
Ese atajo abre la búsqueda desde cualquier parte del PIM, y volver a pulsarlo la cierra. `Esc` también, y `Cerrar` también, el botón que está a la derecha de la casilla mientras la búsqueda está abierta. Los tres te devuelven a la página de donde venías, y ninguno guarda lo que escribiste.
Lo que escribes se va guardando en la barra de direcciones. Así que una búsqueda es algo que puedes marcar como favorita o mandarle a un colega, y abrir esa dirección la vuelve a correr.
### Qué revisa la búsqueda
La búsqueda lee nueve tipos de registro de tu catálogo al mismo tiempo. Cada tipo recibe su propio grupo en la lista, bajo un encabezado que lo nombra, y los grupos siempre vuelven en este orden.
| Grupo | Qué lee una coincidencia | La segunda línea de la fila |
| --- | --- | --- |
| `Products` | El título, la descripción, el tipo de producto, sus etiquetas y todos sus identificadores | El identificador que escribiste, o la marca, o el tipo de producto |
| `Brands` | El nombre de la marca | Su descripción |
| `Categories` | El nombre de la categoría | Su ruta completa, de madres a hijas |
| `Tags` | El nombre de la etiqueta | Su descripción |
| `Spec Groups` | El nombre del grupo | Su descripción |
| `Spec Definitions` | El nombre de la definición | Su descripción |
| `Spec Values` | El valor | La definición donde está |
| `Integrations` | La etiqueta que le pusiste a la cuenta y el nombre del proveedor | El proveedor y el destino |
| `Assets` | El nombre visible y el nombre original del archivo | El nombre original del archivo |
Esos nueve encabezados de grupo siempre están en inglés, uses el PIM en el idioma que lo uses. Los tres del final del catálogo son los que menos se adivinan: `Spec Groups` son tus grupos de especificaciones, `Spec Definitions` tus definiciones y `Spec Values` los valores permitidos de cada definición. `Páginas`, `Configuración` y `Búsquedas recientes` sí siguen tu idioma, y eso es lo que hace visible la diferencia en una pantalla en español.
Un archivo aparece aquí solo cuando terminó de subir, la misma regla que tu [biblioteca de recursos](/es/pim/assets) se aplica a sí misma. Empieza una subida y búscala un segundo después y todavía no está.
### Qué encuentra un producto
**Cualquier identificador tuyo encuentra a su producto.** Escribe un SKU, un código de barras, un ISBN, un número de parte, un ASIN o el valor de un identificador personalizado. Tu producto vuelve. Vale también para un identificador de cualquiera de las variantes del producto. Así que un código que escaneaste es tu vía más rápida al producto que quieres editar, e [identificadores](/es/pim/catalog/identifiers#los-seis-tipos) cubre los seis tipos.
Una variante nunca recibe fila propia. Busca un SKU de una variante y recibes el producto en el que está, con el identificador que escribiste como segunda línea de esa fila.
**Un casi acierto también encuentra.** Los acentos se ignoran, así que `cafe` encuentra `Café`. Una letra equivocada se perdona, así que `camisza` encuentra una camisa. Dos letras equivocadas en la misma palabra suele ser demasiado, y no recibes nada.
**Con un trozo de palabra basta.** `pho` encuentra `iPhone`, estén donde estén esas letras dentro del nombre.
Un producto coincide por los valores de sus identificadores, su título, su descripción, su tipo de producto y los nombres de las etiquetas que lleva. Pesan en ese orden, así que un producto cuyo título escribiste queda por encima de uno que solo menciona tus palabras al fondo de su descripción.
Lo que nada de eso lee es la etiqueta que le pusiste a un identificador `Personalizado`. La búsqueda lee el valor, así que un identificador personalizado llamado `Código de bodega` se encuentra por el código mismo y no por esas tres palabras.
### Cómo saltar a otra pantalla
Junto a tus registros, la búsqueda ofrece una lista fija y corta de lugares del PIM. Vuelven en dos grupos, `Páginas` y `Configuración`, y siempre quedan debajo de tus propios registros.
| Grupo | Los destinos que tiene |
| --- | --- |
| `Páginas` | `Inicio`, `Catálogo`, `Reportes`, `Importaciones`, `Exportaciones`, y `Integraciones` para el rol `Administrador` |
| `Configuración` | `Notificaciones` y `Apariencia` |
**Un destino responde a de qué trata, no solo a su nombre.** Cada uno lleva unas cuantas palabras extra que también coinciden con él. Así que `csv` y `spreadsheet` llegan a `Importaciones`, `dark mode` y `theme` llegan a `Apariencia`, `shopify` y `connections` llegan a `Integraciones`, y `kpi` llega a `Inicio`. Cuando una palabra podría coincidir con un nombre y con una palabra extra a la vez, el nombre se lleva el lugar más alto.
**Esas palabras extra siempre están en inglés.** Los nombres sí siguen el idioma en el que usas el PIM, así que en una pantalla en español `Apariencia` responde igual a `theme`. Aquí también se perdona una letra equivocada.
### Búsquedas recientes
Abre la búsqueda y deja la casilla vacía, y la lista de abajo te muestra lo que buscaste antes, bajo un encabezado de grupo que dice `Búsquedas recientes`.
Una búsqueda se recuerda solo cuando abres uno de sus resultados. Eso mantiene tu lista en las búsquedas que sirvieron, en vez de un registro de todo lo que has tecleado. Abrir un destino también cuenta, así que llegar a `Apariencia` desde la búsqueda pone lo que escribiste en tu lista igual que lo haría abrir un producto. Tus últimas 10 búsquedas se guardan, la más nueva arriba, y cada una se descarta a los 30 días.
Pulsar una fila reciente devuelve ese texto a tu casilla y lo vuelve a correr. No abre nada, así que una búsqueda reciente es un atajo hacia una búsqueda y nunca un atajo hacia un registro.
`Limpiar todo` está a la derecha del encabezado `Búsquedas recientes` y vacía tu lista entera. `Quitar` está a la derecha de cada fila y descarta esa sola búsqueda.
Tus búsquedas recientes se guardan en el navegador que estás usando, guardadas por separado para cada organización. No te siguen a otra computadora y ningún colega las ve.
### Cómo moverte por la lista sin el mouse
| Tecla | Qué hace |
| --- | --- |
| `Ctrl+K`, o `⌘K` en Mac | Abre la búsqueda desde cualquier parte, y también la cierra |
| Flecha arriba y flecha abajo | Mueven el resaltado una fila |
| `Enter` | Abre la fila resaltada |
| `Esc` | Cierra la búsqueda |
La primera fila queda resaltada en cuanto llegan tus resultados, así que escribir y pulsar `Enter` abre la coincidencia más cercana. Pasar el mouse por una fila mueve el resaltado hacia ella, lo que quiere decir que la fila bajo tu cursor es la que `Enter` va a abrir.
Esas tres últimas teclas están impresas abajo de la pantalla, en una franja que solo aparece cuando tu lista ya tiene algo.
### Límites
| Qué | Límite |
| --- | --- |
| Caracteres antes de que se busque algo | 2 |
| Caracteres de tu consulta que se leen | 100 |
| Resultados por grupo | 8 |
| Búsquedas recientes guardadas | 10 |
| Cuánto dura una búsqueda reciente | 30 días |
| Búsquedas por persona por minuto | 100 |
### Lo que la búsqueda no puede hacer
| No puedes | Haz esto en su lugar |
| --- | --- |
| Ver más de 8 resultados de un mismo tipo | Escribe algo más estrecho, o filtra la tabla de ese tipo |
| Acotar la lista a un tipo, o a un estado, una marca o una fecha | Usa los filtros de la tabla de ese tipo |
| Encontrar una importación, una exportación, una fuente de datos, una vista guardada o a un colega | Abre la pantalla que los tiene |
| Encontrar un archivo que sigue subiendo | Espera a que la subida termine |
| Saltar a tu biblioteca de recursos o a tus fuentes de datos | Usa la barra lateral |
| Ordenar tus resultados, o pasar de página | Escribe algo más estrecho |
## Qué te muestra la lista de resultados
Hay dos cosas de la lista que sorprenden la primera vez. Nunca te da más de 8 filas de un mismo tipo, y el número de arriba no es la cantidad de coincidencias que tienes.
### El orden en que vienen los grupos
Primero van tus propios registros, los productos arriba y los recursos al final, en el orden fijo de la tabla de los nueve tipos que está más arriba en esta página. Los dos grupos de destinos van detrás. Dentro de un grupo la coincidencia más cercana queda arriba, así que la lista está ordenada por qué tan bien responde cada fila a lo que escribiste y no alfabéticamente.
Todo llega de una vez. La búsqueda espera a que dejes de escribir antes de correr. Después retiene tu lista entera hasta que cada parte está lista, así que nunca ves aparecer un grupo y otro llegar un momento después.
### Qué te dice cada fila
Cada fila lleva un nombre a la izquierda, con una segunda línea debajo. Lo que guarda esa segunda línea depende del tipo, y la tabla de los nueve tipos que está más arriba en esta página dice cuál.
La fila de un producto lleva dos cosas más a la derecha. El precio es el más bajo entre las variantes del producto, siempre en la moneda base de tu organización, y un producto sin precio en ninguna parte no muestra ninguno. Al lado va el estado del producto, con las mismas palabras que usa tu [tabla de productos](/es/pim/catalog/products#cómo-leer-la-tabla-de-productos).
La fila de una integración lleva en su lugar el logo de su proveedor a la izquierda.
### Ocho por tipo, y eso es toda la lista
Cada uno de los nueve grupos te da 8 filas como máximo, y no hay nada que pulsar para ver el resto. No hay paginación, ni un botón para el conjunto completo, ni forma de decirle a la búsqueda que solo quieres productos.
Así que una palabra que coincide con 300 productos te da 8. Esos 8 son las coincidencias más cercanas y no los primeros 300 recortados, lo que significa que una consulta precisa sigue poniendo arriba al producto correcto. Cuando 8 no bastan, escribe algo más estrecho o abre la tabla de ese tipo y fíltrala. [Los productos](/es/pim/catalog/products) cubren el filtrado que la búsqueda deliberadamente deja en paz.
### Los dos contadores
Arriba de tu lista hay una línea que dice cuántos resultados volvieron y cuántos milisegundos tardó tu búsqueda. Ese mismo número aparece otra vez abajo a la derecha de la franja del pie de la pantalla.
Los dos cuentan solo tus registros, y los cuentan después del límite de 8 por grupo. En la consulta que coincide con 300 productos, los dos dicen 8. Ninguno cuenta las filas de `Páginas` y `Configuración`, así que una búsqueda que no encuentra nada en tu catálogo y sí dos destinos marca 0 con dos filas debajo.
## Cuando algo falla
### Cuando no vuelve nada
`Sin resultados` llena la pantalla siempre que tu lista queda vacía. Cuando estás seguro de que la cosa existe, cuatro motivos explican casi todos los casos.
- **Es una variante.** Busca su SKU y vuelve en su lugar el producto en el que está.
- **Quedó detrás del límite.** Una palabra común la entierra bajo otras 7 coincidencias más cercanas, así que escribe algo más estrecho.
- **El archivo sigue subiendo.** Un recurso se encuentra cuando su subida termina.
- **No es uno de los nueve tipos.** Las importaciones, las exportaciones, las fuentes de datos, las vistas guardadas y tus colegas no se buscan.
Una segunda errata en la misma palabra también falla, porque una letra equivocada es todo lo que tolera una coincidencia.
Hay un caso que parece una falla y no lo es. Justo con 1 carácter recibes `Sin resultados`, porque el mínimo son 2 y todavía no se ha buscado nada. Con el segundo carácter tu lista vuelve.
### Los estados en los que puedes caer
| Qué ves | Qué significa |
| --- | --- |
| Nada en absoluto | Tu casilla está vacía y todavía no tienes búsquedas recientes |
| `Buscando...` | Tu búsqueda está corriendo |
| `Sin resultados` | No coincidió nada, o escribiste un solo carácter |
| `Algo salió mal` | Tu búsqueda no corrió. Vuelve a intentarlo |
`Algo salió mal` también cubre que se te pida bajar el ritmo. Pasadas 100 búsquedas en un minuto las tuyas se rechazan hasta que ese minuto termine, y el rechazo se lee igual que cualquier otra falla. Escribiendo no vas a llegar ahí, porque una búsqueda corre cuando haces una pausa y no una vez por tecla.
## A dónde ir después
Los filtros y las vistas guardadas para las búsquedas demasiado amplias.
Los seis tipos de código por los que se puede encontrar un producto.
La biblioteca que la búsqueda cubre, una vez que el archivo terminó de subir.
Dónde está el botón de búsqueda, y el resto del marco a su alrededor.