> ## 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.
# Problemas de sincronización
> Un producto puede verse terminado en tu catálogo y aun así faltar en una integración, y aquí el PIM anota el motivo y qué tienes que cambiar.
Un problema de sincronización es el PIM avisándote de que uno de tus productos no llegó a una de tus integraciones, o llegó y volvió con una queja. Cada problema es de un producto en una cuenta, y el PIM lo anota en ese producto.
Vienes aquí porque nada de esto se anuncia solo. Un producto puede verse terminado en tu catálogo y no estar en una tienda donde vendes, o estar allá sin precio. La única señal es un punto de color, y esta página es cómo lees ese punto, encuentras la frase que hay detrás y averiguas qué cambiar.
Todo lo que necesitas está en el producto. Abre uno desde `Catálogo` y verás una fila de logos de integración arriba del editor, junto al título, un logo por cada integración que tengas conectada. Cada logo lleva un punto de color pequeño, y al pasar el cursor por el logo se abre un panel que dice con palabras qué significaba ese color.
Esa misma fila de logos también está en una marca y en una categoría, así que todo lo de abajo se lee igual en esas.
## Antes de empezar
| Tu rol | Qué puedes hacer aquí |
| --- | --- |
| `Administrador` | Leer cualquier insignia, arreglar el producto, y reconectar o resincronizar una cuenta |
| `Gerente`, `Editor` | Leer cualquier insignia y arreglar el producto |
Los roles se asignan en [equipo, roles y permisos](/es/team#qué-puede-hacer-cada-rol-del-pim).
Nada te avisa por correo cuando un producto no logra publicarse. Un producto puede dejar de venderse en una integración y quedarse así hasta que alguien lo abra y mire el punto.
## Cómo averiguar por qué un producto no está en una integración
Pulsa `Catálogo` en la barra lateral, que abre en la tabla `Productos`, y pulsa la fila del producto que estás revisando. Se abre el editor, con una fila de logos de integración arriba, junto al título.
Cada logo tiene un punto de color pequeño en la esquina. El verde significa que esa integración no necesita nada de ti. El rojo y el naranja son los dos colores que hay que abrir.
Pasa el cursor por ese logo. Se abre un panel con una sección por cada cuenta que tengas en esa integración, y la primera fila de cada sección, `Estado de sincronización`, escribe el color con palabras.
Debajo de `Estado de sincronización`, el panel escribe qué pasó. Una fila `Problemas al enviar` significa que una parte de lo que mandaste no pudo salir. Una fila `Restricciones` significa que una regla de la integración está frenando el producto. Una fila `Avisos` o `Error al leer` significa que la integración devolvió algo.
Arregla el campo que nombra el mensaje, en cualquier parte del editor de producto, y pulsa `Guardar`. Guardar vuelve a poner ese producto en cola en todas las integraciones, y la insignia se mueve sola.
Ese es todo el flujo. Casi todos los problemas de sincronización son un campo de un producto, y guardar es todo el reintento que hay, porque no existe ningún botón que repita el mismo envío.
Todo lo que sigue es la lista completa de lo que puede decir la insignia, qué pide cada tipo de mensaje, y a dónde ir cuando la respuesta no está en el producto. No necesitas nada de eso para un mensaje que nombra un campo.
## Cada opción en detalle
### Qué significa el color del punto
El punto es lo más rápido de leer de la página, y cinco colores son todo el vocabulario.
| Color | Qué te está diciendo |
| --- | --- |
| Verde | Tu producto está en esa integración y nada te necesita |
| Azul | El PIM lo está publicando ahora, o está esperando su turno |
| Gris | Ahí no se está publicando nada, y no hay ningún problema detrás |
| Naranja | Tu producto está publicado y una parte no es la que mandaste |
| Rojo | Tu producto no está publicado, o la integración no lo quiere mostrar |
**Solo se muestra un estado a la vez**, y el panel elige el más grave que tenga. Así que un estado naranja puede estar debajo de uno rojo y aparecer recién cuando resuelvas el rojo. Arregla lo que te muestre el panel, guarda, y vuelve a mirar.
**Un logo cubre todas las cuentas que tengas en esa integración**, y su punto te muestra la peor de ellas. Dos tiendas de Shopify donde una está limpia y la otra está fallando te dan un punto rojo, y el panel de abajo trae una sección por cada una para que sepas cuál es.
El azul y el gris son los estados donde el PIM está trabajando o donde le dijiste que no. [Envío](/es/pim/integrations/push) los lista todos, junto con qué pone un producto en cada uno.
### Los estados que te piden cambiar algo
Estos son los rojos. Tu producto no se vende en esa cuenta hasta que resuelvas uno de ellos.
| Qué dice `Estado de sincronización` | Qué pasó | Qué hacer |
| --- | --- | --- |
| `Falló` | El último envío fue rechazado y no se escribió nada | Lee `Problemas al enviar`, cambia lo que nombra, y guarda |
| `3 variantes fallaron` | El producto pasó y esa cantidad de variantes no | Lee `Problemas al enviar`, que nombra cada variante por su SKU |
| `Bloqueado` | Una regla de la integración detuvo el envío antes de que saliera nada | Lee `Restricciones`, que nombra la regla |
| `Falló la lectura` | La primera sincronización no pudo tomar este producto | Lee `Error al leer`, arregla ese campo aquí, y el siguiente envío que pase lo limpia |
| `Rechazado por la integración` | La integración tiene tu producto y se niega a mostrarlo | Lee `Restricciones`, que te da el veredicto y el campo detrás de él |
| `Necesita volver a autenticarse` | La conexión venció o fue revocada | Reconecta la cuenta en la pantalla de [integraciones](/es/pim/integrations) |
| `Error en la cuenta` | La cuenta se apagó tras algo de lo que no puede recuperarse | Elimínala y conecta una nueva, en esa misma pantalla |
Los dos últimos son de la conexión y no de tu producto, así que todos los productos de esa cuenta están detenidos igual y ninguno se moverá hasta que arregles la cuenta.
### Los estados que son solo una advertencia
Estos son los naranjas. Tu producto está publicado, y algo de él no es lo que mandaste.
| Qué dice `Estado de sincronización` | Qué pasó | Qué hacer |
| --- | --- | --- |
| `Necesita atención` | El envío llegó y una parte de lo que mandaste se cambió o se descartó | Lee `Avisos` |
| `4 campos necesitan atención` | Esa cantidad de campos tiene algo que decir | Lee `Avisos`, que [extracción](/es/pim/integrations/pull) explica línea por línea |
| `La publicación necesita atención` | La integración tiene tu producto y no lo está mostrando completo | Arréglalo en el panel de esa integración |
Una insignia naranja hay que leerla y casi nunca es urgente. El caso común es un precio. Una cuenta cuyas fuentes de precio no resolvieron nada se queda con el precio que ya tenía, así que la publicación sigue viva con el número viejo. En el panel te enteras de que el nuevo nunca salió.
Solo dos de ellas reportan algo sobre una publicación, y son las dos donde otra persona decide si tu producto se muestra.
En Amazon, la fila `Estado por variante` del panel te da el estado de cada variante: `Publicado` cuando se ve y se puede comprar, `No se puede comprar` cuando la gente la ve y no la puede comprar, `No aparece en búsquedas` cuando la puede comprar y no la encuentra, `Inactivo` cuando no pasa ninguna de las dos, y `Desconocido` cuando Amazon no describe nada. Ninguno de ellos pone tu insignia en naranja por sí solo, porque cada uno dice en qué punto va tu oferta y no que algo esté mal. Lo que sí la pone en rojo es que Amazon se niegue a llevar el producto, y eso se lee `Bloqueado`.
En Google, `Limitado` se lee como `La publicación necesita atención` y `Rechazado` se lee como `Rechazado por la integración`. Esos dos son los únicos estados de publicación, en cualquiera de los dos productos, que mueven la insignia por sí solos.
Shopify, Square y BigCommerce publican lo que les mandas y nunca devuelven un veredicto, así que un producto tuyo o está en ellas o no está.
### Qué te pide cambiar un mensaje
Cada mensaje nombra la integración que lo produjo, así que siempre sabes a qué tienda ir a mirar. Hay cinco tipos, y el tipo te dice dónde está el arreglo.
| El mensaje | Qué significa | Dónde lo arreglas |
| --- | --- | --- |
| Un campo con nombre fue rechazado | El valor salió y la integración no lo quiso tomar | El campo, en tu editor de producto |
| Falta algo que la integración necesita | Tu producto no tiene ningún valor que la integración pueda usar ahí | El campo, o la [configuración](/es/pim/integrations/settings) de la cuenta para que salga otro |
| Se llegó a un límite del lado de la integración | La integración pone un tope, y tu producto o tu tienda ya lo pasó | El producto, o el panel de la integración |
| Un valor se acortó o se descartó al salir | El envío llegó y ese valor no llegó completo | El campo, si prefieres que salga completo |
| La integración desaprobó tu producto | Lo tiene todo y aun así no lo va a mostrar | El panel de esa integración |
**Lee la primera palabra del mensaje.** Te dice si el arreglo es tuyo. Un mensaje que abre con el nombre de la integración es esa integración rechazando un valor, como un precio o un código de barras que no aceptó. Un mensaje que abre con «No hay precio disponible» o «Google requiere» es tu producto al que le falta algo, y ese siempre te toca llenarlo a ti.
Casi todas las fallas son una de estas, y cada una es siempre el mismo mensaje.
| Integración | Sin esto no publica |
| --- | --- |
| Shopify | Un handle de URL que ningún otro producto de la tienda use, y un precio en el primer envío. Acepta como máximo 3 opciones por producto |
| BigCommerce | Un nombre, un precio, un SKU y un slug de URL que acepte |
| Amazon | Una coincidencia con un ASIN, más un precio, una cantidad de existencias y una condición que acepte |
| Square | Un nombre, un precio y una moneda que acepte |
| Google | Una imagen, un título, un SKU en la variante, un precio mayor que cero, y una dirección para la página del producto |
La dirección de Google sale del sitio web que configuraste en la cuenta, no del producto, y su mensaje te lleva directo a la configuración de esa cuenta. Google también rechaza una cuenta cuya moneda no sea la de tu catálogo.
Sea cual sea el identificador que una cuenta manda como SKU, tiene que tener valor y tiene que ser único. Cambia cuál es en `Elige qué identificador recibe la integración`, dentro de [configuración](/es/pim/integrations/settings#elige-qué-identificador-recibe-la-integración).
Casi todos los mensajes están escritos en el idioma que estás usando. Unos pocos no, y son los que vienen de fuera del producto mismo: una marca o una categoría que no logró publicarse, y una falla de la conexión o de la moneda.
Esos llegan como una frase en inglés dentro de `Problemas al enviar`. Cuando pasa, tu producto no tiene nada malo, y la frase igual nombra qué cambiar.
### Volver a enviar después de arreglarlo
**Guardar el producto es el reintento.** Cambia lo que nombraba el mensaje, pulsa `Guardar`, y el PIM vuelve a encolar ese producto en todas las integraciones unos segundos después. La insignia pasa a `Pendiente de actualizar`, y de ahí a `Sincronizado` o de vuelta a `Falló` si el arreglo no era el correcto.
**Nada reintenta una insignia roja por su cuenta.** El PIM reintenta un problema pasajero varias veces antes de rendirse, y una insignia que llegó a `Falló` significa que dejó de intentar. Así que la respuesta a una insignia roja siempre es cambiar algo y nunca esperar.
**Cuando el arreglo es una configuración y no un campo**, guardar el producto no basta, porque esa configuración decide qué arma el envío. Abre la cuenta desde la pantalla de [integraciones](/es/pim/integrations), pulsa `Configuración`, guarda tu cambio, y responde `Resincronizar ahora` cuando te pregunte. Eso encola todos los productos de esa cuenta, incluidos los que fallaron. Esa pantalla solo la ve quien tiene rol `Administrador`.
### Ver a cuántos productos les pasa
El panel de un producto te habla de ese producto y de ningún otro. Para un conteo de todo tu catálogo, pulsa `Reportes` en la barra lateral y abre la tarjeta [Integraciones](/es/pim/reports/integrations).
| Qué te muestra | Qué cuenta |
| --- | --- |
| `Envíos fallidos` | Publicaciones cuyo último envío fue rechazado, en todas las cuentas |
| `Fallidos` y `Pendientes`, en la tabla por proveedor | Los mismos dos conteos, separados por integración |
| `Resultados de envío` | Todos los intentos de envío de tu rango de fechas, según cómo terminaron |
| `Cuentas que necesitan atención` | Cuentas con error, que necesitan reautenticación, o pausadas |
Esa tarjeta aparece recién cuando conectas una cuenta, y solo la abre quien tiene rol `Administrador`. Los conteos son números y no listas, así que úsalos para saber si tienes un problema, y después ve a los productos mismos.
### Límites
| Qué | Límite |
| --- | --- |
| Mensajes que muestra el panel antes de decir `+N más` | 5 |
| Veces que se reintenta un problema pasajero antes de pasar a `Falló` | 3 |
| Intentos anteriores que puedes leer en un producto | Ninguno |
### Lo que no puedes hacer aquí
| No puedes | Haz esto en su lugar |
| --- | --- |
| Listar los productos que están fallando | Abre el reporte de [Integraciones](/es/pim/reports/integrations) para un conteo, y revisa los productos que cambiaste hace poco |
| Reintentar un envío desde la insignia | Arregla lo que nombra el mensaje y guarda el producto |
| Reintentar todos los envíos fallidos de una vez | Guarda la [configuración](/es/pim/integrations/settings) de la cuenta y responde `Resincronizar ahora` |
| Leer los mensajes que un producto recibió la semana pasada | Nada. El panel guarda solo el último intento |
| Leer el texto completo de un mensaje que el panel acortó | Nada. Arregla los 5 que te muestra y guarda, y el resto llega después |
| Recibir un correo cuando un producto falla | Nada. Abre el producto y lee la insignia |
| Filtrar u ordenar tu tabla `Productos` por estado de sincronización | Nada. El estado está solo en el editor de producto |
## Qué guarda el panel
### El panel guarda el último intento y nada de antes
Cada envío sobrescribe lo que dejó el anterior. Así que un producto que falló dos veces por dos motivos distintos te muestra el segundo motivo, y el primero ya no está.
Eso importa sobre todo cuando arreglas una cosa y detrás falla otra. Un `Falló` que vuelve enseguida después de guardar suele ser un segundo problema y no el mismo, así que lee el mensaje de nuevo en lugar de dar por hecho que tu arreglo no entró.
### Un mensaje se resuelve solo cuando el siguiente intento sale limpio
En el PIM nada se resuelve a mano, y no hay nada que descartar. Arregla el valor, guarda, y el mensaje se va cuando el envío que sigue no dice nada de él.
Lo mismo pasa al revés. Un mensaje que devolvió la integración se resuelve en la siguiente extracción que encuentre el valor sano. Así que una publicación que arreglaste en Merchant Center o en Seller Central se pone verde aquí en la próxima extracción y no antes.
## Cuando algo falla
### Una insignia roja que no se resuelve
Revisa estas cuatro en orden. La primera que aplique es tu respuesta.
| Revisa | Qué significa si es cierto |
| --- | --- |
| `Estado de sincronización` dice `Necesita volver a autenticarse`, `Error en la cuenta`, `Cuenta pausada` o `Desconectando la cuenta` | Arregla la cuenta primero. Nada de lo que cambies en el producto lo va a mover |
| El mensaje nombra un campo que tú no cambiaste | Ese es un segundo problema que el primero estaba tapando |
| El mensaje nombra una configuración | Cámbiala en [configuración](/es/pim/integrations/settings) y responde `Resincronizar ahora` |
| El mensaje nombra algo de la integración | Arréglalo allá. La próxima extracción trae el veredicto de vuelta |
### Una insignia naranja después de arreglarla
Vuelve a guardar el producto. Una advertencia la escribe un envío, así que se queda en el producto hasta que el siguiente envío la reemplace. Un producto que editaste en el panel de otra integración no ha tenido ningún envío desde entonces.
Si sigue ahí después de guardar, léela de nuevo. Las dos advertencias que se ven idénticas antes y después de un arreglo son un precio que sigue sin resolverse y una imagen que la integración sigue sin aceptar.
### Nada te avisa cuando se resuelve
Una insignia que se pone verde es todo el aviso que recibes, y tienes que estar mirando el producto para verla. No hay ningún mensaje en la app, porque el PIM te avisa las cosas por correo y un producto que no logró publicarse no manda ninguno.
Lo que sí te manda un correo es la conexión misma. Tres cosas te llegan así: una extracción que sigue fallando en una cuenta, una autorización que venció, y una moneda que no coincide. Las tres las controlas desde `Notificaciones`, dentro de tu configuración, en el grupo `Integraciones y sincronización`, como `Errores de sincronización` y `Problemas de conexión`. Puedes apagar cualquiera de los dos interruptores ahí.
## A dónde ir después
Qué inicia un envío, qué recibe cada integración, y el interruptor que lo detiene.
Qué llega en el sentido contrario, y qué le hizo a tu valor cada nota de un campo.
La cadena de precio, el identificador que sale como SKU, y la resincronización que los vuelve a correr.
Reconectar, pausar y eliminar una cuenta, y qué detiene cada estado de cuenta.