What you'll get done in 20 minutes
Your usual AI will be able to read and operate your store: products and photos, prices per list, categories, customers, orders and abandoned carts. You ask in your own words ("raise the Wholesale B list 8% in Cleaning and show me the table first") and the AI talks to the store through its API. You don't need to understand anything that happens behind the scenes: the prompt in step 3 explains it all to the AI.
Step 1: activate the API and copy your key
- Sign in to your admin panel with an admin user and go to Settings → ERP.
- Under API Integrations, pick the API Token card and activate the service. It's a monthly service quoted separately from the plan, available in every country.
- Under API Token settings your key appears. Click Copy token (or Download token file). Right there you also have the View API documentation link and the Regenerate token button in case you ever need to change it.
- Also note your store address, the one your customers see (for example
https://mystore.com).
Step 2: open an AI that works on your computer
The regular browser chat isn't enough: you need the version of your AI that can work on your computer, because that's the one that reads documentation, stores your key and calls the store. Any of these will do:
| Your AI | What to open |
|---|---|
| Claude | The Claude desktop app, Code tab. Choose a new folder (for example "My store") when asked. Claude Code in the terminal works too. |
| ChatGPT | The ChatGPT desktop app, Codex section (included in paid plans). Choose a new folder. |
| Gemini | Gemini CLI in the terminal, inside a new folder. |
| Copilot · Cursor | Visual Studio Code with Copilot in agent mode, or Cursor, with a new folder open. |
Step 3: paste this prompt and fill in two values
Copy it whole, replace [YOUR STORE ADDRESS] and [YOUR KEY] with the values from step 1, and send it. The AI does the rest on its own: it reads the full API documentation, stores the key, tests the connection and tells you what it can do.
I want you to operate my VentasxMayor wholesale store through its API, following these steps in order.
1. READ THE FULL DOCUMENTATION.
Open https://admin.ventasxmayor.com/api-console (the front page explains authentication and lists every endpoint; each endpoint has its own page with parameters, body and example: open them all). If anything is unclear, complement with https://ventasxmayor.com/help-center/integ-api. Available resources: products, images, prices per list, categories, price lists, customers, orders and carts.
2. SAVE MY ACCESS DETAILS.
My store address: [YOUR STORE ADDRESS]
API key: [YOUR KEY]
Save them in a .env file inside this folder (VXM_URL and VXM_TOKEN) and always use the key in the "Authorization: Bearer" header. Don't display it, don't repeat it in the chat and don't upload it anywhere. Endpoints hang from /api/v1/ on the store address.
3. TEST THE CONNECTION.
Make a simple read (for example, the last 3 products). If it returns 401, tell me the key is mis-copied. If it returns 403, tell me the API isn't active yet in my panel (Settings → ERP). Once it works, leave a summary of the API in a NOTES.md file and write down there the date you read the documentation.
4. TELL ME WHAT YOU CAN DO.
Explain in plain language, with no technical terms, which tasks you can do in my store, and ask me for the first one.
5. STANDING RULES.
- Before creating, modifying or deleting anything, show me exactly what you're about to change and wait for my confirmation.
- On bulk changes, first a table with before and after and how many records it affects.
- Respect the API limits: fetch data page by page, and if you get throttled wait and retry; if a resource changed while you were editing it, re-read it before insisting.
- When each task is done, summarize what changed, how many records and what's pending.
- The API gets new endpoints and fields often. When you start working, if more than 7 days have passed since the date written in NOTES.md, re-read the full documentation, update NOTES.md with the new date and tell me what's new. Do the same without waiting 7 days if I ask for something that isn't in your notes or if the API returns a field or an error you don't know.
- Always talk to me in plain language. To try it: your first requests to the AI
Start with queries (they change nothing) and move on to changes once you see it understands your store:
- "List today's orders with customer, total and status, and flag the ones with no payment."
- "Which products in the Cleaning category are out of stock?"
- "Compare the prices of the Wholesale A and B lists for the 50 best-selling products."
- "Raise the Wholesale B list 8% in Cleaning. Show me the table first and wait for my OK."
- "Load the products from this spreadsheet with their photos. Update the ones that already exist."
- "Place Distribuidora Norte's usual order: 20 boxes of RM-204 and 10 of RM-310. Show me the total before confirming."
- "These 12 customers have overdue debt. Block them and note the reason on each record."
If something fails
- The AI says the key isn't valid (401). It was copied incomplete or with an extra space. Go back to Settings → ERP → API Token, click Copy token and hand it over again: "This is the correct key, update it".
- The AI says the API isn't active (403). The service hasn't been activated in your panel yet (Settings → ERP → API Token). Activate it and ask it to try again.
- The AI can't open the documentation. Ask it to use the help center article (the link is in the prompt) or copy the console text and paste it to it.
- The AI asks permission to install or run something. That's normal: it's how it works in your folder. What it should never do is show you the key on screen.
- A change didn't apply and the AI mentions a "conflict" (409). Someone edited the same thing in the panel at the same time. Ask it to re-read and retry.
Other paths, for when you want more
The path above is enough for the vast majority. These are more technical, and the good news is you don't have to build them yourself: you ask the AI you already connected.
- Using the store from the chat app (Claude, ChatGPT, Gemini, Copilot Studio). It needs an MCP connector, the standard those apps use for external tools; VentasxMayor doesn't publish an official one yet. Ask your AI: "Build an MCP server exposing the API endpoints you already know as tools, with the key stored inside, and tell me how to add it to my app". Then you paste it in the app's connector settings (Claude: Customize → Connectors; ChatGPT: Apps & Connectors → Developer mode; Gemini: Connected apps).
- An assistant for your whole team (a custom GPT in ChatGPT or an agent in Microsoft 365 Copilot). It needs a description of the API in OpenAPI format. Ask your AI: "Generate the OpenAPI schema of the API and explain how to load it as an action with Bearer authentication".
- Tasks that run on their own (n8n, Make, Zapier, Power Automate, or your own program). The automation queries the store periodically and an AI summarizes or decides. Ask your AI: "Leave me a script that every Monday at 8 builds the weekly order summary and sends it to me on WhatsApp". The API doesn't send notifications on its own: the automation asks.
