Retrieves the full set of information for the report. Includes the Report Header, Entry, Attendee, Itemization and Allocation details.

Some elements will appear only if the OAuth consumer has the Web Services Admin role. These include: The ReportKey element, the employee’s credit card information, and the employee’s bank account information, VAT information, Journal entries. Connectors that utilize this information go through a review process with SAP Concur that includes verification of secure data handling.

Request Parameters

Path Parameters

URI Source: The ReportId is returned in the ReportId element of the Get List of Reports function

Headers

Authorization Header

Authorization header with OAuth token for valid SAP Concur user. The OAuth consumer must have one of the following user roles in SAP Concur: Company Administrator or Web Services Administrator for Professional, or Can Administer for Standard.
These roles allow the user to manage data for the entire company.

Accept Header

application/xml

Response

Content Types

application/xml

Schema

This request will return a ReportDetails parent element.

ReportDetails

Element

Description

UserLoginID

The user ID of the report owner. Maximum 128 characters.

EmployeeName

The name of the employee who created the report. Maximum 66 characters.

ReportID

The unique identifier for the report, which appears in the Concur Expense UI. Maximum 32 character varchar.

ReportKey

The unencrypted unique identifier for the report, that appears on the report header. The element appears only if the OAuth consumer has the Web Services Admin role in SAP Concur. Maximum 48 characters.

ReportName

The name of the report. Maximum 40 characters.

Purpose

The information from the Business Purpose field.

ReportDate

The date from the report header. Format: YYYY-MM-DDThh:mm:ss

CreationDate

The date the report was created. Format: YYYY-MM-DDThh:mm:ss

SubmitDate

The date the report was submitted. Maximum 10 characters.

PaidDate

The date the report was extracted for payment. This element has an attribute named i:nil. If the value for this element is null, the i:nil attribute will be set to true. Format: YYYY-MM-DDThh:mm:ss

The total amount of expenses marked as personal. Maximum 23 characters.

AmountDueEmployee

The total amount due to the employee for the report. Maximum 23 characters.

AmountDueCompanyCard

The total amount due to the company card for the report. Maximum 23 characters.

TotalClaimedAmount

The total amount of all non-personal expenses in the report. Maximum 23 characters.

TotalApprovedAmount

The total amount of approved expenses in the report. Maximum 23 characters.

ApprovalStatusCode

The approval status code for the report.

ApprovalStatusName

The approval status name for the report.

PaymentStatusCode

The unique identifier for the payment status of the report.

PaymentStatusName

The payment status of the report.

OrgUnit1 through OrgUnit6

The details from the Org Unit custom fields. These may not have data, depending on configuration. Maximum 48 characters for each field.

Custom1 through Custom20

The details from the Custom fields. These may not have data, depending on configuration. If report owner information is stored in these fields, it may be outdated. Refer to the ReportOwner parent element for the current owner information. Refer to the Custom Fields Child Elements table for more information.

LedgerName

The name of the expense report ledger. Maximum 20 characters.

PolicyID

The unique identifier of the policy that applies to this report. Maximum 64 characters.

EverSentBack

Whether the report has ever been sent back to the employee. Format: Y/N

HasException

Whether the report has exceptions. Format: Y/N

WorkflowActionURL

The URL to post a workflow action to the report using the Post Report Workflow Action function.

ExpenseEntriesList

This parent element has an ExpenseEntry child element for each entry. Refer to the ExpenseEntry elements table for more information.

ReportImageURL

The URL to access the image associated with the report. This URL is valid for 30 minutes after the web service call.

The date that the report completed all approvals and was ready to be extracted for payment. Format: YYYY-MM-DD

ReceiptsReceived

If Y, then this report has its receipt receipt confirmed by the Expense Processor. Format: Y/N

ReportOwner

This parent element includes details about the employee who is the report owner. It saves the caller from calling the Get User Information function to get employee information commonly used in accounting integration. The ReportOwner element includes the most recent information about the report owner, at the time the report is requested.

EmployeeBankAccount

This parent element includes the bank account data found on the Bank Information page in Profile. This data is used in Payment System integrations where the payment system reimburses the employee via this bank account.

ExpenseEntry

Element

Description

ReportEntryID

The ID of the report entry. Maximum 13 characters.

ExpenseTypeID

The expense type ID for the expense entry. Expense Type IDs are returned in the ExpKey element by the Get Expense Group Configuration endpoint.

ExpenseTypeName

The expense type name. Maximum 64 characters.

SpendCategory

The spend category specified for this expense type. Varies by client, used in reporting.

The date the expense entry was last changed. Maximum 19 characters. Format: YYYY-MM-DDThh:mm:ss

ItemizationsList

The list of itemizations for the expense entry. This parent element will have at least one Itemization child element. If the expense entry is not itemized, the Itemization will contain the same values as the entry. If the expense entry has itemizations, there will be one Itemization child element for each itemization. Refer to the Itemization elements table for more information. NOTE: There are a few rare cases where the ItemizationsList will be null. This happens when a report entry has a payment type code that is not IBCP with offsets or CBCP and there is a Regular or Child expense entry with an Approved Amount equal to zero. The expense entry will have a Null ItemizationsList.

ReportEntryVendorName

Vendor name the employee selected from the Vendor list field. Maximum 64 characters.

ReportEntryReceiptReceived

If Y, then this entry has been marked as reviewed by a processor. Maximum 1 character. Format: Y/N

This parent element includes the card transaction data found in the card transaction associated to this expense entry. This data is used in Payment System integrations where the payment system reimburses the card issuer for the indicated card account. Refer to the CardTransaction elements table.

ExpensePay

Whether the entry was paid using the Expense Pay service. This element has a value if the report has reached the Processing Payment workflow step. Format: Yes/No

Itemization

Element

Description

ItemType

The type of itemization. If the expense entry does not have any itemizations, this will be set to Regular. If the expense entry contains itemizations, each one will be set to Child.

ItemizationID

The unique identifier for the itemization. Maximum 19 characters.

ExpenseTypeID

The expense type ID for the itemization.

ExpenseTypeName

The expense type for the itemization. Maximum 64 characters.

TransactionDate

The date of the transaction. Maximum 10 characters. Format: YYYY-MM-DD

TransactionAmount

The amount for the itemization in the expense currency. Maximum 23 characters.

PostedAmount

The amount for the itemization in the user’s reimbursement currency. The user’s reimbursement currency is returned in the CrnCode element for the report. Maximum 23 characters.

ApprovedAmount

The approved amount of the itemization in the user’s reimbursement currency. The user’s reimbursement currency is returned in the CrnCode element for the report. Maximum 23 characters.

BusinessPurpose

The business purpose field from the report header.

OrgUnit1 through OrgUnit6

The details from the Org Unit custom fields. These may not have data, depending on configuration. Maximum 48 characters for each field.

Custom1 through Custom40

The custom fields associated with the itemization. These may not have data, depending on your configuration. Refer to the Custom Fields elements table for more information.

The UTC date when the itemization was last modified. Maximum 19 characters. Format: YYYY-MM-DDThh:mm:ss

AttendeesList

This parent element contains one Attendee element for each associated attendee. Refer to the Attendee elements table for more information.

AllocationsList

This parent element contains at least one Allocation element. It will contain multiple Allocation elements if there are multiple allocations for the itemization. Refer to the Allocation elements table.

Allocation

The unique alphanumeric identifier for the allocation. Maximum 13 characters.

Percentage

The percentage of the expense that is included in this allocation. Maximum 11 characters.

AccountCode1

The primary accounting code assigned to the expense type associated with this allocation. Typically, expense types have only this primary account code.

AccountCode2

The secondary or alternative accounting code assigned to the expense type associated with this allocation. In rare cases some expense types include this accounting code to handle special cases. One example of these special cases is when using travel allowance, where one expense would use the primary account code for the allowed amount, and the alternative account code for the overage. Another example is personal use of a company car. Refer to the Expense: Account Codes Setup Guide for more information on how Concur Expense determines which accounting codes to use.

Custom1 through Custom20

The custom fields associated with the allocation. These may not have data, depending on your configuration. Refer to the Custom Fields elements table for more information.

JournalEntriesList

This parent element contains at least one JournalEntry child element. It contains multiple JournalEntry elements if the allocation has multiple journal entries. Refer to the JournalEntry elements table for more information.

VATDataList

This parent element contains one VATData element for each VAT line item. This element will be empty if there are no VAT line items. Refer to the VATData elements table for more information.

The account code Concur Expense determines should apply to this journal entry. For journal entries associated to an allocation, Concur Expense uses the business logic described in the Expense: Account Codes Setup Guide to determine whether the primary or secondary account code should apply. When there is no allocation associated to the journal entry, Concur Expense uses clearing account codes for Credit Card and Cash Advance for personal use of a company paid expense or a cash advance issued to an employee respectively. Maximum 48 characters. NOTE: The developer should almost always use this accounting code when creating financial transactions in financial systems. In some situations a developer may need to use the accounting codes in the Allocation parent element.

DebitOrCredit

Maximum 2 characters. Either: DR = Debit CR = Credit

Amount

Value, as credit or debit, of the amount to be exchanged between the payer and payee for this expense account code (not an absolute value) Maximum 23 characters. EXAMPLES: Value of zero, credit, or debit, as the following: 0 (Zero) “0” + (Plus / Debit) “+50.00” - (Minus / Credit) “-50.00”

JobRunKey

Either the unique identifier for job run for the accounting extract that processed this journal, or a static value indicating the journal was processed by Manual Pay, Expense Pay, or some other system.