Retail Pro connection validation blueprint
Status: no direct Retail Pro connector is live today. SQL Server, MySQL, and Oracle mappings are planned. This guide is the validation blueprint, not a supported-connector claim.
Do not run these steps today. They are future-pilot acceptance criteria, not an available installer or self-serve connection.
Retail Pro editions use different database engines, including SQL Server, MySQL, and Oracle. This blueprint maps the intended least-privilege path, but the production driver and Retail Pro schema mappings are not built. The first validation step is identifying the edition and database engine.
Written for the owner, not the engineer. Where a value depends on your specific Retail Pro edition, this guide uses a labeled placeholder like <RETAILPRO_DB> and tells you where StoreRounds fills in the real name. It never guesses the names of your tables.
Running example throughout: a fictional four-store specialty chain, Field & Fell Outfitters (apparel and footwear), running Retail Pro from the flagship back office. Every number shown is made up for the example. Your screen shows your real stores.
Which database is under your Retail Pro, and what could a future pilot validate?
Retail Pro is not one database. Depending on edition and version, it can use Oracle, Microsoft SQL Server, or MySQL.1 The engine helps identify a possible validation route, but it does not mean StoreRounds supports that edition. No Retail Pro production adapter is available today.
| If your Retail Pro runs on | Engine | Current StoreRounds status |
|---|---|---|
| Microsoft SQL Server editions | SQL Server | Not supported today. Possible founder-reviewed pilot route. |
| MySQL or MariaDB editions (often Prism / Store) | MySQL | Not supported today. Possible founder-reviewed pilot route. |
| Oracle editions (common on Retail Pro 9) | Oracle | No adapter today. Requires separate driver research. |
StoreRounds has no production Oracle, SQL Server, or MySQL Retail Pro adapter today. An applicant can name the edition and version for founder review, but there is no active export Diagnostic, purchase path, delivery promise, credit, or fallback connector.
A Retail Pro business partner or IT person can identify the engine. In a future approved pilot, StoreRounds would confirm the exact edition, version, service, schema, and safe access route before any credential is created. No customer setup screen performs that check today.
What is the proposed Retail Pro pilot boundary?
No StoreRounds Retail Pro driver is available today. A future pilot agent would use an edition-specific schema map and named read-only database user, minimize approved daily totals locally, and send them outward over an encrypted connection. The controls below are acceptance criteria, not deployed behavior.
What it is
- A read-only reader. A validated pilot driver would have to run named SELECT queries and nothing else.
- Outbound only. It opens one connection out to StoreRounds. It never listens for anything coming in.
- Scoped to named tables. A pilot would have to limit access to reviewed tables in an edition-specific map.
- Yours to switch off. One SQL command, or one uninstall, ends its access completely and immediately.
- Self-reporting. If it loses the database connection it reconnects and logs it, and you see its health in your dashboard.
What it is not
- It is not a writer. It cannot add, change, or delete a single sale, item, or price in Retail Pro. The database user is denied write access on purpose.
- It is not an open door. It opens no ports and needs no inbound firewall rule. Nothing on the internet can reach into your store through it.
- It is not a remote-control tool. No one at StoreRounds gets a login to your computer, your Retail Pro, or your database server.
- It must not touch payment card data. The approved map would include aggregate sales and tender counts, not card numbers.
- It must be not surveillance. The intended output is store-level exceptions, not employee scoring.
If a technician, your Retail Pro business partner, or a managed-services provider needs to sign off first, hand them the one-page security brief: the StoreRounds connector, for IT. It answers a cautious admin's questions in plain terms and prints on one sheet. The deeper security model is in trust and security.
Why can't a cloud tool just read Retail Pro?
Because Retail Pro keeps your sales in a database on a computer you control, behind a database login, not in a vendor's cloud with an open connection port. That is true whether your edition is on Oracle, SQL Server, or MySQL. Even the newer, web-based Retail Pro Prism serves that data from a server on your own network. A cloud dashboard has no neutral way to reach a database it does not host, so the honest way to read it is a database user, scoped tight and read-only.
Why the big platforms skip it
Square, Toast, and Lightspeed report on the cloud stacks they host. A future StoreRounds Retail Pro adapter is intended to read an approved local database without forcing a replatform, but that adapter and its edition-specific mappings are not built or production-proven.
What Retail Pro already does well
Retail Pro is a deep specialty-retail system for inventory, merchandising, purchasing, and reporting. The unproven StoreRounds goal is to add a cross-store overnight exception brief above it. That value must be demonstrated through a real Retail Pro pilot before it can be claimed as a working integration.
How does the connection work across several stores?
A possible pilot topology would place an approved edition-specific edge agent near the back-office database and allow outbound-only transport to StoreRounds. The diagram is a design target, not a deployed connection.
Two facts worth repeating, because they are the whole security story:
- A future pilot agent would have to read over the local network and send only reviewed, minimized fields.
- The connection to StoreRounds is started from inside your store, going out. Your firewall does not need a new inbound rule. There is no port for an outsider to knock on.
Put the connector on the same machine as the Retail Pro database, or on any always-on computer on the same network that can reach it. For a single store, that is usually the back-office PC. For a chain, you can run one connector per store, or one connector where your stores already consolidate if they are networked together. Every layout uses the same read-only login shown below.
What would a future Retail Pro pilot have to validate?
Five stages. Each ends with a verify step, so you never move on wondering whether the last part worked. Stage 1 is the database login and is the only stage that touches SQL. Use the block that matches your engine. If your IT person handles the database, send them stage 1 and do the rest yourself.
Create the read-only login
In an approved future pilot, an authorized administrator could create a dedicated login such as storerounds_ro, limited to the exact Retail Pro objects in a reviewed edition-specific map and denied write access. The sample blocks are documentation, not ready-to-run grants. Do not run them or create a login today.
1. Exact vendor mapping. A future pilot would require founder and IT review of the database, schema, named tables, and store identifiers for the exact Retail Pro edition. No StoreRounds screen provides these values today.
2. A way to run SQL. For a SQL Server edition, that is SQL Server Management Studio or Azure Data Studio. For a MySQL edition, that is the MySQL command line or MySQL Workbench. Open one, connect to the database that holds Retail Pro, and sign in as an administrator. If you would rather not, this is the one stage to hand to your IT person or Retail Pro business partner, then do the rest yourself.
Replace the placeholders in orange first. <RETAILPRO_DB> is your Retail Pro database name, and the <..._TABLE> names are the exact objects from that setup screen. Choose a long password for <STRONG_PASSWORD> and keep it for stage 3. This guide never guesses your table names, so do not run it with the placeholders still in it.
If your Retail Pro runs on SQL Server
-- 1. Create a server login with a strong password. USE [master]; CREATE LOGIN [storerounds_ro] WITH PASSWORD = '<STRONG_PASSWORD>', CHECK_POLICY = ON; GO -- 2. Map it to a user inside your Retail Pro database. USE [<RETAILPRO_DB>]; CREATE USER [storerounds_ro] FOR LOGIN [storerounds_ro]; GO -- 3. FUTURE PILOT ONLY: grant SELECT on the tables a validated adapter would read. GRANT SELECT ON OBJECT::dbo.<SALES_DOC_TABLE> TO [storerounds_ro]; GRANT SELECT ON OBJECT::dbo.<SALES_LINE_TABLE> TO [storerounds_ro]; GRANT SELECT ON OBJECT::dbo.<TENDER_TABLE> TO [storerounds_ro]; GRANT SELECT ON OBJECT::dbo.<STORE_TABLE> TO [storerounds_ro]; GO -- 4. Belt and suspenders: explicitly deny anything that changes data. DENY INSERT, UPDATE, DELETE, EXECUTE, ALTER, CONTROL TO [storerounds_ro]; GO
If your Retail Pro runs on MySQL
-- 1. Create a read-only user. Restrict the host to the connector -- machine where you can, for example 'storerounds_ro'@'10.0.0.20'. CREATE USER 'storerounds_ro'@'%' IDENTIFIED BY '<STRONG_PASSWORD>'; -- 2. FUTURE PILOT ONLY: grant SELECT on the tables a validated adapter would read. GRANT SELECT ON <RETAILPRO_DB>.<SALES_DOC_TABLE> TO 'storerounds_ro'@'%'; GRANT SELECT ON <RETAILPRO_DB>.<SALES_LINE_TABLE> TO 'storerounds_ro'@'%'; GRANT SELECT ON <RETAILPRO_DB>.<TENDER_TABLE> TO 'storerounds_ro'@'%'; GRANT SELECT ON <RETAILPRO_DB>.<STORE_TABLE> TO 'storerounds_ro'@'%'; -- 3. Apply. This user has SELECT only; it was never granted a write. FLUSH PRIVILEGES;
Confirm the user can read, and only read. On SQL Server, run EXECUTE AS USER = 'storerounds_ro'; SELECT TOP 1 * FROM dbo.<SALES_DOC_TABLE>; REVERT;. On MySQL, sign in as storerounds_ro and run SELECT * FROM <RETAILPRO_DB>.<SALES_DOC_TABLE> LIMIT 1;. Each should return a row. Then confirm it cannot write by trying an UPDATE and seeing it refused. If any write succeeds, the grant was too broad, so re-create the user with SELECT only before continuing.
Download and install the connector
- A founder would first approve the exact Retail Pro edition, driver, schema map, and owner for a named pilot.
- The owner's IT reviewer would receive the table map, network request, build hash, and rollback plan before installation.
- A pilot build must be code-signed before a customer receives it. No Retail Pro download is available from this page.
- When it asks, paste the one-time install code. This pairs the connector to your account. The code expires in 30 minutes and works once. If nobody uses it, the unused setup would retire automatically at expiry without touching paired connections or history.
Acceptance criterion: a future pilot would show the approved host, build identity, pairing time, and a truthful paired or failed state. This screen is not live today.
Point the connector at your Retail Pro database
- In the connector window, choose the database type that matches your edition, SQL Server or MySQL.
- Enter the server address. This is often localhost if the connector is on the database machine, otherwise the server's name or LAN address like 10.0.0.20. For a SQL Server named instance, enter it as SERVERNAME\INSTANCE.
- Enter the port if your server uses a fixed one (SQL Server default is 1433, MySQL default is 3306). For a SQL Server named instance you can usually leave the port blank.
- Enter the database name <RETAILPRO_DB>.
- Enter the user storerounds_ro and the password you set in stage 1.
- Click Test connection.
Acceptance criterion: a future pilot must prove it can read only the named Retail Pro tables and cannot write. The customer-facing connected state described here is not live.
Match Retail Pro's store numbers to your stores
Retail Pro identifies stores by a store number, subsidiary, or store code. A future edition-specific driver would return the reviewed identifiers and require a human mapping before reporting. Field & Fell Outfitters is fictional example data.
- Acceptance criterion: a future edition-specific adapter would return only reviewed store codes, and the owner would map each one to a real location.
- If a code is a warehouse, a training or demo store, or a closed location, mark it Do not report. StoreRounds will skip it.
- Set each store's day cutoff (when the sales day ends) and time zone, so the daily totals line up with your own Retail Pro end-of-day.
Future verify condition: the reviewed store list must show the right number of active locations with the right names. The fictional Field & Fell example shows four. A missing code would fail the pilot until its edition mapping and least-privilege grant are reviewed.
Run the read-back test
This would be the release gate. A future pilot would compare a StoreRounds read-back with the owner's Retail Pro report. Only a matching real-store result could mark the driver verified and schedule a first Morning Flash.
How would a Retail Pro pilot prove it read the right store and numbers?
A founder-assisted pilot would select one approved store and closed sales day, retrieve totals through the edition-specific driver, and compare them with the owner's trusted Retail Pro report. The driver must remain unsupported until those values match and the owner confirms the definitions.
| What StoreRounds read back | StoreRounds | Retail Pro end-of-day | Match |
|---|---|---|---|
| Gross sales | $9,318.20 | $9,318.20 | Yes |
| Transactions | 96 | 96 | Yes |
| Cash tendered | $1,240.00 | $1,240.00 | Yes |
| Card tendered | $8,078.20 | $8,078.20 | Yes |
Numbers are fictional, for the Field & Fell Outfitters example. On your screen these are your store's real totals for the day you check.
To pass the read-back test
- In StoreRounds, open the connection and choose Run read-back test. Pick the store and confirm the date it selected.
- In Retail Pro, open that store's Z-out or Sales Summary report for the same date.
- Compare gross sales, transaction count, and the cash and card split. They should match to the cent.
- If a future pilot matches, the owner would confirm the reconciliation. Only then could the connection be marked verified and a first Morning Flash be scheduled.
A future pilot must stop on any mismatch. Likely investigation points include the day cutoff, tax-inclusive versus tax-exclusive totals, and returns, adjustments, orders, layaways, or transfers. No Morning Flash should run until the owner confirms a clean match.
What if something goes wrong?
The common failures and what fixes them. Open the one that matches what you see.
The connection test fails with "cannot reach server"
The connector cannot find the database at the address you gave it. This is almost always the address, the named instance, or the port, not the password.
Future pilot diagnostic: an authorized technician would verify the approved server address and local-network route. A same-host agent could use localhost; a separate approved host would use the server's LAN address. Named-instance and MySQL host rules would be reviewed before any connection attempt.
"Login failed" or "access denied for user storerounds_ro"
Future pilot diagnostic: a refused login would require an authorized technician to re-check the approved credential and host scope. SQL Server SQL logins require mixed-mode authentication, and MySQL host rules must match the approved edge-agent host. No Retail Pro agent exists to run this test today.
"Read-only confirmed" but a table is missing
Future pilot diagnostic: if an approved adapter could sign in but not read a reviewed object, the pilot would stop for a schema and grant review. The edition-specific map, not a customer guess or nonexistent setup screen, must name the exact object and schema.
The store list is missing a location, or shows extras
Extras are usually a training or demo store, a warehouse code, or a closed store still in the database. Mark them Do not report in stage 4. A missing store means either its code is marked Do not report, or the read-only user was not granted the store table. Confirm the grant, then choose Rescan stores.
The read-back numbers are off by a consistent amount
A steady gap is a definition difference, not a fault. In Retail Pro the usual causes are the day-cutoff hour versus your Z-out, tax-inclusive versus tax-exclusive totals, and how returns, price adjustments, and non-sale document types (orders, layaways, transfers) are counted. Set the day cutoff in stage 4 to match your close, then tell StoreRounds which total definition to use when it asks. Re-run the read-back test after each change until it matches to the cent.
I am on Oracle and cannot run either block
No Retail Pro engine or edition is supported today. SQL Server, MySQL, and Oracle each require an edition-specific driver, reviewed schema map, revocation proof, and matching real-store read-back. Note the edition and version in a pilot application; do not send credentials or exports unless StoreRounds approves a manual review path. The Diagnostic is not for sale.
A future supported connection would need a truthful health record for reads, retries, gaps, and unresolved errors. This customer-facing health view is an acceptance criterion, not a live Retail Pro feature.
How must a future Retail Pro pilot prove revocation?
Access is yours to end at any time, with no notice and no call. You have two independent switches, and either one alone stops the flow of data. Use both to remove every trace.
Switch 1: turn off the connector
The future pilot would need a verified pause, unpair, and uninstall path that removes its working credential. No such customer control is live today.
Switch 2: drop the database user
Dropping the dedicated read-only database user is the source-side stop. A future pilot must prove that an attempted read then fails closed.
USE [<RETAILPRO_DB>]; DROP USER [storerounds_ro]; GO USE [master]; DROP LOGIN [storerounds_ro]; GO
DROP USER 'storerounds_ro'@'%'; FLUSH PRIVILEGES;
On SQL Server, run SELECT name FROM sys.database_principals WHERE name = 'storerounds_ro'; and the same against sys.server_principals in master; both return no rows. On MySQL, run SELECT user FROM mysql.user WHERE user = 'storerounds_ro'; and see no rows. The account is gone. If you also removed the connector, nothing of StoreRounds remains on your network.
In a future pilot, revoke must stop new reads. Until self-serve data controls ship, export and deletion requests would go through [email protected].
Frequently asked questions
Status for every answer below: no production Retail Pro adapter is live. These answers are blueprint assumptions that require edition-specific proof.
Is a StoreRounds Retail Pro adapter available?
No. StoreRounds has no production Retail Pro adapter for SQL Server, MySQL, or Oracle today. Each edition needs a driver, schema mapping, and matching real-store read-back. The Diagnostic is not for sale.
How do I know which database engine my Retail Pro uses?
Your Retail Pro business partner or IT person can identify the engine. As a rough guide, Retail Pro 9 commonly runs on Oracle, while Retail Pro Prism and Store databases are often on MySQL, and some editions and versions use SQL Server. In any future pilot, StoreRounds would verify the exact edition and engine before requesting a credential; no setup screen does that today.
Can StoreRounds change or delete anything in Retail Pro?
No production Retail Pro adapter exists today. A future pilot would have to prove that its dedicated user is limited to named SELECT grants and cannot insert, update, delete, execute, or alter data.
Do I have to open a port in my firewall?
A future Retail Pro pilot is designed to require no inbound firewall rule. Its acceptance criterion is outbound HTTPS on port 443 after an edition-specific agent reads only reviewed objects over the local network. No Retail Pro agent is available to install today.
Does it work with Retail Pro Prism as well as Retail Pro 9?
No Retail Pro edition is supported today. The database engine helps identify a future validation path, but edition, schema, driver, and a real-store read-back all must pass before StoreRounds can call it supported.
How do I turn it off later?
No customer Retail Pro connection exists today. A future pilot must prove two independent stop paths: remove the edge agent or drop its dedicated database user. Either must prevent another read.
Connect your first Retail Pro store
You can inspect this blueprint without an account. A Retail Pro production adapter is not live, payments are closed, and applying does not promise a connection date. Suitable applicants will be contacted only if an edition-specific, founder-assisted validation opens.
A portal account does not unlock a Retail Pro adapter. Do not install software or create credentials until StoreRounds confirms an approved pilot.