Mandala
Tools

SAP Concur

Manage expense reports, travel requests, cash advances, and more in SAP Concur

Usage Instructions

Connect SAP Concur via OAuth 2.0. Manage expense reports and line items, allocations, attendees, comments, exceptions, quick expenses, receipts, travel requests and expected expenses, cash advances, itineraries, user identities, custom lists, budgets, exchange rates, and purchase requests across every Concur datacenter.

Tools

sap_concur_approve_expense_report

Approve an expense report as a manager (PATCH /expensereports/v4/reports/{reportId}/approve). Required body field: comment.

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
reportIdstringYesExpense report ID to approve
bodyjsonYesRequest body — comment is required by Concur (e.g., { "comment": "Approved" }). If the report contains rejected expenses, expenseRejectedComment is also required. Optional fields: expectedStepCode, expectedStepSequence, statusId (defaults to "A_APPR").

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_associate_attendees

Associate attendees with an expense (POST /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}/attendees).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER or PROXY
reportIdstringYesExpense report ID
expenseIdstringYesExpense ID
bodyjsonYesAttendee associations payload (e.g., { "attendeeAssociations": [...] })

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonConcur association response (201 Created with URI)

sap_concur_create_cash_advance

Create a cash advance (POST /cashadvance/v4.1/cashadvances).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
bodyjsonYesCash advance payload

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCreated cash advance payload

sap_concur_create_expected_expense

Create an expected expense on a travel request (POST /travelrequest/v4/requests/{requestUuid}/expenses).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
requestUuidstringYesTravel request UUID
userIdstringNoUser UUID acting on the request (required when using a Company JWT, optional otherwise)
bodyjsonYesExpected expense payload

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCreated expected expense payload

sap_concur_create_expense_report

Create an expense report (POST /expensereports/v4/users/{userId}/context/{contextType}/reports — supported contexts: TRAVELER, PROXY). Required body fields: name, policyId.

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID who will own the report
contextTypestringYesAccess context: TRAVELER (creating own report) or PROXY (creating on behalf of another user)
bodyjsonYesReport payload — name and policyId are required. Optional fields: businessPurpose, comment, customData, countryCode, countrySubDivisionCode, etc.

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCreated expense report (Concur returns 201 with a URI to the new report)

sap_concur_create_list_item

Create a list item (POST /list/v4/items).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
bodyjsonYesList item payload. Required: listId, shortCode, value. Optional: parentId or parentCode (mutually exclusive). Note: Concur rejects shortCode/value containing hyphens.

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCreated list item

sap_concur_create_purchase_request

Create a purchase request (POST /purchaserequest/v4/purchaserequests).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
bodyjsonYesPurchase request payload

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCreated purchase request payload

sap_concur_create_quick_expense

Create a quick expense (POST /quickexpense/v4/users/{userId}/context/TRAVELER/quickexpenses).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID who owns the quick expense
contextTypestringYesAccess context: must be TRAVELER
bodyjsonYesQuick expense payload (expenseTypeId, transactionAmount, transactionDate, etc.)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCreated quick expense response (HTTP 201 Created)

sap_concur_create_quick_expense_with_image

Create a quick expense with an attached image (POST /quickexpense/v4/users/{userId}/context/{contextType}/quickexpenses/image).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: must be TRAVELER
receiptjsonYesReceipt image (UserFile). Allowed: PDF, PNG, JPEG, TIFF (max 50MB)
bodyjsonYesQuick expense payload (transactionAmount, transactionDate, expenseTypeId, vendor, ...)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCreated quick expense response (HTTP 201 with attached receipt image)

sap_concur_create_report_comment

Create a comment on a report (POST /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/comments).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER or PROXY
reportIdstringYesExpense report ID
commentstringYesComment text to add

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCreated comment response (Concur returns 201 Created with URI)

sap_concur_create_travel_request

Create a travel request (POST /travelrequest/v4/requests).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringNoOptional Concur user UUID — required when impersonating another user
bodyjsonYesTravel request payload (name, purpose, startDate, endDate, requestPolicyId, etc.)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCreated travel request payload

sap_concur_create_user

Create a new user identity (POST /profile/identity/v4.1/Users).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
bodyjsonYesSCIM User payload (schemas, userName, name, emails, active, etc.)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCreated SCIM User payload

sap_concur_delete_expected_expense

Delete an expected expense (DELETE /travelrequest/v4/expenses/{expenseUuid}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
expenseUuidstringYesExpected expense UUID to delete
userIdstringNoUser UUID acting on the request (required when using a Company JWT, optional otherwise)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonReturns boolean true on 200 OK when the expected expense is deleted.

sap_concur_delete_expense

Delete an expense (DELETE /expensereports/v4/reports/{reportId}/expenses/{expenseId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
reportIdstringYesExpense report ID
expenseIdstringYesExpense ID to delete

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty body on success (HTTP 204 No Content). Error details when status is non-2xx

sap_concur_delete_expense_report

Delete an expense report (DELETE /expensereports/v4/reports/{reportId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
reportIdstringYesExpense report ID to delete

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_delete_list_item

Delete a list item (DELETE /list/v4/items/{itemId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
itemIdstringYesList item UUID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty body on success (HTTP 204 No Content). Error details when status is non-2xx

sap_concur_delete_travel_request

Delete a travel request (DELETE /travelrequest/v4/requests/{requestUuid}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
requestUuidstringYesTravel request UUID to delete
userIdstringNoOptional Concur user UUID — required when impersonating another user

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonConcur delete response payload (boolean true on 200 OK)

sap_concur_delete_user

Delete a user identity (DELETE /profile/identity/v4.1/Users/{id}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userUuidstringYesUser UUID to delete

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonDeletion response — empty body on HTTP 204 No Content

sap_concur_get_allocation

Get a single allocation (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/allocations/{allocationId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER or PROXY
reportIdstringYesExpense report ID
allocationIdstringYesAllocation ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonAllocation detail payload

sap_concur_get_budget

Get a budget item header by ID (GET /budget/v4/budgetItemHeader/{id}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
budgetIdstringYesBudget item header ID (syncguid)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonBudget header detail payload

sap_concur_get_cash_advance

Get a cash advance (GET /cashadvance/v4.1/cashadvances/{cashAdvanceId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
cashAdvanceIdstringYesCash advance ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCash advance detail payload

sap_concur_upload_exchange_rates

Bulk upload up to 100 custom exchange rates (POST /exchangerate/v4/rates). Body contains a currency_sets array, each with from_crn_code, to_crn_code, start_date (YYYY-MM-DD), and rate.

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
bodyjsonYesBulk upload body: { currency_sets: [{ from_crn_code, to_crn_code, start_date: "YYYY-MM-DD", rate }] } (max 100 entries)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonBulk-upload exchange rate response (Exchange Rate v4)

sap_concur_get_expected_expense

Get an expected expense (GET /travelrequest/v4/expenses/{expenseUuid}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
expenseUuidstringYesExpected expense UUID
userIdstringNoUser UUID acting on the request (optional)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonExpected expense payload

sap_concur_get_expense

Get a single expense (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringYesExpense report ID
expenseIdstringYesExpense ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonExpense detail (ReportExpenseDetail) payload

sap_concur_get_expense_report

Retrieve a single expense report header by id via Expense Report v4 (/expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID who owns the report
contextTypestringYesAccess context: TRAVELER (own report), MANAGER (report under approval), PROCESSOR, or PROXY
reportIdstringYesExpense report ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonConcur expense report header (ReportDetails)

sap_concur_get_itemizations

Get expense itemizations (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}/itemizations).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringYesExpense report ID
expenseIdstringYesExpense ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
dataarrayArray of itemizations (ReportExpenseSummary[])

sap_concur_get_itinerary

Get a single trip/itinerary (GET /api/travel/trip/v1.1/{tripID}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
tripIdstringYesTrip ID
useridTypestringNoUser identifier type (login, xmlsyncid, uuid)
useridValuestringNoUser identifier value (paired with useridType)
systemFormatstringNoOptional system format (e.g., GDS) for the response

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonTrip detail payload (Itinerary v1.1)

sap_concur_get_list

Get a single custom list (GET /list/v4/lists/{listId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
listIdstringYesList ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonList detail payload

sap_concur_get_list_item

Get a single list item (GET /list/v4/items/{itemId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
itemIdstringYesList item ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonList item detail payload

sap_concur_get_purchase_request

Get a purchase request by ID (GET /purchaserequest/v4/purchaserequests/{id}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
purchaseRequestIdstringYesPurchase request ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonPurchase request detail payload

sap_concur_get_receipt

Get a single receipt by ID (GET /receipts/v4/{receiptId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
receiptIdstringYesReceipt ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonReceipt detail payload

sap_concur_get_receipt_status

Get receipt processing status (GET /receipts/v4/status/{receiptId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
receiptIdstringYesReceipt ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonReceipt status payload

sap_concur_get_travel_profile

Get a travel profile (GET /api/travelprofile/v2.0/profile). Returns the calling user by default; pass userid_type and userid_value to impersonate.

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
useridTypestringNoIdentifier type: login, xmlsyncid, or uuid
useridValuestringNoIdentifier value (login id, xml sync id, or UUID)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonTravel profile payload. Concur returns XML; downstream may parse it to a best-effort JSON object with the documented top-level sections.

sap_concur_get_travel_request

Get a single travel request (GET /travelrequest/v4/requests/{requestUuid}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
requestUuidstringYesTravel request UUID
userIdstringNoOptional Concur user UUID — required when impersonating another user

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonTravel request detail payload

sap_concur_get_user

Get a single user by UUID (GET /profile/identity/v4.1/Users/{id}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userUuidstringYesUser UUID
attributesstringNoComma-separated SCIM attributes to include in the response
excludedAttributesstringNoComma-separated SCIM attributes to exclude from the response

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonSCIM User identity payload

sap_concur_issue_cash_advance

Issue a cash advance (POST /cashadvance/v4.1/cashadvances/{cashAdvanceId}/issue).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
cashAdvanceIdstringYesCash advance ID to issue
bodyjsonNoOptional request body

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonIssue cash advance result payload

sap_concur_list_allocations

List allocations on an expense (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}/allocations).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER or PROXY
reportIdstringYesExpense report ID
expenseIdstringYesExpense ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonAllocations list payload

sap_concur_list_attendee_associations

List attendees associated with an expense (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}/attendees).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER or PROXY
reportIdstringYesExpense report ID
expenseIdstringYesExpense ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonAttendees list payload

sap_concur_list_budget_categories

List budget categories (GET /budget/v4/budgetCategory).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonBudget categories collection payload

sap_concur_list_budgets

List budget item headers (GET /budget/v4/budgetItemHeader).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
adminViewbooleanNoWhen true, returns all budgets the caller can administer (default false)
offsetnumberNoPage offset (Concur returns up to 50 budget headers per page)
responseSchemastringNoResponse schema variant: "COMPACT" returns a smaller payload

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonBudget headers collection payload

sap_concur_list_exceptions

List exceptions on a report (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/exceptions).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringYesExpense report ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
dataarrayArray of report header exception entries

sap_concur_list_expected_expenses

List expected expenses on a travel request (GET /travelrequest/v4/requests/{requestUuid}/expenses).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
requestUuidstringYesTravel request UUID
userIdstringNoUser UUID acting on the request (optional)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonArray of expected expense objects. Each entry includes id, href, expenseType {id,name}, transactionDate, transactionAmount, postedAmount, approvedAmount, remainingAmount, businessPurpose, location, exchangeRate, allocations, tripData, parentRequest {href, id}, comments {href, id}.

sap_concur_list_expenses

List expenses on a report (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringYesExpense report ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
dataarrayArray of expense summary entries (ReportExpenseSummary[])

sap_concur_list_expense_reports

List expense reports (GET /api/v3.0/expense/reports). Returns a v3 envelope with Items and NextPage.

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (us, us2, eu, eu2, cn, emea — defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userstringNoFilter by a specific user (login id or user identifier).
submitDateBeforestringNoFilter to reports submitted on or before this date (YYYY-MM-DD)
submitDateAfterstringNoFilter to reports submitted on or after this date (YYYY-MM-DD)
paidDateBeforestringNoFilter to reports paid on or before this date (YYYY-MM-DD)
paidDateAfterstringNoFilter to reports paid on or after this date (YYYY-MM-DD)
modifiedDateBeforestringNoFilter to reports last modified on or before this date (YYYY-MM-DD)
modifiedDateAfterstringNoFilter to reports last modified on or after this date (YYYY-MM-DD)
createDateBeforestringNoFilter to reports created on or before this date (YYYY-MM-DD)
createDateAfterstringNoFilter to reports created on or after this date (YYYY-MM-DD)
approvalStatusCodestringNoFilter by approval status code (e.g. A_NOTF, A_PEND, A_APPR)
paymentStatusCodestringNoFilter by payment status code
currencyCodestringNoFilter by ISO currency code (e.g. USD, EUR)
approverLoginIDstringNoFilter by approver login ID
limitnumberNoNumber of records per page (default 25, max 100)
offsetstringNoOpaque cursor token returned by a prior call (NextPage).

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonConcur v3 expense reports envelope

sap_concur_list_itineraries

List travel trips/itineraries (GET /api/travel/trip/v1.1).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
startDatestringNoFilter trips starting on/after this date (YYYY-MM-DD)
endDatestringNoFilter trips ending on/before this date (YYYY-MM-DD)
bookingTypestringNoFilter by booking type (air, car, hotel, rail, etc.)
useridTypestringNoUser identifier type (login, xmlsyncid, uuid)
useridValuestringNoUser identifier value (paired with useridType)
itemsPerPagenumberNoItems per page
pagenumberNo1-based page number
includeMetadatabooleanNoInclude paging metadata in the response
includeCanceledTripsbooleanNoInclude canceled trips in the result set
createdAfterDatestringNoOnly trips created after this date (YYYY-MM-DD)
createdBeforeDatestringNoOnly trips created before this date (YYYY-MM-DD)
lastModifiedDatestringNoOnly trips modified on/after this date (YYYY-MM-DD)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonTrips list payload (Itinerary v1.1 ConnectResponse)

sap_concur_list_lists

List custom lists (GET /list/v4/lists).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
pagenumberNoPage number (1-based; page size is fixed at 100)
sortBystringNoSort field: name, levelcount, or listcategory
sortDirectionstringNoSort direction: asc or desc
valuestringNoFilter by list name
categoryTypestringNoFilter by category type (mapped to category.type query param)
isDeletedbooleanNoInclude deleted lists
levelCountnumberNoFilter by number of levels

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonPaginated lists collection

sap_concur_list_list_items

List the top-level items (children) for a custom list (GET /list/v4/lists/{listId}/children).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
listIdstringYesList ID
pagenumberNoPage number (1-based; page size is fixed at 100)
sortBystringNoSort field: value or shortCode
sortDirectionstringNoSort direction: asc or desc
hasChildrenbooleanNoInclude only items that have children
isDeletedbooleanNoInclude deleted items
shortCodestringNoFilter by short code
valuestringNoFilter by display value
shortCodeOrValuestringNoFilter by short code OR value

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonPaginated list items collection

sap_concur_list_receipts

List receipts for a user (GET /receipts/v4/users/{userId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
dataarrayArray of e-receipt objects

sap_concur_list_report_comments

List comments on a report (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/comments).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER or PROXY
reportIdstringYesExpense report ID
includeAllCommentsbooleanNoInclude comments from all expenses in the report (default false)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
dataarrayArray of report comment entries

sap_concur_list_reports_to_approve

List expense reports awaiting approval (GET /expensereports/v4/users/{userId}/context/MANAGER/reportsToApprove).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesManager user UUID
contextTypestringNoAccess context: must be MANAGER (default)
sortstringNoReport field name to sort by (e.g., reportDate)
orderstringNoSort direction: asc or desc
includeDelegateApprovalsbooleanNoWhether to include reports the caller can approve as a delegate

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
dataarrayArray of reports awaiting approval (ReportToApprove[])

sap_concur_get_request_cash_advance

Get a single cash advance assigned to a travel request (GET /travelrequest/v4/cashadvances/{cashAdvanceUuid}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
cashAdvanceUuidstringYesCash advance UUID (returned as part of a travel request)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonCash advance detail

sap_concur_list_travel_profiles_summary

List travel profile summaries (GET /api/travelprofile/v2.0/summary). LastModifiedDate is required by Concur.

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
lastModifiedDatestringYesRequired UTC datetime in YYYY-MM-DDThh:mm:ss format
pagenumberNo1-based page number
itemsPerPagenumberNoItems per page (max 200)
travelConfigsstringNoComma-separated travel configuration ids

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonTravel profile summary list payload (Concur returns XML mapped to JSON)

sap_concur_list_travel_request_comments

List comments on a travel request (GET /travelrequest/v4/requests/{requestUuid}/comments).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
requestUuidstringYesTravel request UUID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
dataarrayArray of comment entries

sap_concur_list_travel_requests

List travel requests (GET /travelrequest/v4/requests).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
viewstringNoView filter (e.g., ALL, ACTIVE, PENDING, TOAPPROVE)
limitnumberNoMax number of results per page
startnumberNoPage start cursor (offset)
userIdstringNoFilter by Concur user UUID
approvedBeforestringNoISO 8601 date — return requests approved before this date
approvedAfterstringNoISO 8601 date — return requests approved after this date
modifiedBeforestringNoISO 8601 date — return requests modified before this date
modifiedAfterstringNoISO 8601 date — return requests modified after this date
sortFieldstringNoField to sort by: startDate, approvalStatus, or requestId (default startDate)
sortOrderstringNoSort order: ASC or DESC (default DESC)

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonTravel requests list payload

sap_concur_list_users

List Concur user identities (GET /profile/identity/v4.1/Users).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
countnumberNoMax number of users to return (default 100, max 1000)
cursorstringNoSCIM v4.1 pagination cursor returned by a prior call
attributesstringNoComma-separated list of attributes to include in the response
excludedAttributesstringNoComma-separated list of attributes to exclude from the response

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonSCIM ListResponse with Resources array

sap_concur_move_travel_request

Move a travel request through workflow (POST /travelrequest/v4/requests/{requestUuid}/{action}). Valid actions: submit, recall, cancel, approve, sendback, close, reopen.

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
requestUuidstringYesTravel request UUID
actionstringYesWorkflow action: submit, recall, cancel, approve, sendback, close, reopen
userIdstringNoOptional Concur user UUID — required when impersonating another user
bodyjsonNoOptional payload (e.g., { "comment": "..." })

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonWorkflow transition response payload

sap_concur_recall_expense_report

Recall a submitted expense report (PATCH /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/recall — supported contexts: TRAVELER, PROXY). No request body is required.

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID who owns the report
contextTypestringYesAccess context: TRAVELER or PROXY
reportIdstringYesExpense report ID to recall
bodyjsonNoOptional body. Concur docs don't define a payload for this action; pass an empty object if uncertain.

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_remove_all_attendees

Remove all attendees from an expense (DELETE /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}/attendees).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER or PROXY
reportIdstringYesExpense report ID
expenseIdstringYesExpense ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty response body (Concur returns 204 No Content)

sap_concur_search_locations

Search Concur location reference data (GET /localities/v5/locations).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
searchTextstringNoFree-text query (city, airport, landmark, etc.)
locCodestringNoIATA / location code
locationNameIdstringNoConcur internal location name ID (UUID)
locationNameKeynumberNoConcur internal numeric location name key
countryCodestringNo2-letter ISO 3166-1 country code
subdivisionCodestringNoISO 3166-2:2007 country subdivision (e.g. US-WA)
adminRegionIdstringNoAdministrative region ID

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonLocalities v5 search response

sap_concur_search_users

Search users via SCIM .search endpoint (POST /profile/identity/v4.1/Users/.search).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
bodyjsonYesSCIM search request payload ({ schemas, attributes, filter, count, startIndex })

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonSCIM search ListResponse

sap_concur_send_back_expense_report

Send back an expense report to the employee (PATCH /expensereports/v4/reports/{reportId}/sendBack). Required body field: comment.

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
reportIdstringYesExpense report ID to send back
bodyjsonYesRequest body — comment is required by Concur (e.g., { "comment": "Missing receipt" }). Optional fields: expectedStepCode, expectedStepSequence.

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_submit_expense_report

Submit an expense report into the workflow via Expense Report v4 (PATCH /expensereports/v4/users/{userId}/reports/{reportId}/submit).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID who owns the report
reportIdstringYesExpense report ID to submit
bodyjsonNoOptional body. Concur docs don't define a payload for this action; pass an empty object if uncertain.

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_update_allocation

Update an allocation (PATCH /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/allocations/{allocationId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID
contextTypestringYesAccess context: TRAVELER or PROXY (write requires expense.report.readwrite)
reportIdstringYesExpense report ID
allocationIdstringYesAllocation ID to update
bodyjsonYesFields to update on the allocation

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty body on success (Concur returns 204 No Content)

sap_concur_update_expected_expense

Update an expected expense (PUT /travelrequest/v4/expenses/{expenseUuid}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
expenseUuidstringYesExpected expense UUID to update
userIdstringNoUser UUID acting on the request (required when using a Company JWT, optional otherwise)
bodyjsonYesFields to update on the expected expense

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonUpdated expected expense payload

sap_concur_update_expense

Update an expense (PATCH /expensereports/v4/reports/{reportId}/expenses/{expenseId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
reportIdstringYesExpense report ID
expenseIdstringYesExpense ID to update
bodyjsonYesPATCH body. Allowed fields: businessPurpose (string, max 64), customData (CustomData[]), expenseSource (required: EA|MOB|OTHER|SE|TA|TR|UI), isExpenseRejected (boolean), isPaperReceiptReceived (boolean).

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty body on success (HTTP 204 No Content). Error details when status is non-2xx

sap_concur_update_expense_report

Update an unsubmitted expense report (PATCH /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId} — supported contexts: TRAVELER, PROXY). Body fields: businessPurpose, comment, customData, name, etc.

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID who owns the report
contextTypestringYesAccess context: TRAVELER (own report) or PROXY (editing on behalf of another user)
reportIdstringYesExpense report ID to update
bodyjsonYesFields to update on the report

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_update_list_item

Update a list item (PUT /list/v4/items/{itemId}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
itemIdstringYesList item UUID
bodyjsonYesList item payload. Required: shortCode, value. Other fields in the body are ignored.

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonUpdated list item

sap_concur_update_travel_request

Update a travel request (PUT /travelrequest/v4/requests/{requestUuid}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
requestUuidstringYesTravel request UUID to update
bodyjsonYesFields to update on the travel request

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonUpdated travel request payload

sap_concur_update_user

Patch a user identity (PATCH /profile/identity/v4.1/Users/{id}).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userUuidstringYesUser UUID to update
bodyjsonYesSCIM PATCH operations payload ({ schemas, Operations: [...] })

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonUpdated SCIM User payload

sap_concur_upload_receipt_image

Upload an image-only receipt (POST /receipts/v4/users/{userId}/image-only-receipts).

Input

ParameterTypeRequiredDescription
datacenterstringNoConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNoOAuth grant type: client_credentials (default) or password
clientIdstringYesConcur OAuth client ID
clientSecretstringYesConcur OAuth client secret
usernamestringNoUsername (only for password grant)
passwordstringNoPassword (only for password grant)
companyUuidstringNoCompany UUID for multi-company access tokens
userIdstringYesConcur user UUID who owns the receipt
receiptjsonYesReceipt image file (UserFile reference). Supported formats: PDF, PNG, JPEG, GIF, TIFF
forwardIdstringNoOptional client-supplied dedup id (max 40 chars). Sent as the concur-forwardid header.

Output

ParameterTypeDescription
statusnumberHTTP status code returned by Concur
datajsonImage-only receipt upload response (HTTP 202 Accepted; Location and Link response headers exposed in body)

Notes

  • Category: tools
  • Type: sap_concur
On this page

On this page

Usage Instructions
Tools
sap_concur_approve_expense_report
Input
Output
sap_concur_associate_attendees
Input
Output
sap_concur_create_cash_advance
Input
Output
sap_concur_create_expected_expense
Input
Output
sap_concur_create_expense_report
Input
Output
sap_concur_create_list_item
Input
Output
sap_concur_create_purchase_request
Input
Output
sap_concur_create_quick_expense
Input
Output
sap_concur_create_quick_expense_with_image
Input
Output
sap_concur_create_report_comment
Input
Output
sap_concur_create_travel_request
Input
Output
sap_concur_create_user
Input
Output
sap_concur_delete_expected_expense
Input
Output
sap_concur_delete_expense
Input
Output
sap_concur_delete_expense_report
Input
Output
sap_concur_delete_list_item
Input
Output
sap_concur_delete_travel_request
Input
Output
sap_concur_delete_user
Input
Output
sap_concur_get_allocation
Input
Output
sap_concur_get_budget
Input
Output
sap_concur_get_cash_advance
Input
Output
sap_concur_upload_exchange_rates
Input
Output
sap_concur_get_expected_expense
Input
Output
sap_concur_get_expense
Input
Output
sap_concur_get_expense_report
Input
Output
sap_concur_get_itemizations
Input
Output
sap_concur_get_itinerary
Input
Output
sap_concur_get_list
Input
Output
sap_concur_get_list_item
Input
Output
sap_concur_get_purchase_request
Input
Output
sap_concur_get_receipt
Input
Output
sap_concur_get_receipt_status
Input
Output
sap_concur_get_travel_profile
Input
Output
sap_concur_get_travel_request
Input
Output
sap_concur_get_user
Input
Output
sap_concur_issue_cash_advance
Input
Output
sap_concur_list_allocations
Input
Output
sap_concur_list_attendee_associations
Input
Output
sap_concur_list_budget_categories
Input
Output
sap_concur_list_budgets
Input
Output
sap_concur_list_exceptions
Input
Output
sap_concur_list_expected_expenses
Input
Output
sap_concur_list_expenses
Input
Output
sap_concur_list_expense_reports
Input
Output
sap_concur_list_itineraries
Input
Output
sap_concur_list_lists
Input
Output
sap_concur_list_list_items
Input
Output
sap_concur_list_receipts
Input
Output
sap_concur_list_report_comments
Input
Output
sap_concur_list_reports_to_approve
Input
Output
sap_concur_get_request_cash_advance
Input
Output
sap_concur_list_travel_profiles_summary
Input
Output
sap_concur_list_travel_request_comments
Input
Output
sap_concur_list_travel_requests
Input
Output
sap_concur_list_users
Input
Output
sap_concur_move_travel_request
Input
Output
sap_concur_recall_expense_report
Input
Output
sap_concur_remove_all_attendees
Input
Output
sap_concur_search_locations
Input
Output
sap_concur_search_users
Input
Output
sap_concur_send_back_expense_report
Input
Output
sap_concur_submit_expense_report
Input
Output
sap_concur_update_allocation
Input
Output
sap_concur_update_expected_expense
Input
Output
sap_concur_update_expense
Input
Output
sap_concur_update_expense_report
Input
Output
sap_concur_update_list_item
Input
Output
sap_concur_update_travel_request
Input
Output
sap_concur_update_user
Input
Output
sap_concur_upload_receipt_image
Input
Output
Notes
SAP Concur