Invoke Operations Page

Select the SAP Concur Adapter invoke operation values for your integration.

You identify the operation type and the operations to perform in the SAP Concur application.

Element Description

Select Operation Type - Swagger API option

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

  • Create

  • Update

  • Delete

  • Get

Select Operation Type - 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 Type - 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 Operation

Selects the API operation to perform.

Select Extract

Selects the extract to perform.

Description

A description of the API operation that is performed.