Document-Literal Web Services

PrincipalWUWD

PrincipalWUWD allows you to perform the 4 functions from the interactive LeasePak IBL Principal Adjustment [U0125]--Principal Write-Down, Principal Write-Down Reversal, Principal WriteUp, and Principal Write-Up Reversal--all using the API.

 

API Reference

If you need additional information, Sun Microsystems maintains a Java developers' site at http://java.sun.com that includes API specifications, sample code and applications, and technical articles and tips.

Methods

In order to use any of these methods, you will first need to obtain the current accrued principal balance for the lease or loan. You can do this by using the extractBookLease method of the Web service LPBookLease.

PrincipalWUWD contains 4 methods: writeUp, writeDown, writeUpReversal, and writeDownReversal. For more information, refer to the Java Call Reference. For the most current list of methods available, refer to host:port/service_name/services, where host:port/service_name is the location where you've deployed your web service(s).

 

XML Inputs

The input element principalBalance refers to the current accrued principal balance before making the update to the lease or loan.

Below is the DTD for the writeUp and writeDown methods input file:

<!ELEMENT WUWD (leaseNumber | effectiveDate| bankCode? | amount |checkNumber? | principalBalance )>
<!ELEMENT leaseNumber (#PCDATA)>
<!ELEMENT effectiveDate (#PCDATA)>
<!ELEMENT bankCode (#PCDATA)>
<!ELEMENT amount (#PCDATA)>
<!ELEMENT checkNumber (#PCDATA)>
<!ELEMENT principalBalance (#PCDATA)>

Here is an example based on the above DTD:

<?xml version ="1.0"?><WUWD><leaseNumber>50</leaseNumber>
<effectiveDate>072506</effectiveDate><bankCode>130</bankCode>
<amount>100.00</amount><checkNumber>100</checkNumber>
<principalBalance>1000000.00</principalBalance></WUWD>

On success this returns

<?xml version="1.0"?><WUWD>
<INFO>success message</INFO></WUWD>

On failure this returns

<?xml version="1.0"?><WUWD>
<ERROR>error message</ERROR></WUWD>

Below is the DTD for the writeUpReversal and writeDownReversal methods input file:

<!ELEMENT WUWDR (leaseNumber)>
<!ELEMENT leaseNumber (#PCDATA)> 
<!ELEMENT principalBalance (#PCDATA)>

Here is an example based on the above DTD:

<?xml version ="1.0"?><WUWDR><leaseNumber>50</leaseNumber>
<principalBalance>1000000.00</principalBalance></WUWDR>

On success this returns

<?xml version="1.0"?><WUWDR>
<INFO>success message</INFO></WUWDR>

On failure this returns

<?xml version="1.0"?><WUWDR>
<ERROR>error message</ERROR></WUWDR>