Merge branch 'main' into docs/HOTEL-20922

Author: gabriel-schiferdecke

src/_data/sidebars/api-explorer.yml

@@ -68,6 +68,8 @@
   children:
       - title: Allocations
         url: https://api.sap.com/api/ConcurExpense/overview
+      - title: Attendee Types
+        url: https://api.sap.com/api/ConcurAttendeeTypes/overview
       - title: Attendees
         url: https://api.sap.com/api/ConcurAttendees/overview
       - title: Budget
@@ -76,6 +78,8 @@
         url: https://api.sap.com/api/ConcurExpenseCards/overview
       - title: Cash Advance
         url: https://api.sap.com/api/ConcurExpenseCashAdvance/overview
+      - title: Cash Advance Associations
+        url: https://hub.sap.com/api/ConcurExpense/overview
       - title: Change Notification
         url: https://api.sap.com/api/ConcurChangeNotification/overview  
       - title: Comments

src/_data/sidebars/api-guides.yml

@@ -5,6 +5,15 @@
   children:
       - title: Expense - Associating External Attendees to Expense Entries
         url: /api-guides/attendees/external-attendees-to-expense-entries.html
+- title: Authentication
+  url: ''
+  children:
+      - title: Tutorial 1. Create Tokens Required for SAP Concur API Access
+        url: /api-guides/authentication/concur-get-refresh-token/concur-get-refresh-token.html
+      - title: Tutorial 2. Refresh Token Management Automation
+        url: /api-guides/authentication/concur-refresh-token-management/concur-refresh-token-management.html
+      - title: Tutorial 3. Call SAP Concur APIs Using A Multiple Use Bearer Token
+        url: /api-guides/authentication/concur-calling-apis/concur-calling-apis.html
 - title: eReceipts Integration
   url: /api-guides/e-receipts.html
 - title: Event Subscription Service v4 Guide

src/_data/sidebars/api-reference.yml

@@ -77,6 +77,8 @@
 - title: Common
   url: ''
   children:
+      - title: Attendee Types v4
+        url: /api-reference/common/attendees/v4.admin-attendee-types.html
       - title: Attendees v4
         url: /api-reference/common/attendees/v4.attendees.html
       - title: Connection Requests v3.2
@@ -115,6 +117,8 @@
         url: /api-reference/direct-connects/hotel-service-4/v4.endpoints.html
       - title: Hotel Service Change Notification 
         url: /api-reference/direct-connects/hotel-service-4/v4.change-notification-get-started.html
+      - title: Single PNR Solution for CHS
+        url: /api-reference/direct-connects/hotel-service-4/v4.single-pnr-solution.html
       - title: Schemas
         url: /api-reference/direct-connects/hotel-service-4/v4.schemas.html
 - title: Document Compliance Gateway v4
@@ -172,6 +176,8 @@
         url: /api-reference/expense/expense-report/v4.allocations.html
       - title: Attendee Associations v4
         url: /api-reference/expense/expense-report/v4.expense-attendee-associations.html
+      - title: Cash Advance Associations v4
+        url: /api-reference/expense/expense-report/v4.expense-cash-advance-associations.html
       - title: Comments v4
         url: /api-reference/expense/expense-report/v4.comments.html
       - title: Exceptions v4

src/_data/sidebars/event-topics.yml

@@ -2,7 +2,7 @@
   url: /event-topics/
 - title: Document Tax Compliance Event
   url: /event-topics/expense/v4.document-compliance-events.html
-- title: Concur Expense Event
+- title: Concur Expense Report Events
   url: /event-topics/expense/v4.expense-events.html
 - title: Identity Change Event
   url: /event-topics/profile/v4.identity-events.html

src/_data/sidebars/tools-support.yml

@@ -5,6 +5,10 @@
 - title: Developer Platform Release Notes
   url: ''
   children:
+      - title: June 2025
+        url: /tools-support/release-notes/api/2025-06-04.html
+      - title: May 2025
+        url: /tools-support/release-notes/api/2025-05-05.html
       - title: April 2025
         url: /tools-support/release-notes/api/2025-04-03.html
       - title: March 2025

src/_includes/header.html

@@ -85,7 +85,6 @@
               <li class="column-title">Partner Resources</li>
               <li><a href="{{ site.baseurl }}/manage-apps/app-certification.html">App Certification</a></li>
               <li><a href="{{ site.baseurl }}/manage-apps/partner-applications.html">App Registration & Management</a></li>
-              <li><a href="{{ site.baseurl }}/manage-apps/redirect.html">Go to Market</a></li>
               <li><a href="https://www.concur.com/en-us/app-center" target="_blank">App Center</a></li>
               <li><a href="https://www.concursolutions.com/" target="_blank">Login to Concur</a></li>
             </ul>

src/api-explorer/v4-0/HotelService.swagger2-new.json

@@ -1,20 +1,23 @@
 {
   "swagger": "2.0",
+  "x-sap-shortText": "Hotel workflow endpoints.",
   "tags": [
     {
       "description": "Hotel workflow endpoints",
-      "name": "service"
+      "name": "Service"
+    }
+  ],
+  "x-servers": [
+    {
+      "url": "https://www.concursolutions.com/api/v4.0",
+      "description": "Concur API EndPoint"
     }
   ],
   "basePath": "/",
   "host": "hs-mock.service.cnqr.tech",
   "info": {
-    "contact": {
-      "name": "SAP Concur Developer Center",
-      "url": "https://developer.concur.com/api-explorer/v4-0/HotelService.swagger2.json"
-    },
-    "description": "## Important: Please refer to [Endpoints](https://developer.concur.com/api-reference/direct-connects/hotel-service-4/v4.endpoints.html) document for detailed documentation on all endpoints for this API.\nHotelService API provides a method for Custom Hotel Source vendors to provide hotel inventory, rates and booking related functionality to users of Concur OBT (Online Booking Tool).",
-    "title": "HotelService API",
+    "description": "## Important: Please refer to [Endpoints](https://developer.concur.com/api-reference/direct-connects/hotel-service-4/v4.endpoints.html) document for detailed documentation on all endpoints for this API.\nHotel Service API provides a method for Custom Hotel Source vendors to provide hotel inventory, rates and booking related functionality to users of Concur OBT (Online Booking Tool).",
+    "title": "Hotel Service API",
     "version": "4.0"
   },
   "paths": {
@@ -30,7 +33,8 @@
             "in": "header",
             "name": "Accept-Language",
             "required": false,
-            "type": "string"
+            "type": "string",
+            "description": "Advertises which languages the client is able to understand"
           },
           {
             "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.",
@@ -77,7 +81,7 @@
         },
         "summary": "Retrieve descriptive details about specified hotels.",
         "tags": [
-          "service"
+          "Service"
         ]
       }
     },
@@ -93,7 +97,8 @@
             "in": "header",
             "name": "Accept-Language",
             "required": false,
-            "type": "string"
+            "type": "string",
+            "description": "Advertises which languages the client is able to understand"
           },
           {
             "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.",
@@ -140,7 +145,7 @@
         },
         "summary": "Retrieve hotel rate details",
         "tags": [
-          "service"
+          "Service"
         ]
       }
     },
@@ -156,7 +161,8 @@
             "in": "header",
             "name": "Accept-Language",
             "required": false,
-            "type": "string"
+            "type": "string",
+            "description": "Advertises which languages the client is able to understand"
           },
           {
             "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.",
@@ -203,7 +209,7 @@
         },
         "summary": "Retrieve rates for specific hotel properties",
         "tags": [
-          "service"
+          "Service"
         ]
       }
     },
@@ -219,7 +225,8 @@
             "in": "header",
             "name": "Accept-Language",
             "required": false,
-            "type": "string"
+            "type": "string",
+            "description": "Advertises which languages the client is able to understand"
           },
           {
             "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.",
@@ -266,7 +273,7 @@
         },
         "summary": "Reserve the given hotel rate",
         "tags": [
-          "service"
+          "Service"
         ]
       }
     },
@@ -275,14 +282,15 @@
         "consumes": [
           "application/json"
         ],
-        "description": "Cancel specified reservation",
+        "description": "Cancel specified reservation according to parameters",
         "operationId": "cancel",
         "parameters": [
           {
             "in": "header",
             "name": "Accept-Language",
             "required": false,
-            "type": "string"
+            "type": "string",
+            "description": "Advertises which languages the client is able to understand"
           },
           {
             "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.",
@@ -332,7 +340,7 @@
         },
         "summary": "Cancel specified reservation",
         "tags": [
-          "service"
+          "Service"
         ]
       }
     },
@@ -348,7 +356,8 @@
             "in": "header",
             "name": "Accept-Language",
             "required": false,
-            "type": "string"
+            "type": "string",
+            "description": "Advertises which languages the client is able to understand"
           },
           {
             "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.",
@@ -401,7 +410,7 @@
         },
         "summary": "Modify specific reservation",
         "tags": [
-          "service"
+          "Service"
         ]
       }
     },
@@ -417,7 +426,8 @@
             "in": "header",
             "name": "Accept-Language",
             "required": false,
-            "type": "string"
+            "type": "string",
+            "description": "Advertises which languages the client is able to understand"
           },
           {
             "description": "This unique code can be used during troubleshooting as it identifies the API call in the log files.",
@@ -467,7 +477,7 @@
         },
         "summary": "Returns detailed information about a hotel reservation.",
         "tags": [
-          "service"
+          "Service"
         ]
       }
     },
@@ -476,20 +486,22 @@
         "consumes": [
           "application/json"
         ],
-        "description": "Perform the initial search for hotels.",
+        "description": "Perform the initial search for hotels according to params",
         "operationId": "search",
         "parameters": [
           {
             "in": "header",
             "name": "Accept-Language",
             "required": false,
-            "type": "string"
+            "type": "string",
+            "description": "Advertises which languages the client is able to understand"
           },
           {
             "in": "header",
             "name": "concur-correlationid",
             "required": true,
-            "type": "string"
+            "type": "string",
+            "description": "Correlation ID to track the record across the logs"
           },
           {
             "description": "Hotel search criteria",
@@ -529,7 +541,7 @@
         },
         "summary": "Perform the initial search for hotels.",
         "tags": [
-          "service"
+          "Service"
         ]
       }
     }
@@ -2682,7 +2694,9 @@
         },
         "categories": {
           "type": "array",
-          "$ref": "#/definitions/SafetyScoreCategory"
+          "items": {
+            "$ref": "#/definitions/SafetyScoreCategory"
+          }
         }   
       },
       "required": [
@@ -2695,15 +2709,15 @@
       "description": "Safety score category classification of the hotel",
       "properties": {
         "type": {
-          "type": "enum",
+          "type": "string",
           "enum": [ "NIGHTTIME_SAFETY", "PHYSICAL_SAFETY", "BASIC_FREEDOMS",  "WOMENS_SAFETY", "THEFT", "HEALTH_AND_MEDICAL", "LGBTQ_PLUS_SAFETY"]
         },
         "score": {
           "type": "number"
         }
       },
       "required": [
-        "category",
+        "type",
         "score"
       ],
       "type": "object"

src/api-guides/authentication/concur-calling-apis/img/bearer-token-call-api.png

@@ -82,7 +82,7 @@ Depending on the connection flow, a grant will be selected for authentication. T
    ```http
    POST /oauth2/v0/token HTTP/1.1
    Content-Type: application/x-www-form-urlencoded
-   Host: us.api.concursolutions.com
+   Host: glz.api.concursolutions.com
    ```
    ```
    client_id={client_id}
@@ -135,12 +135,12 @@ Depending on the connection flow, a grant will be selected for authentication. T
 
 2. Your app will make a call to the authorization service.
 
-> **_NOTE:_**  the grant type must be accessed using the `www-` version of the API Gateway in order to avoid certificate issues with some browsers. (ex: https://www-us.api.concursolutions.com instead of https://us.api.concursolutions.com)
+> **_NOTE:_**  the grant type must be accessed using the `www-` version of the API Gateway in order to avoid certificate issues with some browsers. (ex: https://www-glz.api.concursolutions.com instead of https://glz.api.concursolutions.com)
 
    Example: 
    ```http
    GET /oauth2/v0/authorize?client_id={your-app-clientId}&redirect_uri={partner_redirect_URI}&response_type=code HTTP/1.1
-   Host: https://www-us.api.concursolutions.com
+   Host: https://www-glz.api.concursolutions.com
    ```
 
 3. The authorization service will prompt the user with two options: **Username** or **Send a link to my email**
@@ -179,7 +179,7 @@ Depending on the connection flow, a grant will be selected for authentication. T
    ```http
    POST /oauth2/v0/token HTTP/1.1
    Content-Type: application/x-www-form-urlencoded
-   Host: us.api.concursolutions.com
+   Host: glz.api.concursolutions.com
    ```
    ```
    client_id={client_id}
@@ -358,7 +358,7 @@ A client’s SAP Concur account may reside one of our many data centers. During
 
 You will need to be aware of the geolocation where the user exists and make the call to the APIs correctly. As you do not know the user's geolocation when you request the token for the first time, you should always make the API call using the **default** Base URI.
 
-For a user hosted on both the US data center and EU data center, please use the **default** Base URI `https://us.api.concursolutions.com`.
+For a user hosted on both the US data center and EU data center, please use the **default** Base URI `https://glz.api.concursolutions.com`.
 
 If you receive the error code 16 ("user lives elsewhere") while calling the authentication service, the error message returns a new `geolocation`. Use this new 'geolocation' as the Base URI to call the Auth API again to get the token.
 
@@ -411,9 +411,19 @@ When making API calls, the appropriate base URI should be used. There are three
 * Calling other APIs.
 
 The base URI for obtaining a token will use your application’s geolocation. The base URI for refreshing tokens and all other API calls will use the token’s geolocation.
+* GLZ = <https://glz.api.concursolutions.com>
+* US2 Production = <https://us2.api.concursolutions.com>
+* EU2 Production = <https://EU2.api.concursolutions.com>
+
+When obtaining a token, your application should use the base URI corresponding to the grant type being performed, as follows:
+
+| Grant Type	| URI |
+|-|-|
+|Authorization|	Use the GLZ base URI|
+|Password (credtype = authtoken)|	Use the GLZ base URI
+|One Time Password|	Use the base URI corresponding to the user’s geolocation|
 
-* US Production = <https://us.api.concursolutions.com>
-* EU Production = <https://emea.api.concursolutions.com>
+When obtaining the token, the token’s geolocation will be included in the response. The token’s geolocation should be stored along with the token. Your application will then make subsequent calls using the token and the correct endpoints based on the token’s geolocation.
 
 The full list of available token geolocations is available on the [Base URIs](https://developer.concur.com/platform/base-uris.html) page.