Page tree
Skip to end of metadata
Go to start of metadata



Anything that happens during a run of DOTS Lead Validation International 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 Lead Validation International, the first two will be the most common.

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


These errors are standard for 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 Lead Validation International allows for all input fields to be optional, so the only time this error will show up is with a bad or omitted TestType or Country input.

DescCode

Desc

1TestType is required to run Service.

2

That does not appear to be a valid TestType.

8

The Country input is missing.

9The Country is not currently supported.

Error type 3: Service Objects Fatal


This is a rare error that signals either a bug in the DOTS Lead Validation International 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." There are currently no domain specific errors for Lead Validation International. This is because, in DOTS Lead Validation International, every normal error is not an error but a valid test result that will result in a positive or negative point swing. All possible outcomes from other services are accounted for.


  • No labels