Learn about SAP Concur APIs

1. Login to your Concur admin panel.

2. Enter your user Id and click Next.
   

   

3. Enter your password and click Sign In.
   

   

1. Go to the OAuth 2.0 Application Management screen.
2. Click Create New App.
   
   
3. Fill in all of the required fields and add all of the grants and scopes you have access to. Click Submit when to form is completed
   
   
4. Copy and paste your Client ID and Client Secret to a text file. Click OK when completed
   
   

1. Go to the Company Request Token screen.
2. Enter your App ID in the required field and click Submit to generate your company request token.
   
   
3. Copy/paste the Company UUID and company request token fields to a text file.
   
   
4. Click OK after you have saved this information to a text file.

Visual Studio Code (or just VSCode) is a free source code editor developed and maintained by Microsoft. The REST Client plugin requires just a plain text file with the extension .http or .rest.

1. Open Visual Studio Code
2. Create a file with name api.http Or you can give any name but file extension should be .http Or .rest.
3. Copy the below code to the file

###
@hostname = <your-company-base_URI>
@your-client_id = <your-client_id>
@your-client_secret = <your-client_secret>
@username = <your-company_uuid>
@password = <your-company_request_token>

Replace the placeholder as per your application configuration your-client_id, your-client_secret, your-company_uuid and your-company_request_token you have generated in previous step.

When making the call, you will use your app’s geolocation as the base URI followed by the endpoint. For example, if your geolocation is https://us.api.concursolutions.com, you will call https://us.api.concursolutions.com/oauth2/v0/token.

The first time you request for a refreshToken This is used to get a new accessToken when one has expired.

1. Copy below code just below the above code to Obtain a refresh token and store it to a variable.

### Obtain a Refesh token
# @name refeshTokenCall
POST {{hostname}}/oauth2/v0/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Connection: close
Content-Length: 175

client_id={{your-client_id}}
&client_secret={{your-client_secret}}
&grant_type=password
&username={{username}}
&password={{password}}
&credtype= authtoken

###
@refeshToken = {{refeshTokenCall.response.body.refresh_token}}

The Oauth2 service generates access tokens for authenticated applications. The token returned in the Oauth2 response can be used to access protected resources on SAP Concur services.

1. Copy below code just below the above code to Obtain a access Token and store it to a variable.

### Obtain an Access Token
# @name accessTokenCall
POST {{hostname}}/oauth2/v0/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Connection: close
Content-Length: 167

client_id={{your-client_id}}
&client_secret={{your-client_secret}}
&grant_type=refresh_token
&refresh_token={{refeshToken}}

###
@accessToken = {{accessTokenCall.response.body.access_token}}

The base URI for all subsequent calls. Armed with the accessToken you can start making calls to an SAP Concur API. Here’s an example How you can retrieve Expense Report by utilizing the appropriate base URI with the access token.

### Get Expense Report
# @name getExpenseReport
GET {{hostname}}/api/v3.0/expense/reports?limit=100&user=ALL HTTP/1.1
Authorization: Bearer {{accessToken}}

Using VS Code extension you can make these API calls easily by giving the references to the required response objects in the first call and using them in the next call.

We have Three Request in the script.

1. First request for a refesh token. This is use to get new access token when one has expired.

2. Second request for a access token. this is use to access protected resources on SAP Concur services.

3. Last Request Get call to retrieve Expense Report.

Click on Send Request sequentially as mentioned in below screenshot

The SAP Concur Expense Reports API used to read and modify an existing expense report. This API can be used to simplify expense reporting and get more visibility into spending.

1. Check your final request result.

You have successfully completed the first tutorial of this tutorial group. Learn in the next tutorial how to fetch expense report entries using the integration flow.