SAP Concur Spoke

The SAP Concur spoke is built by Bristlecone, Inc. Manage expenses, payments, purchases, users, travel, and so on in the SAP Concur account from your ServiceNow instance.

Request apps on Store

Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes. Starting on March 1st 2022, all SAP spokes will be available only on the Store.

Integration Hub subscription

This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview.

Spoke version

SAP Concur spoke v2.1.2 is the latest version.

Spoke requirements

  • SAP Concur API user with these roles:
    • Travel Wizard User
    • Expense User
    • Expense Approver
    • Authorised Support Contact
    • Invoice User

    SAP Concur API user roles

  • SAP Concur API user with these Expense API and Invoice User permissions.

    Expense API permissions

    Invoice API permissions

  • Contact SAP Concur Implementation team to obtain values of Client ID, Client Secret, Company ID, and Company Request Token, and define the scope of the client application.

Spoke dependencies

If you’re having trouble installing the app, ensure that these dependent plugins are installed:
  • Complex Object (com.glide.cobject)
  • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
  • ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
  • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
  • ServiceNow IntegrationHub Action Template - Data Stream (com.glide.hub.action_type.datastream)
  • Remote Tables (com.glide.script.vtable)
Note: Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation.

Spoke flows

The SAP Concur spoke provides a sample flow, Get All Modified Expense Reports to demonstrate retrieving the expense reports modified within 24 hours of the provided Expense Report Last Modified Date. To customize the sample flow, copy it to the required application scope.

Spoke subflows

The SAP Concur spoke provides a sample subflow, Get Expense Report Workflow Step ID to demonstrate retrieving the Workflow Step ID of an expense report on the basis of whether the given expense report is submitted or not. The output Workflow Step ID is required to run the Execute Workflow Action for Expense Report action. To customize the sample subflow, copy it to the required application scope.

Spoke actions

The SAP Concur spoke provides actions to automate tasks when events occurs in your ServiceNow instance. Available actions include:

Category Action Description
Expense Configuration Management Get Expense Group Configurations Retrieves all the expense group configuration for the specified user.
Expense Entry Management Create Expense Entry Creates a new expense entry for the specified user.
Delete Expense Entry Deletes the specified expense entry.
Get Expense Entry Details Retrieves details of the specified expense entry.
Look up Expense Entries Retrieves all expense entries owned by the user.
Look up Expense Itemizations Stream Retrieves all expense itemizations owned by the user.
Update Expense Entry Updates details of the specified expense entry.
Expense Report Management Create Expense Report Creates an expense report with the supplied data.
Execute Workflow Action for Expense Report Executes a workflow action for an expense report using it's workflow step ID.
Note: One of the action inputs is Workflow Step ID. Use the default subflow, Get Expense Report Workflow Step ID, to obtain the required Workflow Step ID value.
Get Expense Report Details Retrieves details of the specified expense report.
Look up Comments Retrieves the comments from the specified report header and from the specific expense within an expense report.
Look up Expense Reports Retrieves all expense reports owned by the user, based on the search criteria.
Look up Expense Reports After Last Modified Date Retrieves the reports modified within 24 hours after the specified Report Last Modified Date.
Submit Expense Report Submits an expense report for the specified report.
Update Expense Report Updates details of the expense report for the specified report.
Itinerary Management Look up Itinerary by Trip ID Retrieves information about the required trip.
Payment Request Management Create Payment Request Creates a payment request with all relevant details, including line items and associated allocations.
Get Payment Request Details Retrieves details such as Payment Request Header, Payment Request Line Item and Payment Request Allocation, for the specified payment request.
Update Payment Request Updates details of the specified payment request such as line items and associated allocations.
Purchase Order Management Create Purchase Order Creates a purchase order in SAP Concur.
Get Purchase Order Details Retrieves information about the specified purchase order.
Update Purchase Order Updates details of the specified purchase order.
Receipt Management Get Expense Entry Receipt Image URL Retrieves expense entry receipt image URL of the specified expense entry.
Get Expense Report Receipt Image URL Retrieves expense report receipt image URL of the specified expense report.
Post Expense Report Receipt Image Creates a receipt image for the specified expense report.
User Management Get User Details Retrieves details of the specified user.
Note: Details of only the expense users are retrieved using this action.
Look up Users Retrieves details of the required user, based on the provided search criteria.
Look up Users Stream Retrieves details of all users in a given company. The filter operation can also be used to retrieve the required user’s identity information.
Webhook Management Create Webhook Subscription Creates subscriptions in SAP Concur for the selected topic with provided endpoint.

Spoke module

The SAP Concur spoke adds the SAP Concur Spoke application to your instance and includes these modules:
ModuleDescription
SAP Concur Expense Entries View details of the expense entries. After you Set up the SAP Concur spoke and map the users in the SAP Concur User Mappings module, the system retrieves details of the expense entries and populates in this module.
SAP Concur Expense Report Details View the expense report details. Configure the default flow Get All Modified Expense Reports as per your requirement to retrieve and populate data.
SAP Concur Expense Report Last Modified Date View the latest timestamp or last modified date on which the flow was executed or reports were filtered. Configure the default flow Get All Modified Expense Reports as per your requirement to retrieve and populate data.
SAP Concur Expense Reports View the expense reports. After you set up the Set up the SAP Concur spoke and map the users, the system retrieves details of the expense reports and populates in this module.
SAP Concur User Mappings Map ServiceNow users to their corresponding User IDs in SAP Concur.

Spoke user roles

The SAP Concur spoke provides these user roles to control access to data:
User role Description
sn_sap_concur_spok.SAP Concur Spoke Admin Users with this role can perform all operations.
sn_sap_concur_spok.SAP Concur Expense Entries User Users with this role can only view the data available in the SAP Concur Expense Entries module.
sn_sap_concur_spok.SAP Concur Expense Reports User Users with this role can only view the data available in the SAP Concur Expense Reports module.

Connection and credential alias requirements

Integration Hub uses aliases to manage connection and credential information. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection. For more information, see Connections and Credentials.

For information about setting up the spoke, see Set up the SAP Concur spoke.