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

# La interfaz

> La barra lateral y la cabecera se ven igual en toda pantalla del PIM, y entre las dos te mueves, buscas, cambias de organización y llegas a tu cuenta.

Todas las pantallas del PIM llevan el mismo marco. Una barra lateral a la izquierda te lleva de una parte del producto a otra. Una cabecera arriba nombra dónde estás y guarda tu cuenta. Debajo de ella hay una franja para lo que el PIM necesita decirle a toda tu organización. Todo lo que queda abajo es la página que abriste, y es lo único que se desplaza.

Vas a usar el marco para dos cosas. La primera es llegar a algún lado, que son la barra lateral, la segunda lista dentro de una sección y la búsqueda de la cabecera. La segunda es todo lo que no es de una sola pantalla. Ahí entran en qué organización estás, con qué cuenta entraste, qué correos te llegan y qué pasó con una importación que dejaste corriendo.

El marco está en todas las pantallas y no hay nada que configurar. Se pliega en una ventana del navegador de menos de 900 píxeles de ancho, y en un teléfono, y cada sección de abajo dice qué se mueve.

## Antes de empezar

Tu rol decide dos cosas del marco, y nada más de esta página depende de él.

| Qué estás buscando | El rol que necesitas |
| --- | --- |
| `Integraciones` en la barra lateral | Administrador |
| `Fuentes de datos` en la lista de `Importar/Exportar` | Gerente o Administrador |

Así que la barra lateral tiene seis entradas para quien es Administrador y cinco para el resto. Tu rol se define por organización y por producto, y por eso la misma cuenta puede ver esas dos entradas en una organización y ninguna en otra. Los roles se asignan en [equipo, roles y permisos](/es/team).

## Cómo moverte por la app

<Steps>
  <Step title="Elige una sección en la barra lateral">
    La barra lateral corre por la izquierda de todas las pantallas. Pulsa una de sus entradas: `Inicio`, `Catálogo`, `Recursos`, `Reportes`, `Importar/Exportar` o `Integraciones`. La que estás viendo se queda marcada mientras trabajas.
  </Step>

  <Step title="Elige una página en la lista propia de la sección">
    `Catálogo` e `Importar/Exportar` abren con una segunda lista, entre la barra lateral y la página. Pulsa una entrada de esa lista, como `Marcas` dentro de `Catálogo`.
  </Step>

  <Step title="Busca en lugar de pulsar">
    `Buscar` está en el extremo derecho de la cabecera, y está en todas las pantallas. Púlsalo, o presiona `Ctrl+K`, que en Mac se muestra como `⌘K`.
  </Step>

  <Step title="Abre tu cuenta desde el avatar">
    Tu avatar es el círculo del extremo derecho de la cabecera. Púlsalo para llegar a `Documentación`, `Sugerencias`, `Página principal`, `Configuración` y `Cerrar sesión`.
  </Step>
</Steps>

Ese es todo el marco. Dos listas de la izquierda te llevan a una pantalla, y la cabecera te lleva a la búsqueda y a tu cuenta. Lo que el PIM necesita decirte llega solo.

Todo lo que sigue explica esas piezas una por una, y las dos últimas secciones cubren los avisos que aparecen sobre tu página. No necesitas nada de eso para moverte.

## Cada opción en detalle

### La barra lateral

La barra lateral corre por la izquierda de todas las pantallas, con tu organización arriba y las secciones del PIM debajo. Una barrita marca la entrada en la que estás.

Las entradas y su orden son fijos. No puedes agregar una, esconder una, cambiarle el nombre ni arrastrarla a otra posición, y ninguna configuración del PIM cambia eso.

Qué tiene cada sección, y a cuáles llega tu rol, es la tabla de [cómo empezar con el PIM](/es/pim/index).

### La segunda lista dentro de una sección

Dos secciones abren con una lista propia, entre la barra lateral y la página. Esa lista es como llegas a las pantallas de dentro de la sección.

| Sección | Qué tiene su propia lista |
| --- | --- |
| `Catálogo` | `Productos`, `Marcas`, `Categorías`, `Etiquetas` y `Especificaciones` |
| `Especificaciones`, que a su vez es una entrada de `Catálogo` | Una tercera lista: `Grupos`, `Definiciones` y `Valores` |
| `Importar/Exportar` | `Importaciones` y `Exportaciones`, más `Fuentes de datos` para Gerente y Administrador |

`Importaciones` y `Exportaciones` se intercambian sin cargar la página, así que moverte entre esas dos es instantáneo. Las demás entradas de estas listas abren una página propia.

El título de la página en la cabecera sigue a esta lista y no a la barra lateral. Abre `Marcas` dentro de `Catálogo` y la cabecera dice `Marcas`, no `Catálogo`.

### Cambiar de organización

La tarjeta de más arriba de la barra lateral es el selector de organización. Muestra el nombre de la organización en la que trabajas, una insignia y un par de flechitas.

Pulsa esa tarjeta y se abre un panel bajo un encabezado que dice `Organizaciones`, con todas las organizaciones donde está tu cuenta. Una palomita está junto a la que ya tienes abierta, y esa fila no se puede pulsar.

Pulsa cualquier otro nombre y el PIM se cambia a esa. Tu catálogo, tus recursos, tus importaciones, tus integraciones y tus reportes cambian a la vez, porque todo en el PIM es de una sola organización.

`Crear organización` está al final de ese mismo panel. Pulsarlo te manda a la app de cuenta, porque las organizaciones se crean allá y no aquí.

<Note>
  Tu rol se define por organización y por producto, así que cambiar puede cambiar lo que trae tu barra lateral. Una cuenta que es Administrador en una organización y Editor en otra pierde la entrada `Integraciones` al cruzar.
</Note>

<Accordion title="Qué te está diciendo la insignia que está junto al nombre de tu organización">
  La insignia nombra lo que tiene la organización. Dice `Prueba` mientras corre un periodo de prueba, y `Gratis` cuando la organización no tiene ningún plan de pago. Si no, nombra el plan, y [planes y facturación](/es/billing) explica de dónde sale ese nombre.
</Accordion>

### La cabecera

La cabecera corre por la parte de arriba de todas las pantallas, a la derecha de la barra lateral. Nombra dónde estás a la izquierda y guarda tu cuenta a la derecha.

| Control | Dónde está | Qué hace |
| --- | --- | --- |
| El título de la página | En el extremo izquierdo | Nombra la pantalla en la que estás, y se mantiene al día mientras te mueves |
| El control propio de la pantalla | A la derecha del título | Una tabla pone ahí su selector de [vistas guardadas](/es/pim/saved-views) en cuanto guardas una vista, y `Reportes` pone ahí su rango de fechas. Casi todas las pantallas dejan ese espacio vacío |
| `Buscar` | A la derecha de ese control | Abre [la búsqueda](/es/pim/search) sobre todo tu catálogo |
| El acceso a las apps | A la derecha de `Buscar` | Un botón de cuadritos, llamado `Herramientas`. Abre el lanzador de Ready for Commerce en la app de cuenta |
| Tu avatar | En el extremo derecho | Abre el menú de abajo |

### El menú del avatar

Tu avatar es el círculo del extremo derecho de la cabecera, con tus iniciales. Púlsalo y se abre un menú corto.

| Elemento | A dónde te lleva |
| --- | --- |
| Tu nombre, con tu rol debajo | Tu perfil en la app de cuenta |
| `Documentación` | Esta documentación |
| `Sugerencias` | El formulario que está más abajo en esta página |
| `Página principal` | El sitio de Ready for Commerce |
| `Configuración` | La configuración propia del PIM, más abajo en esta página |
| `Cerrar sesión` | Termina tu sesión |

El nombre de arriba es tu nombre y tu apellido, o tu correo electrónico si todavía no pusiste un nombre, con tu rol en el PIM debajo.

**`Configuración` y `Sugerencias` se abren sobre la página** en vez de sacarte de ella. Lo que tuvieras abierto se queda abierto detrás, y `Esc` las cierra de nuevo.

**`Cerrar sesión` te saca de todas las apps de Ready for Commerce**, no solo del PIM, y te deja en la pantalla de inicio de sesión. Volver a entrar te devuelve todas.

<Accordion title="Mandarle a alguien un enlace directo a la configuración o al formulario de sugerencias">
  Las dos diálogos tienen su propia dirección aunque se abran sobre la página, así que cualquiera de las dos se puede pegar en un mensaje para un colega.

  El formulario de sugerencias va más lejos y llena su `Tipo`, su `Prioridad` y su `Asunto` con lo que traiga esa dirección, así que un enlace puede llegar con el formulario ya empezado.

</Accordion>

### Elegir claro u oscuro, y qué correos te llegan

`Configuración`, en el menú del avatar, abre un diálogo con dos secciones listadas a su izquierda: `Notificaciones` y `Apariencia`. Esas dos son todo lo que el PIM guarda sobre ti. Tu nombre, tu equipo, tu organización y tu plan están en la app de cuenta.

**`Apariencia` tiene un control**, `Modo de color`, con `Claro`, `Oscuro` y `Sistema`, donde `Sistema` sigue lo que tenga puesto tu computadora. La cabecera no lleva ningún interruptor para esto, así que `Apariencia` es el único lugar donde se pone.

Tu elección se guarda en el navegador que estás usando y no en tu cuenta, así que no te sigue a otra computadora.

**`Notificaciones` tiene cuatro interruptores**, en dos grupos. Los cuatro vienen encendidos, los cuatro se pueden apagar, y cada uno se guarda en cuanto lo mueves.

| Grupo | Los interruptores que tiene |
| --- | --- |
| `Integraciones y sincronización` | `Problemas de conexión` y `Errores de sincronización` |
| `Sistema` | `Exportación lista` e `Importación completada` |

<Accordion title="De qué te manda un correo cada uno de los cuatro interruptores">
  | Interruptor | Recibes un correo cuando |
  | --- | --- |
  | `Problemas de conexión` | Una cuenta conectada necesita reconectarse o volver a autorizarse |
  | `Errores de sincronización` | Una sincronización de tu catálogo o de tus datos se topa con un problema |
  | `Exportación lista` | Una exportación que pediste está lista para descargar |
  | `Importación completada` | Termina una importación |
</Accordion>

Esos cuatro cubren lo que hace el PIM. El correo que Ready for Commerce te manda sobre tu cuenta, tu equipo y tu facturación es otro juego de interruptores, en la app de cuenta, y está listado en [perfil y preferencias](/es/profile).

### Enviarnos sugerencias

`Sugerencias`, en el menú del avatar, abre un diálogo llamado `Enviar sugerencias`. Es la única forma de escribirnos desde dentro del PIM, que no lleva chat ni botón de ayuda.

| Campo | Qué pones ahí |
| --- | --- |
| `Tipo` | `Reporte de error`, `Solicitud de función`, `Mejora`, `Pregunta` u `Otro` |
| `Prioridad` | `Baja`, `Media`, `Alta` o `Crítica` |
| `Asunto` | Una línea que lo resuma |
| `Descripción` | Qué pasó, o qué te gustaría |
| `Adjuntos` | Capturas de pantalla, una grabación o un PDF, soltados en la casilla o elegidos de tu computadora. `Desde URL` agrega uno por dirección |

Todo lo que está arriba de los adjuntos es obligatorio. `Enviar` lo manda y `Cancelar` cierra sin mandar nada. Mientras se está enviando no puedes cerrar el diálogo, así que `Esc` y pulsar fuera dejan de funcionar hasta que termina.

Lo que mandas nos llega como un correo, y va en un solo sentido. No hay número de ticket, no hay nada que revisar después y no hay respuesta dentro de la app.

<Accordion title="Todos los tipos de archivo que puedes adjuntar">
  `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.mp4`, `.webm`, `.mov` y `.pdf`.

  Suelta cualquier otro en la casilla y se rechaza ahí mismo, con un mensaje que lista lo que sí se acepta.

</Accordion>

### En un teléfono o una ventana angosta

Por debajo de 900 píxeles de ancho el marco se pliega, y se vuelve a abrir en cuanto el diálogo da para eso.

| Qué | A dónde se va |
| --- | --- |
| La barra lateral | Detrás de un botón de menú, arriba a la izquierda de la cabecera. Se cierra sola en cuanto eliges algo |
| La lista propia de una sección | Detrás del título de la página, que se convierte en un botón con una flechita. Presiónalo y la lista sube desde abajo de la pantalla |
| El control propio de la pantalla | Se queda junto al título |

### Límites

| Qué | Límite |
| --- | --- |
| Un asunto de sugerencias | 200 caracteres |
| Una descripción de sugerencias | 5.000 caracteres |
| Adjuntos en un mensaje | 5 |
| Un adjunto | 10 MB |
| Cuánto dura un aviso al pie de la pantalla | 5 segundos |
| Dónde se pliega el marco | 900 píxeles de ancho |

### Lo que la interfaz no puede hacer

| No puedes | Haz esto en su lugar |
| --- | --- |
| Reordenar, renombrar ni esconder una entrada de la barra lateral | Nada. Las entradas y su orden son iguales para todo el mundo |
| Cambiar entre claro y oscuro desde la cabecera | Abre `Configuración` desde el menú del avatar y entra a `Apariencia` |
| Cerrar un banner | Resuelve lo que nombra y el banner se va solo |
| Leer un aviso del pie de la pantalla después de que se va | Enciende el correo que corresponde en `Configuración`, dentro de `Notificaciones` |
| Crear una organización aquí | `Crear organización`, en el selector, te manda a la app de cuenta |
| Cambiar aquí tu nombre, tu equipo, tu organización o tu plan | Los cuatro están en la app de cuenta |
| Darle seguimiento a una sugerencia que mandaste | Manda otra |

## Lo que aparece sobre tu página

Hay dos clases de aviso que te llegan estés donde estés en el PIM, y ninguna de las dos depende de la pantalla que tengas abierta.

Un banner se ubica en una franja entre la cabecera y tu página, y se queda ahí hasta que se resuelve lo que nombra. Un aviso corto aparece al pie de la pantalla cuando termina algo que corría en segundo plano, y se va solo.

Cuando no aplica ningún banner no hay franja, así que casi todos los días no vas a ver ninguno de los dos.

### Los banners de facturación

Se muestra un banner de facturación a la vez, y es el más grave de los que apliquen en ese momento. Aquí están en ese orden, del más grave para abajo.

| Título | Aparece cuando |
| --- | --- |
| `Suscripción cancelada` | La suscripción se canceló y el producto queda bloqueado |
| `Pago fallido` | El pago está vencido |
| `Periodo de prueba terminado`, o `Suscripción pausada` | Se acabó la prueba, o la suscripción se pausó por otra razón |
| `Tu prueba termina mañana` | Queda 1 día de prueba y no hay método de pago registrado |
| Un título que cuenta los días de prueba que quedan | Quedan entre 2 y 7 días y no hay método de pago registrado |

Los dos últimos son los únicos que puedes evitar antes de que lleguen. Agrega un método de pago y ninguno de los dos aparece.

**El banner lo ve todo el mundo de la organización.** Quien es Administrador lo recibe con un botón encima. Ese botón dice `Agregar pago`, `Actualizar pago` o `Administrar facturación` según el estado, y los tres abren la app de cuenta.

El resto lee la misma advertencia con una línea que le pide contactar a quien sea Propietario de la organización, la única persona que puede cambiar una suscripción.

A una organización bloqueada no se la echa del producto. Te quedas con la app, en el estado que permita la suscripción, y el banner tiene el mensaje completo. Qué detiene cada estado está trabajado en [planes y facturación](/es/billing).

### Los banners de cobertura del Repricer

Otros dos banners aparecen solo para quien es Administrador, y solo cuando tu PIM y tu Repricer no coinciden sobre una cuenta conectada. Cada uno nombra las cuentas de las que habla.

| Título | Aparece cuando | El botón que lleva |
| --- | --- | --- |
| `Activa la integración con el Repricer` | La misma cuenta conectada está conectada en los dos productos mientras el vínculo entre ellos está apagado, así que los dos publican precios en el mismo sitio y pueden pisarse | `Activar integración`, que abre aquí la integración con el Repricer |
| `Integración conectada solo en el Repricer` | Una cuenta conectada existe en el Repricer y aquí no, así que las dos no se pueden emparejar | `Conectar integración`, que va directo a la pantalla de conexión de esa integración. Cuando hay más de una integración de por medio dice `Ver integraciones` y te lleva a la lista |

Los dos esperan mientras haya un banner de facturación, y aparecen en cuanto ese se va.

Ningún banner de ninguno de los dos tipos tiene botón de cerrar, y ninguno necesita que recargues. La franja resuelve sola lo que aplica, dentro del minuto siguiente a cualquier cambio.

### Los avisos al pie de la pantalla

Lo que corre en segundo plano se anuncia con un aviso corto al pie de la pantalla, en la página en la que estés. El aviso se va solo a los 5 segundos.

| Aviso | Aparece cuando |
| --- | --- |
| `Importación completada`, `Importación fallida` o `Importación cancelada` | Termina una importación de archivo |
| `Exportación completada`, `Exportación fallida` o `Exportación cancelada` | Termina una exportación |
| `Sincronización completada`, `Sincronización fallida` o `Sincronización cancelada` | Termina una sincronización con una integración |
| `Acción masiva completada`, `Acción masiva fallida` o `Acción masiva cancelada` | Termina una acción masiva sobre una selección |

Una falla se muestra como error y una cancelación como información normal, y ninguna de las dos te frena lo que estés haciendo.

**Estos avisos cubren a toda tu organización**, no solo lo tuyo. La importación de un colega al terminar levanta uno en tu pantalla también, y por eso puedes ver uno de algo que tú no empezaste.

**Una acción masiva que empezaste y te quedaste mirando** se anuncia con el aviso que ya te venía mostrando su avance. Este otro solo aparece si te habías ido a otra pantalla antes de que terminara.

<Note>
  Un aviso solo aparece si tienes el PIM abierto cuando eso termina. No se guarda nada y no hay historial, así que el correo es lo que te avisa de algo que terminó mientras no estabas.
</Note>

## Cuando algo falla

### Un banner sigue ahí después de arreglarlo

La franja resuelve lo que aplica dentro de un minuto, así que dale ese tiempo antes de recargar. Si el banner sigue ahí después de eso, lo que nombra sigue siendo cierto. O el método de pago que agregaste en la app de cuenta no se aceptó, o la cuenta del Repricer que señala todavía no está conectada aquí.

### Un mensaje en el formulario de sugerencias

| Mensaje | Qué hacer |
| --- | --- |
| `Este campo es obligatorio` | Dejaste vacío `Asunto` o `Descripción`. Llénalo |
| `Valor inválido` | Dejaste `Tipo` o `Prioridad` sin elegir. Elige uno de cada uno |
| `Debe tener al menos 3 caracteres` | Tu `Asunto` es demasiado corto |
| `Debe tener al menos 10 caracteres` | Tu `Descripción` es demasiado corta |
| `Tipo de archivo no aceptado`, con la lista de los que sí | El archivo no es de los tipos listados más arriba. Conviértelo, o descríbelo con palabras |
| `El archivo es demasiado grande`, con un tamaño | El archivo pasa de 10 MB. Manda una grabación más corta, o una captura |
| `Se alcanzó el número máximo de archivos` | Ya adjuntaste 5. Quita uno primero |
| `No se pudo enviar la sugerencia.` | No se mandó nada, así que intenta de nuevo |
| `Algo salió mal. Inténtalo de nuevo.` | No se mandó nada, así que intenta de nuevo |

Cuando sí se manda, un aviso al pie de la pantalla te lo dice y el diálogo se cierra sola.

### Un interruptor de notificaciones no se queda como lo dejas

`No se pudo actualizar la preferencia` aparece al pie de la pantalla y el interruptor vuelve a donde estaba. No se guardó nada, así que muévelo otra vez.

Si en lugar de los interruptores toda la sección muestra `No se pudieron cargar las preferencias de notificaciones`, cierra `Configuración` desde el menú del avatar y vuelve a abrirla.

### Nadie te avisó de que terminó una importación o una exportación

No tenías el PIM abierto en el momento en que terminó, y de esos avisos no se guarda ningún historial. El correo es la parte que te llega de todos modos.

Abre `Configuración` desde el menú del avatar, entra a `Notificaciones` y enciende `Importación completada` y `Exportación lista`.

## A dónde ir después

<Columns cols={2}>
  <Card title="Cómo empezar con el PIM" icon="compass" href="/es/pim/index">
    Qué tiene cada una de las seis secciones, y a cuáles llega tu rol.
  </Card>

  <Card title="Búsqueda" icon="search" href="/es/pim/search">
    Qué cubre `Ctrl+K` dentro de tu catálogo, y qué deja fuera.
  </Card>

  <Card title="Equipo, roles y permisos" icon="users" href="/es/team">
    Los roles que deciden qué trae tu barra lateral.
  </Card>

  <Card title="Planes y facturación" icon="credit-card" href="/es/billing">
    Qué detiene cada estado de banner y qué no.
  </Card>
</Columns>
