| *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 |