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



Generally, an error is anything that happens during a run of DOTS Phone Append 2 that causes the service to fail. If an error occurs, an XML error message, similar to the one below, will result instead of the PhoneInfoResult output described above:


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


These are standard to all Generation 2 DOTS Web Services.

Desc CodeDescription
0Please provide a valid license key for this web service.
1The daily allowable number of transactions for this license key has been exceeded.
2The monthly allowable number of transactions for this license key has been exceeded.
3The total allowable number of transactions for this license key has been exceeded.
4There are not enough transactions available. Check your daily/monthly transaction limits.
5This license key has expired.
6This license key has not yet been activated.
7This operation is limited to specific usage. Please contact customer service to have your key enabled.
8Your 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.

Desc CodeDescription
1Please enter a LicenseKey.
2Please enter a City/State or PostalCode.
3Please provide a name.

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 an application fault in the DOTS Phone Append 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 common errors seen in Service Objects services. Domain Specific errors indicate that the service completed successfully but the result is not good.

DescCode

Description

1

No phone number found for the given criteria.

2

Bad address information. Required fields: City/state or Postal Code are missing.
3Operation not supported.



  • No labels