docs: update info.description and x-sap-shortText for 37 swagger files

src/api-explorer/v1-0/Image.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Manage receipt images for the OAuth consumer.",
+  "x-sap-shortText": "Uploads and retrieves receipt and invoice images for expense entries",
   "swagger": "2.0",
   "host": "sandbox.api.sap.com",
   "basePath": "/concur/api",
@@ -29,7 +29,7 @@
   ],
   "info": {
     "title": "Image API Documentation",
-    "description": "The SAP Concur Image API allows clients to manage the receipt images attached to expense reports and the images attached to invoices. Clients can retrieve existing images by reportID, image ID, or invoiceID, and upload new images to a user, expense entry, report, or invoice.<p>The Image API supports the following image formats:</p><p><li>`application/pdf`<li>`image/jpg`<li>`image/jpeg`<li>`image/png`</p><p>The maximum file size allowed is 10 MB.</p>",
+    "description": "Management of receipt and invoice images attached to expense reports and invoices. Supports retrieving existing images and uploading new images to a user, expense entry, report, or invoice.",
     "version": "1.0"
   },
   "tags": [

src/api-explorer/v1-1/ExpenseReportFormFields.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Returns information about the configured form fields for a specified form in SAP Concur.",
+  "x-sap-shortText": "Retrieves configured field definitions for an expense report form",
   "swagger": "2.0",
   "host": "sandbox.api.sap.com",
   "basePath": "/concur/api",
@@ -28,7 +28,7 @@
     }
   ],
   "info": {
-    "description": "Returns the configured fields for the specified expense form.",
+    "description": "Retrieves the configured field definitions for a specified expense report form.",
     "version": "1.1",
     "title": "Expense Report Form Fields"
   },

src/api-explorer/v1-1/ExpenseReportForms.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Returns information about the form types and configured forms in SAP Concur.",
+  "x-sap-shortText": "Retrieves expense form types and configured forms for a client",
   "swagger": "2.0",
   "host": "sandbox.api.sap.com",
   "basePath": "/concur/api",
@@ -28,7 +28,7 @@
     }
   ],
   "info": {
-    "description": "Returns the configured Expense form types, or the form IDs for the supplied form type. Clients can have multiple forms configured for each form type.",
+    "description": "Retrieves the configured expense form types and forms available in SAP Concur. Clients can have multiple forms configured for each form type.",
     "version": "1.1",
     "title": "Expense Report Forms"
   },

src/api-explorer/v3-0/Allocations.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "View all allocations for a user or report, or view an allocation by ID",
+  "x-sap-shortText": "Retrieves expense allocations for a user, report, or by ID",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -16,7 +16,7 @@
   ],
   "info": {
     "title": "Allocations",
-    "description": "Allocations divide the responsibility for an expense. Allocation entries consist of a percentage of the original expense, and the configured custom fields. Allocation entries are children of the expense entry. This API provides methods to view all allocations for a user or report, or view an allocation by ID.",
+    "description": "Provides read access to expense allocations, which distribute the financial responsibility of an expense entry across multiple cost centers or custom fields as a percentage of the total. Supports retrieving all allocations for a user or report, or fetching a single allocation by ID. Suited for finance and ERP integrations that need to extract cost allocation data from Concur Expense. Requires a User JWT.",
     "version": "3.0"
   },
   "securityDefinitions": {

src/api-explorer/v3-0/DigitalTaxInvoices.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Allows tax validators to get and update digital receipts.",
+  "x-sap-shortText": "Retrieves and updates digital tax invoices for fiscal compliance",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -29,7 +29,7 @@
   ],
   "info": {
     "title": "Digital Tax Invoices",
-    "description": "The regulations of some countries require that clients provide an electronic receipt in digital XML format for each reimbursable expense. In addition, the client must: Store the XML file in order to claim the expense for tax purposes, be able to produce the original XML file in case of audit, and validate the XML file with the government. To help meet this requirement, Concur offers the Digital Tax Invoice feature. For Mexico, the official digital XML file is called Comprobante Fiscal Digital, or CFDi. This API provides methods to view and update digital tax invoices.",
+    "description": "Enables digital tax invoice validators to view and update tax invoices with a validation status. Currently supports the Comprobante Fiscal Digital (CFD) format used in Mexico.",
     "version": "3.0"
   },
   "tags": [

src/api-explorer/v3-0/Entries.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Manage Expense entries for a user.",
+  "x-sap-shortText": "Creates, retrieves, updates, and deletes expense line items",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -16,7 +16,7 @@
   ],
   "info": {
     "title": "Entries",
-    "description": "Get all entries for a user, create new entries, update entries, or delete entries.",
+    "description": "Provides access to expense line items within a user's expense reports. Supports creating, retrieving, updating, and deleting expense entries, including mileage, VAT, and attendee data. Suited for ERP integrations and travel management tools that need to read or write detailed expense data within the SAP Concur platform. Requires a User JWT.",
     "version": "3.0"
   },
   "securityDefinitions": {

src/api-explorer/v3-0/EntryAttendeeAssociations.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Manages the relationship between attendees and expense entries.",
+  "x-sap-shortText": "Links, retrieves, updates, and removes attendees from expense entries",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -29,7 +29,7 @@
 	],
   "info": {
     "title": "Entry Attendee Associations",
-    "description": "Manage the relationship between the attendees and the expense report and entry, for the specified expense entry. This resource does not include the full attendee information, which can be accessed using the Attendees resource. This API provides methods to view, create, update, and delete entry attendee associations.",
+    "description": "Management of the associations between attendees and expense entries. Supports creating, retrieving, updating, and removing attendee links.",
     "version": "3.0"
   },
   "tags": [

src/api-explorer/v3-0/Itemizations.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Retrieve and manage expense entry itemizations.",
+  "x-sap-shortText": "Creates, retrieves, and deletes expense entry itemizations",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -29,7 +29,7 @@
 	],
   "info": {
     "title": "Itemizations",
-    "description": "Expense Entry Itemizations are children of an expense entry that subdivide the expense. A common use case for itemizations is on a hotel bill, which can have separate itemizations for room rate, room tax, and services such as laundry or minibar.",
+    "description": "Management of expense entry itemizations. Supports creating, retrieving, and deleting itemizations within an expense entry.",
     "version": "3.0"
   },
   "tags": [

src/api-explorer/v3-0/LatestBookings.swagger2.json

@@ -1,4 +1,5 @@
 {
+  "x-sap-shortText": "Retrieves the latest hotel and air bookings for a user",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -15,7 +16,7 @@
   ],
   "info": {
     "title": "Latest Bookings",
-    "description": "",
+    "description": "Retrieves the most recent hotel and air booking for a specified user.",
     "version": "3.0"
   },
   "tags": [

src/api-explorer/v3-0/LocalizedData.swagger2.json

@@ -1,4 +1,5 @@
 {
+  "x-sap-shortText": "Retrieves localized strings for invoice status codes and errors",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -15,7 +16,7 @@
   ],
   "info": {
     "title": "Localized Data",
-    "description": "Invoice includes various status codes, and error messages. This API provides a method to list the localized strings of various codes.",
+    "description": "Retrieves localized strings for status codes and error messages used in Concur Invoice.",
     "version": "3.0"
   },
   "tags": [

src/api-explorer/v3-0/Locations.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Retrieves location information.",
+  "x-sap-shortText": "Retrieves valid city location codes for a given company",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -16,7 +16,7 @@
   ],
   "info": {
     "title": "Locations",
-    "description": "The valid city location codes in SAP Concur. The location codes vary by client, and cannot be used across multiple clients. This API provides methods to get a list of valid locations for the supplied user, or get details of a location by ID.",
+    "description": "Provides access to the valid city location codes configured for a specific company within the SAP Concur platform. Location codes are company-specific and cannot be shared across different clients. Supports listing all available locations or retrieving details for a single location by ID. Suited for expense and travel integrations that need to validate or look up location data. Requires a User JWT.",
     "version": "3.0"
   },
   "securityDefinitions": {

src/api-explorer/v3-0/Opportunities.swagger2.json

@@ -1,4 +1,5 @@
 {
+  "x-sap-shortText": "Retrieves travel cost-saving opportunities for trips or date ranges",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -15,7 +16,7 @@
   ],
   "info": {
     "title": "Opportunities",
-    "description": "",
+    "description": "Retrieves a collection of cost-saving opportunities for a specified trip or for all trips within a date range. Supports filtering by opportunity type.",
     "version": "3.0"
   },
   "tags": [

src/api-explorer/v3-0/PaymentRequest.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "View and manage invoice payment requests.",
+  "x-sap-shortText": "Creates, retrieves, and updates invoice payment requests",
   "swagger": "2.0",
   "host": "sandbox.api.sap.com",
   "basePath": "/concur/api/v3.0",
@@ -16,7 +16,7 @@
   ],
   "info": {
     "title": "Payment Request",
-    "description": "A payment request is a request for payment (partial or full) of an invoice. This API provides methods to create or update a payment request, or view a payment request by ID.",
+    "description": "Handles partial or full payment requests against invoices within Concur Invoice, including line items, allocations, and VAT details in a single call. Supports creating, retrieving, and updating payment requests, with PO matching and e-invoicing network fields. Suited for ERP and accounts payable integrations that need to manage invoice payment workflows within the SAP Concur platform. Requires a User JWT.",
     "version": "3.0"
   },
   "securityDefinitions": {

src/api-explorer/v3-0/PaymentRequestDigest.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Returns summarized lists of payment requests.",
+  "x-sap-shortText": "Retrieves summarized payment request lists for invoice vendors",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -16,7 +16,7 @@
   ],
   "info": {
     "title": "Payment Request Digest",
-    "description": "A payment request digest is a collection of summarized payment requests to invoice vendors. This API provides methods to view all payment requests corresponding to search parameters, or view a payment request digest by ID.",
+    "description": "Provides summarized views of payment requests made to invoice vendors, supporting filtering by approval status, payment status, vendor invoice number, and date ranges. Suited for accounts payable integrations and reporting tools that need to poll or audit invoice payment data within the SAP Concur platform. Requires a User JWT.",
     "version": "3.0"
   },
   "securityDefinitions": {

src/api-explorer/v3-0/PurchaseOrders.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Manages your purchase orders and purchase order related data.",
+  "x-sap-shortText": "Creates, retrieves, and updates purchase orders",
   "x-servers": [
       {
         "url": "https://us.api.concursolutions.com/api/v3.0",
@@ -22,7 +22,7 @@
   ],
   "info": {
     "title": "Purchase Orders",
-    "description": "In Concur Invoice, purchase orders are requests for a vendor to supply goods or services. This API provides methods to create a new purchase order, or view or update an existing purchase order.",
+    "description": "Supports creating and updating purchase orders, closing orders, and resolving matching exceptions on purchase order invoices.",
     "version": "3.0"
   },
   "securityDefinitions": {

src/api-explorer/v3-0/ReceiptImages.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Upload images in the supported formats or retrieve individual images.",
+  "x-sap-shortText": "Uploads and retrieves receipt images attached to expense reports",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -29,7 +29,7 @@
 	],
   "info": {
     "title": "Receipt Images",
-    "description": "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.",
+    "description": "Management of receipt images attached to expense reports, expense entries, and payment requests. Supports uploading new images and retrieving existing images by ID.",
     "version": "3.0"
   },
   "tags": [

src/api-explorer/v3-0/Reports.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Manages the expense reports for a user or the entire company.",
+  "x-sap-shortText": "Retrieves, creates, and updates expense reports for users or companies",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -29,7 +29,7 @@
 	],
   "info": {
     "title": "Reports",
-    "description": "Get expense reports for a user or company, and update existing reports or create new reports.",
+    "description": "Management of expense reports for a user or company. Supports creating, retrieving, and updating expense reports.",
     "version": "3.0"
   },
   "tags": [

src/api-explorer/v3-0/SalesTaxValidationRequest.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Manage sales tax information on invoices.",
+  "x-sap-shortText": "Retrieves invoice data for sales tax calculation and updates it",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -16,7 +16,7 @@
   ],
   "info": {
     "title": "Sales Tax Validation Request",
-    "description": "An invoice is a bill of sale for goods or services. This API provides invoice information so that clients can calculate appropriate sales tax for invoice items. It also allows clients to update the invoice with the calculated sales tax.",
+    "description": "Provides invoice line item data to external tax calculation partners, including ship-to and bill-to addresses and vendor details needed to compute sales tax. Supports retrieving invoices pending tax calculation and writing back the calculated tax amount and rate per line item. Suited for third-party tax engine integrations that need to apply jurisdiction-specific sales tax within the SAP Concur platform. Requires a User JWT.",
     "version": "3.0"
   },
   "securityDefinitions": {

src/api-explorer/v3-0/Suppliers.swagger2.json

@@ -1,4 +1,5 @@
 {
+  "x-sap-shortText": "Retrieves TripLink supplier information",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.0",
@@ -15,7 +16,7 @@
   ],
   "info": {
     "title": "Suppliers",
-    "description": "TripLink supplier information.",
+    "description": "Retrieves TripLink supplier details by search criteria or supplier ID.",
     "version": "3.0"
   },
   "tags": [

src/api-explorer/v3-1/RequestGroupConfigurations.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Returns the Request group configuration for the specified user.",
+  "x-sap-shortText": "Retrieves Request policy configurations for a given user",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.1",
@@ -16,7 +16,7 @@
   ],
   "info": {
     "title": "Request Group Configurations",
-    "description": "Requests allow travelers to submit travel plans, expected expenses, and expected cash advance needs prior to spending funds. Request policies define the required information and workflow for the requests. This API provides the details of the Request policies for the supplied user ID.",
+    "description": "Retrieves the Request group configuration and policy details applicable to a specific user, including available policies, segment types, agency offices, and the default policy. Suited for integrations that need to validate or display Request policy options before creating travel or spend requests in the SAP Concur platform. Requires a User JWT.",
     "version": "3.1"
   },
   "securityDefinitions": {

src/api-explorer/v3-1/Vendors.swagger2.json

@@ -1,5 +1,5 @@
 {
-  "x-sap-shortText": "Manages the vendors that send you invoices.",
+  "x-sap-shortText": "Creates, updates, and deletes invoice vendor records",
   "swagger": "2.0",
   "host": "www.concursolutions.com",
   "basePath": "/api/v3.1",
@@ -16,7 +16,7 @@
   ],
   "info": {
     "title": "Vendors",
-    "description": "An invoice is a bill of sale for goods or services provided by a vendor. This API provides methods to create, update, or delete invoice vendors.",
+    "description": "Manages invoice vendor records within Concur Invoice, supporting creation, update, and deletion of vendor profiles including banking details, payment method types, and custom fields. Suited for procurement and ERP integrations that need to synchronize vendor master data with the SAP Concur platform. Requires a User JWT.",
     "version": "3.1"
   },
   "securityDefinitions": {

src/api-explorer/v3-2/ConnectionRequests.swagger.json

@@ -2,7 +2,7 @@
     "swagger": "2.0",
     "host": "us.api.concursolutions.com",
     "basePath": "/api/v3.2",
-    "x-sap-shortText": "A Connection Request is an object of an SAP Concur user to connect with a specific TripLink partner.",
+    "x-sap-shortText": "Manages connection requests between users and TripLink partners",
     "x-servers": [
       {
         "url": "https://us.api.concursolutions.com/api/v3.2",
@@ -22,7 +22,7 @@
     ],
     "info": {
         "title": "Connection Requests",
-        "description": "A Connection Request is an object representing the willingness of an SAP Concur user to connect with a specific TripLink partner.",
+        "description": "Management of connection requests that link SAP Concur users to TripLink travel suppliers. Supports creating, retrieving, and updating connection requests with status tracking.",
         "version": "3.2"
     },
     "securityDefinitions": {
@@ -336,4 +336,4 @@
             "properties": {}
         }
     }
-}
+}