Select Module

(Appears only if you select Swagger API on the API Options page and v4.0 from the Swagger API Version list on the Connections page.)

• Identity APIs

Select Operation Type - Swagger API option

(Appears only if you select Swagger API on the API Options page.)

If you selected Swagger API on the API Options page, these are the available operations:

• Create

• Update

• Delete

• Get

Note: Only the Get option is supported for Swagger API version v4.0.

Select Operation – Swagger API option

• If you select Swagger API Version as v3.0 v3.1 on the Connections page, the list of operations that support the Create, Update, Delete, and Get operations are displayed for selection (for example, Create a new attendee, Create a new purchase order, Update purchase order receipt, Delete a vendor by vendor code, and Get a receipt image URL).
• If you select Swagger API Version as v4.0, only the following Get operations appear for selection.
  • Retrieve Users
  • Retrieves User Identity Profile

Select Operation - Extract API option

If you selected Extract API on the API Options page, these are the available operations:

• SubmitJobRequest: Submits a job request. After selecting this option, you select an extract corresponding to the job to post to the SAP Concur application. The response of this operation contains the link (status-link) to track the status of the submitted job. The Summary page of the SubmitJobRequest operation shows the file headers of the file(s) returned after the job is completed. You can use the RetrieveFile operation to get the extract file(s) for the job and use the file headers on the Summary page for further processing of the file(s).

  Note: In SAP Concur Standard Edition, only jobs for Invoice GL Extract can be submitted, as provisioned by SAP Concur.

• Getjobdetails: Fetches the details of the past 100 jobs submitted to the SAP Concur application corresponding to the extract you select.

• GetJobstatus: Takes jobStatusLink as input in the payload and returns the status of the job.

  Note:

  • The Status element’s value (the status of the job) in the response is 2, as returned by SAP Concur if the job is completed.

  • The link for the extract file is not available in the response until the job status is completed.

  • The jobStatusLink is returned by the SubmitJobRequest or GetJobDetails operation in the response.

• RetrieveFile: Takes file-link as input in the payload and returns a CSV file(s) (if file-link returns a ZIP, extraction is handled by the adapter) based on the response of the respective file-link. You can use the RetrieveFile operation to get the extract data corresponding to the file link. The RetrieveFile operation downloads the file to a virtual file system (VFS) directory. The VFS location of the downloaded file is returned in the response of the RetrieveFile operation, along with the file(s) name.

  Note: The file-link value is used as the URI when retrieving the extract data. You cannot get the file-link until the job is in a running stage.

Select Operation - Payment Batch API option

If you selected Payment Batch API on the API Options page, these are the available operations with SAP Concur’s Standard Edition:

• CloseBatch: Closes the specified batch based on the payment batch you select. This prevents any new expenses from entering. The batch list corresponding to the SAP Concur instance is displayed. You must select the payment batch required to be closed from the Select Payment Batch section. A request is sent to the SAP Concur application to close the respective batch. After the batch is closed, SAP Concur creates the batch file containing the expense information. The response of this operation contains the link (file-link) to get the corresponding Payment Batch file(s) by using this link as input to the RetrieveFile operation.

• RetrieveFile: Gets the file for the corresponding batch once the batch is closed. This operation takes file-link as input in the payload and returns a CSV file(s) (if the file-link returns a ZIP, extraction is handled by the adapter) based on the response of the respective file-link.

Select Extract

Selects the extract to perform.

Select Payment Batch

Select the payment batch.