...
This web service retrieves a list of expense document approvers (PwsProjectElement), based upon PwsApprovalSet). The service can be invoked with or without a list of projects.
If this service is invoked with a list of unique cost centers projects (PwsCostCenterRefPwsProjectRef), or the caller must also specify either an expense document (PwsExpenseDocumentRef) or a document type and a resource (PwsResourceRef). The specified document type, or the type of the specified expense document, must be expense report ('E'). If both an expense document and a resource are specified, they must be consistent (the resource specified must match the resource associated with the specified expense report). Disbursing cost center is not required, but if both an expense document and a disbursing cost center (PwsCostCenterRef) are specified, they must also be consistent.
If no projects are specified, an expense document is required. A document type, disbursing cost center or resource are not required in this case, but if they are specified, they must be consistent with the specified expense document. A resource may only be specified for expense report expense documents.
The list of unique cost centers (PwsProjectElementof approvers returned depends on the approval type:
- For project-based expense approval, the approvers consist of some contingent of the PM team (project manager, engagement manager, members of project management team), or a
...
- specific individual as determined by the expense approver type for the project in question,
- For resource-based expense approval (also determined by expense approver type setting), the list consists of the designated expense approver for the resource in question, and all users with expense approval permission in the disbursing cost center.
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. | AXSG6rN0j9gBkWbkRw6OpQ== | ||
DisbursingCostCenterIdentity | One of DisbursingCostCenterIdentity or ExpenseDocumentIdentity is required | For this service, the No | The caller may specify a disbursing cost center identity to retrieve a a list of users that can approve expense documents associated with the disbursing cost center. | |||
ExpenseDocumentIdentity | See DisbursingCostCenterIdentity | For this service, the If ProjectIdentities not specified | The caller may specify an expense document to retrieve a a list of users that can approve expenses on the expense document. | |||
ProjectIdentities | No | For this service, the The caller may specify one or more projects to retrieve a a list of users that can approve expense documents associated with the project(s) | ||||
ResourceIdentity | No | For this service, the If ProjectIdentifies is specified and ExpenseDocumentIdentity is not specified | The caller may specify a resource to retrieve a list of users that can approve expense documents associated with the resource. This can only be specified if the document type is an expense report (i.e. "E"). | |||
DocumentType | StringYes | If ProjectIdentifies is specified and ExpenseDocumentIdentity is not specified | The expense document type: "E" for Expense Report "C" for Subcontractor Invoice "V" for Vendor Invoice "S" for Soft Cost Batch | E |
...