Skip to main content

Concur

SAP Concur expense management.

What you can ask​

  • List all expense reports in Submitted status that haven't been approved in more than 5 days.
  • Pull every expense entry on my open report and flag any that are missing a receipt attachment.
  • Pull every expense entry coded to Meals & Entertainment submitted this quarter across the sales team.

Set up​

Concur needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Concur. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Concur developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Concur login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (10)

Grant the scopes for the tools you plan to allow.

  • IMAGE
  • expense.config.paymenttypes.restricted.read
  • expense.report.read
  • expense.report.readwrite
  • identity.user.core.read
  • identity.user.ids.read
  • quickexpense.writeonly
  • receipts.read
  • receipts.readwrite
  • user.read

Tools​

Concur offers 40 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (25)​

View and search information without changing it.

ToolWhat it does
download_expense_receipt_imageDownload an expense receipt's image bytes by the receiptImageId of an expense report entry (receiptImageId/ereceiptImageId).
download_image_only_receiptDownload an image-only receipt's bytes (a user-uploaded receipt image, no merchant data) by a receipt_id from list_image_only_receipts.
download_receiptDownload an e-receipt's image bytes (a merchant-delivered receipt in the user's Concur receipt library) by a receipt_id from list_user_receipts or get_receipt.
get_current_userGet the authenticated user or company profile from /profile/v1/me.
get_expense_form_fieldsGet form-field metadata for an expense entry (custom fields by expense type).
get_expense_receipt_imageGet metadata and a temporary (~15 min) download URL for an expense receipt image WITHOUT downloading the bytes, given a receiptImageId from an Expense Report expense entry (receiptImageId/ereceiptImageId).
get_image_only_receiptGet an image-only receipt's metadata by receipt_id (a user-uploaded receipt image in the receipt library, no merchant-extracted data; receipt_id comes from list_image_only_receipts).
get_principalGet a Concur principal (user or company) by ID via /profile/v1/principals/{id}.
get_receiptGet an e-receipt's metadata by receipt_id (a merchant-delivered digital receipt in the user's Concur receipt library; receipt_id comes from list_user_receipts).
get_receipt_statusGet the processing status of a submitted receipt by receipt_id (from list_user_receipts or an upload response).
get_reportGet an expense report by ID.
get_report_expenseGet a single expense entry on a report including amount, date, location, and custom fields. context_type accepts TRAVELER (default), MANAGER, or PROXY — MANAGER works here even though list_report_expenses rejects it.
get_report_form_fieldsGet policy-driven form-field metadata for a report (data type, required flag, access level).
list_expense_itemizationsList itemizations on an expense entry — itemizations split a single charge across multiple expense types or amounts.
list_image_only_receiptsList image-only receipts in the user's receipt library.
list_payment_typesList payment types available to a Concur user (e.g. 'Cash', 'Company Paid') via Expense Config v4.
list_report_exceptionsList policy exceptions on a report.
list_report_expensesList all expense entries on a report.
list_reportsList the authenticated user's expense reports.
list_reports_to_approveList reports the authenticated user can approve as an approver or delegate.
list_user_receiptsList e-receipts for the authenticated user.
list_usersList Concur users in the company via Identity v4.1 (SCIM).
read_receipt_textRead a receipt's file as text; prefer over the download tools to READ. receipt_source: 'receipt' (receipt_id from list_user_receipts), 'image_only_receipt' (list_image_only_receipts) or 'expense_receipt_image' (an expense entry's receiptImageId).
search_usersSearch Concur users via Identity v4.1 SCIM (POST /Users/.search).
validate_credentialValidate the connected Concur account by fetching the authenticated principal's profile.

Write (7)​

Create or send data.

ToolWhat it does
attach_receipt_to_expenseUpload a receipt image and attach it directly to an expense entry.
create_quick_expenseCreate a quick expense (no image) for the authenticated user.
create_quick_expense_with_imageCreate a quick expense and attach a receipt image in one call.
create_reportCreate a new (unsubmitted) expense report. context_type accepts only TRAVELER (default) or PROXY. policy_id MUST be a v4 ID: call list_reports, pick any report, call get_report on it, and use the policy_id from that v4 response.
create_report_expenseCreate a new expense entry on an existing report.
upload_receiptUpload an e-receipt (image + structured metadata) to the user's receipt library.
upload_receipt_image_onlyUpload an image-only receipt to the user's receipt library.

Delete or overwrite (8)​

Remove or replace existing data.

ToolWhat it does
approve_reportApprove a submitted expense report (MANAGER context).
delete_reportPermanently delete an expense report.
delete_report_expensePermanently delete an expense entry from a report.
sendback_reportSend a submitted report back to the submitter for changes (MANAGER context).
submit_reportSubmit an unsubmitted expense report for approval.
update_reportUpdate fields on an unsubmitted report. context_type accepts only TRAVELER (default) or PROXY. report_source is required by Concur (one of OTHER/SE/UI/EA/TR/MOB; use 'OTHER' for API callers).
update_report_as_companyUpdate a report using a company-level JWT.
update_report_expenseUpdate a single expense entry on a report.
⌘J