Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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
titlePwsGetDefaultVatPercentage Request


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.

ATtU220EvBSE2+GCN9U58g==

ExpenseTypeIdentity

PwsExpenseTypeRef

Yes


The expense type for which to retrieve the VAT percentage. Click here for more information.


LocationIdentity

PwsLocationRef

Yes


The location for which to retrieve the VAT percentage. Click here for more information.


DisbursingCostCenterIdentityPwsCostCenterRefNo
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
languagexml
titleExample 01
collapsetrue
<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>ATtU220EvBSE2+GCN9U58gSessionTicket>AYpG7EHMig6Q0YYpVJ3YDQ==</req:SessionTicket>
            <tim:ExpenseTypeIdentity>
               <com:ExpenseTypeName>Travel<ExpenseTypeName>Travel-AR</com:ExpenseTypeName>
            </tim:ExpenseTypeIdentity>
            <tim:LocationIdentity>
               <com:LocationName>London<LocationName>Boston</com:LocationName>
            </tim:LocationIdentity>
            <tim:DisbursingCostCenterIdentity>
               <com:CostCenterNumber>CA</com:CostCenterNumber>
            </tim:DisbursingCostCenterIdentity>
         </pws:serviceRequest>
      </pws:PwsGetDefaultVatPercentage>
   </soapenv:Body>
</soapenv:Envelope>

...

Panel
titlePwsGetDefaultVatPercentage Response

Response Elements

Element

Data Type

Required?

Default

Description

Sample Data

Messages

PwsMessage[]

The web service response status and message. Click here for more information.


ResponseId

Int32

Click here for more information.


StatusRequestStatusClick Click here for  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
languagexml
titleExample 01
collapsetrue
<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

ErrorNumberErrorCodeErrorText
19013ExpenseTypeRequiredForGetDefaultVatPercentageNo expense type was specified.
19014LocationRequiredForGetDefaultVatPercentageNo location was specified.
57541LocationNotFoundSpecified location does not exist.
59912ExpenseTypeNotFoundCost code (i.e. Expense Type) not found.