...
| Panel | ||
|---|---|---|
| ||
|
Request Elements
Element | Data Type | Required? | Default | Description | Sample Data |
|---|---|---|---|---|---|
RequestId | Int32 | No | Click here for more information. | 1 | |
SessionTicket | String | Yes | Click here for more information. | AV795EkfoxzwEpVD7pZJJA== | |
IncludeInactiveFlag | Boolean | No | false | If set to 'true', inactive vendors will be included in the response. This flag is disregarded if a vendor is specified in VendorIdentity. | true |
IncludeResourceVendorsFlag | Boolean | No | false | If set to 'true', resource vendors will be included in the response. A resource vendor is someone who paid an expense out of their own pocket. In essence they are a virtual vendor that needs to be reimbursed just like any subcontractor vendor or supplier. This flag is disregarded if a vendor is specified in VendorIdentity. | true |
MaxRowsToReturn | Int32 | No | The maximum number of vendors to be returned. This value is disregarded if a vendor is specified in VendorIdentity. | 10 | |
String (255) | No | A search string to narrow down the results. A vendor will be included in the results if the search string matches the VendorName or VendorNumber. This value is disregarded if a vendor is specified in EngagementTypeIdentity. | |||
VendorIdentity | Yes | For this service, the caller may specify a vendor identity to retrieve a specific vendor summary. If a vendor identity is not specified all vendors fitting the other specified criteria will be returned. |
Request Usage Example(s)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
<soapenv:Header/>
<soapenv:Body>
<pws:PwsGetVendorList>
<pws:serviceRequest>
<req:RequestId>1</req:RequestId>
<req:SessionTicket>AV795EkfoxzwEpVD7pZJJA==</req:SessionTicket>
<req:IncludeInactiveFlag>true</req:IncludeInactiveFlag>
<req:IncludeResourceVendorsFlag>true</req:IncludeResourceVendorsFlag>
<req:MaxRowsToReturn>10</req:MaxRowsToReturn>
</pws:serviceRequest>
</pws:PwsGetVendorList>
</soapenv:Body>
</soapenv:Envelope> |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
<soapenv:Header/>
<soapenv:Body>
<pws:PwsGetVendorList>
<pws:serviceRequest>
<req:RequestId>1</req:RequestId>
<req:SessionTicket>AV795EkfoxzwEpVD7pZJJA==</req:SessionTicket>
<req:VendorIdentity>
<com:VendorName>American Express</com:VendorName>
</req:VendorIdentity>
</pws:serviceRequest>
</pws:PwsGetVendorList>
</soapenv:Body>
</soapenv:Envelope> |
Response Format
| Panel | ||
|---|---|---|
| ||
|
Response Elements
Element | Data Type | Description | Sample Data |
|---|---|---|---|
Messages | The web service response status and message. Click here for more information. |
| |
ResponseId | Int32 | Click here for more information | 1 |
Status | Click here for more information | Ok | |
ServerTimestampUtc | DateTime | Click here for more information | 2018-03-05T18:56:29.1103449Z |
Vendors | PwsVendorSummary [???] | The vendor summary records that were fetched by the service |
|
Response Usage Example(s)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<PwsGetVendorListResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
<PwsGetVendorListResult xmlns:a="http://projectorpsa.com/DataContracts/Responses/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Messages xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
<ResponseId xmlns="http://projectorpsa.com/CommonServices/">1</ResponseId>
<Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
<ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-05T18:56:29.1103449Z</ServerTimestampUtc>
<a:Vendors xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
<b:PwsVendorSummary>
<b:VendorId i:nil="true"/>
<b:VendorName>American Express</b:VendorName>
<b:VendorUid>1152921504606937722</b:VendorUid>
<b:VendorNumber>AMEX001</b:VendorNumber>
<b:ExpenseReportPayeeFlag>false</b:ExpenseReportPayeeFlag>
<b:InactiveFlag>true</b:InactiveFlag>
<b:ResourceVendorFlag>false</b:ResourceVendorFlag>
<b:VendorInvoicePayeeFlag>false</b:VendorInvoicePayeeFlag>
<b:SubcontractorInvoicePayeeFlag>false</b:SubcontractorInvoicePayeeFlag>
</b:PwsVendorSummary>
</a:Vendors>
</PwsGetVendorListResult>
</PwsGetVendorListResponse>
</s:Body>
</s:Envelope> |