Skip to content
Permalink
Browse files

Merge pull request #2245 from concur/preview

Preview -> livesite 2020-02-14
  • Loading branch information
jonikamelcher committed Feb 14, 2020
2 parents c15d399 + aac54a7 commit 772513640cda638872b36f8f26d2b75ba8657930
@@ -86,3 +86,5 @@
url: /api-explorer/v4-0/PurchaseRequest.html
- title: Quick Expenses
url: /api-explorer/v4-0/QuickExpenses.html
- title: Request
url: /api-explorer/v4-0/ConcurRequest.html
@@ -196,6 +196,8 @@
url: /api-reference/image/v3.image.html
- title: Request v3
url: /api-reference/request/v3.request.html
- title: Request v4
url: /api-reference/request/v4.get-started.html
- title: Travel Profile
url: ''
children:
@@ -2,6 +2,35 @@
title: SAP Concur Developer Center - Announcements
layout: reference
---
### 2020-02-14 :: February 2020 Release Notes Published

SAP Concur has published release notes for the Quick Expense, Budget v4, and Request APIs in the February 2020 release notes. More details can be found on the [Release Notes](https://developer.concur.com/tools-support/release-notes/index.html) page.

### 2020-02-14 :: New SSL Certificate for concursolutions.com

#### Overview
In an effort to ensure the ongoing security of our products and services, SAP Concur will issue a new concursolutions.com SSL certificate. The new certificate date will be provided as soon as it is available.

Any customer who has pinned this expiring certificate will need to update to the new certificate. If the pinned certificate is not updated, your organization and users will experience disruption to SAP Concur products and services.

Customers who have not pinned the certificate do not need to take any action as the new certificate is updated automatically. Most customers do not pin the certificate.

**Please be aware:** As an enhancement to our Security and Compliance program, this certificate will be updated on an annual basis.

##### BUSINESS PURPOSE / CLIENT BENEFIT

This update provides ongoing security for our products and services.

#### Configuration / Feature Activation

Please consult with your IT department to check if this applies to you.

The new SSL certificate can be accessed here: [http://assets.concur.com/concurtraining/cte/en-us/concursolutions.cert.pem](http://assets.concur.com/concurtraining/cte/en-us/concursolutions.cert.pem)

Supply this URL to your IT department.

To save the certificate, click the link above, select all the text in the browser, copy it to a file, then name the file concursolutions.cert.pem.

### 2020-01-17 :: January 2020 Release Notes Published

SAP Concur has published release notes for the Quick Expense, Budget v4, and Request APIs in the January 2020 release notes. More details can be found on the [Release Notes](https://developer.concur.com/tools-support/release-notes/index.html) page.
@@ -2046,6 +2046,10 @@
"description": "The details from the Custom fields. These fields may not have data, depending on the configuration",
"$ref": "#/definitions/CustomField"
},
"parentRequest": {
"description": "The parent Request of the expected expense",
"$ref": "#/definitions/ResourceLink"
},
"postedAmount": {
"description": "The posted amount of the expected expense",
"$ref": "#/definitions/Amount"
@@ -2206,10 +2210,6 @@
"Location": {
"type": "object",
"properties": {
"airportName": {
"type": "string",
"description": "The airport name of the location"
},
"city": {
"type": "string",
"description": "The city name of the location"
@@ -20,9 +20,10 @@ Concur Request automates the spend request and approval process for both travel
* [User Permissions](#userpermissions)
* [Link](#link)

## Version
## Versions

* 3.0 (Current)
* [4.0](./v4.get-started.html) (Current)
* 3.0
* [1.0](./v1.request.html)

## <a name="method1"></a>Retrieve all requests
@@ -3,13 +3,23 @@ title: Travel Request v4 - Request Cash Advance Resources
layout: reference
---

{% include prerelease.html %}

* [Request Cash Advance Resources](#request-cash-advance-resource)
* [Get the list of existing cash advances within a Request](#get-request-cash-advance-resource)
## Menu

* [Getting Started](./v4.get-started.html)
* [Request](./v4.endpoints.request-resources.html)
* [Workflow](./v4.endpoints.workflow-resources.html)
* [Expected Expense](./v4.endpoints.expected-expense-resources.html)
* [Request Cash Advance](./v4.endpoints.cashadvance-resources.html)
* [Request Policy](./v4.endpoints.policy-resources.html)
* [Travel Agency](./v4.endpoints.travel-agency-resources.html)
* [Schema](./v4.endpoints.schemas.html)
* [HTTP Status Codes](./v4.response-codes.html)
* [Run in Postman](https://app.getpostman.com/run-collection/8273d843078f0bcf0823)

# <a name="request-cash-advance-resource"></a>Request Cash Advance Resources

* [Get the list of existing cash advances within a Request](#get-request-cash-advance-resource)

## <a name="get-request-cash-advance-resource"></a>Get the content of an existing cash advances

### Scopes
@@ -26,13 +36,13 @@ GET {datacenter}/travelrequest/v4/cashadvances/{cashAdvanceUuid}

#### Parameters

Name|Parameter Type|Data Type|Description
Name|Type|Format|Description
---|---|---|---
cashAdvanceUuid|path|string|**Required** The unique identifier of the cash advance
`cashAdvanceUuid`|`string`|-|**Required** The unique identifier of the cash advance.

#### Payload

None
None.

### HTTP Response

@@ -3,19 +3,29 @@ title: Travel Request v4 - Expected Expense Resources
layout: reference
---

{% include prerelease.html %}

* [Expected Expense Resources](#expected-expense-resource)
* [Create a new expected expense](#create-new-expected-expense-resource)
* [Get the list of expected expenses attached to a Request](#get-expected-expense-attached-request-resource)
* [Get the content of an expected expense](#get-content-expected-expense-resource)
* [Update the content of an expected expense](#update-content-expected-expense-resource)
* [Delete an expected expense from the Request](#delete-expected-expense-request-resource)
* [Get the list of comments for an existing expected expense](#expected-expense-resource-comments)
## Menu

* [Getting Started](./v4.get-started.html)
* [Request](./v4.endpoints.request-resources.html)
* [Workflow](./v4.endpoints.workflow-resources.html)
* [Expected Expense](./v4.endpoints.expected-expense-resources.html)
* [Request Cash Advance](./v4.endpoints.cashadvance-resources.html)
* [Request Policy](./v4.endpoints.policy-resources.html)
* [Travel Agency](./v4.endpoints.travel-agency-resources.html)
* [Schema](./v4.endpoints.schemas.html)
* [HTTP Status Codes](./v4.response-codes.html)
* [Run in Postman](https://app.getpostman.com/run-collection/8273d843078f0bcf0823)

# <a name="expected-expense-resource"></a>Expected Expense Resources

Manage expected expense entries attached to a Request document.
Manage expected expenses attached to a Request.

* [Create a new expected expense](#create-new-expected-expense-resource)
* [Get the list of expected expenses attached to a Request](#get-expected-expense-attached-request-resource)
* [Get the content of an expected expense](#get-content-expected-expense-resource)
* [Update the content of an expected expense](#update-content-expected-expense-resource)
* [Delete an expected expense from the Request](#delete-expected-expense-request-resource)
* [Get the list of comments for an existing expected expense](#expected-expense-resource-comments)

## <a name="create-new-expected-expense-resource"></a>Create a new expected expense

@@ -33,10 +43,10 @@ POST {datacenter}/travelrequest/v4/requests/{requestUuid}/expenses

#### Parameters

Name|Parameter Type|Data Type|Description
Name|Type|Format|Description
---|---|---|---
requestUuid|path|string|**Required** The unique identifier of the Request to which the expected expense is attached
userId|query|string|The unique identifier of the user performing the expected expense creation. <br> **Required** when connecting with a Company token, if empty a 400 `missingRequiredParam` error code will be displayed
`requestUuid`|`string`|-|**Required** The unique identifier of the Request to which the expected expense is attached.
`userId`|`string`|-|The unique identifier of the user performing the expected expense creation. **Required** when connecting with a Company token. If empty, a 400 `missingRequiredParam` error code will be displayed.

#### Payload

@@ -50,7 +60,7 @@ To learn more about response HTTP status codes for this API see [Travel Request

#### Payload

[Expected Expense](./v4.endpoints.schemas.html#schema-expected-expense) - The created expected expense
[Expected Expense](./v4.endpoints.schemas.html#schema-expected-expense) - The created expected expense.

### Example

@@ -271,14 +281,14 @@ GET {datacenter}/travelrequest/v4/requests/{requestUuid}/expenses

#### Parameters

Name|Parameter Type|Data Type|Description
Name|Type|Format|Description
---|---|---|---
requestUuid|path|string|**Required** The unique identifier of the Request
userId|query|string|The unique identifier of the user viewing the expected expenses attached to a Request. <br> **Required** when connecting with a Company token, if empty a 400 `missingRequiredParam` error code will be displayed
`requestUuid`|`string`|-|**Required** The unique identifier of the Request.
`userId`|`string`|-|The unique identifier of the user viewing the expected expenses attached to a Request. **Required** when connecting with a Company token. If empty, a 400 `missingRequiredParam` error code will be displayed.

#### Payload

None
None.

### HTTP Response

@@ -555,14 +565,14 @@ GET {datacenter}/travelrequest/v4/expenses/{expenseUuid}

#### Parameters

Name|Parameter Type|Data Type|Description
Name|Type|Format|Description
---|---|---|---
expenseUuid|path|string|**Required** The unique identifier of the expected expense
userId|query|string|The unique identifier of the user viewing the expected expense. <br> **Required** when connecting with a Company token, if empty a 400 `missingRequiredParam` error code will be displayed
`expenseUuid`|`string`|-|**Required** The unique identifier of the expected expense.
`userId`|`string`|-|The unique identifier of the user viewing the expected expense. **Required** when connecting with a Company token. If empty, a 400 `missingRequiredParam` error code will be displayed.

#### Payload

None
None.

### HTTP Response

@@ -572,7 +582,7 @@ To learn more about response HTTP status codes for this API see [Travel Request

#### Payload

[Expected Expense](./v4.endpoints.schemas.html#schema-expected-expense) - The expected expense having {expenseUuid} as unique identifier
[Expected Expense](./v4.endpoints.schemas.html#schema-expected-expense) - The expected expense having {expenseUuid} as unique identifier.

### Example 1 - for a Request segment

@@ -632,6 +642,11 @@ Authorization: Bearer {token}
"id": "AIRFR",
"name": "Airfare"
},
"parentRequest": {
"href": "https://us.api.concursolutions.com/travelrequest/v4/request/224AF3CDCC2A5244A37C72FA5770C6F2",
"id": "224AF3CDCC2A5244A37C72FA5770C6F2",
"template": "http://us.api.concursolutions.com/travelrequest/v4/request/{requestUuid}"
},
"postedAmount": {
"value": 324.56,
"currency": "USD"
@@ -769,6 +784,11 @@ Authorization: Bearer {token}
"city": "Berlin, GERMANY",
"name": "Berlin, GERMANY"
},
"parentRequest": {
"href": "https://us.api.concursolutions.com/travelrequest/v4/request/224AF3CDCC2A5244A37C72FA5770C6F2",
"id": "224AF3CDCC2A5244A37C72FA5770C6F2",
"template": "http://us.api.concursolutions.com/travelrequest/v4/request/{requestUuid}"
},
"postedAmount": {
"value": 80,
"currency": "USD"
@@ -785,7 +805,7 @@ Authorization: Bearer {token}
}
```

## <a name="update-content-expected-expense-resourcee"></a>Update the content of an expected expense
## <a name="update-content-expected-expense-resource"></a>Update the content of an expected expense

### Scopes

@@ -801,10 +821,10 @@ PUT {datacenter}/travelrequest/v4/expenses/{expenseUuid}

#### Parameters

Name|Parameter Type|Data Type|Description
Name|Type|Format|Description
---|---|---|---
expenseUuid|path|string|**Required** The unique identifier of the expected expense to update
userId|query|string|The unique identifier of the user performing the expected expense update. <br> **Required** when connecting with a Company token, if empty a 400 `missingRequiredParam` error code will be displayed
`expenseUuid`|`string`|-|**Required** The unique identifier of the expected expense to update.
`userId`|`string`|-|The unique identifier of the user performing the expected expense update. **Required** when connecting with a Company token. If empty, a 400 `missingRequiredParam` error code will be displayed.

#### Payload

@@ -818,7 +838,7 @@ To learn more about response HTTP status codes for this API see [Travel Request

#### Payload

[Expected Expense](./v4.endpoints.schemas.html#schema-expected-expense) - The expected expense having {expenseUuid} as unique identifier after update
[Expected Expense](./v4.endpoints.schemas.html#schema-expected-expense) - The expected expense having {expenseUuid} as unique identifier after update.

### Example

@@ -986,6 +1006,11 @@ Authorization: Bearer {token}
"id": "AIRFR",
"name": "Airfare"
},
"parentRequest": {
"href": "https://us.api.concursolutions.com/travelrequest/v4/request/224AF3CDCC2A5244A37C72FA5770C6F2",
"id": "224AF3CDCC2A5244A37C72FA5770C6F2",
"template": "http://us.api.concursolutions.com/travelrequest/v4/request/{requestUuid}"
},
"postedAmount": {
"value": 432.45,
"currency": "USD"
@@ -1078,14 +1103,14 @@ DELETE {datacenter}/travelrequest/v4/expenses/{expenseUuid}

#### Parameters

Name|Parameter Type|Data Type|Description
Name|Type|Format|Description
---|---|---|---
expenseUuid|path|string|**Required** The unique identifier of the expected expense to delete
userId|query|string|The unique identifier of the user performing the deletion of the expected expense. <br> **Required** when connecting with a Company token, if empty a 400 `missingRequiredParam` error code will be displayed
`expenseUuid`|`string`|-|**Required** The unique identifier of the expected expense to delete.
`userId`|`string`|-|The unique identifier of the user performing the deletion of the expected expense. **Required** when connecting with a Company token. If empty, a 400 `missingRequiredParam` error code will be displayed.

#### Payload

None
None.

### HTTP Response

@@ -1095,7 +1120,7 @@ To learn more about response HTTP status codes for this API see [Travel Request

#### Payload

None
None.

### Example

@@ -1133,14 +1158,14 @@ GET {datacenter}/travelrequest/v4/expenses/{expenseUuid}/comments

#### Parameters

Name|Parameter Type|Data Type|Description
Name|Type|Format|Description
---|---|---|---
expenseUuid|path|string|**Required** The unique identifier of the expected expense
userId|query|string|The unique identifier of the user getting the content of the comments. <br> **Required** when connecting with a Company token, if empty a 400 `missingRequiredParam` error code will be displayed
`expenseUuid`|`string`|-|**Required** The unique identifier of the expected expense.
`userId`|`string`|-|The unique identifier of the user getting the content of the comments. **Required** when connecting with a Company token. If empty, a 400 `missingRequiredParam` error code will be displayed.

#### Payload

None
None.

### HTTP Response

0 comments on commit 7725136

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