Guide to the Request v4.0 API, TMC Edition

The Request v4.0 API provides travel request information for a specified traveler. Request v4.0 allows applications to pull and post information about the traveler’s request for travel.

This guide is part of a collection designed for TMCs, to read the shared content about audience, development, authentication, and other key information see the TMC Guide Overview.

Sequence Diagram

Application Scopes

Travel applications normally have the following scopes registered:

openid
travelrequest.write
user.read
company.read
user_read
FOP
GHOST
ITINER
TRVREQ
TRVPRF
PASSV
EMERG
TSAI
TMCSP
MEDIC
UNUTX
USER
NOTIF
COMPD
COMPANY

Explanations for these scopes are documented on developer.concur.com. If you wish to have your application include additional scopes or endpoints, you must have your application recertified.

Geolocation

Host Location	URL from refresh token based on host location of Company GUID	URL to use for Travel Profile
EMEA	https://emea.api.concursolutions.com/oauth2/v0/token	https://emea.api.concursolutions.com/api/travelprofile/v2.0/profile
US	https://us.api.concursolutions.com/oauth2/v0/token	https://us.api.concursolutions.com/api/travelprofile/v2.0/profile

Using the Request v4.0 API

Traveler Plans Trip

The traveler has to plan few aspects of travel, before creating or submitting the travel request. Below are a few things need to be planned.

Plan itinerary.
Plan hotel bookings.
Plan car rentals.
Specify the airlines to use.

Make a Travel Request

Once the traveler has the plan ready, they can create the travel request by using Concur Request.

Step 1: Log in to SAP Concur

Once logged in, click the Request tab:

SAP Concur page after log in

Step 2: Create a Travel Request

Once you are logged in, select New Request under the Request tab and fill in the traveler details.

Request Header: Includes details for request policy, request name, travel start date, travel end date, and purpose of the travel.

New Request Form UI

Next you’ll fill in details for all the segments. This may include:

Air Segment

Request UI showing air segments

Rail Segment

Request UI showing rail segments

Hotel Segment

Request UI showing hotel segment

Car Segment

Request UI showing car segment

Click Submit Request. This request will be added to your Active Travel Requests.

Request UI showing all active travel requests

Agency Receives Travel Request Notification

Agencies that have subscribed to ESS services will be notified, once the traveler submits the travel request. Based on the Travel_Request_Id the agencies fetch the travel request details for a traveler.

Get Travel Request Information

To fetch the traveler’s request using status “Submitted” without parsing UUID.

NOTE: If no value for status is indicated, then by default it will return the response for “ALL ACTIVE” travel requests.

URI: GET
/travelrequest/v4/requests?view=SUBMITTED
Content-Type: application/json
Authorization: Bearer 

Response

 {
            "href": "https://us.api.concursolutions.com/travelrequest/v4/requests/8354DDF8F1C6374BAE25189266293CF9",
            "id": "8354DDF8F1C6374BAE25189266293CF9",
{
    "data": [
"approvalStatus": {
                "code": "SUBMITTED",
                "name": "Pending Travel Agency Update"
            },
            "approved": false,
            "businessPurpose": "Leisure Trip",
            "canceledPostApproval": false,
            "closed": false,
            "comment": "Bon voyage\n",
            "creationDate": "2019-06-03T21:14:42.000Z",
            "endDate": "2019-08-25",
            "everSentBack": false,
            "expenses": [],
            "highestExceptionLevel": "NONE",
            "name": "Dream Trip To Paris",
            "owner": {
                "href": "https://us.api.concursolutions.com/profile/v1/users/eaf089a5-1569-31ab-95d2-7ef8dc58354a",
                "id": "eaf089a5-1569-31ab-95d2-7ef8dc58354a",
                "template": "https://us.api.concursolutions.com/profile/v1/users/{id}",
                "firstName": "William",
                "middleInitial": "p",
                "lastName": "Never2"
            },
            "pendingApproval": true,
            "requestId": "3339",
            "startDate": "2019-07-26",
            "submitDate": "2019-06-03T21:29:50.000Z",
            "totalApprovedAmount": {
                "value": 12000,
                "currency": "USD"
            },
            "totalPostedAmount": {
                "value": 12000,
                "currency": "USD"
            },
            "totalRemainingAmount": {
                "value": 12000,
                "currency": "USD"
            },
            "type": {
                "code": "TRAVEL",
                "label": "Travel"
            }
        },
        {
            "href": "https://us.api.concursolutions.com/travelrequest/v4/requests/C1CDF36851BF1645ABA76C92A91DE06E",
            "id": "C1CDF36851BF1645ABA76C92A91DE06E",
            "approvalStatus": {
                "code": "SUBMITTED",
                "name": "Pending Travel Agency Update"
            },
            "approved": false,
            "businessPurpose": "Business Visit",
            "canceledPostApproval": false,
            "closed": false,
            "comment": "Book a travel\n",
            "creationDate": "2019-05-30T17:47:06.000Z",
            "endDate": "2019-07-01",
            "everSentBack": false,
            "expenses": [],
            "highestExceptionLevel": "NONE",
            "name": "Book To California",
            "owner": {
                "href": "https://us.api.concursolutions.com/profile/v1/users/eaf089a5-1569-31ab-95d2-7ef8dc58354a",
                "id": "eaf089a5-1569-31ab-95d2-7ef8dc58354a",
                "template": "https://us.api.concursolutions.com/profile/v1/users/{id}",
                "firstName": "William",
                "middleInitial": "p",
                "lastName": "Never2"
            },
            "pendingApproval": true,
            "requestId": "3336",
            "startDate": "2019-06-28",
            "submitDate": "2019-05-30T17:51:31.000Z",
            "totalApprovedAmount": {
                "value": 400,
                "currency": "USD"
            },
            "totalPostedAmount": {
                "value": 400,
                "currency": "USD"
            },
            "totalRemainingAmount": {
                "value": 400,
                "currency": "USD"
            },
            "type": {
                "code": "TRAVEL",
                "label": "Travel"
            }
        },
        {
            "href": "https://us.api.concursolutions.com/travelrequest/v4/requests/47ACF629CB38F54EAEAB227BFC4E09C8",
            "id": "47ACF629CB38F54EAEAB227BFC4E09C8",
            "approvalStatus": {
                "code": "SUBMITTED",
                "name": "Pending Travel Agency Update"
            },
            "approved": false,
            "businessPurpose": "Buisness Travel",
            "canceledPostApproval": false,
            "closed": false,
            "comment": "Travel\n",
            "creationDate": "2019-05-30T17:48:49.000Z",
            "endDate": "2019-07-01",
            "everSentBack": false,
            "expenses": [],
            "highestExceptionLevel": "NONE",
            "name": "Book to BLR",
            "owner": {
                "href": "https://us.api.concursolutions.com/profile/v1/users/eaf089a5-1569-31ab-95d2-7ef8dc58354a",
                "id": "eaf089a5-1569-31ab-95d2-7ef8dc58354a",
                "template": "https://us.api.concursolutions.com/profile/v1/users/{id}",
                "firstName": "William",
                "middleInitial": "p",
                "lastName": "Never2"
            },
            "pendingApproval": true,
            "requestId": "3337",
            "startDate": "2019-06-28",
            "submitDate": "2019-05-30T17:53:21.000Z",
            "totalApprovedAmount": {
                "value": 3000,
                "currency": "USD"
            },
            "totalPostedAmount": {
                "value": 3000,
                "currency": "USD"
            },
            "totalRemainingAmount": {
                "value": 3000,
                "currency": "USD"
            },
            "type": {
                "code": "TRAVEL",
                "label": "Travel"
            }
        },
        {
            "href": "https://us.api.concursolutions.com/travelrequest/v4/requests/4A8BA47815C5034CB5493A1F5F57351F",
            "id": "4A8BA47815C5034CB5493A1F5F57351F",
            "approvalStatus": {
                "code": "SUBMITTED",
                "name": "Pending Travel Agency Update"
            },
            "approved": false,
            "businessPurpose": "save",
            "canceledPostApproval": false,
            "closed": false,
            "creationDate": "2019-05-28T19:25:42.000Z",
            "endDate": "2019-06-12",
            "everSentBack": false,
            "expenses": [],
            "highestExceptionLevel": "NONE",
            "name": "Trip to Bangalore",
            "owner": {
                "href": "https://us.api.concursolutions.com/profile/v1/users/ba6a1658-7d6d-3659-b8a5-884319f6d724",
                "id": "ba6a1658-7d6d-3659-b8a5-884319f6d724",
                "template": "https://us.api.concursolutions.com/profile/v1/users/{id}",
                "firstName": "William",
                "middleInitial": "p",
                "lastName": "Never"
            },
            "pendingApproval": true,
            "requestId": "3334",
            "startDate": "2019-06-04",
            "submitDate": "2019-05-28T19:29:46.000Z",
            "totalApprovedAmount": {
                "value": 3000,
                "currency": "USD"
            },
            "totalPostedAmount": {
                "value": 3000,
                "currency": "USD"
            },
            "totalRemainingAmount": {
                "value": 3000,
                "currency": "USD"
            },
            "type": {
                "code": "TRAVEL",
                "label": "Travel"
            }
        }
    ],
    "operations": [
        {
            "rel": "first",
            "href": "https://us.api.concursolutions.com/v4/requests?view=ACTIVE&limit=10&start=0&sortField=startDate&sortOrder=DESC"
        },
        {
            "rel": "last",
            "href": "https://us.api.concursolutions.com/v4/requests?view=ACTIVE&limit=10&start=0&sortField=startDate&sortOrder=DESC"
        }
    ]
}

To view the traveler’s profile, using “GET Travel Profile by UUID.”

URI: GET https://us.api.concursolutions.com/api/travelprofile/v2.0/profile?uuid=eaf089a5-1569-31ab-95d2-7ef8dc58354a
Content-Type: application/xml
Authorization: Bearer 

Response

<?xml version="1.0" encoding="utf-8"?>
<ProfileResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Status="Active" LoginId="wsadmin@pe30-connect.com" Unique="">
    <General>
        <NamePrefix />
        <FirstName>William</FirstName>
        <MiddleName>pe30</MiddleName>
        <LastName>Never</LastName>
        <NameSuffix />
        <PreferredName />
        <JobTitle />
        <CompanyEmployeeID>1000100010003</CompanyEmployeeID>
        <PreferredLanguage>en</PreferredLanguage>
        <HasOpenBooking>false</HasOpenBooking>
        <CountryCode>US</CountryCode>
        <CompanyName>SAP Concur TMC-130-PE</CompanyName>
        <CompanyID>283423</CompanyID>
        <RuleClass>Default Travel Class</RuleClass>
        <TravelConfigID>146793</TravelConfigID>
        <UUID>4b81eb15-da89-4964-987c-9a61ff01eb65</UUID>
    </General>
    <Addresses />
    <EmailAddresses>
        <EmailAddress Contact="true" Type="Business">wsadmin@pe30-connect.com</EmailAddress>
    </EmailAddresses>
    <RatePreferences>
        <AAARate>false</AAARate>
        <AARPRate>false</AARPRate>
        <GovtRate>false</GovtRate>
        <MilitaryRate>false</MilitaryRate>
    </RatePreferences>
    <Air>
        <AirMemberships />
        <Seat>
            <InterRowPositionCode>DontCare</InterRowPositionCode>
            <SectionPositionCode>DontCare</SectionPositionCode>
        </Seat>
        <AirOther />
    </Air>
    <Rail>
        <Seat>DontCare</Seat>
        <Coach>DontCare</Coach>
        <NoiseComfort>DontCare</NoiseComfort>
        <Bed>DontCare</Bed>
        <BedCategory>DontCare</BedCategory>
        <Berth>DontCare</Berth>
        <Deck>DontCare</Deck>
        <SpaceType>DontCare</SpaceType>
        <FareSpaceComfort>DontCare</FareSpaceComfort>
        <SpecialMeals>DontCare</SpecialMeals>
        <Contingencies>DontCare</Contingencies>
        <RailMemberships />
    </Rail>
    <Car>
        <CarSmokingCode>DontCare</CarSmokingCode>
        <CarGPS>false</CarGPS>
        <CarType>DontCare</CarType>
        <CarMemberships />
        <CarOther />
        <CarSkiRack>false</CarSkiRack>
        <CarTransmission>DontCare</CarTransmission>
    </Car>
    <Hotel>
        <HotelSmokingCode>DontCare</HotelSmokingCode>
        <HotelMemberships />
        <RoomType>DontCare</RoomType>
        <PreferFoamPillows>false</PreferFoamPillows>
        <PreferCrib>false</PreferCrib>
        <PreferRollawayBed>false</PreferRollawayBed>
        <PreferGym>false</PreferGym>
        <PreferPool>false</PreferPool>
        <PreferRestaurant>false</PreferRestaurant>
        <PreferWheelchairAccess>false</PreferWheelchairAccess>
        <PreferAccessForBlind>false</PreferAccessForBlind>
        <PreferRoomService>false</PreferRoomService>
        <PreferEarlyCheckIn>false</PreferEarlyCheckIn>
    </Hotel>
    <Roles />
    <TSAInfo />
</ProfileResponse>

To view the traveler’s expenses fetch all active travel requests, using “Get TR by requests by status=ACTIVE.”

{
   "href":"https://us.api.concursolutions.com/travelrequest/v4/requests/8354DDF8F1C6374BAE266293CF9",
"id": "8354DDF8F1C6374BAE25189266293CF9"
approvalStatus": {
                "code": "SUBMITTED",
                "name": "Pending Travel Agency Update"
 }

By passing the travel_request_id (id: “8354DDF8F1C6374BAE25189266293CF9”) you can get the expenses for a traveler.

URI: GET https://us.api.concursolutions.com/travelrequest/v4/requests/8354DDF8F1C6374BAE25189266293CF9
Content-Type: application/json
Authorization: Bearer 

Response

{
    "href": "https://us.api.concursolutions.com/travelrequest/v4/requests/8354DDF8F1C6374BAE25189266293CF9",
    "id": "8354DDF8F1C6374BAE25189266293CF9",
    "approvalStatus": {
        "code": "SUBMITTED",
        "name": "Pending Travel Agency Update"
    },
    "approved": false,
    "businessPurpose": "Leisure Trip",
    "canceledPostApproval": false,
    "closed": false,
    "creationDate": "2019-06-03T21:14:42.000Z",
    "endDate": "2019-08-25",
    "everSentBack": false,
    "expensePolicy": {
        "href": "https://us.api.concursolutions.com/expenseconfig/v4/users/null/context/TRAVELER/policies/DC9A8A67FE220F48BB1C0C7A625FB4CB",
        "id": "DC9A8A67FE220F48BB1C0C7A625FB4CB",
        "template": "https://us.api.concursolutions.com/expenseconfig/v4/users/null/context/TRAVELER/policies/{id}"
    },
    "expenses": [
        {
            "href": "https://us.api.concursolutions.com/travelrequest/v4/expenses/04B6E512AC2FCD4FA66697D14CC964F5?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab",
            "id": "04B6E512AC2FCD4FA66697D14CC964F5",
            "template": "https://us.api.concursolutions.com/travelrequest/v4/expenses/{id}?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab"
        },
        {
            "href": "https://us.api.concursolutions.com/travelrequest/v4/expenses/5B1B4B514CE60243AF70F53062DFAE5B?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab",
            "id": "5B1B4B514CE60243AF70F53062DFAE5B",
            "template": "https://us.api.concursolutions.com/travelrequest/v4/expenses/{id}?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab"
        },
        {
            "href": "https://us.api.concursolutions.com/travelrequest/v4/expenses/B6D135D95C7E904988C6569410F8114B?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab",
            "id": "B6D135D95C7E904988C6569410F8114B",
            "template": "https://us.api.concursolutions.com/travelrequest/v4/expenses/{id}?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab"
        },
        {
            "href": "https://us.api.concursolutions.com/travelrequest/v4/expenses/7F06BECD2A87F64F87F346C94C7D095D?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab",
            "id": "7F06BECD2A87F64F87F346C94C7D095D",
            "template": "https://us.api.concursolutions.com/travelrequest/v4/expenses/{id}?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab"
        }
    ],
    "lastModified": "2019-06-03T21:29:50.000Z",
    "name": "Dream Trip To Paris",
    "owner": {
        "href": "https://us.api.concursolutions.com/profile/v1/users/613cd9cd-9145-4806-ae6c-bfc7da54c9ab",
        "id": "613cd9cd-9145-4806-ae6c-bfc7da54c9ab",
        "template": "https://us.api.concursolutions.com/profile/v1/users/{id}",
        "firstName": "William",
        "middleInitial": "p",
        "lastName": "Never2"
    },
    "pendingApproval": true,
    "policy": {
        "id": "C61AF0EA030FF243ABA2C4C115E0EA50"
    },
    "requestId": "3339",
    "startDate": "2019-07-26",
    "submitDate": "2019-06-03T21:29:50.000Z",
    "totalApprovedAmount": {
        "value": 12000,
        "currency": "USD"
    },
    "totalPostedAmount": {
        "value": 12000,
        "currency": "USD"
    },
    "totalRemainingAmount": {
        "value": 12000,
        "currency": "USD"
    },
    "travelAgency": {
        "href": "https://us.api.concursolutions.com/travelrequest/v4/travelagencies/D8E1B4B94CA13B4DA1642147B600731B",
        "id": "D8E1B4B94CA13B4DA1642147B600731B",
        "template": "https://us.api.concursolutions.com/travelrequest/v4/travelagencies/{id}"
    },
    "type": {
        "code": "TRAVEL",
        "label": "Travel"
    },
    "operations": [
        {
            "rel": "recall",
            "href": "https://us.api.concursolutions.com/travelrequest/v4/requests/8354DDF8F1C6374BAE25189266293CF9/recall?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab"
        },
        {
            "rel": "cancel",
            "href": "https://us.api.concursolutions.com/travelrequest/v4/requests/8354DDF8F1C6374BAE25189266293CF9/cancel?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab"
        }
    ]
}

To get the travelers request expenses, by passing `Expense_id` and `user_id`.

URI: GET https://us.api.concursolutions.com/travelrequest/v4/expenses/B6D135D95C7E904988C6569410F8114B?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab

Response

{
    "href": "https://us.api.concursolutions.com/travelrequest/v4/expenses/B6D135D95C7E904988C6569410F8114B?userId=613cd9cd-9145-4806-ae6c-bfc7da54c9ab",
    "id": "B6D135D95C7E904988C6569410F8114B",
    "allocations": [
        {
            "allocationAmount": {
                "value": 1000,
                "currency": "USD"
            },
            "approvedAmount": {
                "value": 1000,
                "currency": "USD"
            },
            "allocationId": "52B89920BABD924B8FAAE9328B7B37C3",
            "postedAmount": {
                "value": 1000,
                "currency": "USD"
            },
            "expenseId": "B6D135D95C7E904988C6569410F8114B",
            "percentEdited": false,
            "systemAllocation": true,
            "percentage": 100
        }
    ],
    "approvedAmount": {
        "value": 1000,
        "currency": "USD"
    },
    "exchangeRate": {
        "value": 1,
        "operation": "MULTIPLY"
    },
    "expenseType": {
        "id": "CARRT",
        "name": "Car Rental",
        "href": "https://us.api.concursolutions.com/expenseconfig/v4/users/613cd9cd-9145-4806-ae6c-bfc7da54c9ab/context/TRAVELER/expensetypes/CARRT",
        "expKey": null,
        "formId": null,
        "customFormId": null,
        "hasSegment": null,
        "formType": null,
        "spendCategoryCode": null,
        "expId": null,
        "formula": null,
        "agencyVisible": null,
        "caRelated": null,
        "spendExpenseCode": null
    },
    "postedAmount": {
        "value": 1000,
        "currency": "USD"
    },
    "remainingAmount": {
        "value": 1000,
        "currency": "USD"
    },
    "transactionAmount": {
        "value": 1000,
        "currency": "USD"
    },
    "transactionDate": "2019-07-26T00:00:00.000Z",
    "tripData": {
        "agencyBooked": true,
        "selfBooked": false,
        "tripType": "ONE_WAY",
        "legs": [
            {
                "endDate": "2019-08-25",
                "endLocation": {
                    "id": "D0059541F7874D3A97F53ACD163FEB7E",
                    "countryCode": "US",
                    "countrySubDivisionCode": "US-WA",
                    "city": "Seattle",
                    "name": "Seattle",
                    "lnKey": 83926
                },
                "endTime": "01:00",
                "id": "11D37079654C4042AE5FC88D53D724F6",
                "returnLeg": false,
                "startDate": "2019-07-26",
                "startLocation": {
                    "id": "0BC6B782B77349898E2CA814F5B57C08",
                    "countryCode": "US",
                    "countrySubDivisionCode": "US-WA",
                    "city": "Seattle",
                    "name": "Seattle",
                    "lnKey": 29857
                },
                "startLocationDetail": "Airport Drop off",
                "startTime": "00:00"
            }
        ],
        "segmentType": {
            "category": "REQ_SEG_CARRT",
            "code": "CARRT"
        }
    }
}

To get the traveler’s expense type details, by passing `ExpenseType_id` and `user_id`.

URI: GET https://us.api.concursolutions.com/expenseconfig/v4/users/613cd9cd-9145-4806-ae6c-bfc7da54c9ab/context/TRAVELER/expensetypes/01025

Response

{
    "expenseTypeId": "01025",
    "expenseCategoryCode": null,
    "expenseCode": "OTHER",
    "expenseCodeName": "Standard",
    "hasChildren": false,
    "isDeletable": true,
    "isDeleted": false,
    "isReadOnly": false,
    "isSystemRecord": false,
    "isUsedInItemizationConfig": false,
    "isVisibilityCodeEditable": true,
    "itemizationType": "NREQ",
    "name": "Train",
    "parentExpenseKey": "TRANS",
    "parentName": "02. Transportation",
    "showOnMobile": true,
    "spendCategoryCode": "RAILX",
    "spendCategoryName": "Train",
    "visibilityCode": "ALWAYS",
    "links": [
        {
            "rel": "self",
            "href": "https://seapr1ecs.concurasp.com/expenseconfig/v4/users/613cd9cd-9145-4806-ae6c-bfc7da54c9ab/context/TRAVELER/expensetypes/01025"
        }
    ]
}

Agency Submits Proposals

Agencies store the Travel Request and Expense details, and use that information to create proposals that will be shared with the traveler.

TMCs can submit up to three proposals for a traveler for each travel request submitted.

Prerequisites:

Sign in to your SAP Concur Travel and Expense User Profile.
Select Profile Settings.
Select Request Setting then Request Information.
In the Default Travel Agency drop down, select the agency.

Set the default travel agency

The following fields will help you submit proposals to a traveler.

ProposalBatchSize

You can submit up to three proposals in a series known as batches per trip request. You need to pass the value in the data element for ProposalBatchSize and ProposalSequenceIndex for the number of proposals you are submitting in the POST.

<Name>ProposalBatchSize</Name>
     <DisplayTitle />
     <Data>3</Data>
     <DisplayOnItinerary>true</DisplayOnItinerary>

Code example showing proposal batch size and proposal sequence index

Now, you can submit the proposal and see the response on the successful submission of a proposal.

You now have the ItinLocator, TripId, and TripLinkLocator generated.

Trip Status

You can track our proposals submitted by using Request ID. Log the Trip ID that is returned in the response and associate those Trip IDs with the Request IDs. Proposals are submitted as itineraries. The itineraries are identified by the value in the TripStatus element.

A trip status of “7” indicates to our system this is a proposal.

Code example showing the itinerary, trip ID, and trip link locator, and trip status

Reviewing a Proposal

Traveler reviews and selects one of the three proposals.

Postman example showing proposal submission

Once you submit the proposal successfully, you can see the Agency Proposal option by logging into your Concur Travel account.

You can see the proposal comparison for each category.

Air Proposal

Comparison screen showing flight options

Car Rental Proposal

Comparison screen showing car rental options

Hotel Proposal

Comparison screen showing hotel options

Note: Each travel proposal submitted, is associated with its Travel_Request_Id and Trip_Id. The traveler can select the proposals that best meets their needs.

Agencies Receive Notification of Proposal Selected by Traveler

Once the traveler selects one of the proposals, the agencies receives notification. It is then sent to ticketing, by setting TripStatus to “0 or 1.”

Code example showing trip status

Convert Proposal to Actual PNR

Each travel proposal is submitted, based on its Travel_Request_Id and Trip_Id.

Code example showing PNR

Traveler Notified of Confirmed Booking and Receives Itinerary

Itinerary appears in traveler’s trip library.

SAP Concur UI showing trip details in the trip library

Traveler’s Itinerary

SAP Concur UI showing itinerary details

Cancel Itinerary

You can always cancel the itinerary if the traveler’s needs change.

Guide to the Request v4.0 API, TMC Edition

Application Scopes

Geolocation

Using the Request v4.0 API

Traveler Plans Trip

Make a Travel Request

Step 1: Log in to SAP Concur

Step 2: Create a Travel Request

Agency Receives Travel Request Notification

Get Travel Request Information

To fetch the traveler’s request using status “Submitted” without parsing UUID.

Response

To view the traveler’s profile, using “GET Travel Profile by UUID.”

Response

To view the traveler’s expenses fetch all active travel requests, using “Get TR by requests by status=ACTIVE.”

Response

To get the travelers request expenses, by passing Expense_id and user_id.

Response

To get the traveler’s expense type details, by passing ExpenseType_id and user_id.

Response

Agency Submits Proposals

ProposalBatchSize

Trip Status

Reviewing a Proposal

Agencies Receive Notification of Proposal Selected by Traveler

Convert Proposal to Actual PNR

Traveler Notified of Confirmed Booking and Receives Itinerary

Cancel Itinerary

On this page

To get the travelers request expenses, by passing `Expense_id` and `user_id`.

To get the traveler’s expense type details, by passing `ExpenseType_id` and `user_id`.