Skip to navigation

Concur Approvals Access Requirements

View as Markdown

Authentication

Use this document for instructions on how to get the access setup in place for the Moveworks Expense Approvals integration with Concur.

Docs for reference:

  1. https://developer.concur.com/api-reference/authentication/apidoc.html
  2. https://developer.concur.com/api-reference/expense/expense-report/v3.reports.html

Refresh token expiration:

Concur company refresh tokens expire every 6 months. Before yours expires, exchange a new Company Request Token for a refresh token with the Concur API and paste the new refresh token on the Concur connector under Core Platform > Connectors > Built-in Connectors. Setup doesn’t do the exchange or warn you before expiry today; Moveworks Support can do the exchange if you send them the new request token.

Method

Moveworks will be authenticating into your Concur system via the Company Request Token Method. This lets us generate a 1-time Company Request Token (valid for 24 hours) followed by refreshable access tokens which we’ll use to authenticate any interactions.

Pre-requisites: Customer must have access to the Web-Service tool in Concur.

Process Walkthrough

  1. Create a new OAuth 2.0 App with the required scopes.

    1. Navigate to OAuth 2.0 Application Management under Authentication Admin

    2. Client Create New App

    3. Fill in the following details:

      1. App Name: Moveworks Integration Application
      2. App Type: Client
      3. App Description: Moveworks uses this application to provide Concur expenses support into your native chat platform
      4. Allowed Grants: refresh_token, password, & client_credentials
      5. Allowed Scopes: openid, EXPRPT, expense.report.read, expense-report.readwrite, expense.report.workflowstatus.write, identity.user.core.read & identity.user.ids.read
    4. ❗Note down the generated Client ID & Client Secret

  2. Create a Company Request Token (which we’ll be using to authenticate into our application created above)

    1. Navigate to Company Request Token under Authentication Admin

    2. Now Paste the Client ID into the App ID & hit submit.

    3. ❗Note down the Company UUID & Company Request Token

Requirements: Within 24 hours, exchange the Company Request Token for a refresh token: send a POST request to your Concur token endpoint (for example https://us.api.concursolutions.com/oauth2/v0/token) with grant_type=password, credtype=authtoken, your client_id and client_secret, the Company UUID as username, and the Company Request Token as password. Then enter the Client Id, Client Secret, and the refresh_token from the response on the SAP Concur connector under Core Platform > Connectors > Built-in Connectors.