> ## 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 en la cabecera del Repricer que encuentra una publicación, una estrategia o una cuenta conectada y te lleva a su pantalla.

La búsqueda es una casilla que revisa tres cosas a la vez y te lleva a la que nombras. Escribes unas letras y vuelve una lista agrupada: primero tus publicaciones, luego tus estrategias, luego las cuentas que tienes conectadas. Pulsa una fila y se abre.

Casi siempre se usa la búsqueda cuando sabes cómo se llama una publicación, o sabes su `SKU`, y recorrer la tabla de publicaciones tardaría más que escribir. También es la forma más rápida de llegar a otra parte del Repricer, porque esa misma lista te da un conjunto de pantallas a las que saltar junto a tus propios registros. Nada de lo que haces aquí cambia un precio, una estrategia ni una conexión, así que no hay nada que romper por escribir dentro.

Abres la búsqueda desde `Buscar`, el botón de la cabecera que está a la derecha del título de la página, y ese botón está en todas las pantallas. La búsqueda llena entonces la página: una casilla reemplaza el título y tus resultados llenan todo lo de abajo.

## Antes de empezar

Todo tu equipo busca sobre las mismas publicaciones, estrategias y cuentas. Tu rol no te esconde ninguna de ellas y no cambia lo que coincide. Lo que sí cambia es a dónde te puede llevar un resultado.

Hay dos destinos que son solo del rol `Admin`. `Integraciones` y `Facturación` están en la lista de lugares a los que un Admin puede saltar, y en la de nadie más.

Un resultado de una de tus cuentas conectadas funciona distinto. Todos los roles reciben esas filas, y pulsar una abre tu pantalla de integraciones si eres Admin e `Inicio`, la portada del Repricer, para todos los demás. El Repricer tiene cuatro roles, y en [equipo, roles y permisos](/es/team#qué-puede-hacer-cada-rol-del-repricer) es donde se asignan.

## Cómo buscar

<Steps>
  <Step title="Abre la búsqueda">
    Pulsa `Buscar` en la cabecera, a la derecha del título de la página, desde la pantalla en la que estés. `Ctrl+K` hace lo mismo desde cualquier parte del Repricer, o `⌘K` en una Mac.
  </Step>

  <Step title="Escribe lo que buscas">
    Una casilla reemplazó al título de la página arriba a la izquierda, con tu cursor ya dentro. Escribe al menos 2 caracteres, porque debajo de eso no se busca nada.
  </Step>

  <Step title="Lee la lista">
    Tus resultados llegan juntos, en grupos. Tus propios registros van primero, un grupo por tipo, y las pantallas a las que puedes saltar van después.
  </Step>

  <Step title="Abre la que quieres">
    Pulsa cualquier fila. La primera ya viene resaltada, así que presionar `Enter` abre la coincidencia más cercana sin tocar el ratón.
  </Step>
</Steps>

Ese es todo el flujo. Abrir un resultado cierra la búsqueda y te lleva a la pantalla donde está esa cosa. Tu búsqueda se agrega 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 hasta dónde llega. No necesitas nada de eso para encontrar una publicación por su `SKU`.

## Cada opción en detalle

### Abrir y cerrar la búsqueda

`Buscar` está en la cabecera, a la derecha del título de la página y del control que ponga ahí esa pantalla, y está en todas las pantallas. Junto a la palabra hay una tecla pequeña que dice `Ctrl+K`, o `⌘K` en una Mac. Esa tecla se esconde en una ventana angosta y en el teléfono, y el botón no.

Presionar ese atajo en cualquier parte del Repricer abre la búsqueda, y presionarlo otra vez la cierra. `Esc` hace lo mismo, y también `Cerrar`, 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 la que veniste, y ninguno guarda lo que escribiste, así que tu casilla está vacía la próxima vez que la abras.

Lo que escribes va a la barra de direcciones mientras lo escribes. Así que una búsqueda es algo que puedes guardar en favoritos o mandarle a alguien de tu equipo, y abrir esa dirección la corre de nuevo.

### Qué revisa la búsqueda

La búsqueda lee tres tipos de registro 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 debajo de la fila |
| --- | --- | --- |
| `Publicaciones` | El `SKU`, el `ID de producto`, el `FNSKU`, el título del producto y la marca | El `SKU` y el `ID de producto`, con un punto en medio |
| `Estrategias` | El nombre de la estrategia y su descripción | La cuenta para la que está puesta la estrategia |
| `Integraciones` | La `Etiqueta` que le pusiste a la cuenta, y el ID con el que la integración la conoce | Ese ID y los marketplaces que cubre la cuenta |

Esos tres cubren todas las integraciones que tienes conectadas y todos los marketplaces dentro de ellas, así que una sola búsqueda te da una publicación la vendas donde la vendas. Nada acota la lista a una integración ni a una cuenta.

Una estrategia que no está puesta para una sola cuenta no tiene segunda línea, así que debajo dice `Estrategia`.

### Qué encuentra una publicación

**Tu `SKU` y tu `ID de producto` encuentran su publicación.** Los dos están en la segunda línea de cada fila de publicación. Los dos coinciden con una parte de sí mismos, así que con medio `SKU` basta, y las publicaciones de Amazon también responden a su `FNSKU`.

**El título del producto y la marca también la encuentran.** Escribe cómo se llama el producto y vuelven sus publicaciones. Escribe una marca y vuelven todas las publicaciones de esa marca.

**Un casi acierto igual la encuentra.** Los acentos se ignoran, así que `cafe` encuentra `Café`. Una letra equivocada se perdona, así que `camsa` encuentra una camisa. Dos letras equivocadas en la misma palabra suele ser demasiado, y no recibes nada.

**Con parte de una palabra basta.** `pho` encuentra `iPhone`, estén donde estén esas letras dentro del nombre.

<Accordion title="Todo lo que lee una búsqueda de publicaciones, y qué pone arriba">
  Una publicación coincide por su `SKU`, su `ID de producto`, su `FNSKU`, su título de producto y su marca. Cuentan en ese orden, así que una publicación cuyo `SKU` escribiste queda por encima de una que solo tiene tu palabra en algún lugar del título.

  La misma publicación en dos marketplaces son dos publicaciones, y vuelven las dos. Cada fila muestra el logo de la integración en la que está, y así distingues una de otra.
</Accordion>

### Saltar a otra pantalla

Junto a tus registros, la búsqueda te da un conjunto fijo de lugares del Repricer. Vuelven en tres grupos, y siempre van debajo de tus propios registros.

| Grupo | Los destinos que tiene |
| --- | --- |
| `Páginas` | `Inicio`, `Publicaciones`, `Estrategias`, `Actividad de precios`, `Reportes`, `Importaciones`, `Exportaciones`, e `Integraciones` para un Admin |
| `Reportes` | Una fila por cada uno de los seis reportes |
| `Configuración` | `Notificaciones`, `Apariencia`, `Perfil`, `Seguridad`, `General`, `Equipo`, y `Facturación` para un Admin |

**Un destino responde a lo que trata, no solo a su nombre.** Cada uno tiene unas palabras extra que también lo encuentran. Así que `csv` y `hoja de cálculo` encuentran `Importaciones` y `Exportaciones`, `modo oscuro` y `tema` encuentran `Apariencia`, `margen` encuentra el `Reporte de rentabilidad`, y `reglas` encuentra `Estrategias`. Esas palabras extra siguen el idioma en el que usas el Repricer, y aquí también se perdona una letra equivocada.

**Cinco de los destinos de `Configuración` te sacan del Repricer.** `Perfil`, `Seguridad`, `General`, `Equipo` y `Facturación` abren la app de cuenta. Ahí es donde se guardan tu nombre, tu organización, tu equipo y tu plan. `Notificaciones` y `Apariencia` son los dos propios del Repricer, y se abren en un diálogo sobre la página en la que estás.

<Accordion title="Los seis reportes que puedes abrir desde la búsqueda">
  `Reporte de ventas`, `Reporte de propiedad de Buy Box`, `Reporte de cambios de precio`, `Reporte de rentabilidad`, `Reporte de salud del Repricing` y `Reporte de unidades vendidas`.

  Cada uno abre el reporte mismo. `Reportes`, en el grupo `Páginas` de arriba, abre la pantalla que lista los seis.
</Accordion>

### A dónde te lleva cada fila

| La fila que pulsas | Dónde terminas |
| --- | --- |
| Una publicación | Tu pantalla de publicaciones, con el diálogo de esa publicación abierta encima |
| Una estrategia | Esa estrategia, abierta en el asistente de estrategias en su primer paso |
| Una cuenta conectada | Tu pantalla de integraciones |
| Un destino de `Páginas` o de `Reportes` | Esa pantalla |
| Un destino de `Configuración` | El diálogo de configuración del Repricer, o la app de cuenta para los cinco de arriba |

La fila de cuenta es la única que no abre lo que está en la fila. Te deja en tu pantalla de integraciones, donde eliges la cuenta tú. Para cualquier rol que no sea `Admin` te deja en `Inicio`, porque la pantalla de integraciones es la única que un rol por debajo de Admin no puede abrir.

### 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 deja tu lista con las búsquedas que funcionaron, en lugar de un registro de todo lo que has escrito. Abrir un destino también cuenta, así que abrir `Apariencia` desde la búsqueda pone en tu lista la palabra que escribiste igual que abrir una publicación. Se guardan tus últimas 10 búsquedas, la más nueva arriba, y cada una se descarta a los 30 días.

Pulsar una fila reciente vuelve a poner ese texto en tu casilla y la corre de nuevo. No abre nada, así que una búsqueda reciente es un atajo a una búsqueda y nunca un atajo a una publicación.

`Limpiar todo` está a la derecha del encabezado `Búsquedas recientes` y vacía toda tu lista. `Quitar` está a la derecha de cada fila y descarta esa búsqueda.

<Accordion title="Dónde se guardan tus búsquedas recientes, y quién más las ve">
  Se guardan en el navegador que estás usando, y se guardan aparte para cada organización. Así que la lista que recibes en una organización no es la que recibes en otra, y cambiar de organización cambia la lista.

  No te siguen a otra computadora ni a otro navegador, y nadie de tu equipo las ve nunca.
</Accordion>

### Moverte por la lista sin el ratón

| Tecla | Qué hace |
| --- | --- |
| `Ctrl+K`, o `⌘K` en una Mac | Abre la búsqueda desde donde estés, y la vuelve a cerrar |
| 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 apenas llegan tus resultados, así que escribir y presionar `Enter` abre la coincidencia más cercana. Pasar el ratón por encima de una fila mueve el resaltado a ella, o sea que la fila bajo tu cursor es la que va a abrir `Enter`.

Esas tres últimas teclas están impresas en una franja al pie de la pantalla, que aparece solo 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 que se guardan | 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 específico, o filtra la tabla de ese tipo |
| Acotar la lista a un tipo, o a una integración, una cuenta o un estado | Usa los [filtros](/es/repricer/filters) de la tabla de ese tipo |
| Encontrar una publicación por su código de barras, su descripción o su condición | Abre [publicaciones](/es/repricer/listings) y filtra la tabla |
| Encontrar una importación, una exportación, una programación, una vista guardada, un cambio de precio o a alguien de tu equipo | Abre la pantalla donde están |
| Abrir una cuenta conectada desde su fila | Entra desde tu pantalla de integraciones |
| Ordenar tus resultados, o pasar de página | Escribe algo más específico |

## 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

Tus propios registros van primero, las publicaciones arriba, luego las estrategias, luego tus cuentas conectadas. Los tres grupos de destinos van después. Dentro de un grupo, la coincidencia más cercana está arriba, así que la lista va ordenada por qué tan bien responde cada fila a lo que escribiste y no alfabéticamente.

Todo llega junto. La búsqueda espera a que dejes de escribir antes de correr. Después retiene la lista entera hasta que cada parte está lista, así que nunca ves aparecer un grupo y llegar otro un momento más tarde.

### Qué te dice cada fila

Cada fila muestra en el extremo izquierdo el logo de la integración en la que está, luego un nombre, con una segunda línea debajo del nombre. Lo que muestra esa segunda línea depende del tipo, y la tabla de tres tipos de más arriba dice cuál.

| Tipo | El nombre de la izquierda | Qué hay a la derecha |
| --- | --- | --- |
| Una publicación | Su título de producto, o su `SKU` cuando no tiene título | Su precio, y su estado de repricing |
| Una estrategia | El nombre que le pusiste a la estrategia | En cuántas publicaciones está la estrategia |
| Una cuenta conectada | La `Etiqueta` que le pusiste a la cuenta | Si la conexión está funcionando |

El precio de una publicación es el precio al que está viva, en la moneda del marketplace donde está. Una publicación que todavía no tiene precio no muestra ninguno.

El estado que está a la derecha de una fila de publicación y de una fila de cuenta viene escrito como se guarda, en inglés y con un guion bajo en lugar del espacio. Así que una publicación en la que el repricing no puede correr dice `NOT_WORKING`, y una cuenta que hay que reconectar dice `NEEDS_REAUTH`. Tu tabla de [publicaciones](/es/repricer/listings) escribe esos mismos estados con palabras normales.

### Ocho por tipo, y esa es toda la lista

Cada uno de los tres grupos te da 8 filas como máximo, y no hay nada que pulsar para ver el resto. No hay páginas, no hay un botón para el conjunto completo, y no hay forma de decirle a la búsqueda que solo quieres publicaciones.

Así que una palabra que coincide con 300 publicaciones te da 8 de ellas. Esas 8 son las coincidencias más cercanas y no las primeras 300 cortadas, o sea que una consulta precisa igual pone arriba la publicación correcta. Cuando 8 no bastan, escribe algo más específico o abre la tabla de ese tipo y fíltrala. [Los filtros](/es/repricer/filters) cubren ese acotado que la búsqueda deja de lado a propósito.

### 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. La misma cuenta aparece otra vez abajo a la derecha, en la franja al pie de la pantalla.

Las dos cuentan solo tus propios registros, y los cuentan después del límite de 8 por grupo. En la consulta que coincide con 300 publicaciones, las dos dicen 8. Ninguna cuenta las filas de `Páginas`, `Reportes` ni `Configuración`, así que una búsqueda que no encuentra nada tuyo y sí dos destinos dice 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 tienes claro que la cosa existe, cuatro motivos explican casi todos los casos.

- **Quedó detrás del límite.** Una palabra común entierra lo que quieres debajo de 7 coincidencias más cercanas, así que escribe algo más específico.
- **Escribiste algo que la búsqueda no lee.** Un código de barras, una descripción, una condición y una comisión no encuentran nada, por exacto que los escribas.
- **No es de los tres tipos.** Las importaciones, las exportaciones, las programaciones, las vistas guardadas, los cambios de precio y tus compañeros no se buscan.
- **La publicación no está en esta organización.** La búsqueda cubre la organización en la que estás trabajando, así que cámbiala en la barra lateral y prueba otra vez.

Un segundo error de tecleo en la misma palabra también falla, ya que una letra equivocada es hasta donde llega una coincidencia.

Hay un caso que parece una falla y no lo es. Con exactamente 1 carácter recibes `Sin resultados`, porque 2 es el piso y todavía no se buscó nada. Un segundo carácter te devuelve la lista.

### Los estados en los que puedes terminar

| Qué ves | Qué significa |
| --- | --- |
| Nada | 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ó. Prueba otra vez |

`Algo salió mal` también cubre que te pidan bajar el ritmo. Pasadas 100 búsquedas en un minuto las tuyas se rechazan hasta que ese minuto termina, y el mensaje se lee igual que cualquier otra falla. Escribir solo no te lleva ahí, porque una búsqueda corre cuando haces una pausa y no una por tecla.

## A dónde ir después

<Columns cols={2}>
  <Card title="Publicaciones" icon="table" href="/es/repricer/listings">
    Qué es una publicación, y la tabla que abres cuando 8 filas no son la respuesta.
  </Card>

  <Card title="Estrategias" icon="target" href="/es/repricer/strategies">
    Qué es una estrategia, y qué te dice el conteo que va en su fila.
  </Card>

  <Card title="Filtros" icon="funnel" href="/es/repricer/filters">
    Cómo acotar una tabla cuando 8 filas de un tipo no bastan.
  </Card>

  <Card title="La interfaz" icon="layout-dashboard" href="/es/repricer/interface">
    Dónde está `Buscar` en la cabecera, y el resto del marco a su alrededor.
  </Card>
</Columns>
