ExportExpenseReports

This exports the expense report header information and disbursements. Expense report details are exported using ExportCostCards.

Request

The service request contains:

Name

Data Type

Required?

Default Value

Discussion

MaxRowsToReturn

int

no

1000

The maximum number of cards to be exported. Values greater than 1000 may fail due to system-enforced transaction time limits.

ExpenseReportNumbersAfter

string(20)

no

 

Export is limited to items whose expense report number comes after this. To avoid skipping or duplicating exported items set this to the last ExpenseReportNumber from the previous result set.

OnlyCountRows

boolean

no

false

If true, then only the RowCount is returned.


Response


For each project in the result set the following data is returned:

Name

Data Type

Discussion

ExpenseReportNumber

string

The document number of the expense report.

ExpenseReportName

string

The document name of the expense report.

DisplayName

string

Name of the resource the expense report is associated with.

EmployeeId

string

This is the resource's reference system ID.

ProjectCode

string

The project code of the project associated with the expense report. If the expense report contains cost cards from multiple projects, this will be unspecified in the result.

Status

string

Consolidated status (see below)

ApprovalWorkflowStatus

string

Approval workflow status (see below)

PaymentWorkflowStatus

string

Payment workflow status (see below)

InvoiceWorkflowStatus

string

Invoice workflow status (see below)

ExpenseReportGrossAmount

double

The total disbursed amount of all cost cards on the expense report.

CashAdvanceReturnAmount

double

The cash advance amount attached to the expense report.

CurrencyCode

string

The disbursing currency code.

ApVoucherNumber

string

If all cost cards on the expense report are on the same payment voucher, and that payment voucher is transmitted, this is the confirmation number. Otherwise it is unspecified.

ApPaymentInformation

string

If all cost cards on the expense report are on the same payment voucher, and that payment voucher is paid, this is the payment information. Otherwise it is unspecified.


The four status fields listed above will have a one or two character code summarizing the status of the items (cost cards) on the expense report, as detailed in the table below.

Status Field

Value

Meaning

Status

D

All cost cards on expense report are in draft state

 

R

All cost cards on expense report are in rejected

 

S

All cost cards on expense report are in submitted

 

A

All cost cards on expense report are in approved, but not approved to pay state

 

F

All cost cards on expense report are in approved to pay state

 

T

All cost cards on expense report are in transmitted

 

P

All cost cards on expense report are in paid state

 

<null>

Not all of the cost cards on the expense report are in the same state

Approval workflow status

D

Draft. All cost cards on expense report are in draft state.

 

R

Rejected. All cost cards are in rejected state.

 

PR

Partially Rejected. At least one cost card is in rejected state.

 

S

Submitted. All cost cards are in submitted state.

 

PS

Partially Submitted. At least one cost card is in submitted state, the rest indraft state.

 

A

Approved. All cost cards are in approved state.

 

PA

Partially Approved. At least one cost card has been approved. The rest are in draft or submitted state.

Payment workflow status

N

Not Approved to Pay. None of the cost cards on the expense report are on payment vouchers that have been approved to pay.

 

F

Approved to Pay. All cost cards are on approved to pay payment vouchers.

 

PF

Partially Approved to Pay. At least one cost card is on an approved to pay payment voucher. The rest are on unapproved payment vouchers.

 

T

Transmitted. All cost cards are on transmitted payment vouchers.

 

PT

Partially Transmitted. At least one cost card is on a transmitted payment voucher. The rest are on unapproved to pay or approved to pay payment vouchers.

 

P

Paid. All cost cards are on paid payment vouchers (not marked received).

 

PP

Partially Paid. At least one cost card is on a paid (but not marked received) payment voucher. The rest are on unapproved to pay, approved to pay or transmitted payment vouchers.

 

R

Received. All cost cards are on paid payment vouchers that have been marked received.

 

PR

Partially Received. At least one cost card is on a payment voucher that has been paid and marked received. The rest are on unapproved to pay, approved to pay, transmitted or paid (not marked received) payment vouchers.

Invoice workflow status

N

Not Approved to Invoice. None of the cost cards on the expense report have been approved to invoice.

 

A

Approved to Invoice. All cost cards have been approved to invoice (but not yet placed on an invoice).

 

PA

Partially Approved to Invoice. At least one cost card has been approved to invoice (but not yet placed on an invoice). The rest have not yet been approved to invoice.

 

D

Draft Invoiced. All cost cards have been approved to invoice and placed on an invoice currently in the draft or approved state.

 

PD

Partially Draft Invoiced. At least one cost card has been approved to invoice and placed on an invoice currently in the draft or approved state. The rest are not approved to invoice or approved but not yet on an invoice.

 

I

Invoiced. All cost cards have been approved to invoice and are on an invoice currently in the issued state.

 

PI

Partially Invoiced. At least one cost card has been approved to invoice and placed on an invoice currently in the issued state. The rest are not approved to invoice, approved but not yet on an invoice or approved and on an invoice currently in the draft or approved state.