Overview
This web service retrieves a list of expense reports (PwsExpenseDocument) , based upon a list of unique expense document identifiers (PwsExpenseDocumentRef) or resource identifiers (PwsResourceRef)for a specified resource (PwsResourceRef). The caller may optionally specify a unique expense document identifier (PwsExpenseDocumentRef) to retrieve only a specific expense report.
| Info | ||
|---|---|---|
| ||
In order to protect our servers from inadvertent service overuse or intentional attack, and to fairly distribute services to all our customers, we have implemented a rate limiting algorithm. When fully deployed, this new algorithm will cause services to either succeed with new warnings or fail with new errors when services are consumed at too high a rate. Programs that consume Projector services should be enhanced to handle rate limiting errors so that they can continue functioning properly. For more information please visit: Projector Rate Limiting Behavior. |
Request Format
| Panel | ||
|---|---|---|
| ||
|
...
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. | Aa/HJL2aAIqnCD1DEazq8Q== | ||
ExpenseDocumentIdentity | Yes | This structure represents the unique key fields associated with identifying an expense documentNo | An expense document to retrieve (do not specify to retrieve complete list for specified resource. | |||
IncludeUnreceivedOnlyFlag | Boolean | No | false | If set to 'true', only expense reports that have not been marked as 'received' will be returned | false | |
NumberMonths | Int32 | No | 0 | The number of months to retrieve expense reports for (prior to the current month, the date). All expense report(s) returned by this service must will contain at least one cost card within this window. | 12 | |
ResourceIdentity | No | This structure represents the unique key fields associated with identifying the resource. If a ResourceIdentity is not specified, the authenticated resource identity associated with the authenticated user will be used. If the resource identity is supplied and, it differs from the authenticated user's resource, the authenticated user must have permission to view the specified resource's expense documents, otherwise the service will fail. If resource is not specified, and the authenticated user is not associated with a resource, the result will be an empty list. |
Request Usage Example(s)
...
| Panel | ||
|---|---|---|
| ||
|
...
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-02-27T19:11:06.216758Z |
ExpenseReports | This structure represents the fields associated with an expense report | ||
CreateExpenseReportsPermissionFlag | Boolean | If set to 'true', the authenticated user has permission to create expense reports | true |
...