InTouch Hub · Blue Isle Software

SAP Concur

Read SAP Concur expense data — reports, entries, and users.

Licensed connector — not free. SAP Concur requires a paid licence from Blue Isle. You may download and install it, but it will not execute until a valid licence is applied — the server checks at run time. Contact Blue Isle to licence it.

Supported by Blue Isle. This is a commercially licensed connector, maintained and supported by Blue Isle Software under the terms of your licence agreement. Talk to Blue Isle about licensing and support.

agreementconcurexpensefinancelevelreportservicestatus

SAP Concur Tool

Read SAP Concur expense data — reports, entries, and users.

Tool ID

concur-expense

Credential Required

Yes — a server-refreshed oauth credential (auth mode oauth_user). The InTouch server resolves and refreshes the linked oauth credential and hands the tool a live access token at execution time; the tool never stores or refreshes tokens itself. Mint one with itcli.py /oauth. Every request is sent as Authorization: Bearer <access_token> to the fixed base URL https://us.api.concursolutions.com.

Credential Properties

Property Type Default Description
client_id string — OAuth app client ID (your registered SAP Concur app)
client_secret string — OAuth app client secret (if required on refresh)
token_url string — Provider OAuth token endpoint — used to refresh
access_token string — Required. Current access token — kept fresh by the server; do not edit by hand
refresh_token string — Refresh token; enables automatic server-side refresh
token_type string Bearer Token type
scope string — Granted OAuth scopes (space-separated)
expires_at string — Access-token expiry in epoch seconds (0 = non-expiring)

Operations

1. list_reports — List expense reports

Reads expense reports.

Calls GET /api/v3.0/expense/reports.

Properties:

Property Type Default Description
query string — Optional query params as a JSON object string, e.g. {"limit": 25, "user": "ALL"}

Published Outputs: - result — the JSON response body - status — HTTP status code

2. get_report — Get one expense report

Reads a single expense report by id.

Calls GET /api/v3.0/expense/reports/{id}.

Properties:

Property Type Default Description
id string — Required. Expense report id
query string — Optional query params as a JSON object string, e.g. {"limit": 25, "user": "ALL"}

Published Outputs: - result — the JSON response body - status — HTTP status code

3. list_entries — List expense entries

Reads expense entries.

Calls GET /api/v3.0/expense/entries.

Properties:

Property Type Default Description
query string — Optional query params as a JSON object string, e.g. {"limit": 25, "user": "ALL"}

Published Outputs: - result — the JSON response body - status — HTTP status code

4. list_users — List users

Reads Concur users.

Calls GET /api/v3.0/common/users.

Properties:

Property Type Default Description
query string — Optional query params as a JSON object string, e.g. {"limit": 25, "user": "ALL"}

Published Outputs: - result — the JSON response body - status — HTTP status code

License

Requires a per-tool connector license on Department/Enterprise editions (Personal/Solo/Team editions are unaffected). Apply the license via the tool's Apply License action.

Self-Contained JAR

The jar bundles all runtime dependencies; only intouch-tool-api is provided by the server.

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.