...
This web service retrieves one single currency or a list of currencies (PwsCurrencyRate) based on specified search criteria. If you only provide session ticket, a complete list of system currencies is returned. If disbursed currency identity is provided, a complete list of system currencies with available FX rate calculated against disbursed currency is returned. When incurred currency is also provided, only incurred currency, instead of the complete list of currencies, is returneddefault VAT percentage based on the expense type (PwsExpenseTypeRef) and location (PwsLocationRef) provided in the request.
Request Format
| Panel | ||
|---|---|---|
| ||
|
Request Elements
Element | Data Type | Required? | Default | Description | Sample Data |
|---|---|---|---|---|---|
RequestId | Int32 |
No | Click here for more information. |
SessionTicket | String |
Yes | Click here for more information. |
LocationIdentity
ATtU220EvBSE2+GCN9U58g== | |
ExpenseTypeIdentity |
Yes | The expense type for which to retrieve the VAT percentage. Click here for more information. | ||||
LocationIdentity | Yes | The location for which to retrieve the VAT percentage. Click here for more information. | |||
| DisbursingCostCenterIdentity | PwsCostCenterRef | No | If cost center disallow VAT on expense, then the VAT is 0.00 regardless of expense type and location. |
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:tim="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/"> <soapenv:Header/> <soapenv:Body> <pws:PwsGetDefaultVatPercentage> <pws:serviceRequest> <req:SessionTicket>AYpG7EHMig6Q0YYpVJ3YDQ==</req:SessionTicket> <tim:ExpenseTypeIdentity> <com:ExpenseTypeName>Travel-AR</com:ExpenseTypeName> </tim:ExpenseTypeIdentity> <tim:LocationIdentity> <com:LocationName>Boston</com:LocationName> </tim:LocationIdentity> <tim:DisbursingCostCenterIdentity> <com:CostCenterNumber>CA</com:CostCenterNumber> </tim:DisbursingCostCenterIdentity> </pws:serviceRequest> </pws:PwsGetDefaultVatPercentage> </soapenv:Body> </soapenv:Envelope> |
Response Format
| Panel | ||
|---|---|---|
| ||
|
Response Elements
Element | Data Type |
|---|
Required?
Default
Description | Sample Data |
|---|---|
Messages |
The web service response status and message. Click here for more information. | ||
ResponseId | Int32 |
Click here for more information. |
| Status | RequestStatus |
| Click here for more information |
| Ok | |
ServerTimestampUtc | DateTime |
Click here for more information. |
2018-03-13T15:24:27.1225758Z | |
VatPercentage | Double |
The default VAT percentage of the specified expense type at the specified location | 0.175 |
Response Usage Example(s)
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <PwsGetDefaultVatPercentageResponse xmlns="http://projectorpsa.com/PwsProjectorServices/"> <PwsGetDefaultVatPercentageResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" 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/">0</ResponseId> <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status> <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-13T15:24:27.1225758Z</ServerTimestampUtc> <a:VatPercentage>0.175</a:VatPercentage> </PwsGetDefaultVatPercentageResult> </PwsGetDefaultVatPercentageResponse> </s:Body> </s:Envelope> |
PwsGetDefaultVatPercentage - Common Errors and Warnings
- For all errors and warnings please refer to the Complete List of Errors and Warnings
| ErrorNumber | ErrorCode | ErrorText |
|---|---|---|
| 19013 | ExpenseTypeRequiredForGetDefaultVatPercentage | No expense type was specified. |
| 19014 | LocationRequiredForGetDefaultVatPercentage | No location was specified. |
| 57541 | LocationNotFound | Specified location does not exist. |
| 59912 | ExpenseTypeNotFound | Cost code (i.e. Expense Type) not found. |