Troubleshoot the RevoSpend Agent
Troubleshoot the RevoSpend Agent: what each status means, agent offline, firewall and clock issues, expired Odoo keys, and how to run Diagnostics.
The RevoSpend Agent tells you exactly what’s wrong — in RevoSpend next to the integration, and in the agent’s own window on your server.
Connection statuses in RevoSpend
| Status | What to do |
|---|---|
| Waiting for agent | The agent hasn’t paired yet. Finish the installation and enter the pairing code. |
| Agent offline | RevoSpend can’t hear from the agent. See below. |
| No company chosen | Click Load companies and choose the Odoo company. |
| Key expires soon | Create a new Odoo API key and enter it in the agent. |
| Key expired | Create a new Odoo API key and enter it in the agent. Transfers resume right away. |
| Connected | Everything’s working. |
Run Diagnostics
Open the agent on the server
On the Windows server, open the RevoSpend Agent window.
Go to Diagnostics
Click Diagnostics, then Check again. It runs the setup checks again and changes nothing.
Read the result
The first failed check tells you where the problem is.
Common problems
Agent offline. Check that the server is on and the RevoSpendAgent service is running. If it has stopped, start it from Windows Services. The service starts automatically with Windows.
“Can’t reach RevoSpend”. The server needs outbound HTTPS to agent.revospend.com on port 443. If your network inspects SSL traffic, exclude this address so the RevoSpend certificate reaches the agent unchanged.
The clock is out of sync. Secure connections need the correct time. Run w32tm /resync on the server.
“Can’t reach Odoo”. Check the Odoo address in the agent’s program settings. It must be the address as seen from that server, including the port.
“API key invalid or expired”. Odoo keys last at most three months. Create a new one in Odoo under Preferences → Account Security and enter it in the agent.
“No permission to write”. The Odoo user behind the API key needs accounting rights in the chosen company.
Keep an eye on transfers
The agent’s Overview shows what it sent, how many lines were written and whether everything read back correctly. It notifies the administrators signed in on the server when a transfer is only partly done or the program stops responding. Pause stops transfers for a while; Resume starts them again.
Companies are removed from the agent in RevoSpend, under Settings → Integrations → Remove connection.