...
This web service retrieves one single currency or a list of currencies (PwsCurrencyRate) based on specified search criteria. If you only provide session ticketdo not specify the currency to retrieve, a complete list of system currencies is returned. If a disbursed currency identity is provided, a complete list of system currencies with the available FX rate calculated against disbursed currency is returned. When data for conversion to and from the specified disbursed currency will be included in the response for each currency. If you do not specify a disbursed currency, but do specify a resource identity, the resource's disbursing currency is used. If neither a disbursed currency identity nor a resource identity are provided, the FX rate data will be null in the response. When an incurred currency is also provided, only incurred the specified currency, instead of the complete list of currencies, is returned.
...
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== | |
DisbursedCurrencyIdentity | No | If provided, it is used to calculate FX rate against the complete list of system currencies or one incurred this response for each incurred currency will include the FX rate for conversion to or from the specified disbursed currency. | |||
EffectiveDate | DateTime | No | Today's date | It This date is used to calculate determine the FX rate between the specified disbursed currency and the incurred currency or a list of system currencies.0.2496 | 2018-01-01z |
IncurredOpsCurrencyIdentity | No | If not provided, a complete of system currencies is returned, Otherwise, this currency is returned in the response | |||
ResourceIdentity | No | It If specified, this resource is used to calculate determine the disbursed currency when disbursed currency identity is not provided in the request. |
...
| 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:PwsGetCurrencies>
<pws:serviceRequest>
<req:SessionTicket>ATtU220EvBSE2+GCN9U58g==</req:SessionTicket>
<tim:DisbursedCurrencyIdentity>
<com:CurrencyCode>JPY<CurrencyCode>CAD</com:CurrencyCode>
</tim:DisbursedCurrencyIdentity>
<tim:EffectiveDate>2018-01-01z</tim:EffectiveDate>
<tim:IncurredOpsCurrencyIdentity>
<com:OpsCurrencyCode>JPY<OpsCurrencyCode>USD</com:OpsCurrencyCode>
</tim:IncurredOpsCurrencyIdentity>
<tim:ResourceIdentity>
<com:ResourceDisplayName>Larry Krakauer</com:ResourceDisplayName>
</tim:ResourceIdentity>
</pws:serviceRequest>
</pws:PwsGetCurrencies>
</soapenv:Body>
</soapenv:Envelope> |
...
| 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. | 0 |
| Status | RequestStatus | Click here for more information | Ok |
ServerTimestampUtc | DateTime | Click here for more information. | 2018-03-13T13:42:05.2909846Z |
Currencies | The basic currency information and Fx rate between disbursed and incurred currencies. |
Response Usage Example(s)
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<PwsGetCurrenciesResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
<PwsGetCurrenciesResult 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-13T1313T14:4217:0528.2909846Z<8610811Z</ServerTimestampUtc>
<a:Currencies>
<a:PwsCurrencyRate>
<a:Currency xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
<b:OpsCurrencyCode>JPY<OpsCurrencyCode>USD</b:OpsCurrencyCode>
<b:OpsCurrencyId i:nil="true"/>
<b:CurrencyIdentity>
<b:CurrencyCode>JPY<CurrencyCode>USD</b:CurrencyCode>
<b:CurrencyId i:nil="true"/>
<b:CurrencyUid>1152921504606850741<CurrencyUid>1152921504606849879</b:CurrencyUid>
</b:CurrencyIdentity>
<b:CurrencyName>JapaneseCurrencyName>United States Yen<Dollars</b:CurrencyName>
<b:DecimalDigits>0<DecimalDigits>2</b:DecimalDigits>
<b:InactiveFlag>false</b:InactiveFlag>
<b:InstallationCurrencyInactiveFlag>false</b:InstallationCurrencyInactiveFlag>
</a:Currency>
<a:FxRate>1<FxRate>2</a:FxRate>
</a:PwsCurrencyRate>
</a:Currencies>
</PwsGetCurrenciesResult>
</PwsGetCurrenciesResponse>
</s:Body>
</s:Envelope>
|
PwsGetCurrencies - Common Errors and Warnings
- For all errors and warnings please refer to the Complete List of Errors and Warnings
| ErrorNumber | ErrorCode | ErrorText |
|---|---|---|
| 57530 | CurrencyNotValidForAccount | The specified currency is not enabled for this account. |
| 57545 | ResourceNotFound | The specified resource does not exist. |