> ## 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.
# Conecta tu primera tienda
> Autorizar tu primera integración te toma unos minutos, y trae de vuelta los productos que ya tiene, así tu catálogo arranca lleno y no vacío.
Una integración es una conexión viva entre el PIM o el Repricer y un lugar donde vendes. La autorizas una vez y, de ahí en adelante, tus datos se mueven solos entre los dos.
Mientras no tengas una, los dos productos te están esperando. El PIM no tiene dónde publicar tu catálogo y el Repricer no tiene publicaciones a las que ponerles precio. Conectar también es la forma más rápida de llenar cualquiera de los dos. La conexión lee lo que ya está en la tienda y se lo trae, así que nunca escribes tu catálogo a mano.
Esto se hace dentro del producto que la va a usar. La primera vez que abres el PIM o el Repricer, te pide conectar una antes que nada. Después de eso, `Integraciones` en la barra lateral izquierda de ese producto es donde está cada conexión.
Una misma tienda usada en los dos productos se autoriza dos veces, una en cada uno. Son aplicaciones distintas con credenciales distintas, y ninguna puede prestarle su conexión a la otra.
## Antes de empezar
Hay tres cosas que importan antes de tu primera conexión. Todo lo demás de esta página puede esperar hasta que lo necesites.
### Qué te permite hacer tu rol
Necesitas el rol de producto Administrador en el producto que vas a conectar. Es el único rol que puede conectar o desconectar algo, y por debajo de él el enlace `Integraciones` ni siquiera está en la barra lateral.
Así que si no encuentras `Integraciones`, la respuesta es tu rol y no la página. Alguien con el rol de organización Propietario o Administrador te lo cambia, y [equipo, roles y permisos](/es/team) explica los dos conjuntos de roles.
### Una cuenta de vendedor, una organización
Tu tienda de Shopify, tu cuenta de vendedor de Amazon, tu comercio de Square: cada una se puede conectar en una sola organización a la vez, en todo Ready for Commerce. Si alguien de tu empresa la conectó bajo otra organización, la tuya se rechaza hasta que la desconecte allá.
Cuando la organización que la tiene es una a la que entras, el mensaje la nombra, así que sabes exactamente a dónde ir. Cuando no lo es, el mensaje te manda a la dirección de nuestro equipo de soporte.
### Qué le hace conectar a tu tienda
Conectar una tienda al PIM también crea dos locaciones dentro de ella, llamadas `Supplier Stock` y `On-hand Stock`. Son la forma en que el PIM publica una cantidad sin contar dos veces lo que ya tienen tus propias locaciones, y tienen que estar ahí. [Inventario](/es/pim/catalog/inventory) explica qué guarda cada una.
Cuando el PIM termina de leer una tienda, cada producto tuyo que falte ahí entra en cola para publicarse. Conectar sobre un catálogo que ya armaste escribe en la tienda.
## Cómo conectar tu primera integración
Abre el PIM o el Repricer. La primera vez que abres uno, te pide conectar una integración antes que nada, y `Omitir por ahora`, debajo de las tarjetas, te lleva al producto sin ninguna. Las demás veces, pulsa `Integraciones` en la barra lateral izquierda.
La página `Integraciones` es una cuadrícula de tarjetas cuadradas, una por integración, agrupadas en secciones. Pulsa una que nunca hayas conectado y el diálogo abre directo en su formulario de conexión. Una tarjeta con el logo apagado y una etiqueta `Próximamente` todavía no existe y no hace nada al pulsarla.
Varias no te piden nada. Shopify, BigCommerce y Walmart te piden credenciales que creas tú primero, y los tres formularios enlazan a la página donde las creas.
`Conectar` está abajo a la derecha del diálogo. En las integraciones que no te pidieron nada te manda a su propio sitio, donde lees qué se te está pidiendo y aceptas, y ellas te devuelven aquí.
Un diálogo se abre sobre la página solo y va contando lo que pasa. Déjala hasta que termine y luego pulsa `Ir al catálogo` en el PIM, o `Ir a publicaciones` en el Repricer.
Ese es todo el flujo. Tu cuenta queda conectada apenas vuelve la aprobación, la primera sincronización arranca sola, y la tarjeta gana una etiqueta `Conectado` cuando termina.
Todo lo que sigue explica esas piezas una por una. No necesitas nada de eso para conectar la primera.
## Cada opción en detalle
### Dónde se conecta
Hay dos pantallas, y la primera que conoces existe una sola vez.
**La primera vez que abres un producto**, te pone enfrente una cuadrícula de tarjetas y te pide conectar una. `Omitir por ahora` está debajo de la cuadrícula y te lleva al producto sin nada conectado. Eso no te cuesta nada, porque la pantalla no vuelve y `Integraciones` hace lo mismo con más adentro. El Repricer agrega un segundo paso que configura cómo compite en precio, y ese trae su propio `Omitir, usar valores predeterminados`.
**`Integraciones` en la barra lateral izquierda** es la casa de verdad. Tiene todas las integraciones que conecta ese producto, todas las cuentas que tienes en cada una, y todo lo que puedes cambiarles después. Conectar desde aquí es idéntico, y esta es la pantalla que te ofrece todas las integraciones.
Usa la pantalla de inicio si la tienda que quieres está ahí. Usa `Integraciones` en cualquier otro caso, y para una segunda cuenta, una segunda tienda o cualquier cosa que conectes más adelante.
### Qué te pide cada integración
Qué integraciones ves depende del producto en el que estés, porque el PIM y el Repricer no se conectan al mismo conjunto.
| Integración | Dónde la conectas | Qué te pide el formulario de conexión |
| --- | --- | --- |
| Shopify | El PIM y el Repricer | Tres campos, `URL de la tienda`, `Client ID` y `Client secret` |
| BigCommerce | El PIM y el Repricer | Tres campos, `URL de la tienda`, `Access Token` y `Client ID` |
| Amazon | El PIM y el Repricer | Nada |
| Square | El PIM y el Repricer | Nada |
| Google | El PIM | Nada |
| Walmart | El Repricer | Tres campos, `Seller ID`, `Client ID` y `Client Secret` |
| eBay | El Repricer | Nada |
**Empieza por la tienda donde ya están tus productos.** Una tienda desde la que llevas años vendiendo llena tu catálogo o tus publicaciones en un solo paso. Todo lo que conectes después se publica a partir de lo que trajo esa primera. Conectar una tienda vacía funciona y recibes un resultado vacío, que es el camino lento al mismo lugar.
Shopify funciona con una app que es tuya. La creas en tu propia cuenta de Shopify, la instalas en tu tienda, y pegas su `Client ID` y su `Client secret` en el formulario. El formulario trae los pasos para crearla, y el acordeón de abajo también.
El campo `URL de la tienda` de Shopify acepta tu dirección en cualquier forma que la tengas. Pega la dirección de tu navegador, pega tu dirección `myshopify.com`, o escribe solo el nombre de la tienda. Las tres te llevan a la misma tienda.
**BigCommerce y Walmart también necesitan credenciales que creas tú primero.** Los dos formularios traen un enlace a la página donde las creas. `Conectar` se queda en gris, con `Completa todos los campos obligatorios` encima, hasta que cada casilla tenga algo. Créalas en otra pestaña antes de empezar, porque un formulario a medias no te espera cuando vuelves.
Tu app se crea en el Dev Dashboard de Shopify, al que enlaza el formulario de conexión. Desde el admin de Shopify, abre `Configuración`, después `Apps y canales de venta`, después `Desarrollar apps`, y pulsa `Build apps in Dev Dashboard`.
Crea una app y ponle un nombre. En la versión de la app, agrega los permisos que lista el formulario de conexión y pulsa `Release`. Cópialos del formulario con el botón `Copiar` que tienen encima, porque a tu app se le rechaza la conexión si le falta cualquiera de ellos.
Después abre `Installs` e instala la app en tu tienda. Tu `Client ID` y tu `Client secret` están en `Settings` y después `Credentials`, dentro de la app, y esos dos son los que quiere el formulario.
Deja la app instalada a partir de ahí. Cuando necesites credenciales nuevas, rota el secret en el Dev Dashboard en vez de borrar la app.
Una conexión de BigCommerce funciona con una cuenta de API que creas en la configuración de BigCommerce, en `API` y después `Store-Level API Accounts`. Dale permiso para modificar productos y para modificar inventario, porque un token sin los dos se rechaza y el mensaje dice cuál falta.
Crearla te da un access token y un client ID. Guarda los dos en un lugar seguro, porque BigCommerce te los muestra una sola vez y nunca vencen solos.
Tu client ID y tu client secret de Walmart se verifican contra Walmart mientras esperas, así que recibes un error de vuelta si alguno está mal. Tu `Seller ID` no se verifica contra nada. Se guarda tal como lo escribiste y se convierte en la identidad de la cuenta aquí.
Así que un error de dedo en ese campo produce una conexión que parece haber funcionado y que queda atada a un vendedor que no eres tú. Cópialo de Walmart y pégalo.
Puedes conectar tantas cuentas en una integración como tengas, y cada una guarda su propia configuración. Abre la tarjeta, pulsa `Administrar cuentas`, y el botón del final de la lista dice `Agregar otra cuenta` en cuanto tienes una.
Ponles nombre mientras estás ahí. `Renombrar`, en el encabezado del diálogo de la cuenta, es donde se hace, y dos tiendas que venden la misma marca se ven idénticas en esa lista hasta que las distingas tú.
### Aprobarlo en el sitio de la integración
Pulsar `Conectar` en un formulario que no te pidió nada te entrega a esa integración. Llegas a su propia pantalla de permisos, lees qué se te está pidiendo y aceptas. Te devuelven de inmediato, y la conexión existe desde ese momento.
Los formularios de credenciales no te mandan a ningún lado. Crear las credenciales fue la aprobación, así que pulsar `Conectar` ahí lo termina donde estás.
Nunca se te pide elegir un marketplace, una región ni un país. Cada integración encuentra sola dónde vendes: Amazon por los marketplaces en los que tu cuenta de vendedor está dada de alta, Shopify por tus mercados, BigCommerce por tus tiendas. Square y eBay tienen uno cada uno. Los que no quieras los apagas después, dentro de la cuenta.
### El paso extra que agrega Google
Google es la que te pide algo de regreso. Un feed de compras manda gente a tu propio sitio web, así que cada producto que publica tiene que decir la dirección de la página de ese producto en tu sitio. Google recién puede decirte qué sitio tiene verificado cuando inicias sesión.
Por eso se abre un diálogo llamado `Configuración de la página de producto` entre el regreso de Google y el diálogo de la primera sincronización. Llena tu sitio web y pulsa `Guardar y publicar`, o pulsa `Configurar después` y déjalo en la configuración de la cuenta cuando llegues ahí. No se pierde nada de ninguna de las dos formas, y la primera sincronización corre detrás de ese diálogo mientras escribes.
### Ver la primera sincronización
Vuelves a `Integraciones` con un diálogo ya abierto. Muestra una barra y una cuenta en marcha mientras la sincronización se arma. Cuando termina, cambia a un resumen de lo que pasó, con un enlace debajo que descarga los errores en un archivo.
Qué cuenta ese resumen depende del producto en el que estés y de la integración que conectaste, y la sección sobre con qué te deja la primera sincronización lo detalla. Hay dos cosas del diálogo misma que importan en la primera.
**Una sincronización que empezaste tú no tiene botón de cerrar.** No hay nada que cancelar ni nada que descartar. Deja la pestaña y vuelve si se alarga, porque nada de esto depende de que tu navegador siga abierto.
**Una sincronización que encuentras corriendo se cierra sin problema.** Abre `Integraciones` mientras la importación de alguien más va en camino y el diálogo vuelve con una X en la esquina. Una importación larga nunca puede dejarte atrapado en esa pantalla, y cerrarla nunca detiene lo que está corriendo detrás.
Cuánto tarda depende de la integración y de cuánto haya en la tienda. Amazon es la que más tarda en arrancar, en los dos productos, porque tiene que preparar un reporte de tus publicaciones antes de poder leer nada. Varios minutos sin avance visible ahí es lo normal.
### Pausar y desconectar una cuenta
Pausar es la opción reversible y es la que quieres casi siempre. El interruptor de la derecha de una fila en la lista de cuentas detiene la lectura y la escritura de esa cuenta. No elimina nada, todo lo ya sincronizado se queda donde está, y volver a mover el interruptor arranca la cuenta de nuevo.
Desconectar no es reversible. `Eliminar` está abajo a la derecha del diálogo de la cuenta, y el diálogo te dice qué está por quitar antes de dejarte llegar al botón. Después te pide escribir el nombre exacto de la cuenta, y escribir la palabra `DELETE` en una segunda casilla, y recién ahí `Eliminar` se puede pulsar.
Desconectar una cuenta del Repricer elimina para siempre sus publicaciones y su historial de precios. En el PIM quita la conexión y todo lo que anotó sobre ella. Tu catálogo del PIM nunca se elimina.
Desconectar una tienda de Shopify no le quita tu app. La app se queda instalada, así que volver a conectar la tienda más adelante es llenar el mismo formulario con las mismas credenciales, y eso es una conexión nueva con su propia primera sincronización. Desinstalar esa app desde tu Shopify Admin también desconecta la cuenta, y al producto se le avisa y la quita por ti.
### Límites
| Qué | Límite |
| --- | --- |
| Organizaciones en las que se puede conectar una cuenta de vendedor | 1 |
| Cuentas en una integración | Sin límite |
| Caracteres en el nombre de una cuenta | 100 |
| Primeras sincronizaciones por cuenta | 1 |
### Lo que conectar no puede hacer
| No puedes | Haz esto en su lugar |
| --- | --- |
| Compartir una conexión entre el PIM y el Repricer | Autoriza la cuenta en cada producto y después une los dos desde `Tools` |
| Correr la primera sincronización una segunda vez | Desconecta la cuenta y vuelve a conectarla |
| Cancelar una primera sincronización | Espérala, y desconecta después si conectaste la cuenta equivocada |
| Elegir qué regiones o marketplaces conectas | Apaga los que no quieras dentro de la cuenta, después |
| Elegir qué cuenta de Merchant Center usa Google | Inicia sesión con la cuenta de Google que llega a la que quieres |
| Conectar una tienda que alguien ya conectó en otro lado | Desconéctala primero en la organización que la tiene |
## Con qué te deja la primera sincronización
Una primera sincronización corre una sola vez, sola, apenas existe tu cuenta. Es la única vez que cualquiera de los dos productos lee una tienda de principio a fin, y lo que hace con lo que encuentra es distinto en cada uno.
**En el PIM llena tu catálogo.** Los productos de una tienda entran como productos tuyos. Lo que coincide con algo que ya tienes se vincula en lugar de duplicarse, y tu versión es la que sale de vuelta. Dos de ellas se portan lo bastante distinto como para nombrarlas. Amazon no crea nada, porque empareja tus variantes actuales con tus ofertas en vivo por SKU. Google publica en lugar de leer, porque un feed de compras no tiene productos propios. [Extracción](/es/pim/integrations/pull) tiene el panorama completo, integración por integración.
**En el Repricer llena tus publicaciones.** Entran con los precios a los que se están vendiendo ahora mismo. Donde la integración informa cuánto te cuesta un artículo, ese costo entra también, y el Repricer ya tiene con qué calcular un precio mínimo y un margen.
Nada de lo que entra trae su seguimiento de existencias. Una variante importada llega con el seguimiento apagado, con las cuentas propias de la integración al lado como números que puedes leer y no editar, y [inventario](/es/pim/catalog/inventory) explica cómo encenderlo.
Un producto que alguien cree en la tienda después es otro caso. Algunas integraciones te siguen leyendo productos nuevos y otras se detienen tras la primera sincronización, y [extracción](/es/pim/integrations/pull#qué-trae-la-primera-sincronización) dice cuáles.
## Cuando algo falla
### La conexión se rechazó antes de empezar
| Mensaje | Qué hacer |
| --- | --- |
| `Esta cuenta ya está conectada a tu organización.` | Ya la tienes. Búscala en tu lista de cuentas |
| `Esta cuenta ya está conectada a "{orgName}", otra de tus organizaciones. Desconéctala allí primero para conectarla aquí.` | Desconéctala en la organización que se nombra y vuelve |
| `Esta cuenta de Amazon aún no vende en ningún marketplace compatible.` | Empieza a vender en un marketplace de Amazon primero |
| `No se encontró ninguna cuenta de Merchant Center accesible con esta cuenta de Google.` | Inicia sesión con una cuenta de Google que llegue a tu Merchant Center |
| `BigCommerce rechazó el token de acceso. Verifica el token e intenta de nuevo.` | Crea un token nuevo en tu panel de BigCommerce |
| `Al token le falta un permiso de escritura requerido. Otorga Products (modify) e Inventory (modify) a la cuenta de API.` | Dale los dos permisos a la cuenta de API y conecta otra vez |
| `Client ID o Client Secret de Walmart inválidos. Verifica tus credenciales en el Walmart Developer Center.` | Crea un par nuevo en el Walmart Developer Center |
| `Se rechazó la autorización en la pantalla de consentimiento de Google.` | Empieza de nuevo y aprueba el acceso |
| `No tienes permiso para conectar cuentas.` | Tu rol de producto está por debajo de Administrador. Pide que te lo suban |
### La primera sincronización falló
El diálogo te lo dice y te ofrece el reporte de errores. No hay nada que reintentar ni botón que la vuelva a correr. La salida es la misma en los dos productos: desconecta esa cuenta y vuelve a conectarla, lo que corre una primera sincronización nueva.
Hay una causa que hay que revisar antes. Una tienda cuya moneda no es la moneda de tu organización detiene la sincronización en seco, en Shopify, BigCommerce y Square dentro del PIM. No se importa nada, porque un precio en la otra moneda entraría reetiquetado y no convertido. Alinea las dos monedas primero, cambiando la moneda de tu organización mientras tu catálogo todavía es chico, o conectando una tienda que coincida. [Organizaciones](/es/organizations) tiene lo que cuesta ese cambio cuando ya hay un catálogo.
### La conexión dice que necesita atención
Las credenciales vencen, y una integración puede revocar las tuyas. Ninguna de las dos cosas se arregla sola, así que la cuenta te espera. `Reconectar`, en el diálogo de la cuenta, te manda de vuelta por lo mismo que te pidió la conexión la primera vez, y no se pierde nada de lo que configuraste. Tiene que ser la misma cuenta, y conectar otra tienda se rechaza. [Salud de la conexión](/es/integrations/connection-health) cubre todos los estados en los que puede estar una cuenta.
### No entró nada
Un resultado vacío casi siempre significa que la cuenta que autorizaste no es la que tiene tus productos. En Shopify, revisa que la dirección que diste sea la tienda que querías. En Amazon, revisa qué marketplaces volvieron con la conexión.
### Todo se ve conectado y nada se mueve
Abre tu página de Facturación en la configuración de tu cuenta antes de revisar cualquier otra cosa. Un producto vencido o pausado deja de sincronizar y de ajustar precios mientras cada interruptor de la página `Integraciones` se sigue viendo encendido. [Planes y facturación](/es/billing) tiene qué detiene cada estado y cómo salir.
## A dónde ir después
Cada cuenta, destino y locación en una pantalla, y qué cambia cada ajuste.
Qué admite cada integración, lado a lado para los dos productos.
Qué escribe de vuelta una integración conectada, y qué trae una primera sincronización.
El rol que conecta una integración, y quién puede repartirlo.