Versions Compared

Key

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

...

This web service retrieves a list of expense reports (PwsExpenseDocument) , based upon for a specified resource (PwsResourceRef). The caller may optionally specify a unique expense document identifier (PwsExpenseDocumentRef) or resource identifier (PwsResourceRef)to retrieve only a specific expense report.

Request Format


Panel
titlePwsGetExpenseReports Request

...

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

PwsExpenseDocumentRef

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

PwsResourceRef

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)

...