DWH Web Services - KFS Vendor

Detail table: PK (vndr_hdr_gnrtd_id + vndr_dtl_asnd_id)

Address table: PK (vndr_addr_gnrtd_id)

Alias (old vendor) table: PK (vndr_alias_nm + vndr_hdr_gnrtd_id + vndr_dtl_asnd_id)

1 (vndr_hdr_gnrtd_id + vndr_dtl_asnd_id) has N (vndr_addr_gnrtd_id)

isValidKFSVendors(List of (kfsVendorHeaderId, kfsVendorDetailId) )

Input Specifications

Index	Parameter	Description	Required?	Data Type (max length)	Example
0	kfsVendorHeaderId	Vendor Header Generated ID	Y	String (10)	1126
1	kfsVendorDetailId	Vendor Detail Assigned ID	Y	String (10)	1

DB Query

SELECT CONVERT(varchar(10), a.vndr_hdr_gnrtd_id) AS vndr_hdr_gnrtd_id,
       CONVERT(varchar(10), a.vndr_dtl_asnd_id) AS vndr_dtl_asnd_id, 
       'true' AS VALID
FROM PUR_VNDR_DTL_T a
WHERE
(
(a.vndr_hdr_gnrtd_id = '1126' AND a.vndr_dtl_asnd_id = '1') OR 
(a.vndr_hdr_gnrtd_id = '1127' AND a.vndr_dtl_asnd_id = '1') OR
(a.vndr_hdr_gnrtd_id = '0000' AND a.vndr_dtl_asnd_id = '0')
);

Result Schema: A list of following elements (VendorValidation.java)

DB Parameter	Java Parameter	Description	Data Type	Example
vndr_hdr_gnrtd_id	kfsVendorHeaderId	Vendor Header Generated ID	String	1126
vndr_dtl_asnd_id	kfsVendorDetailId	Vendor Detail Assigned ID	String	1
VALID	isValid	is Vendor valid	boolean	true

WS Example

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adc="http://www.adcom.uci.edu">
   <soapenv:Header/>
   <soapenv:Body>
      <adc:isValidKFSVendors>
         <kfsVendorList>
            <item>1126</item>
            <item>1</item>
         </kfsVendorList>
         <kfsVendorList>
            <item>1127</item>
            <item>1</item>
         </kfsVendorList>
         <kfsVendorList>
            <item>0000</item>
            <item>0</item>
         </kfsVendorList>
      </adc:isValidKFSVendors>
   </soapenv:Body>
</soapenv:Envelope>

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:isValidKFSVendorsResponse xmlns:ns2="http://www.adcom.uci.edu">
         <return>
            <kfsVendorDetailId>0</kfsVendorDetailId>
            <kfsVendorHeaderId>0000</kfsVendorHeaderId>
            <valid>false</valid>
         </return>
         <return>
            <kfsVendorDetailId>1</kfsVendorDetailId>
            <kfsVendorHeaderId>1126</kfsVendorHeaderId>
            <valid>true</valid>
         </return>
         <return>
            <kfsVendorDetailId>1</kfsVendorDetailId>
            <kfsVendorHeaderId>1127</kfsVendorHeaderId>
            <valid>true</valid>
         </return>
      </ns2:isValidKFSVendorsResponse>
   </soap:Body>
</soap:Envelope>

Java Client Example

DWHServerService dss = new DWHServerService();
DWHServer ds = dss.getDWHServerPortCustom();


System.out.println("\nWSClient-isValidKFSVendors()");
StringArray sa280 = new StringArray();
sa280.getItem().add("1126");
sa280.getItem().add("1");
StringArray sa281 = new StringArray();
sa281.getItem().add("1127");
sa281.getItem().add("1");
StringArray sa282 = new StringArray();
sa282.getItem().add("0000");
sa282.getItem().add("0");
List<VendorValidation> resultList28 = ds.isValidKFSVendors(Arrays.asList(sa280, sa281, sa282));
if (resultList28 != null) {
	for (Iterator i = resultList28.iterator(); i.hasNext();) {
		VendorValidation element = (VendorValidation)i.next();
		System.out.println("\t" + element.getKfsVendorHeaderId() + "/" + element.getKfsVendorDetailId() + " : " + element.isValid());
	}
} else {
	System.out.println("something bad happened...please check your query");
}

getValidKFSVendors(List of (kfsVendorHeaderId, kfsVendorDetailId) )

Input Specifications

Index	Parameter	Description	Required?	Data Type (max length)	Example
0	kfsVendorHeaderId	Vendor Header Generated ID	Y	String(10)	1126
1	kfsVendorDetailId	Vendor Detail Assigned ID	Y	String(10)	1

DB Query

SELECT CONVERT(varchar(10), a.vndr_hdr_gnrtd_id) AS vndr_hdr_gnrtd_id,
       CONVERT(varchar(10), a.vndr_dtl_asnd_id) AS vndr_dtl_asnd_id, 
       a.vndr_nm,
       a.vndr_duns_nbr
FROM PUR_VNDR_DTL_T a 
WHERE 
(
(a.vndr_hdr_gnrtd_id = '1126' AND a.vndr_dtl_asnd_id = '1') OR 
(a.vndr_hdr_gnrtd_id = '1127' AND a.vndr_dtl_asnd_id = '1') OR
(a.vndr_hdr_gnrtd_id = '0000' AND a.vndr_dtl_asnd_id = '0')
);

Result Schema: A list of following elements (VendorDetails.java)

DB Parameter	Java Parameter	Description	Data Type	Example
vndr_hdr_gnrtd_id	kfsVendorHeaderId	Vendor Header Generated ID	String	1126
vndr_dtl_asnd_id	kfsVendorDetailId	Vendor Detail Assigned ID	String	1
vndr_nm	kfsVendorName	Vendor Name	String	CORNELL UNIVERSITY-ILR
vndr_duns_nbr	kfsVendorDUNSNumber	Vendor DUNS Number	String	0

WS Example

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adc="http://www.adcom.uci.edu">
   <soapenv:Header/>
   <soapenv:Body>
      <adc:getValidKFSVendors>
         <kfsVendorList>
            <item>1126</item>
            <item>1</item>
         </kfsVendorList>
         <kfsVendorList>
            <item>1127</item>
            <item>1</item>
         </kfsVendorList>
         <kfsVendorList>
            <item>0000</item>
            <item>0</item>
         </kfsVendorList>
      </adc:getValidKFSVendors>
   </soapenv:Body>
</soapenv:Envelope>

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getValidKFSVendorsResponse xmlns:ns2="http://www.adcom.uci.edu">
         <return>
            <kfsVendorDUNSNumber>0</kfsVendorDUNSNumber>
            <kfsVendorDetailId>1</kfsVendorDetailId>
            <kfsVendorHeaderId>1126</kfsVendorHeaderId>
            <kfsVendorName>CORNELL UNIVERSITY-ILR</kfsVendorName>
         </return>
         <return>
            <kfsVendorDUNSNumber>0</kfsVendorDUNSNumber>
            <kfsVendorDetailId>1</kfsVendorDetailId>
            <kfsVendorHeaderId>1127</kfsVendorHeaderId>
            <kfsVendorName>THE CENTER QUICKPRINT</kfsVendorName>
         </return>
      </ns2:getValidKFSVendorsResponse>
   </soap:Body>
</soap:Envelope>

Java Client Example

DWHServerService dss = new DWHServerService();
DWHServer ds = dss.getDWHServerPortCustom();

System.out.println("\nWSClient-getValidKFSVendors()");
StringArray sa290 = new StringArray();
sa290.getItem().add("1126");
sa290.getItem().add("1");
StringArray sa291 = new StringArray();
sa291.getItem().add("1127");
sa291.getItem().add("1");
StringArray sa292 = new StringArray();
sa292.getItem().add("0000");
sa292.getItem().add("0");
List<VendorDetails> resultList29 = ds.getValidKFSVendors(Arrays.asList(sa290, sa291, sa292));
if (resultList29 != null) {
	for (Iterator i = resultList29.iterator(); i.hasNext();) {
		VendorDetails element = (VendorDetails)i.next();
		System.out.println("\t" + element.getKfsVendorHeaderId() + "/" + element.getKfsVendorDetailId() + " : " + element.getKfsVendorName() + "/" + element.getKfsVendorDUNSNumber());
	}
} else {
	System.out.println("something bad happened...please check your query");
}

getAllKFSVendors( )

DB Query

SELECT CONVERT(varchar(10), a.vndr_hdr_gnrtd_id) AS vndr_hdr_gnrtd_id,
       CONVERT(varchar(10), a.vndr_dtl_asnd_id) AS vndr_dtl_asnd_id, 
       a.vndr_nm,
       a.vndr_duns_nbr
FROM PUR_VNDR_DTL_T a;

Result Schema: Same as getValidKFSVendors()

WS Example

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adc="http://www.adcom.uci.edu">
   <soapenv:Header/>
   <soapenv:Body>
      <adc:getAllKFSVendors/>
   </soapenv:Body>
</soapenv:Envelope>

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getAllKFSVendorsResponse xmlns:ns2="http://www.adcom.uci.edu">
         <return>
            <kfsVendorDUNSNumber>0</kfsVendorDUNSNumber>
            <kfsVendorDetailId>0</kfsVendorDetailId>
            <kfsVendorHeaderId>1124</kfsVendorHeaderId>
            <kfsVendorName>AJAX SIGN GRAPHICS, INC</kfsVendorName>
         </return>
         <return>
            <kfsVendorDUNSNumber>0</kfsVendorDUNSNumber>
            <kfsVendorDetailId>0</kfsVendorDetailId>
            <kfsVendorHeaderId>1125</kfsVendorHeaderId>
            <kfsVendorName>AJAX SIGN GRAPHICS, INC</kfsVendorName>
         </return>

         ...
         ...
      </ns2:getAllKFSVendorsResponse>
   </soap:Body>
</soap:Envelope>

Java Client Example

DWHServerService dss = new DWHServerService();
DWHServer ds = dss.getDWHServerPortCustom();


System.out.println("\nWSClient--getAllKFSVendors()================================");
List<VendorDetails> resultList30 = ds.getAllKFSVendors();
if (resultList30 != null) {
	System.out.println("getAllVendor-total size: " + resultList30.size());
	System.out.println("getAllVendor-1st item HeaderId / DetailId : VendorName / DUNSNumber" + ((VendorDetails)resultList30.get(0)).getKfsVendorHeaderId() + "/" + ((VendorDetails)resultList30.get(0)).getKfsVendorDetailId() + " : " + ((VendorDetails)resultList30.get(0)).getKfsVendorName() + "/" + ((VendorDetails)resultList30.get(0)).getKfsVendorDUNSNumber());
} else {
	System.out.println("something bad happened...please check your query");
}

isValidKFSVendorAddresses(List of (kfsVendorAddressId) )

Input Specifications

Index	Parameter	Description	Required?	Data Type (max length)	Example
0	kfsVendorAddrId	Vendor Address Generated ID	Y	String(10)	21626

DB Query

SELECT 
CONVERT(varchar(10), a.vndr_addr_gnrtd_id) AS vndr_addr_gnrtd_id,
'true' AS VALID
FROM PUR_VNDR_ADDR_T a 
WHERE a.VNDR_ADDR_GNRTD_ID IN ('21626', '21627', '0000');

Result Schema: A list of following elements (VendorAddressValidation.java)

DB Parameter	Java Parameter	Description	Data Type	Example
vndr_addr_gnrtd_id	kfsVendorAddrId	Vendor Address Generated ID	String	21626
VALID	isValid	is Vendor Address ID valid	boolean	true

WS Example

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adc="http://www.adcom.uci.edu">
   <soapenv:Header/>
   <soapenv:Body>
      <adc:isValidKFSVendorAddresses>
         <kfsVendorAddressList>21626</kfsVendorAddressList>
         <kfsVendorAddressList>21627</kfsVendorAddressList>
         <kfsVendorAddressList>0000</kfsVendorAddressList>
      </adc:isValidKFSVendorAddresses>
   </soapenv:Body>
</soapenv:Envelope>

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:isValidKFSVendorAddressesResponse xmlns:ns2="http://www.adcom.uci.edu">
         <return>
            <kfsVendorAddrId>0000</kfsVendorAddrId>
            <valid>false</valid>
         </return>
         <return>
            <kfsVendorAddrId>21626</kfsVendorAddrId>
            <valid>true</valid>
         </return>
         <return>
            <kfsVendorAddrId>21627</kfsVendorAddrId>
            <valid>true</valid>
         </return>
      </ns2:isValidKFSVendorAddressesResponse>
   </soap:Body>
</soap:Envelope>

Java Client Example

DWHServerService dss = new DWHServerService();
DWHServer ds = dss.getDWHServerPortCustom();


System.out.println("\nWSClient-isValidKFSVendorAddresses()");
List<VendorAddressValidation> resultList31 = ds.isValidKFSVendorAddresses(Arrays.asList(new String[]{"21626", "21627", "0000"}));
if (resultList31 != null) {
	for (Iterator i = resultList31.iterator(); i.hasNext();) {
		VendorAddressValidation element = (VendorAddressValidation)i.next();
		System.out.println("\t" + element.getKfsVendorAddrId() + " : " + element.isValid());
	}
} else {
	System.out.println("something bad happened...please check your query");
}

getValidKFSVendorAddresses(List of (kfsVendorHeaderId, kfsVendorDetailId, kfsVendorAddrType))

Relationship between Vendor and Address is 1:Many, but only get the default one

Input Specifications

Index	Parameter	Description	Required?	Data Type (max length)	Example
0	kfsVendorHeaderId	Vendor Header Generated ID	Y	String(10)	1007
1	kfsVendorDetailId	Vendor Detail Assigned ID	Y	String(10)	0
2	kfsVendorAddrType	Vendor Address Type	Y	String	PO

DB Query

SELECT 
CONVERT(varchar(10), VNDR_HDR_GNRTD_ID) AS VNDR_HDR_GNRTD_ID,
CONVERT(varchar(10), VNDR_DTL_ASND_ID) AS VNDR_DTL_ASND_ID,
VNDR_ADDR_TYP_CD, 
CONVERT(varchar(10), VNDR_ADDR_GNRTD_ID) AS VNDR_ADDR_GNRTD_ID,
VNDR_LN1_ADDR, 
VNDR_LN2_ADDR, 
VNDR_CTY_NM,
VNDR_ST_CD,
VNDR_ZIP_CD,
VNDR_CNTRY_CD
FROM pur_vndr_addr_t 
WHERE VNDR_DFLT_ADDR_IND <> 'N' AND
(
(VNDR_HDR_GNRTD_ID = '1007' AND VNDR_DTL_ASND_ID = '0' AND VNDR_ADDR_TYP_CD='PO') OR 
(VNDR_HDR_GNRTD_ID = '1007' AND VNDR_DTL_ASND_ID = '0' AND VNDR_ADDR_TYP_CD='RM') OR 
(VNDR_HDR_GNRTD_ID = '13788' AND VNDR_DTL_ASND_ID = '3' AND VNDR_ADDR_TYP_CD='PO') OR 
(VNDR_HDR_GNRTD_ID = '13788' AND VNDR_DTL_ASND_ID = '0' AND VNDR_ADDR_TYP_CD='RM') OR 
(VNDR_HDR_GNRTD_ID = '00000' AND VNDR_DTL_ASND_ID = '0' AND VNDR_ADDR_TYP_CD='XX')
);

Result Schema: A list of following elements (VendorAddressDetails.java)

DB Parameter	Java Parameter	Description	Data Type
VNDR_HDR_GNRTD_ID	kfsVendorHeaderId	Vendor Header Generated Id	String
VNDR_DTL_ASND_ID	kfsVendorDetailId	Vendor Detailed Assigned Id	String
VNDR_ADDR_TYP_CD	kfsVendorAddrType	Vendor Address Type	String
vndr_addr_gnrtd_id	kfsVendorAddrId	Vendor Address Id	String
vndr_ln1_addr	kfsVendorAddr1	Vendor Address Line 1	String
vndr_ln2_addr	kfsVendorAddr2	Vendor Address Line 2	String
vndr_cty_nm	kfsVendorCity	Vendor City	String
vndr_st_cd	kfsVendorState	Vendor State	String
vndr_zip_cd	kfsVendorZip	Vendor Zip	String
vndr_cntry_cd	kfsVendorCountry	Vendor Country	String

WS Example

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adc="http://www.adcom.uci.edu">
   <soapenv:Header/>
   <soapenv:Body>
      <adc:getValidKFSVendorAddresses>
         <kfsVendorAddressList>
            <item>1007</item>
            <item>0</item>
            <item>PO</item>
         </kfsVendorAddressList>
         <kfsVendorAddressList>
            <item>1007</item>
            <item>0</item>
            <item>RM</item>
         </kfsVendorAddressList>
         <kfsVendorAddressList>
            <item>13788</item>
            <item>3</item>
            <item>PO</item>
         </kfsVendorAddressList>
         <kfsVendorAddressList>
            <item>13788</item>
            <item>0</item>
            <item>RM</item>
         </kfsVendorAddressList>
         <kfsVendorAddressList>
            <item>00000</item>
            <item>0</item>
            <item>XX</item>
         </kfsVendorAddressList>
      </adc:getValidKFSVendorAddresses>
   </soapenv:Body>
</soapenv:Envelope>

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getValidKFSVendorAddressesResponse xmlns:ns2="http://www.adcom.uci.edu">
         <return>
            <kfsVendorAddr1>338 SO. 4TH STREET</kfsVendorAddr1>
            <kfsVendorAddr2>P.O. BOX 446</kfsVendorAddr2>
            <kfsVendorAddrId>21633</kfsVendorAddrId>
            <kfsVendorAddrType>PO</kfsVendorAddrType>
            <kfsVendorCity>GROVER CITY</kfsVendorCity>
            <kfsVendorCountry>US</kfsVendorCountry>
            <kfsVendorDetailId>0</kfsVendorDetailId>
            <kfsVendorHeaderId>1007</kfsVendorHeaderId>
            <kfsVendorState>CA</kfsVendorState>
            <kfsVendorZip>93483-0446</kfsVendorZip>
         </return>
         <return>
            <kfsVendorAddr1>PO BOX 446</kfsVendorAddr1>
            <kfsVendorAddr2></kfsVendorAddr2>
            <kfsVendorAddrId>21634</kfsVendorAddrId>
            <kfsVendorAddrType>RM</kfsVendorAddrType>
            <kfsVendorCity>GROVER BEACH</kfsVendorCity>
            <kfsVendorCountry>US</kfsVendorCountry>
            <kfsVendorDetailId>0</kfsVendorDetailId>
            <kfsVendorHeaderId>1007</kfsVendorHeaderId>
            <kfsVendorState>CA</kfsVendorState>
            <kfsVendorZip>93483-0446</kfsVendorZip>
         </return>
         <return>
            <kfsVendorAddr1>ONE ZEISS DRIVE</kfsVendorAddr1>
            <kfsVendorAddr2></kfsVendorAddr2>
            <kfsVendorAddrId>21638</kfsVendorAddrId>
            <kfsVendorAddrType>PO</kfsVendorAddrType>
            <kfsVendorCity>THORNWOOD</kfsVendorCity>
            <kfsVendorCountry>US</kfsVendorCountry>
            <kfsVendorDetailId>3</kfsVendorDetailId>
            <kfsVendorHeaderId>13788</kfsVendorHeaderId>
            <kfsVendorState>NY</kfsVendorState>
            <kfsVendorZip>10594-1939</kfsVendorZip>
         </return>
         <return>
            <kfsVendorAddr1>PO BOX 5943</kfsVendorAddr1>
            <kfsVendorAddr2></kfsVendorAddr2>
            <kfsVendorAddrId>21639</kfsVendorAddrId>
            <kfsVendorAddrType>RM</kfsVendorAddrType>
            <kfsVendorCity>NEW YORK</kfsVendorCity>
            <kfsVendorCountry>US</kfsVendorCountry>
            <kfsVendorDetailId>0</kfsVendorDetailId>
            <kfsVendorHeaderId>13788</kfsVendorHeaderId>
            <kfsVendorState>NY</kfsVendorState>
            <kfsVendorZip>10087-5943</kfsVendorZip>
         </return>
      </ns2:getValidKFSVendorAddressesResponse>
   </soap:Body>
</soap:Envelope>

Java Client Example

DWHServerService dss = new DWHServerService();
DWHServer ds = dss.getDWHServerPortCustom();


System.out.println("\nWSClient-getValidKFSVendorAddresses()");
StringArray sa320 = new StringArray();
sa320.getItem().add("1007");
sa320.getItem().add("0");
sa320.getItem().add("PO");
StringArray sa321 = new StringArray();
sa321.getItem().add("1007");
sa321.getItem().add("0");
sa321.getItem().add("RM");
StringArray sa322 = new StringArray();
sa322.getItem().add("13788");
sa322.getItem().add("3");
sa322.getItem().add("PO");
StringArray sa323 = new StringArray();
sa323.getItem().add("13788");
sa323.getItem().add("0");
sa323.getItem().add("RM");
StringArray sa324 = new StringArray();
sa324.getItem().add("00000");
sa324.getItem().add("0");
sa324.getItem().add("XX");
List<VendorAddressDetails> resultList32 = ds.getValidKFSVendorAddresses(Arrays.asList(sa320, sa321, sa322, sa323, sa324));
if (resultList32 != null) {
	for (Iterator i = resultList32.iterator(); i.hasNext();) {
		VendorAddressDetails element = (VendorAddressDetails)i.next();
		System.out.println("\t" + element.getKfsVendorHeaderId() + "/" + element.getKfsVendorDetailId() + "/" + element.getKfsVendorAddrType() + " : " + element.getKfsVendorAddrId() + "/" + element.getKfsVendorAddrId());
	}
} else {
	System.out.println("something bad happened...please check your query");
}

ON HOLD...need to find out the link between old VendorID and new VendorID, right now the vendorAliasNm to (headerId + detailId) are many to many

translatePALVendors(PALVendorID)

Old Vendor Id is Alias Name (VNDR_ALIAS_NM) in Alias table (PUR_VNDR_ALIAS_T)

Input Specifications

Index	Parameter	Description	Required?	Data Type (max length)	Example
0	PALVendorID	Old PAL Vendor ID	Y	String(10)	0005923500

DB Query

SELECT
/*a.VNDR_ALIAS_NM,*/
CONVERT(varchar(10), VNDR_HDR_GNRTD_ID) AS VNDR_HDR_GNRTD_ID,
CONVERT(varchar(10), VNDR_DTL_ASND_ID) AS VNDR_DTL_ASND_ID,
FROM PUR_VNDR_ALIAS_T 
WHERE 
DOBJ_MAINT_CD_ACTV_IND <> 'N' AND 
VNDR_ALIAS_NM = '0421835099';

Result Schema: A list of following elements (VendorDetails.java)

DB Parameter	Java Parameter	Description	Data Type	Example
VNDR_HDR_GNRTD_ID	kfsVendorHeaderId	Vendor Header Generated ID	String	20248
VNDR_DTL_ASND_ID	kfsVendorDetailId	Vendor Detail Assigned ID	String	0