Merge pull request #2245 from concur/preview

Preview -> livesite 2020-02-14

src/_data/sidebars/api-explorer.yml

@@ -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

src/_data/sidebars/api-reference.yml

@@ -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:

src/announcements/index.md

@@ -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.

src/api-explorer/v4-0/ConcurRequest.swagger2.json

@@ -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"

src/api-reference/request/v3.request.markdown

@@ -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

src/api-reference/request/v4.endpoints.cashadvance-resources.markdown

@@ -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
 

src/api-reference/request/v4.endpoints.expected-expense-resources.markdown

@@ -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