> ## 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.
# Integrations
> An integration is a live connection to a place you sell, and it is what brings your listings in and what sends your new prices back out to them.
An integration is a live connection between Repricer and one place you sell. Once you connect one, every listing on that seller account comes in with the price it is selling at right now. From then on Repricer reads that account again on its own and sends your new prices back to it.
This is where your listings come from. Repricer never creates one and there is nothing to type in yourself, so `Listings` in the sidebar stays empty until you connect something here. The same connection is the only way a price Repricer calculated gets in front of a shopper.
You will find all of this under `Integrations` in the left sidebar. The screen is a grid of square cards, one per integration, sorted into sections. Clicking a card opens a dialog over the page, and everything you do next happens inside that dialog.
Repricer connects six today: Shopify, BigCommerce, Amazon, Walmart, eBay and Square. The other cards on the screen are placeholders you cannot click yet. The PIM keeps a separate set of connections of its own, and [Integrations](/integrations/index) sets both out side by side.
## Before you start
### What your role lets you do
| Role | What you can do here |
| --- | --- |
| Admin | Everything on this screen |
| Manager | Nothing. You never see the screen |
| Editor | Nothing. You never see the screen |
| Analyst | Nothing. You never see the screen |
`Integrations` is not in your sidebar at all below Admin, and typing its address sends you back to your dashboard. So if a teammate tells you they cannot find `Integrations`, their role is the answer. Roles are set in [team, roles and permissions](/team#what-each-repricer-role-can-do).
### Deleting an account cannot be undone
Deleting an account permanently removes its listings, their pricing history and their market data. Your costs and your price limits go with them, and nothing brings any of it back.
## How to connect an integration
Click `Integrations` in the left sidebar. You get a grid of square cards, grouped into sections such as `Online Stores` and `Marketplaces`.
A card you can use opens a dialog right on the connect form. A card showing a dimmed logo and a `Coming Soon` tag does nothing when you click it.
Three integrations ask you for nothing at all. Shopify, Walmart and BigCommerce ask for credentials you create yourself first, and each of those three forms links to the page you make them on.
Click `Connect` in the bottom right of the dialog. On three of the six you are sent to the integration's own site to approve access, and it sends you back here after that. Shopify, Walmart and BigCommerce never send you away, so you stay where you are.
A dialog opens on its own and counts your listings as they arrive. It stays until the sync finishes, and none of the work depends on your browser staying open.
That is the whole flow. Your account is live from that moment, your listings arrive with the prices they are selling at, and the card gets a green `Connected` tag. Every new account starts in `Preview Mode`. Repricer calculates a price for each of those listings and publishes none of them until you go live, which [getting started](/repricer/index) walks through.
Everything below explains the screen one part at a time. You do not need any of it to connect your first account.
## Every option in detail
Three words run through this whole screen, and they are worth learning once.
An **integration** is one place you sell. An **account** is one seller account you authorized on it: one Shopify store, one Amazon seller account, one Walmart seller, one Square merchant. A **region** is one country site or one storefront under that account, and it is the level that actually syncs.
You can connect more than one account on the same integration, and each account keeps its own regions and its own listings. Every strategy you build is built for one account and one of its regions, which is why [strategies](/repricer/strategies) has an `Integration` and a `Region` column.
Every region you have switched on is read again every 10 minutes, and that is the only schedule on this screen. A listing you add on the store, a price somebody changes there, a title you fix: all of it turns up here within that dialog, and there is no button anywhere that asks for it sooner.
### Reading the cards
The `Integrations` page is one long grid, sorted into sections in a fixed order: `Online Stores`, `Marketplaces`, `POS Systems`, `Shopping Feeds`, and `Tools` at the bottom. A card shows the integration's logo and nothing else, because the name, the numbers and every control are in the dialog behind it.
Under the logo is one short tag, and which tag you get tells you the state of your connection.
| Tag | What it means |
| --- | --- |
| `Connected` | At least one account is connected and none needs your attention |
| `Paused` | You have accounts here and none of them is currently syncing |
| `Needs Attention` | An account has lost its authorization, or hit a problem it cannot recover from |
| `Coming Soon` | This one is not built yet, and clicking does nothing |
| No tag at all | You have never connected this integration |
The worst state is the one shown, so one broken account hides a healthy one's `Connected`. If you have two Amazon accounts and the tag reads `Needs Attention`, open the card and look at the list to see which of the two it is about.
**Clicking a card you have never connected goes right to the connect form.** An integration with no accounts has no numbers to show you yet.
Once you do have an account, that same click opens an overview instead. It gives you three numbers, labeled `Accounts`, `Listings` and `Synced`, so you can see how many listings you have there and how recently anything came in. Under them is `Manage accounts`, which is how you open the accounts themselves.
### Connecting an account
Clicking a card on `Integrations` puts you on that integration's connect form, and what it wants from you depends on which one you picked. Four of the six hand you over to their own site to approve access, so there is nothing to type and nothing to copy. Walmart and BigCommerce are the two that ask you for credentials you make yourself.
| Integration | What the form asks for | Where you approve it |
| --- | --- | --- |
| Amazon | Nothing | Amazon Seller Central |
| eBay | Nothing | eBay |
| Square | Nothing | Square |
| Shopify | Three fields, `Shop URL`, `Client ID` and `Client secret` | Nowhere. You approve it by creating an app in Shopify and installing it on your store |
| Walmart | Three fields, `Seller ID`, `Client ID` and `Client Secret` | Nowhere. You approve it by creating the credentials in the Walmart Developer Center first |
| BigCommerce | Three fields, `Store URL`, `Access Token` and `Client ID` | Nowhere. You approve it by creating the credentials in BigCommerce first |
`Connect` in the bottom right of the dialog stays gray until every box the form asks for has something in it. `Fill in all required fields` is on it while it waits. [Connect your first store](/connect-a-store) goes through each form field by field, including what to create in Shopify, in Walmart and in BigCommerce before you start.
**You never pick a marketplace, a country or a region.** Each integration finds where you sell on its own. Amazon uses the marketplaces your seller account is enrolled in, and Walmart tests your credentials against each of its sites. Shopify uses your markets and BigCommerce uses your storefronts. eBay and Square get one apiece. You switch off the ones you do not want afterward, inside the account.
A seller account can be in one organization at a time, across every organization on Ready for Commerce. Connecting one that is already taken is rejected, and the message points you at the address of our support team.
Shopify, Walmart and BigCommerce catch this before it wastes your time, because each of those forms already has the account's identity in it. The other three can only be recognized once the authorization comes back, so you go all the way to their site before you learn the answer.
If the account is in another organization you are in, the message names it, so you know exactly where to disconnect it.
### Watching the first sync
You come back to `Integrations` with a dialog already open. It shows a bar and a running count of your listings while the sync builds. Once it knows how many there are, the count reads `Syncing listings` with a number over a total. When it finishes it tells you how many listings came in and how many hit an error, with a line under those numbers that downloads the errors as a file.
An account with more than one region gets one line per region that was skipped or failed, saying which one and why. A skipped region is normal on Amazon, where a marketplace your seller account is not enrolled in cannot be read.
**The sync you started yourself has no close button.** There is nothing to cancel and nothing to dismiss, so leave the tab and come back if it runs long. One you find already running when you open `Integrations` later closes freely, so a long sync never traps you here. Closing that dialog never stops the sync.
Amazon takes the longest to get going, because it has to prepare a report of your listings before anything can be read. Several minutes of no visible progress there is normal.
A first sync runs once per account and there is no way to run it again. If it failed, or if you connected the wrong account, disconnect that account and connect it again.
### Managing an account after you connect it
Everything you do to an account after it exists happens in the same dialog. Click a card on `Integrations`, then `Manage accounts`, then the account you want. From there you switch its regions on and off, pause it, rename it, reconnect it, or delete it.
[Accounts and regions](/repricer/integrations/accounts#what-a-broken-connection-does-to-your-regions) walks that dialog control by control, including which regions each integration gives you and what a broken connection does to them.
### Linking the PIM
Scroll to the bottom of `Integrations` and the `Tools` section has one card, `PIM`. It is not an integration and it has no accounts of its own. It is the one switch that links your Repricer to your PIM.
Click that card and a dialog shows you four numbers before you commit. It counts your PIM products, your Repricer listings, and how many of them match and do not. Press `Connect` in that dialog and the link is on.
Both products have to be active on your organization first. If the PIM is not, the dialog says so and gives you a link out to activate it.
Once the link is on, every account you have in both products pairs up. The paired ones are listed in that same dialog under `Paired accounts`, tagged `Prices by Repricer`. From then on Repricer owns the selling price on those accounts and the PIM stops writing it, while the PIM sends your cost, your MAP and your MSRP across. `Disconnect` gives pricing back, and the values the PIM sent stay where they are and become yours to edit again. [The PIM connection](/repricer/integrations/pim) covers the whole trade.
### What you cannot do here
| You cannot | Do this instead |
| --- | --- |
| Run a first sync again | Disconnect the account and connect it again |
| Share one connection between Repricer and the PIM | Authorize the account separately in each product, then link them from `Tools` |
| Put an account back into preview once it is live | Pause the account, or switch its regions off |
| Edit a price, a cost or a strategy from this screen | Open the listing in [listings](/repricer/listings) |
## What each integration does with your listings
The six are not variations on one idea, and the difference decides how much work a connection leaves you. It comes down to one thing: whether the integration tells you what your competition charges, or whether you have to say where to look.
| Integration | Where the competing price comes from | What Repricer sends back |
| --- | --- | --- |
| Amazon | Amazon reports every competing offer on the item, and who is winning the featured offer | Your price, and your business price where business pricing is on |
| Walmart | Walmart reports the competitive position on the item | Your price |
| Shopify | The competitor pages you add to the listing | Your price, your strike-through compare price, and your cost |
| BigCommerce | The competitor pages you add to the listing | Your price and your strike-through compare price |
| eBay | The competitor pages you add to the listing | Your price |
| Square | The competitor pages you add to the listing | Your price |
**On Amazon and Walmart you add nothing.** You sell next to other sellers on the same item, so the marketplace already knows what the competition is charging and reports it. Repricer reads that every 10 minutes and your strategy has something to measure against from the first day.
**Everywhere else there is no shared offer to measure against.** A strategy there prices from your cost and the margin you want to keep. If you would rather it followed a rival, add that rival's page on the listing's `Competitors` tab and Repricer reads the price off the page for you. [Competitor pages](/repricer/listings/competitor-urls) covers adding one.
eBay is the one that surprises people, because it is in the `Marketplaces` section and behaves like your own store. There is no featured offer on eBay and no competing offer list, so an eBay listing needs competitor pages the same way a Shopify listing does.
Shopify is the one that gives something back. Where your store already records what an item costs you, that cost comes into the listing on every read, and a cost you change here goes back to Shopify. What moves in each direction, field by field, is set out in [pull](/repricer/integrations/pull) and [push](/repricer/integrations/push).
## When something goes wrong
### What each account state stops
Four things have to be true for a region to keep syncing, and any one of them stops it on its own.
| State | What stops | What clears it |
| --- | --- | --- |
| Paused by you | Reading and writing on every region | Flip the switch back |
| Region switched off | Reading and writing on that region alone | Flip that switch back |
| `Reconnection required` | Everything, until you authorize it again | `Reconnect` in the account dialog |
| `Account deactivated` | Everything, permanently | Delete the account and connect a new one |
| Lapsed subscription | Reading and writing on every account you have | Fix your organization's billing |
A lapsed subscription stops every sync without changing a thing on this screen. Every switch still reads as on and no account looks paused. Check your billing before you check your connections.
What the app puts on the account itself, and what each message means, is in [sync issues](/repricer/integrations/sync-issues).
### Getting told about it
You get an email when a connection needs you, and email is the only way Repricer tells you: there is no message center anywhere in the app. Each one names the integration and the account it is about.
| The email is about | What it asks you to do |
| --- | --- |
| An expired or revoked authorization | Reconnect the account |
| A store that is frozen, deactivated or gone | Fix it with the integration, then reconnect |
| A sync problem | Nothing. It is retried for you |
| A problem at the integration's own end | Nothing. It often clears itself |
| Listings a sync removed | Nothing, unless they should still be there |
You control these under `Notifications` in your settings, in the group named `Integrations & Sync`. There are three switches: `Connection issues`, `Sync errors` and `Listings removed`.
### Two things that happen with no message
Neither of these tells you it happened, so they are worth knowing about.
A card reading `Connected` can still hide a broken account, because the tag reports your worst account and not your best one. Open the card and read the list.
An account you paused stays paused forever. Nothing resumes it for you and nothing reminds you. If a store went quiet weeks ago, the switch on its row is the first thing to look at.
## Where to go next
One account's dialog: its regions, the switches, and what a broken connection does to them.
What each integration reports back, how often, and what a sync can remove.
What Repricer writes out, what starts it, and what it never touches.
What each product gives up when you pair them, and how to undo it.