Submit an Expense Report

Triggers the Submit workflow action for the specified report.

Important Note: This endpoint submits the expense report as if the original report owner had submitted it. Consult your company’s Expense administrator to confirm that the web service should be allowed to submit reports on behalf of users. If you wish to enforce the expense report delegate functionality, use the Get Expense Delegators function to determine if the user in question has the correct permissions to submit on behalf of the report owner.

Limitations

Access to this documentation does not provide access to the API. 

Request

Request Parameters

Scopes

EXPRPT - get, add, approve, or update expense reports.

Path Parameters

Parameter Required/Optional Description
{reportKEY}/submit required The identifier for the desired report and the submit keyword.

Example: https://www.concursolutions.com/api/expense/expensereport/v1.1/report/{reportKEY}/submit

URI Source: The reportId value is returned by the Get List of Reports and Get Report Details functions, and as part of the Report-Details-Url element of the Post Expense Report Header function.

Content Types

application/xml

Authorization Header

Authorization: This request requires an Authorization header with an OAuth token for a valid SAP Concur user.

X_UserID: This request requires an additional field in the authorization header, identifying the report owner. This identifier is the SAP Concur login for the user, and is often also the email address of the user. The field format is:
X_UserID: expenseuser@example.com

Response

Schema

This request will return a ReportStatus parent element with the following child elements.

Report Status Elements

Element Description
Message The error message. Only appears if a submission error was generated.
Status The status of the report submit action.

If the report submission triggered an exception, a ReportExceptions parent element will be provided, with a ReportException parent element for each exception. The ReportException element contains the following elements.

Report Exception Schema

Element Description
CrnCode The currency code of the entry.
EventCode The event that resulted in the exception.
ExceptionCode The company-defined exception code.
ExceptionErrorCode The severity of the exception. Exceptions with ERROR as the code cannot be submitted.
ExceptionVisibility Which users are able to see the exception.
ExpKey The expense type key for the entry.
ExpName The expense type name for the entry.
IsCleared Whether the exception has been cleared by the Expense Processor.
SeverityLevel A numeric value indicating the severity level of the exception. The value threshold is configurable.
TransactionAmount The amount of the entry.
TransactionDate The date of the entry.
Type The exception type.

Examples

XML Example Request

POST https://www.concursolutions.com/api/expense/expensereport/v1.1/report/nxxKgLlnROz$sQ6SKJFjLNs4OWBErcJ8yX/submit HTTP/1.1
Authorization: OAuth {access token}
X-UserID: cmiller@example.com
...

XML example of Successful Response

<ReportStatus xmlns="http://www.concursolutions.com/api/expense/expensereport/2011/03" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Status>SUCCESS</Status>
</ReportStatus>

On this page