Reference translation
This page is a courtesy translation. The Spanish version is the authoritative reference.
Test SES credentials
Before sending a real report, you can test your credentials with the Ministry to confirm they're correct. It's the fastest way to rule out credential issues when a submission fails.
Owner and Admin only
The test-connection action is only available to Owner and Administrator roles. It is rate-limited to 10 attempts per minute.
Automatic verification
You don't have to keep an eye on it: RegistroViajero checks your credentials on its own. Every time you save or edit a set of credentials —and once a day as well— it sends a read-only query to the Ministry to confirm they're still valid. This check generates no guest report.
- Status badge in the list. In Settings → Agency → SES Credentials, each credential shows its status next to the label:
- Verified — the Ministry accepts them.
- Rejected by the Ministry — the Ministry has stopped accepting them (usually an expired or wrong password).
- Not verified — they couldn't be checked yet (for example, the Ministry's service wasn't responding at the time).
- Automatic alert. If the Ministry stops accepting a credential, you get a notification right away —in the app and as a push alert— without clicking Test connection. That way you find out before a real submission fails, not when a guest's report bounces.
- It clears on its own. If you later fix the credential and it works again, the alert goes away. If it fails again, we alert you again.
The manual Test connection button stays available as an on-demand check (below).
How to test
- Go to Settings → Agency and find the SES Credentials section.
- Open the credential form: click Add credential for new ones, or the edit (pencil) icon on an existing credential to open Edit credential.
- Inside the form, click Test connection.
- RegistroViajero sends a probe request to the Ministry (no actual guest report is generated — it's only a verification).
- You'll see the result in a few seconds: Successful or a specific error message.
Possible results
| Result | What it means | What to do |
|---|---|---|
| Connection successful | The Ministry accepts the credentials and the account has telematic submission enabled. | Nothing — you can submit reports now. |
| Invalid username or password | The Ministry rejects the sign-in. | Review the username and password. Remember these are your SES web-service credentials, not the portal login. |
| Lessor code not registered | The lessor code doesn't match your SES.HOSPEDAJES registration. | Verify the lessor code in Settings → Agency → SES Credentials; it must match your SES.HOSPEDAJES registration exactly. |
| Account not enabled for the web service | The credentials are valid but the account doesn't have web-service submission enabled yet. | Request activation through the SES.HOSPEDAJES portal (Sede Electrónica → enable communications via web service). |
| Account lacks permission | The account exists but lacks submission permission. | Contact SES.HOSPEDAJES support. |
| The Ministry is unreachable | Temporary outage of the Ministry's service. | Wait a few minutes and try again. |
| Too many attempts | You have run 10 tests in under a minute. | Wait 1 minute before retrying. |
When to test
- After creating new credentials — to catch typos before submitting anything.
- If a submission fails with a credentials error — to confirm whether it's a credentials issue or a data issue.
- After renewing the password in the Ministry portal — the test confirms the new password is active.
Automatic verification already covers the day-to-day
The status badge and the automatic alert monitor your credentials continuously, so you don't need to test by hand as a routine. The manual test is most useful when you want to confirm a fix right away —for example, just after renewing the password— without waiting for the next automatic check.
If the test passes but a real submission fails
If the test says Connection successful but a later submission goes to Rejected, the problem is in the guest data, not in the credentials. Open the registration and check the Ministry message to find the field to fix. More detail in Ministry errors.
Why there's a limit
The Ministry can temporarily block accounts that send too many queries in a short time. RegistroViajero caps testing at 10 attempts per minute to protect you from accidental lockouts caused by repeated retries.