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

# Filtros

> Un filtro esconde las filas que ahora mismo no quieres ver, así sacas 12 productos de entre 40,000 sin cambiarle nada a ninguno.

Un filtro acota una tabla a las filas que quieres ver. Eliges una columna, eliges una condición y le das un valor, y la tabla se queda solo con las filas que responden. Lee todas tus filas y no solo la página que tienes enfrente, así que 12 coincidencias entre 40.000 productos vuelven juntas en una sola página, por muy adentro que estuvieran.

No cambia ni borra nada, así que puedes probar sin miedo. Un filtro decide qué ves, y lo quitas cuando quieras.

Casi siempre se filtra para encontrar un hueco o para juntar un grupo. Productos sin costo, marcas que nadie ha usado todavía, importaciones que fallaron la semana pasada. Cuando la tabla tiene solo esas filas puedes revisarlas, cambiarlas todas de una vez, o mandarle la lista a un colega como enlace.

Todas las listas del PIM son la misma tabla, así que lo que aprendes en una te sirve en el resto. Eso incluye las cuatro listas del catálogo, las tres de especificaciones y tu [biblioteca de recursos](/es/pim/assets). También incluye las listas de importaciones, exportaciones y fuentes de datos de `Importar/Exportar`, y las tablas que hay dentro de cada reporte. Los controles están en una barra justo arriba de las filas, y el que abre los filtros se llama `Filtrar`.

## Antes de empezar

Un filtro por sí solo no cambia ningún dato. Lo primero que importa es qué pasa después con las filas que te deja.

<Warning>
  Una acción masiva corre sobre todas las filas que coinciden con tu filtro, no solo sobre las que ves. Lee tus condiciones antes de seleccionar todo y confirmar, porque una acción masiva no tiene deshacer.
</Warning>

## Cómo filtrar una tabla

<Steps>
  <Step title="Abre la tabla que quieres acotar">
    Desde `Catálogo`, entra a `Productos`, o abre cualquier otra lista. Justo arriba de las filas hay una barra con `Buscar`, `Columnas`, `Filtrar` y `Densidad`.
  </Step>

  <Step title="Abre el panel de filtros">
    Pulsa `Filtrar` en esa barra. Debajo del botón se abre un panel con una fila de filtro vacía esperándote.
  </Step>

  <Step title="Elige la columna que quieres acotar">
    Pon `Filtrar por`, la primera lista desplegable de la fila, en una columna como `Estado`.
  </Step>

  <Step title="Elige una condición">
    Pon `Operadores`, la lista de al lado, en una condición como `es`. Qué condiciones te ofrece depende de la columna que acabas de elegir.
  </Step>

  <Step title="Dale un valor a la condición">
    Escribe o elige tu respuesta en `Valor`, la última casilla de la fila. La tabla se acota apenas lo haces, y pulsar fuera del panel lo cierra otra vez.
  </Step>
</Steps>

Ese es todo el flujo. Tu tabla ahora tiene solo las filas que respondieron. Tu filtro también está en la barra de direcciones, así que lo que estás viendo ya es un enlace que puedes guardar o mandar.

Todo lo que sigue explica la barra un control a la vez, y después qué se guarda en el enlace cuando compartes el resultado. No necesitas nada de eso para acotar una tabla.

## Cada opción en detalle

La barra es igual arriba de cada tabla, así que las secciones de abajo la siguen de izquierda a derecha, y después pasan a las columnas y a las páginas que hay debajo.

### La barra que hay arriba de cada tabla

La barra es una sola fila que va entre la página y la primera fila de datos. Tiene cuatro controles, más los botones propios de esa tabla, como `Nuevo producto` en la tabla de productos.

| Control | Qué hace |
| --- | --- |
| `Buscar` | Acota la tabla por texto, sin que elijas columna ni condición |
| `Columnas` | Abre la lista de columnas, para que escondas las que no estás usando |
| `Filtrar` | Abre el panel de filtros, donde armas una condición sobre una columna |
| `Densidad` | Define qué tan altas son las filas. En una pantalla angosta no está en la barra |

**`Buscar` y `Filtrar` acotan la tabla los dos, y hay que distinguirlos.** Usa `Buscar` cuando más o menos sabes qué palabras buscas y quieres la respuesta de una. Usa `Filtrar` cuando la pregunta es exacta, y siempre que busques una ausencia. Por más que escribas en `Buscar`, ahí no puedes pedir un producto que no tiene costo.

### La casilla de búsqueda

`Buscar` se ve como una palabra suelta en la barra hasta que la pulsas, y entonces se convierte en una casilla donde escribes. La tabla se acota un momento después de que dejas de escribir, y no en cada letra. Un botón `Limpiar` aparece al lado apenas hay algo escrito, y pulsar `Esc` vacía la casilla y la vuelve a dejar como palabra.

Qué compara esa casilla lo decide la tabla en la que estás. En `Productos` lee el título del producto y los valores de tus identificadores, así que un `SKU` o un código de barras encuentra su producto. En las tablas más chicas lee las columnas que tienes enfrente.

Lo que escribes se compara como una sola frase y no como palabras sueltas. Así que `open box` encuentra las filas que tienen esas dos palabras juntas, y no todas las que tienen `open` en alguna parte.

Aquí no hay largo mínimo. Una sola letra ya busca, y esa es una diferencia con la [búsqueda](/es/pim/search) de todo el producto, donde nada corre por debajo de dos caracteres.

### Cómo armar una condición en el panel de filtros

Pulsa `Filtrar` en la barra y se abre un panel debajo del botón, con una fila de filtro. Una fila de filtro son tres listas desplegables una al lado de la otra y una × chica para tirar la fila.

| Parte de la fila | Qué haces con ella |
| --- | --- |
| `Filtrar por` | Elige la columna que quieres acotar. Algunas tablas ofrecen aquí campos que no son columnas en ninguna parte |
| `Operadores` | Elige la condición, como `contiene` o `esta vacío`. La lista cambia según la columna |
| `Valor` | Dale su respuesta a la condición. Una condición como `esta vacío` no necesita ninguna, así que la casilla no aparece |
| La × de la fila | Quita esa fila y deja las demás como estaban |

Abajo del panel hay dos botones. `Agregar filtro` te da otra fila, y `Remover todos` limpia todas las filas de un clic. No hay ningún botón que aplique lo que armaste, porque la tabla se acota mientras lo armas.

Hay una segunda entrada al mismo panel. Pasa el cursor por el encabezado de una columna, pulsa el menú de su borde derecho y elige `Filtro`. El panel se abre con `Filtrar por` ya puesto en esa columna, y te ahorra buscarla en una lista larga.

Puedes poner más de una condición sobre la misma columna. Dos filas de `contiene` sobre `Título` están permitidas, y una fila de `mayor que (>)` más una de `menor que (<)` sobre `Costo` es como pides un rango en lugar de un límite.

### Cómo combinar dos condiciones

Agrega una segunda fila al panel de filtros y arriba a su izquierda aparece una lista desplegable chica que dice `Y`. Es la elección entre acotar y ampliar, y aplica a todas las filas del panel y no a un par de ellas.

| Ajuste | Una fila se queda cuando |
| --- | --- |
| `Y` | Responde todas las condiciones del panel |
| `O` | Responde al menos una de ellas |

`Y` es lo que quieres casi siempre, porque cada condición que agregas baja más la lista. Cambia a `O` cuando estás juntando en vez de acotando: productos en borrador junto con productos archivados, en una sola lista, y no los productos que de algún modo son las dos cosas.

La lista desplegable no está en la primera fila, porque una condición sola no tiene con qué combinarse.

Las condiciones sobre columnas distintas se apilan igual que las de una sola columna, y pueden ser de tipos distintos. Así que cuatro filas en `Y` te dan todos los productos activos, de una categoría, sin costo, cambiados desde una fecha que elegiste.

### Qué condiciones ofrece cada tipo de columna

`Operadores`, la lista desplegable del medio de una fila de filtro, no ofrece lo mismo en todas las columnas. A una fecha y a un precio no se les pueden hacer las mismas preguntas, así que la lista se arma según el tipo de cosa que guarda la columna.

| Qué guarda la columna | Qué le puedes preguntar |
| --- | --- |
| Texto, como `Título` | Si contiene, empieza, termina, coincide o le falta un pedazo de texto |
| Un número, como `Costo` | Si es igual, mayor, menor, o no tiene ningún valor |
| Un conteo, como `Productos` en una marca | Lo mismo que un número, sin las condiciones de vacío |
| Una fecha, como `Última actualización` | Si está en, antes o después de un momento que eliges |
| Sí o no, como `Tiene variantes` | Solo cuál de los dos es |
| Una lista fija, como `Estado` | Si es un valor, no es un valor, o es alguno de varios |
| Una lista de registros, como `Marcas` | Esas tres, y si la fila tiene algún registro |
| Quién hizo un cambio, como `Creado por` | Una persona por su nombre, o la vía por la que llegó el cambio |

**Un conteo nunca falta**, porque una marca sin productos igual tiene un conteo y ese conteo es 0. Por eso una columna de conteo se queda sin las condiciones de vacío, y en su lugar pides `es igual a (=)` con el valor 0.

**`esta vacío` y `no esta vacío` son las dos que hay que aprender primero**, porque son la única forma de preguntar por algo que no está. Variantes sin costo, productos sin categoría, marcas que nadie usó. Cada una de esas es una fila del panel, y sin ella armarías la misma lista leyendo la tabla entera hasta el final.

<AccordionGroup>
  <Accordion title="Todas las condiciones de una columna de texto, en el orden en que aparecen">
    `contiene`, `no contiene`, `es igual`, `es diferente a`, `comienza con`, `termina con`, `esta vacío`, `no esta vacío`, `es cualquiera de`.

    `es cualquiera de` es la que hay que conocer. Te deja escribir varias respuestas en una sola fila y deja pasar la fila que coincide con cualquiera, lo que te ahorra armar tres filas y cambiar el panel a `O`.
  </Accordion>

  <Accordion title="Todas las condiciones de una columna de números, en el orden en que aparecen">
    `es igual a (=)`, `distinto de (≠)`, `mayor que (>)`, `mayor o igual que (≥)`, `menor que (<)`, `menor o igual que (≤)`, `está vacío`, `no está vacío`, `es alguno de`.

    Una columna de conteo muestra esa misma lista sin `está vacío` y sin `no está vacío`.
  </Accordion>

  <Accordion title="Todas las condiciones de una columna de fechas, en el orden en que aparecen">
    `es`, `no es`, `es posterior`, `es en o posterior`, `es anterior`, `es en o anterior`, `esta vacío`, `no esta vacío`.

    `es` y `no es` trabajan al minuto y no al día, porque el selector toma una hora además de una fecha. Para pedir un día entero, usa `es en o posterior` a su inicio y `es anterior` al día siguiente.
  </Accordion>
</AccordionGroup>

Hay un caso que se muestra en inglés aunque uses la app en español. En las columnas que guardan una lista de registros, como `Marcas` o `Categorías`, las condiciones son `is`, `is not`, `is any of`, `is empty` y `is not empty`.

### Qué escribes en Valor

`Valor`, la última casilla de una fila de filtro, no siempre es una casilla donde escribes. Cambia según la columna, así que nunca escribes una fecha a mano ni adivinas cómo se deletrea una marca.

| En este tipo de columna | `Valor` te da |
| --- | --- |
| Texto o un número | Una casilla donde escribes |
| Una fecha | Un selector de día y hora |
| Sí o no | Una lista desplegable con `Sí` y `No` |
| Una lista fija, como `Estado` | Una lista desplegable con los valores que puedes elegir |
| Una lista de registros, como `Marcas` | Una casilla que busca en tus registros mientras escribes y guarda lo que eliges como fichas |
| Una medida, como `Peso` | Una casilla para el número y una unidad al lado |

**Una medida es la que agarra a la gente desprevenida.** Tus pesos y tus tamaños se muestran en la unidad que usa tu organización, así que el filtro pone esa unidad junto a la casilla. Escribe 11, deja la unidad en `lb` y recibes las filas de más de 11 libras. Cambia la unidad después y el número se convierte solo, así que el filtro sigue pidiendo el mismo tamaño físico. Vuelve a un filtro guardado más tarde y se abre en la unidad de tu organización, sea cual sea la unidad en la que escribiste.

**Una lista desplegable nunca te ofrece el mismo valor dos veces en una columna.** Elige `Activo` en una fila y después agrega una segunda fila de `es` sobre `Estado`. `Activo` desaparece de su lista, así que no puedes armar dos filas que pregunten lo mismo.

### Cómo ordenar tus filas

Un filtro decide qué filas recibes y el orden decide en qué secuencia llegan. Pulsa el encabezado de una columna una vez para ordenarla hacia arriba, y otra vez para darla vuelta. Pulsando nunca vuelves a quedarte sin orden, así que para eso abre el menú del borde derecho del encabezado y elige `Desordenar`.

Mantén `Shift` mientras pulsas el encabezado de una segunda columna y se aplican los dos órdenes, y el que pusiste primero desempata.

### Cómo elegir qué columnas ves

`Columnas`, en la barra, abre la lista de todas las columnas que puedes apagar, cada una con su casilla. Arriba hay una casilla de búsqueda para las listas largas. Abajo hay dos controles: `Mostrar/Ocultar todas` da vuelta todas las casillas de una vez, y `Restablecer` deja la tabla como llegó.

Una columna que no está en esa lista no se puede apagar. `Título` en `Productos` es una de esas, y los campos que solo existen como filtros tampoco están ahí.

Esconder una columna no la saca de `Filtrar por`. Puedes acotar por una columna que no ves, y eso es justo lo que hace usables esos campos que solo son filtros.

### Cómo mover, ensanchar y fijar una columna

Arrastra el encabezado de una columna de lado para moverla. Arrastra la línea que hay entre dos encabezados para hacer una más ancha o más angosta, hasta 400 píxeles, y pulsa dos veces esa misma línea para ajustar la columna a lo que tiene adentro.

Fijar una columna la deja quieta mientras las demás se desplazan por debajo, y así es como mantienes un nombre a la vista mientras lees columnas del extremo derecho. Abre el menú del borde derecho del encabezado y elige `Anclar a la izquierda` o `Anclar a la derecha`. Te tocan 3 por lado, y una cuarta se rechaza con `Puedes fijar hasta 3 columnas por lado`.

### Cómo definir la altura de la fila y el tamaño de página

`Densidad`, en la barra, te da tres alturas: `Compacta`, `Estándar` y `Cómoda`. Elige `Compacta` cuando quieres la mayor cantidad de filas en pantalla, y `Cómoda` cuando las estás leyendo una por una en vez de hojearlas.

Abajo a la derecha de la tabla eliges cuántas filas tiene una página: 25, 50 o 100. Las tablas del catálogo y las de subidas abren en 50, y una tabla de reporte abre en 25.

Cambiar una condición o un orden te devuelve a la página 1, porque la página en la que estabas puede quedar sin nada bajo el filtro nuevo.

### Cómo filtrar en un teléfono

En una pantalla angosta la barra conserva `Buscar`, `Columnas` y `Filtrar`, y se queda sin `Densidad`. Los paneles dejan de flotar junto a su botón y en cambio suben desde abajo de la pantalla, encima de la tabla, y los cierras tocando fuera de ellos. Se ofrece un tamaño de página en vez de tres, y es 25.

### Límites

| Qué | Límite |
| --- | --- |
| Filas en una página | 25, 50 o 100 |
| Condiciones en una tabla | Sin límite |
| Condiciones en una columna | Sin límite |
| Columnas fijadas | 3 por lado |
| Cuánto puedes ensanchar una columna | 400 píxeles |
| Filas marcadas que aguanta un enlace | 200 |

### Lo que un filtro no puede hacer

| No puedes | Haz esto en su lugar |
| --- | --- |
| Guardar un filtro sin ponerle nombre | Guárdalo como una [vista guardada](/es/pim/saved-views) |
| Mandar el filtro de tu tabla a una exportación | Arma las mismas condiciones dentro de la [diálogo de exportación](/es/pim/uploads/exports), que tiene filtros propios |
| Sumar, agrupar o graficar las filas que coincidieron | Abre los [reportes](/es/pim/reports) |
| Acotar por todas las columnas, porque unas pocas están solo para leerse | Acota por una columna de al lado, o usa `Buscar` |
| Deshacer un cambio a la vez desde el panel | Usa el botón de atrás de tu navegador, porque cada cambio es un paso en la dirección |

## Qué se guarda en el enlace cuando compartes una tabla

Todo lo que pones en una tabla se guarda en la dirección, y eso convierte en un enlace la tabla que estás viendo. Cópiala de la barra de direcciones, mándala, y quien la abra recibe tus condiciones, tu orden, tu búsqueda y tu página.

Eso sí, no se guarda todo, y hay que leer la división antes de mandar una.

### Qué se guarda en el enlace

| Se guarda en el enlace | Se queda en tu propia computadora |
| --- | --- |
| Cada condición del panel | Qué columnas tienes a la vista |
| Si se combinan con `Y` o con `O` | Qué tan altas están tus filas |
| Lo que haya en la casilla de búsqueda | Qué ancho tiene cada columna |
| El orden, incluido un segundo orden | El orden en el que arrastraste las columnas |
| La página en la que estás, y cuántas filas tiene | Cuáles columnas fijaste |
| Las filas que marcaste | |

La columna de la izquierda habla de qué filas estás viendo y la de la derecha de cómo están dispuestas. Así que un colega que abra tu enlace lee exactamente tus filas, dispuestas en sus propias columnas y no en las tuyas.

Todo lo de la derecha se guarda por navegador y por tabla. Por eso la misma tabla puede verse de una forma en tu computadora y de otra en tu teléfono, sin que nada esté mal en ninguna de las dos.

### Cómo mandarle una selección a alguien

Las filas que marcas con la casilla de la izquierda de cada fila también se guardan, hasta 200. Pasadas las 200 las filas marcadas se quedan en tu pantalla y nunca llegan a la dirección, y nada te avisa. Tú conservas tu selección, y la persona a la que le mandaste el enlace abre la misma tabla sin nada marcado.

La casilla de la fila de encabezado que está arriba de todas es distinta. Esa selecciona todas las filas que coinciden con tu filtro, sean las que sean, y esa sí se guarda, porque lo que el enlace almacena es el filtro y no la lista de filas.

### Cómo guardar un filtro que armas seguido

Un enlace sirve para mandar algo una vez. Para el filtro que rearmas cada lunes, [las vistas guardadas](/es/pim/saved-views) son el control que lo conserva. Guardan la dirección entera bajo un nombre que tú eliges, y están en la barra de arriba de la tabla.

Un filtro también es sobre lo que corre un cambio masivo, así que [las acciones masivas](/es/pim/bulk-actions) y el panel de filtros se suelen usar uno después del otro.

## Cuando algo falla

### Tu tabla volvió vacía

| Qué ves | Qué significa |
| --- | --- |
| `No se encontraron resultados`, con `Intenta ajustar tu búsqueda o los filtros` debajo | Tus condiciones están bien armadas y ninguna fila las cumple. Afloja una, o cambia el panel a `O` |
| `No hay datos para mostrar` | No se filtró nada. La tabla misma está vacía, así que es el mensaje que recibes en un catálogo recién empezado |

### Una condición que olvidaste que pusiste

El botón `Filtrar` de la barra muestra un número chico al lado con cuántas condiciones hay puestas. Una tabla que se te ve rara suele ser una tabla con una condición que dejaste ahí. Pulsa `Filtrar`, lee las filas y usa `Remover todos`, abajo del panel, para limpiarlas todas de una vez.

Ese número solo cuenta una fila terminada. Una fila donde elegiste columna y te detuviste no entra en la cuenta, aunque siga ahí en el panel.

### Una fila que llenaste a medias

Una fila de filtro cuya condición necesita un valor y no lo tiene no acota nada, y la tabla no te lo dice. Tampoco desaparece. Pulsa `Filtrar` en la barra, busca la fila de filtro que tiene `Valor` vacío, y después termínala o quítala con la × de esa fila.

### Una columna que no puedes filtrar ni ordenar

Algunas columnas están solo para leerse: una imagen, o un resumen armado con otras columnas. No tienen menú en su encabezado y faltan en la lista `Filtrar por` de dentro del panel de filtros. Acota por una columna de al lado, como el nombre que va con esa imagen.

## A dónde ir después

<Columns cols={2}>
  <Card title="Vistas guardadas" icon="bookmark" href="/es/pim/saved-views">
    Guardar un filtro bajo un nombre en vez de rearmarlo cada semana.
  </Card>

  <Card title="Acciones masivas" icon="list-checks" href="/es/pim/bulk-actions">
    Qué le puedes hacer a las filas que te dejó un filtro.
  </Card>

  <Card title="Productos" icon="package" href="/es/pim/catalog/products">
    La tabla más grande, y los campos que te deja filtrar y no son columnas.
  </Card>

  <Card title="Búsqueda" icon="search" href="/es/pim/search">
    La otra búsqueda, la que llega a todos los tipos de registro a la vez.
  </Card>
</Columns>
