Skip to main content

Updates, moving and removing

What this covers​

Keeping the agent up to date, moving it to another PC, and removing it.

Before you start​

You need permission to manage connectors in the GoRoute portal.

Steps​

Update the agent​

  1. When a new version is published, the agent's card under Connectors shows update available and the version. The agent window's Home tab says Update available.
  2. Open the agent page in the portal and click Update to the new version.
  3. Within a minute the agent downloads the new installer and checks two things: that it is exactly the file GoRoute published, and that it is signed by ClayDesk. If either check fails, the file is deleted and not run, and Recent commands says why.
  4. The agent installs the update quietly and starts again. The portal shows the new version within a few minutes.

Your settings, tax-code table, queue and record of what has been sent are kept. Nothing is sent twice: each invoice carries a key made from the company and the invoice number, and GoRoute recognises a repeat.

You can also run a new signed installer by hand, on the same PC and as the same Windows user. It does the same.

What a release note looks like. Each version is listed in Release notes: what is new, what is fixed, and anything you need to do.

Move the agent to a new PC or a new Windows user​

The agent's key is protected for the Windows user it was installed for. Another PC, or another user on the same PC, cannot read it. So you install again:

  1. On the old PC, uninstall the agent first. Two agents must never watch the same company.
  2. In the portal, open the agent page and click New enrolment code. The new installation pairs with the same connection, so its history stays in one place.
  3. On the new PC, follow Install and connect. On Invoices Already in Sage, choose Only invoices posted from today onwards.
  4. Confirm the tax codes again on the Tax codes tab.

Remove the agent​

  1. On the Sage PC, open Start ▸ GoRoute ▸ Uninstall GoRoute Sage 50 Agent, or uninstall GoRoute Sage 50 Agent from Settings ▸ Apps in Windows.
  2. In the portal, open the agent page and click Remove if you are not installing it again.
  3. If you are removing it for good, delete the GOROUTE user in Sage under Settings ▸ Access Rights.

What you should see​

After an update, the portal shows the new version and Online. After removal, the agent no longer starts with Windows.

What uninstalling leaves behind​

On purpose, uninstalling leaves your records:

Left in placeWhere
The agent's settings, tax-code table, queue and log%APPDATA%\GoRoute\Sage50Agent for that Windows user
The supplier-invoice import files and PDFsC:\Users\Public\Documents\GoRoute Sage 50\Supplier invoices
The GOROUTE userSage, until you delete it

Delete the folders by hand if you want the PC clean. Uninstalling changes nothing inside your Sage data: no records, layouts or settings are touched by install, update or removal.

If it does not work​

You seeWhat to do
The update failed in Recent commandsRead the result. A file that failed a check was not run. Try again later, or ask GoRoute for the signed installer.
No Update to buttonThe agent is already on the newest version, or it is offline.
The agent on the new PC sends nothingConfirm the tax codes on the Tax codes tab.

Written for agent 0.2.x and the GoRoute portal release of 31 October 2026.

Last updated on