Concur Receipt Images API v3 Service Connector
Posted by: Informatica Cloud Application Integration Team
Allows for the management of receipt images attached to expense reports, expense entries, and payment requests. You can retrieve existing images by Image ID, and upload new images to a User. This API allows you to upload images in a predefined format and size targeting a specific resource or user in SAP Concur. You can also pull images down from SAP Concur by either displaying them in the browser or downloading the image content to save locally. Note: This API is not designed to obtain the receipt images attached to an expense report. If you are an Enterprise Partner creating integrations that are intended to obtain final-approved Expense or Invoice data, and the accompanying receipt images that substantiate those transactions you will need to use Image v1.
Overview
Receipt Images Calls:
Endpoint 1: /expense/receiptimages
- Get a list of all receipt IDs owned by the user associated with the access token
- Method Path:/expense/receiptimages
- HTTP Method: GET
- Accepted content type(s): application/json
Endpoint 2:/expense/receiptimages
- Upload a new receipt image.
- Method Path:/expense/receiptimages
- HTTP Method: POST
- Accepted content type(s): application/json
Endpoint 3: /expense/receiptimages/{id}
- Deletes the specified receipt image
- Method Path:/expense/receiptimages
- HTTP Method: DELETE
- Accepted content type(s): application/json
Endpoint 4: /expense/receiptimages/{id}
- Get a receipt image URL by image ID.
- Method Path:/expense/receiptimages/{id}
- HTTP Method: GET
- Accepted content type(s): application/json
Endpoint 5: /expense/receiptimages/{id}
- Appends a receipt image to an existing image. The resulting image will be a consolidated PDF.
- Method Path: /expense/receiptimages/{id}
- HTTP Method: PUT
- Accepted content type(s): application/json
Features
Specifications
Security
SAP Concur will make calls to the application connector’s endpoint using SSL. During configuration, SAP Concur will connect to the application connector to validate that its hostname and access credentials are valid.
SAP Concur will not be able to connect to the application connector until a certificate signed by a Certificate Authority (CA) is installed in the application connector. If you are hosting the application connector, you will need to install the signed certificate before SAP Concur can access the connector.
Authentication
Authenticating to the application connector
Expense passes credentials using HTTP Basic Auth to authenticate with the application connector. By default, these credentials are stored in the appropriate web configuration file for your platform, such as web.xml or web.config. The steps to configure Expense with the credentials are detailed below.