Anything that happens during a run of DOTS GeoPhone Plus 2 that causes it to be unable to finish its normal processing is an error. If an error occurs, something like the following will be the result instead of the normal output:
Example:
*Error!*
<Type>Authorization</Type>
<TypeCode>1</TypeCode>
<Desc>Your license key does not work on this service.</Desc>
<DescCode>8</DescCode>
There are four error types described below. For DOTS GeoPhone Plus 2, the first two will be the most common.
- Error Types
| Type | TypeCode | Billable | Standard for all Gen2 Web Services |
|---|---|---|---|
| Authorization | 1 | No | Yes |
| User Input | 2 | Yes | No |
| Service Objects Fatal | 3 | No | Yes |
| Domain Specific | 4 | Yes | No |
Error type 1: Authorization
- These are standard to all Generation 2 DOTS Web Services.
| DescCode | Desc |
|---|---|
| 0 | Unknown authorization error. |
| 1 | Please provide a valid license key for this web service. |
| 2 | The daily allowable number of transactions for this license key has been exceeded. |
| 3 | The monthly allowable number of transactions for this license key has been exceeded. |
| 4 | The total allowable number of transactions for this license key has been exceeded. |
| 5 | There are not enough transactions available. Check your daily/monthly transaction limits. |
| 6 | This license key has not yet been activated. |
| 7 | This license key has expired. |
| 8 | Your license key does not work on this service. |
Error type 2: User Input
- These errors occur as a result of bad input. DOTS GeoPhone Plus 2 requires all three inputs to be present in order for a proper validation to take place.
| DescCode | Desc |
|---|---|
| 1 | Please input a valid 10 digit phone number. |
| 2 | The Test Type submitted is not valid. |
| 3 | You must input a license key in the LicenseKey field. |
Error type 3: Service Objects Fatal
- The Desc will always be the same and the DescCode has no meaning. This is standard to all Generation 2 DOTS Web Services. This is a rare error that signals either a bug in the DOTS GeoPhone Plus 2 service, or a Network/Connectivity issue.
| DescCode | Desc |
|---|---|
| 1 | Unhandled error. Please contact Service Objects. |
Error type 4: Domain Specific
- Domain specific errors represent the normal errors seen in Service Objects services. For example, if the user is looking for an address in DOTS Address Validation and the address does not exist, a valid domain specific error is “Address not found.”
| DescCode | Desc |
|---|---|
| 1 | Phone Number is not valid. |
| 2 | Country calling code not supported. |