Common Sage 300 ERP Connection Issues

This section explains the most common health check issues found for organizations using the Sage 300 adapter. Each described error focuses on what the issue means, possible causes, and how to proceed.

Select one of the following error types to view more details.

Username and Password is Required
The Specified Username or Password is Incorrect
ERP Health Check Call is Taking More Than 7200 Seconds
Connection Timed Out While Establishing DLL Connection / Check Pop Ups in Sage
ERP DLL connection check failed with blank error
Example

ERP DLL connection check failed for DSN : [DSN] and Company : [Company] and Error: [blank].

Meaning

The Sage 300 DLL connection check failed, but Sage did not return a detailed error message.

Possible Causes
- Sage 300 failed before returning a useful error.
- The DSN or Sage 300 runtime is not configured correctly.
- The ERP client, database driver, or integration component may be unavailable.
- A local Sage 300 prompt or environment issue interrupted the connection.
- The failure may require a backend log review to identify the real cause.
Recommended Resolution

Contact Textura Support, your ERP administrator, or your ERP consultants. Troubleshooting usually requires reviewing ERP-side logs, local Sage 300 behavior, and integration logs.
Invalid Data Folder
Conversion from String to Number Failed with Blank Value

General Guidance for End Users

If you see one of these errors, it does not necessarily mean you did something wrong. In most cases, the issue is related to authentication, Sage 300 configuration, DSN setup, ERP availability, local Sage prompts, data folder access, or ERP-side permissions.

Next Steps

Capture the error message exactly as shown.
Note the approximate date and time.
Share the org ID and any related transaction details, if available.
Contact Textura Support, your ERP administrator, or your ERP consultants for investigation and resolution.
Note: Do not share passwords in support tickets or screenshots.

Username and Password is Required

The Specified Username or Password is Incorrect

ERP Health Check Call is Taking More Than 7200 Seconds

Connection Timed Out While Establishing DLL Connection / Check Pop Ups in Sage

ERP DLL connection check failed with blank error

Invalid Data Folder

Conversion from String to Number Failed with Blank Value

Next Topic: Username and Password is Required