Anything that happens during a run of DOTS Address Detective that causes it to be unable to finish its normal processing is an error. If an error occurs, something similar to the following will result instead of the normal/typical 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.
Error Types
| Type | TypeCode | Billable | Standard Across 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
- Theses 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
- User Input errors are caused when a user inputs an invalid value or fails to provide a certain input field altogether. If a developer creates a request and mistypes a parameter name, it will probably cause a User Input Error.
| DescCode | Desc |
|---|---|
| 1 | Address and Address2 fields were too long. Together, they must be 100 characters or less. |
| 2 | Address field was too long, must be 100 characters or less. |
| 3 | Please input a street address. |
| 4 | Please input either zip code or both city and state. |
| 5 | You must input a time out value in the timeout field. |
| 6 | Invalid timeout value. Please enter a timeout value of 200 miliseconds or more. |
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 Address Detective 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 common errors seen in Service Objects services. Domain Specific errors indicate that the service completed successfully but the result is not good.
| DescCode | Desc |
|---|---|
| 1 | Address not found |
| 2 | Firm/Highrise name conflict |
| 3 | Multiple addresses match |
| 4 | Insufficient address data |
| 5 | Please enter a valid address number. |
| 6 | PR Urb not found in city street list |
| 7 | Street not found |
| 8 | Street number or box number out of range |
| 9 | Address could not be found, search timed out. |
| 10 | City has no streets (Unable to load street list) |
| 11 | Error initializing service |
| 12 | Internal error. |
| 13 | Server busy. Please try your request again. |
| 14 | City not found |
| 15 | State not found |
| 16 | DPV Lockout. Contact Service Objects immediately. |
| 17 | Address not found but the region has General Delivery service |