> ## 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.
# Reports
> The reports turn what your listings did into numbers you can read over a date range you choose, from what you sold to what the repricer is not pricing.
A report is a set of numbers about listings you already have. It counts what you sold, what the repricer did to your prices, and where each of your listings stands today. The answers come back on one screen, as numbers, charts and tables. A report changes nothing on its own, so there is nothing here you can get wrong by clicking it.
There are six of them. Between them they tell you what you sold, how many items that was, and how often you are winning the Buy Box. They also tell you how many prices the repricer changed, what you are making on each listing, and how many of your listings it is pricing at all. You come here when you want a number instead of a row, and when you want it for a stretch of time instead of for this minute.
You find all of this under `Reports`, the fifth entry in the sidebar down the left. The screen is six cards, one per report, each with one large number on it and a small chart under that number. Click a card and its report opens in a dialog over the screen, with everything the report has inside that dialog.
The bar across the top of the screen has the date range every number is counted over, and the dropdowns that narrow the whole screen down to one seller account. Both of those stay with you when you open a report.
## Before you start
### What your role lets you do here
`Admin`, `Manager`, `Editor` and `Analyst` all open `Reports` and read every number in it. No report is hidden from a role and no figure is trimmed for one, so a number you cannot explain is never one your role is keeping from you.
Two of the reports let you open a listing from a table row, and what you can change on that listing is what your role lets you change anywhere else. Roles are set in [team, roles and permissions](/team#what-each-repricer-role-can-do).
### There is nothing to count until an account is connected
Every number here comes from your listings, and your listings come from a connected seller account. So a new organization gets an empty screen until somebody connects one and its first sync finishes. `Integrations` in the sidebar is where that happens, and only an `Admin` sees that entry, which [integrations](/repricer/integrations) covers.
## How to read a report
Click `Reports` in the sidebar down the left. You get six cards, one for each report.
In the bar across the top of the screen is a dropdown reading `Last 30 days`. Open it and pick another period from the list, or pick two dates of your own on the calendar beside that list. Every card recounts for what you picked.
Beside the date range are up to three more dropdowns, `Integration`, `Account` and `Region`. Leave them on `All Integrations`, `All Accounts` and `All Regions` to count everywhere you sell.
The card opens its report in a dialog over the screen. `Sales` opens `Sales Report`, `Profit` opens `Profitability Report`, and the other four are named after their card.
A report opens on a row of numbers, with charts under them and a table at the bottom. Hover the small info icon beside any number and you get a sentence saying exactly what that number counts.
That is the whole screen. Close the dialog with the × at the top of it, with the Escape key, or by clicking outside it. You come back to your six cards with the date range and the dropdowns exactly as you left them.
Everything below explains one piece at a time, and each of the six reports has a page of its own. You do not need any of it to read a number.
## Every option in detail
### The six cards and what each one opens
The `Reports` page is fixed. You cannot add a card, remove one or move one, and everybody in your organization gets the same six in the same order.
| Card | The number on it | The dialog it opens |
| --- | --- | --- |
| `Sales` | What you sold over the date range, as money | `Sales Report` |
| `Profit` | What is left of that after your costs and the marketplace fees | `Profitability Report` |
| `Units Sold` | How many individual items you sold | `Units Sold Report` |
| `Buy Box Ownership` | The share of your listings winning the Buy Box right now | `Buy Box Ownership Report` |
| `Price Changes` | How many of your prices the repricer changed | `Price Changes Report` |
| `Repricing Health` | How many of your listings the repricer is pricing right now | `Repricing Health Report` |
One card and its dialog do not share a name. `Profit` opens `Profitability Report`. The other five match.
`Buy Box Ownership` shows `N/A` instead of a percentage when you set `Integration` to one that has no Buy Box. A Buy Box is the featured spot you win against other sellers on the same item, which is how Amazon and Walmart sell, so Amazon and Walmart listings are what that number counts. It counts the ones you have active and in stock.
### Setting the date range
`Last 30 days` is the dropdown at the right of the bar across the top of the screen, and it decides the period every number on the screen is counted over. Open `Reports` from the sidebar and it starts on `Last 30 days` every time.
| Choice | What it covers |
| --- | --- |
| `Today` | Today so far |
| `Yesterday` | Yesterday, from midnight to midnight |
| `Last 7 days` | Today and the 6 days before it |
| `Last 14 days` | Today and the 13 days before it |
| `Last 30 days` | Today and the 29 days before it |
| `Last 90 days` | Today and the 89 days before it |
| `Month to date` | The 1st of this month until today |
| `Quarter to date` | The first day of this quarter until today |
| `Year to date` | January 1 until today |
| `All time` | Everything you have, however far back it goes |
The same dropdown gives you a calendar beside that list. Pick a start date and an end date on it and the screen counts between the two, and the dropdown then reads your two dates instead of a period name.
**One report has no date range at all.** `Repricing Health` counts your listings as they stand this minute, so the dropdown is missing from its dialog. Which of the other five it moves, and how much of each, is further down this page.
### Narrowing to one integration, account or region
In the bar across the top of the screen, beside the date range, are up to three dropdowns: `Integration`, `Account` and `Region`. They open on `All Integrations`, `All Accounts` and `All Regions`, and each one narrows every card and every report on the screen at once.
They work in that order. Set `Integration` to `Amazon` and `Account` keeps only your Amazon accounts. Set `Account` to one of those and `Region` keeps only that account's regions. Set one back to `All` and the two under it widen again.
**A dropdown you cannot see is a dropdown with one answer in it.** Each of the three appears only when you have more than one to pick from. A seller with a single account on a single region gets the date range and nothing else.
The same three dropdowns and the same date range are inside the dialog too, beside the report's title. Change one there and the cards behind the dialog recount with it, so you never have to close a report to widen it.
On a narrow screen all of this collapses behind a button reading `Filters`, with a number beside it for how many of them you have changed.
### What you get inside a report
Every report is laid out the same way inside its dialog, whichever card on `Reports` you clicked to get there.
At the top is a row of numbers under a heading, `Overview` on five of the six and `Repricing Status` on `Repricing Health`. Each number is a label, a figure and a small info icon. Hover the icon and you get a sentence saying what that figure counts and how it was calculated. That is the fastest way to settle what a number on this screen means.
Under the numbers are charts, and under the charts is a table, sometimes two. The chart is there for the shape and the table under it is there for the figures. Read the chart to see whether your line is going up, and read the table when you need the day.
### Working with a table inside a report
Above the rows of every table in a report is a toolbar with `Search`, `Columns`, `Filter` and `Density` on it. It is the same toolbar every other table in the Repricer gives you, and what each of those four controls does is in [filters](/repricer/filters).
Two things are worth knowing here. A table of listings or of products opens on 25 rows a page, and `25`, `50` and `100` are your choices in the footer under it, while a table of days has no pages and puts every day on screen at once. Changing the date range or one of the three dropdowns sends a paged table back to its first page, because the rows underneath you have just been recounted.
On `Repricing Health` and on `Units Sold`, the `SKU` column is a link. Click it and that listing opens in a dialog on top of the report, on the tab that matches what you clicked. On `Repricing Health` you get `Pricing`, which is where you fill in the cost or the minimum price it needs. On `Units Sold` you get `Insights`. Close that dialog and you are back on the report where you were.
### Sending a report to somebody
Everything you set is in the address bar. The date range, the three dropdowns, which report is open, and where you are in its table all go in, so the report you are reading is already a link. Copy it out of the address bar and whoever opens it gets the same report, set up the same way, counted for the organization they are in.
What goes into a link like that, and what stays on your own computer, is in [filters](/repricer/filters#what-goes-into-the-link).
### Limits
| What | Limit |
| --- | --- |
| Reports | 6 |
| Rows a paged table shows at once | 25, 50 or 100 |
| Date ranges on screen at once | 1 |
### What a report cannot do
| You cannot | Do this instead |
| --- | --- |
| Download, print or email a report | Build a spreadsheet of your listings under `Uploads`, which [exports](/repricer/uploads/exports) covers |
| Have a report sent to you on a schedule | Open `Reports` when you want it |
| Save a date range and a scope under a name | Send yourself the address, which is a link to your exact setup |
| Put two periods side by side | Read one, change your date range, read the other |
| Read one listing's own numbers here | Open your listing and use its `Insights` tab, which [insights](/repricer/listings/insights) covers |
## What the numbers cover
### Which numbers follow the date range and which do not
This is the part of the screen that surprises people. The date range in the bar across the top of `Reports` does not move every number, because not every number is about a period.
Three of the reports count events, and an event happened on a day. A sale happened on a day and a price change happened on a day, so widening the range to `Last 90 days` gives you more of them and every figure goes up.
The other three count the state your listings are in right now, and a state has no day attached to it. A listing either is winning the Buy Box or it is not. It either has a cost on it or it does not. Widening the range changes none of that, so those numbers stay exactly where they were.
| Report | What the date range moves |
| --- | --- |
| `Sales Report` | Every number on it |
| `Units Sold Report` | Every number on it |
| `Price Changes Report` | Every number on it |
| `Buy Box Ownership Report` | The trend chart. The numbers above it count your listings right now |
| `Profitability Report` | The daily table. The numbers above it count your listings right now |
| `Repricing Health Report` | Nothing, and the dropdown is not in its dialog |
So a `Buy Box Ownership` of 62% is not 62% of last month. It is 62% of the listings you have active and in stock this minute, and it reads the same whether you asked for 7 days or for `All time`.
### The currency your money is shown in
Every money figure on `Reports`, on the cards and inside every report, is shown in one currency, your organization's, whatever currency the listing itself sells in. A sale in euros and a sale in dollars are converted and added together for you, so a total is a total instead of a pile of currencies.
Two things follow from that. The rate used is today's, so a total for last quarter is close instead of exact to the cent. Any table with one row per listing is the exception. Each of those rows is in the currency that listing sells in, because a price you might go and change has to be the price you would type.
Your organization's currency is the `Currency` field in the account app, and [organizations](/organizations) says where to find it and what changing it does.
### The cards recount on their own
You do not have to reload the screen. While `Reports` is open, the six cards recount when a price changes or a listing's status moves, so nothing flashes and you do not lose your place.
A report you have open in the dialog does not do this. It reads its numbers once, when it opens, so close it and open it again if you want it counted again.
## When something goes wrong
### The screen has nothing on it
| What you see | What it means | What clears it |
| --- | --- | --- |
| `Nothing here yet` | You have no seller account connected | Connect one under `Integrations` in the sidebar |
| `Almost there` | Your account is connected and nothing has come in from it yet | Wait for your first sync to finish |
| `No regional data available` under a chart | No region had anything to put on that one chart | Widen that range |
A report that has nothing to count does not tell you so. Its figures read zero and its table fills with zeros, so widen your date range or set the three dropdowns back to `All` before you decide you sold nothing.
### A report will not load
Every message below comes with a `Retry` button under it. Nothing was changed and nothing was lost, so retrying is always safe.
| Message | What to do |
| --- | --- |
| `This report took too long to load. Try a shorter date range or fewer filters, then retry.` | Shorten your date range, or narrow `Integration` to one of yours, then click `Retry` |
| `We couldn't load this report. Please try again.` | Click `Retry` |
| `We couldn't read the report data. Please retry, and contact support if it keeps happening.` | Click `Retry`, and write to support if it comes back |
| `One of the report filters isn't valid. Clear the filters and try again.` | Set `Integration`, `Account` and `Region` back to `All` |
| `You don't have access to this organization.` | Switch organization with your organization name at the top of the sidebar |
| `You don't belong to this organization.` | The same |
When the six cards themselves cannot be counted, the message takes over the whole screen under the heading `Reports error`, with the same `Retry` button under it.
## Where to go next
What you sold, by day and by region, and what an average order is worth to you.
How many of your items went out, and which products they were.
How much of the time you are winning, and which of your listings lose it while priced lowest.
How often the repricer moved one of your prices, which way it went, and what set it off.
Margin, fees and estimated profit on each of your listings.
How many of your listings the repricer is pricing, and what the rest are missing.