{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21390,"path":"integrate-applications/integration-hub/sap-concur-spoke.md","title":"SAP Concur Spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# SAP Concur Spoke\n\nThe 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.\n\n## Request apps on Store\n\nVisit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) 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](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html). Starting on March 1st 2022, all SAP spokes will be available only on the Store.\n\n## Integration Hub subscription\n\nThis spoke requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf).\n\n## Supported versions\n\nThis spoke was built for SAP Concur API versions v3.0 and v4.0, but may be compatible with later versions.\n\n## Spoke version\n\nSAP Concur spoke v2.3.3 is the latest version. For version history of the spoke, see [SAP Concur spoke release notes](https://www.servicenow.com/docs/r/store-release-notes/store-integrationhub-rn-sap-concur.html).\n\n## Spoke requirements\n\n-   SAP Concur API user with these roles:\n\n    -   Travel Wizard User\n    -   Expense User\n    -   Expense Approver\n    -   Authorised Support Contact\n    -   Invoice User\n    \\[Omitted image \"sap-concur-user-roles.png\"\\] Alt text: SAP Concur API user roles\n\n-   SAP Concur API user with these Expense API and Invoice User permissions.\n\n    \\[Omitted image \"sap-concur-expense-prms.png\"\\] Alt text: Expense API permissions\n\n    \\[Omitted image \"sap-concur-invoice-prms.png\"\\] Alt text: Invoice API permissions\n\n-   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.\n\n## Spoke dependencies\n\nIf you’re having trouble installing the app, ensure that these dependent plugins are installed:\n\n-   Complex Object \\(com.glide.cobject\\)\n-   ServiceNow IntegrationHub Runtime \\(com.glide.hub.integration.runtime\\)\n-   ServiceNow Flow Designer - Dynamic Inputs \\(com.glide.hub.dynamic\\_inputs\\)\n-   ServiceNow IntegrationHub Action Step - REST \\(com.glide.hub.action\\_step.rest\\)\n-   ServiceNow IntegrationHub Action Template - Data Stream \\(com.glide.hub.action\\_type.datastream\\)\n-   Remote Tables \\(com.glide.script.vtable\\)\n\n**Note:** Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation.\n\n## Spoke flows\n\nThe 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.\n\n## Spoke subflows\n\nThe 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.\n\n## Spoke actions\n\nThe SAP Concur spoke provides actions to automate tasks when events occurs in your ServiceNow instance. Available actions include:\n\n<table id=\"table_szt_jcd_h4b\"><thead><tr><th>\n\nCategory\n\n</th><th>\n\nAction\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nExpense Configuration Management\n\n</td><td>\n\nGet Expense Group Configurations\n\n</td><td>\n\nRetrieves all the expense group configuration for the specified user.\n\n</td></tr><tr><td rowspan=\"6\">\n\nExpense Entry Management\n\n</td><td>\n\nCreate Expense Entry\n\n</td><td>\n\nCreates a new expense entry for the specified user.\n\n</td></tr><tr><td>\n\nDelete Expense Entry\n\n</td><td>\n\nDeletes the specified expense entry.\n\n</td></tr><tr><td>\n\nGet Expense Entry Details\n\n</td><td>\n\nRetrieves details of the specified expense entry.\n\n</td></tr><tr><td>\n\nLook up Expense Entries\n\n</td><td>\n\nRetrieves all expense entries owned by the user.\n\n</td></tr><tr><td>\n\nLook up Expense Itemizations Stream\n\n</td><td>\n\nRetrieves all expense itemizations owned by the user.\n\n</td></tr><tr><td>\n\nUpdate Expense Entry\n\n</td><td>\n\nUpdates details of the specified expense entry.\n\n</td></tr><tr><td rowspan=\"8\">\n\nExpense Report Management\n\n</td><td>\n\nCreate Expense Report\n\n</td><td>\n\nCreates an expense report with the supplied data.\n\n</td></tr><tr><td>\n\nExecute Workflow Action for Expense Report\n\n</td><td>\n\nExecutes 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.\n\n</td></tr><tr><td>\n\nGet Expense Report Details\n\n</td><td>\n\nRetrieves details of the specified expense report.\n\n</td></tr><tr><td>\n\nLook up Comments\n\n</td><td>\n\nRetrieves the comments from the specified report header and from the specific expense within an expense report.\n\n</td></tr><tr><td>\n\nLook up Expense Reports\n\n</td><td>\n\nRetrieves all expense reports owned by the user, based on the search criteria.\n\n</td></tr><tr><td>\n\nLook up Expense Reports After Last Modified Date\n\n</td><td>\n\nRetrieves the reports modified within 24 hours after the specified Report Last Modified Date.\n\n</td></tr><tr><td>\n\nSubmit Expense Report\n\n</td><td>\n\nSubmits an expense report for the specified report.\n\n</td></tr><tr><td>\n\nUpdate Expense Report\n\n</td><td>\n\nUpdates details of the expense report for the specified report.\n\n</td></tr><tr><td>\n\nItinerary Management\n\n</td><td>\n\nLook up Itinerary by Trip ID\n\n</td><td>\n\nRetrieves information about the required trip.\n\n</td></tr><tr><td rowspan=\"3\">\n\nPayment Request Management\n\n</td><td>\n\nCreate Payment Request\n\n</td><td>\n\nCreates a payment request with all relevant details, including line items and associated allocations.\n\n</td></tr><tr><td>\n\nGet Payment Request Details\n\n</td><td>\n\nRetrieves details such as Payment Request Header, Payment Request Line Item and Payment Request Allocation, for the specified payment request.\n\n</td></tr><tr><td>\n\nUpdate Payment Request\n\n</td><td>\n\nUpdates details of the specified payment request such as line items and associated allocations.\n\n</td></tr><tr><td rowspan=\"3\">\n\nPurchase Order Management\n\n</td><td>\n\nCreate Purchase Order\n\n</td><td>\n\nCreates a purchase order in SAP Concur.\n\n</td></tr><tr><td>\n\nGet Purchase Order Details\n\n</td><td>\n\nRetrieves information about the specified purchase order.\n\n</td></tr><tr><td>\n\nUpdate Purchase Order\n\n</td><td>\n\nUpdates details of the specified purchase order.\n\n</td></tr><tr><td rowspan=\"3\">\n\nReceipt Management\n\n</td><td>\n\nGet Expense Entry Receipt Image URL\n\n</td><td>\n\nRetrieves expense entry receipt image URL of the specified expense entry.\n\n</td></tr><tr><td>\n\nGet Expense Report Receipt Image URL\n\n</td><td>\n\nRetrieves expense report receipt image URL of the specified expense report.\n\n</td></tr><tr><td>\n\nPost Expense Report Receipt Image\n\n</td><td>\n\nCreates a receipt image for the specified expense report.\n\n</td></tr><tr><td rowspan=\"3\">\n\nUser Management\n\n</td><td>\n\nGet User Details\n\n</td><td>\n\nRetrieves details of the specified user.**Note:** Details of only the expense users are retrieved using this action.\n\n</td></tr><tr><td>\n\nLook up Users\n\n</td><td>\n\nRetrieves details of the required user, based on the provided search criteria.\n\n</td></tr><tr><td>\n\nLook up Users Stream\n\n</td><td>\n\nRetrieves details of all users in a given company. The filter operation can also be used to retrieve the required user’s identity information.\n\n</td></tr><tr><td>\n\nWebhook Management\n\n</td><td>\n\nCreate Webhook Subscription\n\n</td><td>\n\nCreates subscriptions in SAP Concur for the selected topic with provided endpoint.\n\n</td></tr></tbody>\n</table>## Available AI agents\n\nInstall Now Assist for Integration Hub and start using the available AI agents. For more information, see [ServiceNow Otto for Integration Hub](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/now-assist-spokes.md).\n\nThis spoke provides standalone AI agents that mimic human-like intelligence to perform tasks in your ServiceNow instance.\n\n-   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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/configure-use-case-ai-agents.md) for information about adding AI agents to create agentic workflows as per your requirement and provide the required trigger.\n\n    You can also search for other available AI agents and add them to your agentic workflow. See [Find AI agents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/find-ai-agents.md) for more information.\n\n-   You can create a clone of the required spoke AI agent and customize it as per your requirement. See [Duplicate an AI agent](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/clone-ai-agent.md) for more information about creating a clone.\n-   See [AI Agent Studio \\(legacy\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/na-ai-agents.md) for information about AI agents.\n\nAvailable AI agents include:\n\n|AI agent|Description|\n|--------|-----------|\n|SAP Concur payment request management AI agent|Manages and retrieves payment request details.|\n|SAP Concur expense report management AI agent|Manages and submits expense reports, retrieves detailed information, and manages comments|\n|SAP Concur purchase order management AI agent|Manages purchase order operations and retrieves the required purchase order details.|\n|SAP Concur expense entry management AI agent|Manages and retrieves expense entry details.|\n|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.|\n|SAP Concur itinerary management AI agent|Manages itineraries and expenses, and retrieves the required itinerary information.|\n\nThere might be AI agents installed on your instance that are not used in agentic workflows. To learn how to see all agents that are available to you, see [Find AI agents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/find-ai-agents.md).\n\n**Note:** Ensure that the user running an AI agent has the required roles and permissions to access data or perform operations on data in the table that is associated with the AI agent.\n\n## Available sample agentic workflows\n\nInstall Now Assist for Integration Hub and start using the available sample agentic workflows and AI agents. For more information, see [ServiceNow Otto for Integration Hub](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/now-assist-spokes.md).\n\nIn 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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/modify-aia-use-case.md).\n\nAvailable sample agentic workflow includes:\n\n<table id=\"table_chb_l90v_c3c\"><thead><tr><th>\n\nSample agentic workflow\n\n</th><th>\n\nDescription\n\n</th><th>\n\nAI agents used\n\n</th><th>\n\nAlways ON by default?\n\n</th></tr></thead><tbody><tr><td>\n\nGet Purchase Order and Payment Request Details\n\n</td><td>\n\nRetrieves purchase order information and the corresponding payment request details for review and processing.\n\n</td><td>\n\n-   SAP Concur payment request management AI agent\n-   SAP Concur purchase order management AI agent\n\n</td><td>\n\nNo**Note:** To activate the workflow, see [Activate an agentic workflow template](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/activate-aia-use-case.md).\n\n</td></tr><tr><td>\n\nUpload Expense Receipt Image and Submit Expense Report\n\n</td><td>\n\nRetrieves recently updated expense reports, uploads a receipt image to an expense report, and submits the expense report for approval.\n\n</td><td>\n\n-   SAP Concur receipt management AI agent\n-   SAP Concur expense report management AI agent\n\n</td><td>\n\nNo**Note:** To activate the workflow, see [Activate an agentic workflow template](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/activate-aia-use-case.md).\n\n</td></tr></tbody>\n</table>## Spoke module\n\nThe SAP Concur spoke adds the SAP Concur Spoke application to your instance and includes these modules:\n\n|Module|Description|\n|------|-----------|\n|SAP Concur Expense Entries|View details of the expense entries. After you [Set up the SAP Concur spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-sapconcur-spk.md) and map the users in the SAP Concur User Mappings module, the system retrieves details of the expense entries and populates in this module.|\n|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.|\n|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.|\n|SAP Concur Expense Reports|View the expense reports. After you set up the [Set up the SAP Concur spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-sapconcur-spk.md) and map the users, the system retrieves details of the expense reports and populates in this module.|\n|SAP Concur User Mappings|Map ServiceNow users to their corresponding User IDs in SAP Concur.|\n\n## Spoke user roles\n\nThe SAP Concur spoke provides these user roles to control access to data:\n\n|User role|Description|\n|---------|-----------|\n|sn\\_sap\\_concur\\_spok.SAP Concur Spoke Admin|Users with this role can perform all operations.|\n|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.|\n|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.|\n\n## Connection and credential alias requirements\n\nIntegration 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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-security/r-credentials.md).\n\nFor information about setting up the spoke, see [Set up the SAP Concur spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/setup-sapconcur-spk.md).\n\n"}}