Roraima Vendor Guide
AI connections and offers API
Menu path
Seller tools → Connected AI and management software. This page shows the external programs authorized to use your Roraima account and lets eligible suppliers create personal offer keys. It separates Connected AI, Management software for offers and Offers API keys because their access serves different purposes. Disconnecting a program or revoking a key immediately stops that access.
Connected AI
This section lists AI connections for the account. Start a new connection from the AI you intend to use. This page lets you review an existing connection and remove its access.
An offer-management connection does not grant the permissions of a connected AI. Authorize each program for the work it needs to do. The panel's built-in assistant is not an external connection in this list.
Connect management software through the offers API
The Management software for offers section lists programs connected through the Roraima offers API. This API lets a compatible program read your company's linked offers and send updates to prices, active status and device stock after you authorize it. Only your company's main account holder can authorize or disconnect a program.
The program must be compatible with Roraima, and the connection starts from that program. Ask its provider whether it supports the connection if you cannot find Roraima among its options. There is no general-purpose connection that makes every management program compatible.
- Start the Roraima connection from the management program.
- Sign in to Roraima when requested and review the access the program is asking for.
- Authorize it with the company's main account holder. Return to Connected AI and management software to review the connection.
- To let it send automatic changes, open Offer updates, select Management software, choose the authorized program and confirm that it is your automatic update method.
Giving access and choosing automatic updates are separate actions. Until selected, an authorized program does not supply automatic changes. The selected program can update existing offer prices, active status and device stock. It cannot create new offers or catalogue items, update stock for installation services, or handle orders and bookings.
API keys and authorization
An Authorized Supplier's main account holder can create a personal key under Offers API keys. This is available to suppliers approved as a Seller, an Installer or both. Permission to use CSV files or spreadsheets alone does not grant access to API keys.
- Enter a recognizable name for the program in Key name, using 1 to 80 characters.
- Press Create API key. Use Copy key, keep the value in a safe place and enter it in your program before leaving or reloading this page.
- Follow Offer updates, select the key's name under Management software and press Use this program for updates when you want that program to send automatic changes.
The key is shown only once. After you leave or reload the page, the list shows its name, connection date and last use, without revealing the value again. Before the first use, Last used shows Never. If you lose the value, revoke that key and create another.
Your company can have up to three active keys. They have no automatic expiry and remain valid until revoked. Creating a key does not change the automatic update method: you still select its name in Offer updates before it can send changes. Keys use the same company limits and offer rules as programs connected by authorization.
Programs that start their own authorization connection remain supported. In that case, Roraima sends access credentials directly to the program, which handles their renewal; you do not need to create a personal key.
Revoke a personal key
Find the key in Offers API keys, press Revoke and confirm the request. Its row disappears from the active list and the program using it loses access through that key. Revocation does not undo changes already saved to your offers.
If you revoke the key selected for automatic updates, a previous CSV or Google Sheets connection stays disabled. Return to Offer updates and choose and enable the source you want to use next.
Review or disconnect a program
When a section has no connections, it displays No programs connected. With a connection present, identify the program you want to review or disconnect.
Use the disconnect action for the program you want to remove, and confirm the request. Its access stops immediately. To use it again, start a new connection from that program and authorize it again.
Disconnecting does not undo changes already made to your offers. Review and correct those offers separately. If that program was your automatic method, disconnecting it does not switch a previous CSV or Google Sheets source back on. Return to Offer updates and deliberately choose and enable the source you want to use next.
Field reference
| Label | Purpose | Instruction | Requirement or condition |
|---|---|---|---|
| Connected AI | Lists the account's external AI connections. | Review the connection or use its disconnect action. | Empty sections show No programs connected. |
| Management software for offers | Lists programs authorized for company offers. | Review the program before choosing it for automatic updates. | Authorized Supplier connection. |
| Offers API keys | Lists your active personal offer keys. | Review the name, Connected on, Last used and the Revoke action. | Authorized Supplier's main account holder; up to three active keys per company. |
| Key name | Identifies the program that will use the key. | Enter a recognizable name using 1 to 80 characters. | Required when creating a key. |
| Copy key | Copies the value just created. | Keep it in a safe place and enter it in your program before leaving or reloading the page. | The value is visible only immediately after creation. |
| Offer updates | Opens the choice of automatic update method. | Select the key's name under Management software and press Use this program for updates. | Creating a key does not select it automatically. |
If an update fails after you reconnect, check both the authorization here and the automatic method selected in Offer updates. Complete missing selling requirements on the offer itself. For wrong prices or stock, check the values in your management program, including how it counts Roraima sales, before asking it to send them again.