OrderService Web Service

OrderService

Click here for a complete list of operations.

TaxCertReady

Used For Example only - non functional on this site.

When configured by ValueCheck to do so, this customer implemented method will be called by the ValueCheck Title Automation Systems when an Tax Cert Reqeust has been completed.

Notes on usage:

It must be implemented by the customer as an HTTP-SOAP Web Service.
ValueCheck must enable this.
Each Tax Cert Reqeust that needs notification must have the 'ClientWebServiceAddress' set to the URL of the Web Service that implements this method at the time the operation OrderTaxCert is called to request the Tax Cert.

Arguments:

Argument

Description

order

The Order identifier.

VCAppID	Application Identifier provided by ValueCheck.
VCClientID	Customer Identifier provided by ValueCheck.
AccountNum	Customer supplied Identifier to indicate individual user or Account.
OrderNum	Unique Order Number assigned to this order.
Submitted	Timestamp of this request.

Will contain the same information as what was posted with the Order without the authentication credentials.

Sts

Status	Value	Description
1	Found	Tax Cert is found and ready to be download via the GetImage method.
2	InProgress	Tax Cert is currently being obtained. (This will not normally be sent to this method)
4	Manual	Tax Cert has been requested and should be manually processed by the county
-1	NotFound	Unable to find the Tax Cert.
-2	NotSupported	Tax Certs are not supported in the requested State/County/TitleSystem.
-3	DoesNotExist	Tax Cert does not exist.
-4	NotAuthorized	Client not authorized to obtain Tax Cert.

statusInfo

More infomation about the order. Most likely will contain a textual description about a problem.

TaxCertXml

More information about the order in a structure customized for the customer if neeeded. Currently will return this content:

<TaxCertInfo>
  <Pin>Pin#</Pin>
</TaxCertInfo>

Returns: The customer returns a Status Object that contains:

Return	Description
AccountNum	Must be the same as sent in the order.
OrderNum	Must be the same as sent in the order.
Sts	Zero to acknowledge the status update. Non-Zero to indicate a problem.
Description	Textual information about the Sts.
StsDate	TimeStamp of response.

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TA_WS/OrderService.asmx HTTP/1.1
Host: www.valuecheckonline.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://TitleAutomation.valuecheck.com/TaxCertReady"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <TaxCertReady xmlns="http://TitleAutomation.valuecheck.com/">
      <order>
        <VCAppID>int</VCAppID>
        <VCClientID>int</VCClientID>
        <AccountNum>string</AccountNum>
        <OrderNum>string</OrderNum>
        <Submitted>dateTime</Submitted>
      </order>
      <status>Unknown or Found or InProgress or Manual or NotFound or NotSupported or DoesNotExist or NotAuthorized</status>
      <statusInfo>string</statusInfo>
      <TaxCertXml>string</TaxCertXml>
    </TaxCertReady>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <TaxCertReadyResponse xmlns="http://TitleAutomation.valuecheck.com/">
      <TaxCertReadyResult />
    </TaxCertReadyResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TA_WS/OrderService.asmx HTTP/1.1
Host: www.valuecheckonline.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <TaxCertReady xmlns="http://TitleAutomation.valuecheck.com/">
      <order>
        <VCAppID>int</VCAppID>
        <VCClientID>int</VCClientID>
        <AccountNum>string</AccountNum>
        <OrderNum>string</OrderNum>
        <Submitted>dateTime</Submitted>
      </order>
      <status>Unknown or Found or InProgress or Manual or NotFound or NotSupported or DoesNotExist or NotAuthorized</status>
      <statusInfo>string</statusInfo>
      <TaxCertXml>string</TaxCertXml>
    </TaxCertReady>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <TaxCertReadyResponse xmlns="http://TitleAutomation.valuecheck.com/">
      <TaxCertReadyResult />
    </TaxCertReadyResponse>
  </soap12:Body>
</soap12:Envelope>