Skip to content
Permalink
Browse files

Merge pull request #1938 from concur/preview

Preview -> Live 04.12.19
  • Loading branch information...
sarraloew committed Apr 13, 2019
2 parents 0b7a95c + e70cd12 commit 9d1cddbdedff01dbd1320d3c877e9bebb0dfd2e0
@@ -147,9 +147,6 @@
"payment": {
"type": "object",
"properties": {
"currency": {
"type": "string"
},
"invoices": {
"type": "array",
"items": {
@@ -6,6 +6,7 @@ layout: reference
# Endpoints

* [Definitions of Resources](#definitions-of-resources)
* [Supported Image Formats](#supported-image-formats)
* [General](#general)
* [GET Service Index](#endpoint-service-index)
* [GET Receipt Status by Receipt ID](#endpoint-get-receipt-status)
@@ -26,6 +27,12 @@ layout: reference
* *__E-Receipt__* - A schema-enforced resource with data and, optionally, an image. If an image is not provided, one will be generated from the data resource.
* *__Image-Only Receipt__* - A standalone image without data.

#### <a name="supported-image-formats"></a>Supported Image Formats

* Image size must not exceed 5MB.
* Images with any dimension exceeding 2,200 pixels will be reduced, with the longest dimension reduced to 2,200 pixels and the remaining dimensions scaled down using a fixed aspect ratio.
* Image must be one of the supported file types: image/png, image/jpg, image/jpeg, image/tiff, image/tif, image/gif, and application/pdf. Images provided in image/tiff and image/tif will be converted to a PDF document with the image embedded within.

### General

|Endpoint|Response Format|Request Summary|
@@ -319,20 +326,19 @@ _Example Response:_
|---|---|---|
|userId|required|The id of the user to whom the receipt belongs.|
|receipt|required|The JSON receipt to be posted.|
|image|optional|Image of the receipt. If an image isn't provided, one will be generated automatically from the JSON.|
|image|optional|Image of the receipt. If an image isn't provided, one will be generated automatically from the JSON. Refer to [Supported Image Formats](#supported-image-formats) for more information.|

Creating a receipt requires JSON data about the transaction and, optionally, an image of the receipt. If an image is not supplied with the request, Concur will automatically generate a receipt image based on the data provided. [JSON schemas](https://developer.concur.com/api-reference/receipts/get-started.html#endpoint-schemas) are used to validate the format of receipt data received in POST requests.
Creating a receipt requires JSON data about the transaction and, optionally, an image of the receipt. If an image is not supplied with the request, SAP Concur will automatically generate a receipt image based on the data provided. [JSON schemas](https://developer.concur.com/api-reference/receipts/get-started.html#endpoint-schemas) are used to validate the format of receipt data received in POST requests.

Successful POST requests will receive a response of 201 Created. The `Location` header of the response contains a URL for your receipt. Once the receipt has been processed, it can be retrieved at this URL. The `Link` header of the response contains a processing-status URL for your receipt. More information can be found [here](#endpoint-get-receipt-status).

Helpful Notes:
- Include link as a header and make its value: “<http://schema.concursolutions.com/{receipt type}.schema.json>;rel=describedBy”
- Include link as a header and make its value: “<http://schema.concursolutions.com/{receipt type}.schema.json>;rel=describedBy”
- Copy a sample receipt of that receipt type from the documentation (https://developer.concur.com/api-reference/receipts/sample-receipts.html) and post it into the body of this POST call → you can then edit this body to your specification


If you are not providing an image with your receipt data, the body of the request should be your receipt JSON.

Receipt images may be posted along with data. In this case, Concur will use the provided image instead of generating a new one. To post data and an image, use multipart form data. The `Content-Type:multipart/form-data` header must be set. The image should be included under the key `image`, and the receipt JSON should be included under the key `receipt`. Image files are limited to a maximum size of 5MB. Accepted file formats for image files are: image/png, image/jpg, image/jpeg, image/tiff, image/tif, image/gif, and application/pdf.
Receipt images may be posted along with data. In this case, SAP Concur will use the provided image instead of generating a new one. To post data and an image, use multipart form data. The `Content-Type:multipart/form-data` header must be set. The image should be included under the key `image`, and the receipt JSON should be included under the key `receipt`. For information regarding image size, dimension, and type, please refer to [Supported Image Formats](#supported-image-formats).

_Example Requests:_

@@ -523,18 +529,16 @@ http https://us.api.concursolutions.com/receipts/v4/{RECEIPT ID}/image "Authoriz
|Parameter|Requirement|Value|
|---|---|---|
|userId|required|The id of the user to whom the receipt image belongs.|
|image|required|Image of the receipt.|

- Image constraints
- Image size must not exceed 5MB
- Image must be one of the supported file types: image/png, image/jpg, image/jpeg, image/tiff, image/tif, image/gif, and application/pdf
|image|required|Image of the receipt. Refer to [Supported Image Formats](#supported-image-formats) for more information.|

Successful POST requests will receive a response of 202 Accepted. The Location header of the response contains a URL for your receipt image. Once the receipt has been processed, it can be retrieved at this URL. The Link header of the response contains a processing-status URL for your receipt image.

Helfpul Notes:
- The header must include content-type with multipart/form-data as its value
Helpful Notes:
- The header must include content-type with multipart/form-data as its value
- In the body, add "image" as a key and select "file" from the dropdown since you will be linking an image file. Then, choose your saved image file as the value.

For information regarding image size, dimension, and type, please refer to [Supported Image Formats](#supported-image-formats).

_Example Requests:_

cURL:
@@ -5,18 +5,19 @@ layout: reference

* [January](#january)
* [March](#march)
* [April - DRAFT](#april)


## <a name="january"></a>January 2019

* [Apps for Me / User Connection Apps Now Available](#apps-for-me-connection-now-available)
* [Chauffeur Privé](#chauffeur-prive)
* [Apps for Me / User Connection Apps Coming Soon](#apps-for-me-connection-coming-soon)
* [Parken+](#parken+)
* [Apps for Me / User Connection Apps Now Available](#apps-for-me-connection-now-available-january)
* [Chauffeur Privé](#chauffeur-prive-january)
* [Apps for Me / User Connection Apps Coming Soon](#apps-for-me-connection-coming-soon-january)
* [Parken+](#parken+-january)

### <a href="apps-for-me-connection-now-available"></a>Apps for Me / User Connection Apps Now Available
### <a href="apps-for-me-connection-now-available-january"></a>Apps for Me / User Connection Apps Now Available

#### <a href="chauffeur-prive"></a>Chauffeur Privé
#### <a href="chauffeur-prive-january"></a>Chauffeur Privé

![Chauffeur Privé Logo](./app-center-2019-01-01-chauffeur-logo.png)

@@ -72,9 +73,9 @@ So, where are we taking you?

Chauffeur Privé works with Expense for Concur Standard and Expense for Concur Professional. It is now available in the SAP Concur App Center under User Connections (formerly Apps for Me) at [www.Concur.com/AppCenter](www.Concur.com/AppCenter). For more information about the Chauffeur Privé integration, visit [https://www.chauffeur-prive.com/](https://www.chauffeur-prive.com/).

## <a name="apps-for-me-connection-coming-soon"></a>Apps for Me / User Connection Apps Coming Soon
## <a name="apps-for-me-connection-coming-soon-january"></a>Apps for Me / User Connection Apps Coming Soon

### <a name="parken+"></a>Parken+
### <a name="parken+-january"></a>Parken+

![Parken+ Logo](./app-center-2019-01-01-parken-logo.png)

@@ -92,15 +93,15 @@ Parken+ works with Expense for Concur Standard and Expense for Concur Profession

## <a name="march"></a>March 2019

* [Apps for Me / User Connection Apps Now Available](#apps-for-me-connection-now-available)
* [Kapten](#kapten)
* [Apps for Me / User Connection Apps Coming Soon](#apps-for-me-connection-coming-soon)
* [prayerletters.com](#prayerletters.com)
* [Parken+](#parken+)
* [Apps for Me / User Connection Apps Now Available](#apps-for-me-connection-now-available-march)
* [Kapten](#kapten-march)
* [Apps for Me / User Connection Apps Coming Soon](#apps-for-me-connection-coming-soon-march)
* [prayerletters.com](#prayerletters.com-march)
* [Parken+](#parken+-march)

### <a href="apps-for-me-connection-now-available"></a>Apps for Me / User Connection Apps Now Available
### <a href="apps-for-me-connection-now-available-march"></a>Apps for Me / User Connection Apps Now Available

#### <a href="kapten"></a>Kapten
#### <a href="kapten-march"></a>Kapten

![Kapten Logo](./app-center-2019-03-14-kapten-logo.png)

@@ -157,9 +158,9 @@ AVAILABLE CITIES

So, where are we taking you? Click “Connect” to get started.

## <a name="apps-for-me-connection-coming-soon"></a>Apps for Me / User Connection Apps Coming Soon
## <a name="apps-for-me-connection-coming-soon-march"></a>Apps for Me / User Connection Apps Coming Soon

### <a name="prayerletters.com"></a>prayerletters.com
### <a name="prayerletters.com-march"></a>prayerletters.com

![prayerletters.com Logo](./app-center-2019-03-14-prayerlettersdotcom-logo.png)

@@ -173,7 +174,7 @@ Click “Connect” to link your SAP Concur account. Once linked, we'll send rec

Contact us any time with questions or to get advice on your prayer letters. You can also use live chat to interact directly with us during our business hours (US Eastern time).

### <a name="parken+"></a>Parken+
### <a name="parken+-march"></a>Parken+

![Parken+ Logo](./app-center-2019-01-01-parken-logo.png)

@@ -188,3 +189,64 @@ By connecting your Concur Expense account with Parken+, you can easily submit yo

Parken+ works with Expense for Concur Standard and Expense for Concur Professional. It will be available soon in the SAP Concur App Center under User Connections (formerly Apps for Me) at [https://www.concur.com/app-center](https://www.concur.com/app-center). For more information about the Parken+ integration, visit
[http://www.parken.plus/](http://www.parken.plus/).

## <a name="april"></a>April 2019

* [Apps for Me / User Connection Apps Coming Soon](#apps-for-me-connection-coming-soon-april)
* [DiDi Enterprise Solutions](#didi-enterprise-solutions-april)
* [prayerletters.com](#prayerletters.com-april)
* [Parken+](#parken+-april)

## <a name="apps-for-me-connection-coming-soon-april"></a>Apps for Me / User Connection Apps Coming Soon

### <a name="didi-enterprise-solutions-april"></a>DiDi Enterprise Solutions - Updated EU and China Data Center Availability

![DiDi Enterprise Solutions Logo](./app-center-2019-04-09-didienterprisesolutions-logo.png)

*The DiDi integration will be updated to the SAP Concur Receipts v4 API and will be available on the EU Data Center and China Data Center, in addition to the US Data Center. No action is required from existing users. New users on all Data Centers can connect to DiDi in the [SAP Concur App Center](https://www.concur.com/app-center/listings/576c6598c144f515002e4fea).*

DiDi Enterprise Solutions (DiDi ES) is a market leader dedicated to offering business travel services and expense management solutions to corporate clients.

After a company creates an enterprise account, its employees can use the DiDi Enterprise App to request a business ride. Trip fares will then be paid directly from the enterprise account. Through the integration with SAP Concur, employees’ ride receipts can be sent automatically to Concur Expense.

Through its intelligent transportation management system, DiDi Enterprise Solutions can simplify the management process of expense reporting for companies and allow their employees to enjoy a more relaxed business travel experience. It also helps companies manage vehicle usage while ensuring employees stay in compliance with company policies and regulations, reducing the risk of conducting non-compliant activities.

At the same time, DiDi Enterprise Solutions provides comprehensive and accurate data points on itinerary and travel expenses to corporate managers who can use the data to have better cost control, reduce management cost, and increase operating efficiency.

DiDi Enterprise Solutions services more than 300,000 corporate customers and over 17.5 million employees.

To automatically synchronize your ride expenses with Concur Expense and submit expenses for reimbursement, simply click the “Connect” button in the DiDi app and connect your SAP Concur account with your DiDi Enterprise Solutions account.

DiDi Enterprise Solutions works with Expense for Concur Standard and Expense for Concur Professional. It will be available soon in the SAP Concur App Center under User Connections (formerly Apps for Me) at [https://www.concur.com/app-center](https://www.concur.com/app-center). For more information about the DiDi ES integration, visit
[https://www.didiglobal.com/](https://www.didiglobal.com/).

### <a name="prayerletters.com-april"></a>prayerletters.com

![prayerletters.com Logo](./app-center-2019-03-14-prayerlettersdotcom-logo.png)

As a missionary, you need to send regular updates to people interested in your ministry so that they can effectively pray for you and send financial support.

At prayerletters.com, we make it easy for you to send high-quality printed prayer letters quickly and easily. You simply write your letter and send it to us with your mailing list. We take care of all the printing, folding, stuffing, and mailing, freeing up your time and energy to minister in the ways you've been gifted.

Our online order system is designed specifically for missionaries. You can quickly create a mailing, make changes to your list, and resend returned letters, all from your computer, tablet, or phone. Include gift inserts, reply envelopes, and logos from your ministry with a few clicks. If we don't have your ministry's logo, let us know and we'll add it for free!

Click “Connect” to link your SAP Concur account. Once linked, we'll send receipts for your orders directly into your account here, simplifying your expense reports.

Prayerletters.com works with Expense for Concur Standard and Expense for Concur Professional. It will be available soon in the SAP Concur App Center under User Connections (formerly Apps for Me) at [https://www.concur.com/app-center](https://www.concur.com/app-center). For more information about the prayerletters.com integration, visit
[https://www.prayerletters.com/](https://www.prayerletters.com/).

### <a name="parken+-april"></a>Parken+

![Parken+ Logo](./app-center-2019-01-01-parken-logo.png)

With more than 9,500 parking garages available in our parking inventory, Parken+ is the gold standard for finding, booking, and paying parking spots across major cities nationwide.

* See all the available parking spots near you with the click of a button.
* In-app navigation will guide you to any parking spot you desire.
* Book parking spots at any time.
* Pay for parking and save all your receipts in the app.

By connecting your Concur account with Parken+, you can easily submit your expense receipts directly to SAP Concur. Save time & money by using Parken+!

Parken+ works with Expense for Concur Standard and Expense for Concur Professional. It will be available soon in the SAP Concur App Center under User Connections (formerly Apps for Me) at [https://www.concur.com/app-center](https://www.concur.com/app-center). For more information about the Parken+ integration, visit
[http://www.parken.plus/](http://www.parken.plus/).
@@ -11,7 +11,6 @@ redirect_from:
## Support Options

* [Request Support (Partners)](/tools-support/requesting-partner-support.html)
* [Developers (Developer Forum)](https://forum.developer.concur.com)
* [Company Administrators](https://www.concur.com/en-us/contact)
* **Individual Users** of SAP Concur products should request assistance from their company's internal help desk or their company's SAP Concur administrator

0 comments on commit 9d1cddb

Please sign in to comment.
You can’t perform that action at this time.