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 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.
Supported versions
This spoke was built for SAP Concur API versions v3.0 and v4.0, but may be compatible with later versions.
Spoke version
SAP Concur spoke v2.3.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 with these Expense API and Invoice User 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
- 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)
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. |
Available AI agents
Install Now Assist for Integration Hub and start using the available AI agents. For more information, see Now Assist for Integration Hub.
- In the ServiceNow agentic system, you can create an agentic workflow that comprises of a set of large language model (LLM) instructions along with one or more standalone AI agents to execute an
objective. See Create an agentic workflow for information about adding AI agents to create agentic workflows as per your requirement and provide the required trigger.
You can also search for other available AI agents and add them to your agentic workflow. See Find AI agents for more information.
- You can create a clone of the required spoke AI agent and customize it as per your requirement. See Duplicate an AI agent for more information about creating a clone.
- See Now Assist AI agents for information about AI agents.
| AI agent | Description |
|---|---|
| SAP Concur payment request management AI agent | Manages and retrieves payment request details. |
| SAP Concur expense report management AI agent | Manages and submits expense reports, retrieves detailed information, and manages comments |
| SAP Concur purchase order management AI agent | Manages purchase order operations and retrieves the required purchase order details. |
| SAP Concur expense entry management AI agent | Manages and retrieves expense entry details. |
| SAP Concur receipt management AI agent | Manages receipts by enabling users to perform tasks such as uploading receipt images to expense reports, retrieving URLs for expense entry receipt images, and obtaining URLs for expense report receipt images. |
| SAP Concur itinerary management AI agent | Manages itineraries and expenses, and retrieves the required itinerary information. |
There might be AI agents installed with the Now Assist application that are not used in agentic workflows. To learn how to see all agents that are available to you, see Find AI agents.
Available sample agentic workflows
Install Now Assist for Integration Hub and start using the available sample agentic workflows and AI agents. For more information, see Now Assist for Integration Hub.
In the ServiceNow agentic system, you can create an agentic workflow that comprises of a set of large language model (LLM) instructions along with one or more standalone AI agents to execute an objective. Use the available sample agentic workflow in AI Agent Studio so that AI agents can coordinate to solve complex problems. To modify the available sample agentic workflow as per your requirement, see Modify an agentic workflow.
| Sample agentic workflow | Description | AI agents used | Always ON by default? |
|---|---|---|---|
| Get Purchase Order and Payment Request Details | Retrieves purchase order information and the corresponding payment request details for review and processing. |
|
No Note: To activate the workflow, see Activate an agentic workflow template. |
| Upload Expense Receipt Image and Submit Expense Report | Retrieves recently updated expense reports, uploads a receipt image to an expense report, and submits the expense report for approval. |
|
No Note: To activate the workflow, see Activate an agentic workflow template. |
Spoke module
| Module | Description |
|---|---|
| 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
| 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.