AptlyStar

SAP Concur

Manage expense reports, travel requests, cash advances, and more in SAP Concur

Nutzungsanweisungen

Connect SAP Concur via OAuth 2.0. Manage expense reports and line items, allocations, attendees, comments, exceptions, quick expenses, receipts, travel requests and expected expenses, cash advances, itineraries, user identities, custom lists, budgets, exchange rates, and purchase requests across every Concur datacenter.

Tools

sap_concur_approve_expense_report

Approve an expense report as a manager (PATCH /expensereports/v4/reports/{reportId}/approve). Required body field: comment.

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
reportIdstringJaExpense report ID to approve
bodyjsonJaRequest body — comment is required by Concur (e.g., { "comment": "Approved" }). If the report contains rejected expenses, expenseRejectedComment is also required. Optional fields: expectedStepCode, expectedStepSequence, statusId (defaults to "A_APPR").

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_associate_attendees

Associate attendees with an expense (POST /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}/attendees).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER or PROXY
reportIdstringJaExpense report ID
expenseIdstringJaExpense ID
bodyjsonJaAttendee associations payload (e.g., { "attendeeAssociations": [...] })

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonConcur association response (201 Created with URI)
↳ uristringResource URI of the attendee associations collection

sap_concur_create_cash_advance

Create a cash advance (POST /cashadvance/v4.1/cashadvances).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
bodyjsonJaCash advance payload

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCreated cash advance payload
↳ cashAdvanceIdstringUnique identifier of the created cash advance

sap_concur_create_expected_expense

Create an expected expense on a travel request (POST /travelrequest/v4/requests/{requestUuid}/expenses).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
requestUuidstringJaTravel request UUID
userIdstringNeinUser UUID acting on the request (required when using a Company JWT, optional otherwise)
bodyjsonJaExpected expense payload

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCreated expected expense payload
↳ idstringExpected expense identifier
↳ hrefstringSelf-link to the resource
↳ expenseTypejsonExpense type {id, name}
↳ transactionDatestringTransaction date
↳ transactionAmountjsonTransaction amount {value, currencyCode}
↳ postedAmountjsonPosted amount {value, currencyCode}
↳ approvedAmountjsonApproved amount {value, currencyCode}
↳ remainingAmountjsonRemaining amount on the expected expense
↳ businessPurposestringBusiness purpose of the expense
↳ locationjsonLocation {id, name, city, countryCode, countrySubDivisionCode, iataCode, locationType}
↳ exchangeRatejsonExchange rate {value, operation}
↳ allocationsjsonBudget allocations array (allocationId, allocationAmount, approvedAmount, postedAmount, expenseId, percentEdited, systemAllocation, percentage)
↳ tripDatajsonTrip data {agencyBooked, selfBooked, tripType (ONE_WAY|ROUND_TRIP), legs[{id, returnLeg, startDate, startTime, startLocationDetail, startLocation, endLocation, class {code,value}, travelExceptionReasonCodes}], segmentType {category, code}}
↳ parentRequestjsonParent travel request resource link {href, id}
↳ commentsjsonComments sub-resource link {href, id}

sap_concur_create_expense_report

Create an expense report (POST /expensereports/v4/users/{userId}/context/{contextType}/reports — supported contexts: TRAVELER, PROXY). Required body fields: name, policyId.

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID who will own the report
contextTypestringJaAccess context: TRAVELER (creating own report) or PROXY (creating on behalf of another user)
bodyjsonJaReport payload — name and policyId are required. Optional fields: businessPurpose, comment, customData, countryCode, countrySubDivisionCode, etc.

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCreated expense report (Concur returns 201 with a URI to the new report)
↳ uristringURI of the newly created expense report

sap_concur_create_list_item

Create a list item (POST /list/v4/items).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
bodyjsonJaList item payload. Required: listId, shortCode, value. Optional: parentId or parentCode (mutually exclusive). Note: Concur rejects shortCode/value containing hyphens.

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCreated list item
↳ idstringList item UUID
↳ codestringLong code format for the item
↳ shortCodestringShort code identifier
↳ valuestringDisplay value of the item
↳ parentIdstringParent item UUID (omitted for first-level items)
↳ levelnumberHierarchy level (1 for root items)
↳ isDeletedbooleanDeletion status across all containing lists
↳ listsarrayLists containing this item
↳ idstringList UUID
↳ hasChildrenbooleanWhether this item has children in the list

sap_concur_create_purchase_request

Create a purchase request (POST /purchaserequest/v4/purchaserequests).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
bodyjsonJaPurchase request payload

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCreated purchase request payload
↳ idstringIdentifier of the created purchase request
↳ uristringResource URI for the created purchase request
↳ errorsarrayValidation or processing errors returned by Concur
↳ errorCodestringError code
↳ errorMessagestringError message
↳ dataPathstringPath to the request data which has the error

sap_concur_create_quick_expense

Create a quick expense (POST /quickexpense/v4/users/{userId}/context/TRAVELER/quickexpenses).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID who owns the quick expense
contextTypestringJaAccess context: must be TRAVELER
bodyjsonJaQuick expense payload (expenseTypeId, transactionAmount, transactionDate, etc.)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCreated quick expense response (HTTP 201 Created)
↳ quickExpenseIdUristringURI of the created quick expense resource

sap_concur_create_quick_expense_with_image

Create a quick expense with an attached image (POST /quickexpense/v4/users/{userId}/context/{contextType}/quickexpenses/image).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: must be TRAVELER
receiptjsonJaReceipt image (UserFile). Allowed: PDF, PNG, JPEG, TIFF (max 50MB)
bodyjsonJaQuick expense payload (transactionAmount, transactionDate, expenseTypeId, vendor, ...)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCreated quick expense response (HTTP 201 with attached receipt image)
↳ quickExpenseIdUristringURI of the created quick expense resource

sap_concur_create_report_comment

Create a comment on a report (POST /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/comments).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER or PROXY
reportIdstringJaExpense report ID
commentstringJaComment text to add

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCreated comment response (Concur returns 201 Created with URI)
↳ uristringResource URI of the created comment

sap_concur_create_travel_request

Create a travel request (POST /travelrequest/v4/requests).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringNeinOptional Concur user UUID — required when impersonating another user
bodyjsonJaTravel request payload (name, purpose, startDate, endDate, requestPolicyId, etc.)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCreated travel request payload
↳ idstringTravel request UUID
↳ hrefstringResource hyperlink
↳ requestIdstringPublic-facing request ID (4-6 alphanumeric characters)
↳ namestringRequest name
↳ businessPurposestringBusiness purpose
↳ commentstringLast attached comment
↳ creationDatestringCreation timestamp
↳ lastModifiedstringLast modification timestamp
↳ submitDatestringLast submission timestamp
↳ startDatestringTrip start date (ISO 8601)
↳ endDatestringTrip end date (ISO 8601)
↳ startTimestringTrip start time (HH:mm)
↳ endTimestringTrip end time (HH:mm)
↳ approvedbooleanWhether the request is approved
↳ pendingApprovalbooleanPending approval flag
↳ closedbooleanClosed flag
↳ everSentBackbooleanEver-sent-back flag
↳ canceledPostApprovalbooleanCanceled after approval flag
↳ approvalStatusjsonApproval status
↳ codestringStatus code (NOT_SUBMITTED, SUBMITTED, APPROVED, CANCELED, SENTBACK)
↳ namestringLocalized status name
↳ ownerjsonTravel request owner
↳ idstringUser UUID
↳ firstNamestringOwner first name
↳ lastNamestringOwner last name
↳ approverjsonApprover assigned to the request
↳ idstringUser UUID
↳ firstNamestringApprover first name
↳ lastNamestringApprover last name
↳ policyjsonResource link to the applicable policy
↳ idstringPolicy ID
↳ hrefstringPolicy hyperlink
↳ typejsonRequest type
↳ codestringRequest type code
↳ labelstringRequest type label
↳ mainDestinationjsonMain destination of the trip
↳ citystringCity
↳ countryCodestringISO country code
↳ countrySubDivisionCodestringISO country sub-division code
↳ namestringDestination name
↳ totalApprovedAmountjsonTotal approved amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ totalPostedAmountjsonTotal posted amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ totalRemainingAmountjsonTotal remaining amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ operationsarrayAvailable workflow actions
↳ relstringOperation name
↳ hrefstringOperation URL
↳ expensesarrayExpected expenses attached to the request
↳ highestExceptionLevelstringHighest exception level (NONE, WARNING, ERROR)
↳ travelAgencyjsonTravel agency reference
↳ idstringAgency identifier
↳ hrefstringAgency URL
↳ templatestringTemplate URL
↳ custom1jsonCustom field 1
↳ custom2jsonCustom field 2
↳ custom3jsonCustom field 3
↳ custom4jsonCustom field 4

sap_concur_create_user

Create a new user identity (POST /profile/identity/v4.1/Users).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
bodyjsonJaSCIM User payload (schemas, userName, name, emails, active, etc.)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCreated SCIM User payload

sap_concur_delete_expected_expense

Delete an expected expense (DELETE /travelrequest/v4/expenses/{expenseUuid}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
expenseUuidstringJaExpected expense UUID to delete
userIdstringNeinUser UUID acting on the request (required when using a Company JWT, optional otherwise)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonReturns boolean true on 200 OK when the expected expense is deleted.

sap_concur_delete_expense

Delete an expense (DELETE /expensereports/v4/reports/{reportId}/expenses/{expenseId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
reportIdstringJaExpense report ID
expenseIdstringJaExpense ID to delete

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty body on success (HTTP 204 No Content). Error details when status is non-2xx

sap_concur_delete_expense_report

Delete an expense report (DELETE /expensereports/v4/reports/{reportId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
reportIdstringJaExpense report ID to delete

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_delete_list_item

Delete a list item (DELETE /list/v4/items/{itemId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
itemIdstringJaList item UUID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty body on success (HTTP 204 No Content). Error details when status is non-2xx

sap_concur_delete_travel_request

Delete a travel request (DELETE /travelrequest/v4/requests/{requestUuid}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
requestUuidstringJaTravel request UUID to delete
userIdstringNeinOptional Concur user UUID — required when impersonating another user

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonConcur delete response payload (boolean true on 200 OK)

sap_concur_delete_user

Delete a user identity (DELETE /profile/identity/v4.1/Users/{id}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userUuidstringJaUser UUID to delete

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonDeletion response — empty body on HTTP 204 No Content

sap_concur_get_allocation

Get a single allocation (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/allocations/{allocationId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER or PROXY
reportIdstringJaExpense report ID
allocationIdstringJaAllocation ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonAllocation detail payload
↳ allocationIdstringUnique allocation identifier
↳ accountCodestringLedger account code
↳ overLimitAccountCodestringAccount code applied to amounts over the per-allocation limit
↳ percentagenumberAllocation percentage
↳ allocationAmountjsonAllocation amount (value, currencyCode)
↳ valuenumberAmount value
↳ currencyCodestringISO 4217 currency code
↳ approvedAmountjsonPro-rated approved amount (value, currencyCode)
↳ valuenumberAmount value
↳ currencyCodestringISO 4217 currency code
↳ claimedAmountjsonRequested reimbursement amount (value, currencyCode)
↳ valuenumberAmount value
↳ currencyCodestringISO 4217 currency code
↳ customDataarrayCustom field values (id, value, isValid)
↳ expenseIdstringAssociated expense identifier
↳ isSystemAllocationbooleanTrue when system-managed
↳ isPercentEditedbooleanTrue when the percentage was manually edited

sap_concur_get_budget

Get a budget item header by ID (GET /budget/v4/budgetItemHeader/{id}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
budgetIdstringJaBudget item header ID (syncguid)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonBudget header detail payload
↳ idstringBudget item header ID
↳ namestringAdmin-facing budget name
↳ descriptionstringUser-friendly display name
↳ budgetItemStatusTypestringStatus: OPEN, CLOSED, or REMOVED
↳ budgetTypestringType: PERSONAL_USE, BUDGET, RESTRICTED, or TEAM
↳ periodTypestringPeriod type: YEARLY, QUARTERLY, MONTHLY, or DATE_RANGE
↳ currencyCodestringISO 4217 currency code
↳ isTestbooleanTest budget flag
↳ activebooleanDisplay availability flag
↳ ownedbooleanCaller ownership flag
↳ annualBudgetnumberTotal annual budget amount
↳ createdDatestringUTC creation timestamp
↳ lastModifiedDatestringUTC modification timestamp
↳ fiscalYearjsonFiscal year reference (id, name, startDate, endDate, status)
↳ budgetAmountsjsonAggregate spend amounts (pendingAmount, spendAmount, unExpensedAmount, availableAmount, adjustedBudgetAmount, consumedPercent, threshold)
↳ ownerjsonOwner user (externalUserCUUID, employeeUuid, email, employeeId, name)
↳ budgetManagersarrayManager user objects
↳ budgetApproversarrayApprover user objects
↳ budgetViewersarrayViewer user objects
↳ budgetTeamMembersarrayTeam member entries (budgetPerson, startDate, endDate, active, status)
↳ budgetCategoryjsonLinked category (id, name, description, statusType)
↳ costObjectsarrayTracking field values (fieldDefinitionId, code, value, operator)
↳ budgetItemDetailsarrayPer-period detail entries (id, currencyCode, amount, budgetItemDetailStatusType, fiscalPeriod, budgetAmounts)
↳ dateRangejsonDate range for DATE_RANGE budgets (startDate, endDate)

sap_concur_get_cash_advance

Get a cash advance (GET /cashadvance/v4.1/cashadvances/{cashAdvanceId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
cashAdvanceIdstringJaCash advance ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCash advance detail payload
↳ cashAdvanceIdstringUnique identifier of the cash advance
↳ namestringCash advance name
↳ purposestringPurpose for the cash advance
↳ commentstringComment recorded on the cash advance
↳ accountCodestringAccount code linked to the employee
↳ requestDatestringDatetime the cash advance was requested (UTC, YYYY-MM-DD hh:mm:ss)
↳ issuedDatestringDatetime the cash advance was issued (UTC, YYYY-MM-DD hh:mm:ss)
↳ lastModifiedDatestringDatetime the cash advance was last modified (UTC, YYYY-MM-DD hh:mm:ss)
↳ hasReceiptsbooleanWhether the cash advance has receipts
↳ reimbursementCurrencystringReimbursement currency (3-letter ISO 4217 currency code)
↳ amountRequestedjsonAmount requested for the cash advance
↳ amountstringRequested amount value
↳ currencystring3-letter ISO 4217 currency code
↳ availableBalancejsonUnsubmitted balance for the cash advance
↳ amountstringBalance amount
↳ currencystring3-letter ISO 4217 currency code
↳ exchangeRatejsonExchange rate that applies to the cash advance
↳ valuestringExchange rate value
↳ operationstringExchange rate operation (MULTIPLY)
↳ approvalStatusjsonApproval status of the cash advance
↳ codestringStatus code
↳ namestringStatus display name
↳ paymentTypejsonPayment type for the cash advance
↳ paymentCodestringPayment type code
↳ descriptionstringPayment method description

sap_concur_upload_exchange_rates

Bulk upload up to 100 custom exchange rates (POST /exchangerate/v4/rates). Body contains a currency_sets array, each with from_crn_code, to_crn_code, start_date (YYYY-MM-DD), and rate.

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
bodyjsonJaBulk upload body: { currency_sets: [{ from_crn_code, to_crn_code, start_date: "YYYY-MM-DD", rate }] } (max 100 entries)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonBulk-upload exchange rate response (Exchange Rate v4)
↳ overallStatusstringOverall result status for the bulk upload (e.g. SUCCESS, FAILURE)
↳ messagestringTop-level result message
↳ currencySetsjsonPer-row results: array of { from_crn_code, to_crn_code, start_date, rate, statusCode, statusMessage }

sap_concur_get_expected_expense

Get an expected expense (GET /travelrequest/v4/expenses/{expenseUuid}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
expenseUuidstringJaExpected expense UUID
userIdstringNeinUser UUID acting on the request (optional)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonExpected expense payload
↳ idstringExpected expense identifier
↳ hrefstringSelf-link
↳ expenseTypejsonExpense type {id, name}
↳ transactionDatestringTransaction date
↳ transactionAmountjsonTransaction amount {value, currencyCode}
↳ postedAmountjsonPosted amount {value, currencyCode}
↳ approvedAmountjsonApproved amount {value, currencyCode}
↳ remainingAmountjsonRemaining amount on the expected expense
↳ businessPurposestringBusiness purpose of the expense
↳ locationjsonLocation {id, name, city, countryCode, countrySubDivisionCode, iataCode, locationType}
↳ exchangeRatejsonExchange rate {value, operation}
↳ allocationsjsonBudget allocations array
↳ tripDatajsonTrip data {agencyBooked, selfBooked, tripType (ONE_WAY|ROUND_TRIP), legs[{id, returnLeg, startDate, startTime, startLocationDetail, startLocation, endLocation, class {code,value}, travelExceptionReasonCodes}], segmentType {category, code}}
↳ parentRequestjsonParent travel request resource link {href, id}
↳ commentsjsonComments sub-resource link {href, id}

sap_concur_get_expense

Get a single expense (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringJaExpense report ID
expenseIdstringJaExpense ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonExpense detail (ReportExpenseDetail) payload
↳ expenseIdstringExpense identifier
↳ allocationSetIdstringIdentifier of the associated allocation set
↳ allocationStatestringFULLY_ALLOCATED, NOT_ALLOCATED, or PARTIALLY_ALLOCATED
↳ expenseTypejsonExpense type {id, name, code, isDeleted}
↳ paymentTypejsonPayment type {id, name, code}
↳ expenseSourcestringSource of the expense (CASH, CCARD, EBOOKING, etc.)
↳ transactionDatestringTransaction date (YYYY-MM-DD)
↳ budgetAccrualDatestringBudget accrual date
↳ transactionAmountjsonTransaction amount {currencyCode, value}
↳ postedAmountjsonPosted amount in report currency {currencyCode, value}
↳ claimedAmountjsonNon-personal claimed amount {currencyCode, value}
↳ approvedAmountjsonApproved amount {currencyCode, value}
↳ approverAdjustedAmountjsonTotal amount adjusted by the approver
↳ exchangeRatejsonExchange rate {value, operation}
↳ vendorjsonVendor info {id, name, description}
↳ locationjsonLocation {id, name, city, countryCode, countrySubDivisionCode}
↳ businessPurposestringBusiness purpose
↳ commentstringFree-form comment associated with the expense
↳ isExpenseBillablebooleanBillable flag
↳ isPersonalExpensebooleanPersonal-expense flag
↳ isExpenseRejectedbooleanWhether the expense was rejected
↳ isExcludedFromCashAdvanceByUserbooleanWhether the user excluded this from cash advance
↳ isImageRequiredbooleanWhether a receipt image is required
↳ isPaperReceiptRequiredbooleanWhether a paper receipt is required
↳ isPaperReceiptReceivedbooleanWhether a paper receipt was received
↳ isAutoCreatedbooleanAuto-creation indicator
↳ hasBlockingExceptionsbooleanWhether submission-blocking exceptions exist
↳ hasExceptionsbooleanWhether any exceptions exist
↳ hasMissingReceiptDeclarationbooleanAffidavit declaration status
↳ attendeeCountnumberNumber of attendees
↳ receiptImageIdstringIdentifier of the attached receipt image
↳ ereceiptImageIdstringeReceipt image identifier
↳ receiptTypejsonReceipt {id, status}
↳ imageCertificationStatusstringReceipt image processing/certification status
↳ ticketNumberstringAssociated travel ticket number
↳ traveljsonTravel data (airline, car rental, hotel, etc.)
↳ travelAllowancejsonTravel allowance association data
↳ mileagejsonMileage details (odometerStart, odometerEnd, totalDistance, ...)
↳ expenseTaxSummaryjsonAggregated tax data for the expense
↳ taxRateLocationstringTax rate location: FOREIGN, HOME, or OUT_OF_PROVINCE
↳ fuelTypeListItemjsonFuel type list item {id, value, isValid}
↳ merchantTaxIdstringMerchant tax identifier
↳ customDatajsonArray of custom field values [{id, value, isValid}]
↳ parentExpenseIdstringIdentifier of the parent expense (for itemizations)
↳ authorizationRequestExpenseIdstringLinked travel-request expected expense identifier
↳ jptRouteIdstringJapan Public Transport route id
↳ invoiceIdstringInvoice identifier
↳ governmentInvoiceIdstringGovernment invoice identifier
↳ lastModifiedDatestringLast modified timestamp
↳ expenseSourceIdentifiersjsonSource reference identifiers
↳ linksjsonHATEOAS links for the expense

sap_concur_get_expense_report

Retrieve a single expense report header by id via Expense Report v4 (/expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID who owns the report
contextTypestringJaAccess context: TRAVELER (own report), MANAGER (report under approval), PROCESSOR, or PROXY
reportIdstringJaExpense report ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonConcur expense report header (ReportDetails)
↳ reportIdstringUnique report identifier
↳ reportNumberstringReport number
↳ reportFormIdstringReport form ID
↳ policyIdstringPolicy ID applied to the report
↳ policystringPolicy name
↳ namestringReport name
↳ currencyCodestringISO currency code
↳ currencystringCurrency name
↳ approvalStatusstringApproval status name
↳ approvalStatusIdstringApproval status identifier
↳ paymentStatusstringPayment status name
↳ paymentStatusIdstringPayment status identifier
↳ ledgerstringLedger name
↳ ledgerIdstringLedger identifier
↳ userIdstringOwner user UUID
↳ reportDatestringReport date (YYYY-MM-DD)
↳ creationDatestringCreation timestamp (ISO 8601)
↳ submitDatestringSubmit timestamp (ISO 8601) or null
↳ startDatestringReport period start (YYYY-MM-DD)
↳ endDatestringReport period end (YYYY-MM-DD)
↳ approvedAmountjsonAmount approved { value, currencyCode }
↳ claimedAmountjsonAmount claimed { value, currencyCode }
↳ reportTotaljsonReport total { value, currencyCode }
↳ amountDueEmployeejsonAmount due employee
↳ amountDueCompanyjsonAmount due company
↳ amountDueCompanyCardjsonAmount due company card
↳ amountCompanyPaidjsonAmount company has paid
↳ personalAmountjsonPersonal portion of the report
↳ paymentConfirmedAmountjsonConfirmed payment amount
↳ amountNotApprovedjsonAmount not approved
↳ totalAmountPaidEmployeejsonTotal amount paid to employee
↳ concurAuditStatusstringConcur audit status
↳ isFinancialIntegrationEnabledbooleanWhether financial integration is enabled
↳ isSubmittedbooleanWhether the report has been submitted
↳ isSentBackbooleanWhether the report has been sent back
↳ isReopenedbooleanWhether the report was reopened
↳ isReportEverSentBackbooleanWhether the report was ever sent back
↳ canRecallbooleanWhether the report can be recalled
↳ canAddExpensebooleanWhether expenses can be added to the report
↳ canReopenbooleanWhether the report can be reopened
↳ isReceiptImageRequiredbooleanWhether receipt images are required
↳ isReceiptImageAvailablebooleanWhether receipt images are available
↳ isPaperReceiptsReceivedbooleanWhether paper receipts were received
↳ isPendingDelegatorReviewbooleanWhether pending delegator review
↳ isFundsAndGrantsIntegrationEligiblebooleanFunds and grants eligibility
↳ hasReceivedCashAdvanceReturnsbooleanWhether cash advance returns received
↳ analyticsGroupIdstringAnalytics group ID
↳ hierarchyNodeIdstringHierarchy node ID
↳ allocationFormIdstringAllocation form ID
↳ countryCodestringISO country code
↳ countrySubDivisionCodestringISO country subdivision code
↳ countrystringCountry name
↳ businessPurposestringBusiness purpose
↳ commentstringHeader-level comment on the report
↳ reportVersionnumberReport version number
↳ reportTypestringReport type identifier
↳ cardProgramStatementPeriodIdstringCard program statement period ID
↳ defaultFieldAccessstringDefault field access (HD/RO/RW)
↳ imageStatusstringImage status
↳ receiptContainerIdstringReceipt container ID
↳ receiptStatusstringReceipt status
↳ sponsorIdstringSponsor ID
↳ submitterIdstringSubmitter user ID
↳ taxConfigIdstringTax configuration ID
↳ redirectFundjsonRedirect fund object { amount, creditCardId }
↳ customDataarrayArray of custom data { id, value, isValid, listItemUrl }
↳ employeejsonEmployee object { employeeId, employeeUuid }
↳ linksarrayHATEOAS links

sap_concur_get_itemizations

Get expense itemizations (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}/itemizations).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringJaExpense report ID
expenseIdstringJaExpense ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
dataarrayArray of itemizations (ReportExpenseSummary[])
↳ idstringItemization identifier
↳ expenseIdstringItemization expense id
↳ allocationsarrayAllocations applied to the itemization
↳ expenseTypejsonExpense type {id, name, code, isDeleted}
↳ transactionDatestringTransaction date (YYYY-MM-DD)
↳ transactionAmountjsonTransaction amount
↳ postedAmountjsonPosted amount
↳ approvedAmountjsonApproved amount
↳ claimedAmountjsonClaimed amount
↳ approverAdjustedAmountjsonApprover-adjusted amount
↳ paymentTypejsonPayment type
↳ vendorjsonVendor info
↳ locationjsonLocation info
↳ allocationStatestringAllocation state
↳ allocationSetIdstringAllocation set identifier
↳ attendeeCountnumberAttendee count
↳ businessPurposestringBusiness purpose
↳ hasBlockingExceptionsbooleanHas blocking exceptions
↳ hasExceptionsbooleanHas exceptions
↳ isPersonalExpensebooleanPersonal expense
↳ linksarrayHATEOAS links

sap_concur_get_itinerary

Get a single trip/itinerary (GET /api/travel/trip/v1.1/{tripID}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
tripIdstringJaTrip ID
useridTypestringNeinUser identifier type (login, xmlsyncid, uuid)
useridValuestringNeinUser identifier value (paired with useridType)
systemFormatstringNeinOptional system format (e.g., GDS) for the response

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonTrip detail payload (Itinerary v1.1)
↳ ItinLocatorstringConcur trip locator (trip ID)
↳ ClientLocatorstringClient (booking source) trip locator
↳ ItinSourceNamestringBooking source name
↳ BookedViastringHow the trip was booked (e.g. ConcurTravel, Direct)
↳ TripNamestringTrip name
↳ StatusstringTrip status (e.g. Confirmed, Cancelled)
↳ DescriptionstringTrip description
↳ CommentsstringComments attached to the trip
↳ CancelCommentsstringCancellation comments (when applicable)
↳ ProjectNamestringAssociated project name
↳ StartDateUtcstringTrip start datetime in UTC
↳ EndDateUtcstringTrip end datetime in UTC
↳ StartDateLocalstringTrip start datetime in local time
↳ EndDateLocalstringTrip end datetime in local time
↳ DateCreatedUtcstringTrip creation timestamp (UTC)
↳ DateModifiedUtcstringTrip last-modified timestamp (UTC)
↳ DateBookedLocalstringBooking date in local time
↳ UserLoginIdstringLogin id of the trip owner
↳ BookedByFirstNamestringFirst name of the booker
↳ BookedByLastNamestringLast name of the booker
↳ IsPersonalbooleanWhether the trip is flagged personal
↳ RuleViolationsarrayTravel rule violations attached to the trip
↳ BookingsarrayBookings (air/hotel/car/rail) attached to the trip

sap_concur_get_list

Get a single custom list (GET /list/v4/lists/{listId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
listIdstringJaList ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonList detail payload
↳ idstringUnique identifier (UUID) of the list
↳ valuestringName of the list
↳ levelCountnumberNumber of levels in the list
↳ searchCriteriastringSearch attribute (TEXT or CODE)
↳ displayFormatstringDisplay order ((CODE) TEXT or TEXT (CODE))
↳ categoryjsonList category
↳ idstringCategory UUID
↳ typestringCategory type
↳ isReadOnlybooleanWhether the list is read-only
↳ isDeletedbooleanWhether the list has been deleted
↳ managedBystringIdentifier of the managing application or service
↳ externalThresholdnumberThreshold from where the level starts being external

sap_concur_get_list_item

Get a single list item (GET /list/v4/items/{itemId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
itemIdstringJaList item ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonList item detail payload
↳ idstringList item UUID
↳ codestringLong code format for the item
↳ shortCodestringShort code identifier
↳ valuestringDisplay value of the item
↳ parentIdstringParent item UUID (omitted for first-level items)
↳ levelnumberHierarchy level (1 for root items)
↳ isDeletedbooleanDeletion status across all containing lists
↳ listsarrayLists containing this item
↳ idstringList UUID
↳ hasChildrenbooleanWhether this item has children in the list

sap_concur_get_purchase_request

Get a purchase request by ID (GET /purchaserequest/v4/purchaserequests/{id}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
purchaseRequestIdstringJaPurchase request ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonPurchase request detail payload
↳ purchaseRequestIdstringUnique identifier of the purchase request
↳ purchaseRequestNumberstringHuman-readable purchase request number
↳ purchaseRequestQueueStatusstringQueue status of the purchase request
↳ purchaseRequestWorkflowStatusstringWorkflow status of the purchase request
↳ purchaseOrdersarrayPurchase orders generated from the request
↳ purchaseOrderNumberstringPurchase order number
↳ purchaseRequestExceptionsarrayExceptions raised on the purchase request
↳ eventCodestringEvent code
↳ exceptionCodestringException code
↳ isClearedbooleanWhether the exception has been cleared
↳ prExceptionIdstringIdentifier of the exception record
↳ messagestringException message

sap_concur_get_receipt

Get a single receipt by ID (GET /receipts/v4/{receiptId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
receiptIdstringJaReceipt ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonReceipt detail payload
↳ idstringReceipt identifier
↳ userIdstringOwning user UUID
↳ dateTimeReceivedstringTimestamp when the receipt was received (ISO 8601)
↳ receiptjsonParsed receipt JSON object
↳ imagestringReceipt image URL or data reference
↳ validationSchemastringSchema used to validate the receipt
↳ selfstringURL to this receipt resource
↳ templatestringURL template for receipts

sap_concur_get_receipt_status

Get receipt processing status (GET /receipts/v4/status/{receiptId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
receiptIdstringJaReceipt ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonReceipt status payload
↳ statusstringProcessing status: ACCEPTED, PROCESSING, PROCESSED, or FAILED
↳ logsarrayArray of log entries
↳ logLevelstringLog level
↳ messagestringLog message
↳ timestampstringLog timestamp

sap_concur_get_travel_profile

Get a travel profile (GET /api/travelprofile/v2.0/profile). Returns the calling user by default; pass userid_type and userid_value to impersonate.

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
useridTypestringNeinIdentifier type: login, xmlsyncid, or uuid
useridValuestringNeinIdentifier value (login id, xml sync id, or UUID)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonTravel profile payload. Concur returns XML; downstream may parse it to a best-effort JSON object with the documented top-level sections.
↳ GeneraljsonGeneral profile info (NamePrefix, FirstName, MiddleName, LastName, NameSuffix, JobTitle, CompanyEmployeeID, EmailAddress, RuleClass, TravelConfigID, etc.)
↳ TelephonesjsonTelephone numbers (Telephone[] with Type, CountryCode, PhoneNumber, etc.)
↳ AddressesjsonAddress records (Address[] with Type, Street, City, StateProvince, etc.)
↳ DriversLicensesarrayDrivers license records
↳ NationalIDsarrayNational ID records
↳ EmailAddressesjsonEmail addresses (EmailAddress[] with Type, Address, Contact, Verified)
↳ EmergencyContactjsonEmergency contact (Name, Relationship, Phones, Address)
↳ AirjsonAir travel preferences (HomeAirport, Seat, Meal, AirOther, AirMemberships)
↳ RailjsonRail preferences (Seat, Coach, Berth, Other, RailMemberships)
↳ HoteljsonHotel preferences (SmokingCode, RoomType, HotelOther, HotelMemberships, Accessibility flags)
↳ CarjsonCar rental preferences (CarSmokingCode, CarType, CarMemberships, etc.)
↳ CustomFieldsjsonCustom-defined fields configured by the company
↳ RatePreferencesjsonRate preferences (e.g. AAA, AARP, government, military rates)
↳ DiscountCodesjsonDiscount codes available to the traveler
↳ HasNoPassportbooleanWhether the traveler has no passport on file
↳ RolesjsonRole assignments (TravelManager, Assistant, etc.)
↳ SponsorsjsonSponsor information for guest travelers
↳ TSAInfojsonTSA SecureFlight info (Gender, DateOfBirth, NoMiddleName, etc.)
↳ PassportsjsonPassport documents (Passport[] with PassportNumber, Country, Expiration)
↳ VisasjsonVisa documents (Visa[] with VisaNationality, VisaNumber, etc.)
↳ UnusedTicketsjsonUnused ticket records
↳ SouthwestUnusedTicketsjsonSouthwest-specific unused ticket records
↳ AdvantageMembershipsjsonAdvantage program memberships
↳ XmlSyncIdstringXML sync identifier for the user
↳ LoginIdstringConcur login id
↳ ProfileLastModifiedUTCstringUTC timestamp the profile was last modified

sap_concur_get_travel_request

Get a single travel request (GET /travelrequest/v4/requests/{requestUuid}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
requestUuidstringJaTravel request UUID
userIdstringNeinOptional Concur user UUID — required when impersonating another user

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonTravel request detail payload
↳ idstringTravel request UUID
↳ hrefstringResource hyperlink
↳ requestIdstringPublic-facing request ID (4-6 alphanumeric characters)
↳ namestringRequest name
↳ businessPurposestringBusiness purpose
↳ commentstringLast attached comment
↳ creationDatestringCreation timestamp
↳ lastModifiedstringLast modification timestamp
↳ submitDatestringLast submission timestamp
↳ authorizedDatestringDate when approval was completed
↳ approvalLimitDatestringRequired approval deadline
↳ startDatestringTrip start date (ISO 8601)
↳ endDatestringTrip end date (ISO 8601)
↳ startTimestringTrip start time (HH:mm)
↳ endTimestringTrip end time (HH:mm)
↳ pnrstringPassenger record number
↳ approvedbooleanWhether the request is approved
↳ pendingApprovalbooleanPending approval flag
↳ closedbooleanClosed flag
↳ everSentBackbooleanEver-sent-back flag
↳ canceledPostApprovalbooleanCanceled after approval flag
↳ isParentRequestbooleanParent request flag
↳ parentRequestIdstringParent budget request ID
↳ allocationFormIdstringAllocation form identifier
↳ highestExceptionLevelstringHighest exception level (WARNING, ERROR, NONE)
↳ approvalStatusjsonApproval status
↳ codestringStatus code (NOT_SUBMITTED, SUBMITTED, APPROVED, CANCELED, SENTBACK)
↳ namestringLocalized status name
↳ ownerjsonTravel request owner
↳ idstringUser UUID
↳ firstNamestringOwner first name
↳ lastNamestringOwner last name
↳ approverjsonApprover assigned to the request
↳ idstringUser UUID
↳ firstNamestringApprover first name
↳ lastNamestringApprover last name
↳ policyjsonResource link to the applicable policy
↳ idstringPolicy ID
↳ hrefstringPolicy hyperlink
↳ typejsonRequest type
↳ codestringRequest type code
↳ labelstringRequest type label
↳ mainDestinationjsonMain destination of the trip
↳ citystringCity
↳ countryCodestringISO country code
↳ countrySubDivisionCodestringISO country sub-division code
↳ namestringDestination name
↳ totalApprovedAmountjsonTotal approved amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ totalPostedAmountjsonTotal posted amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ totalRemainingAmountjsonTotal remaining amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ expensesarrayResource links to expected expenses
↳ cashAdvancesjsonResource link to cash advances
↳ idstringResource ID
↳ hrefstringResource hyperlink
↳ commentsjsonResource link to comments
↳ idstringResource ID
↳ hrefstringResource hyperlink
↳ exceptionsjsonResource link to exceptions
↳ idstringResource ID
↳ hrefstringResource hyperlink
↳ travelAgencyjsonResource link to travel agency
↳ idstringResource ID
↳ hrefstringResource hyperlink
↳ parentRequestjsonResource link to parent request
↳ idstringResource ID
↳ hrefstringResource hyperlink
↳ eventRequestjsonResource link to parent event request
↳ idstringResource ID
↳ hrefstringResource hyperlink
↳ operationsarrayAvailable workflow actions
↳ relstringOperation name
↳ hrefstringOperation URL
↳ expensePolicyjsonExpense policy reference
↳ idstringPolicy identifier
↳ hrefstringPolicy URL
↳ custom1jsonCustom field 1
↳ custom2jsonCustom field 2
↳ custom3jsonCustom field 3
↳ custom4jsonCustom field 4

sap_concur_get_user

Get a single user by UUID (GET /profile/identity/v4.1/Users/{id}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userUuidstringJaUser UUID
attributesstringNeinComma-separated SCIM attributes to include in the response
excludedAttributesstringNeinComma-separated SCIM attributes to exclude from the response

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonSCIM User identity payload

sap_concur_issue_cash_advance

Issue a cash advance (POST /cashadvance/v4.1/cashadvances/{cashAdvanceId}/issue).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
cashAdvanceIdstringJaCash advance ID to issue
bodyjsonNeinOptional request body

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonIssue cash advance result payload
↳ issuedDatestringDate the cash advance was issued (YYYY-MM-DD)
↳ statusjsonCash advance status after the issue action
↳ codestringStatus code
↳ namestringStatus display name

sap_concur_list_allocations

List allocations on an expense (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}/allocations).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER or PROXY
reportIdstringJaExpense report ID
expenseIdstringJaExpense ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonAllocations list payload

sap_concur_list_attendee_associations

List attendees associated with an expense (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}/attendees).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER or PROXY
reportIdstringJaExpense report ID
expenseIdstringJaExpense ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonAttendees list payload
↳ noShowAttendeeCountnumberNumber of unnamed/no-show attendees
↳ expenseAttendeeListarrayAttendees associated with the expense, including amounts
↳ attendeeIdstringUnique identifier of the attendee
↳ transactionAmountjsonExpense portion assigned to this attendee
↳ valuenumberNumeric amount
↳ currencyCodestringISO 4217 currency code
↳ approvedAmountjsonApproved amount in report currency
↳ valuenumberNumeric amount
↳ currencyCodestringISO 4217 currency code
↳ isAmountUserEditedbooleanWhether the amount was manually edited
↳ isTravelingbooleanWhether the attendee is traveling (affects tax calculations)
↳ associatedAttendeeCountnumberTotal attendee count; greater than 1 indicates unnamed attendees
↳ versionNumbernumberVersion number preserving previous attendee state
↳ customDataarrayCustom field values for the association
↳ idstringCustom field identifier
↳ valuestringCustom field value (max 48 characters)
↳ isValidbooleanWhether the value passes validation
↳ listItemUrlstringHATEOAS link for list items

sap_concur_list_budget_categories

List budget categories (GET /budget/v4/budgetCategory).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonBudget categories collection payload

sap_concur_list_budgets

List budget item headers (GET /budget/v4/budgetItemHeader).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
adminViewbooleanNeinWhen true, returns all budgets the caller can administer (default false)
offsetnumberNeinPage offset (Concur returns up to 50 budget headers per page)
responseSchemastringNeinResponse schema variant: "COMPACT" returns a smaller payload

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonBudget headers collection payload
↳ offsetnumberPage offset
↳ limitnumberPage size
↳ totalCountnumberTotal result count

sap_concur_list_exceptions

List exceptions on a report (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/exceptions).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringJaExpense report ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
dataarrayArray of report header exception entries
↳ exceptionCodestringUnique exception code
↳ exceptionVisibilitystringVisibility scope: ALL, APPROVER_PROCESSOR, or PROCESSOR
↳ isBlockingbooleanWhether the exception prevents report submission
↳ messagestringHuman-readable description of the exception
↳ expenseIdstringRelated expense entry ID
↳ allocationIdstringRelated allocation ID, if any
↳ parentExpenseIdstringParent expense ID for itemized entries

sap_concur_list_expected_expenses

List expected expenses on a travel request (GET /travelrequest/v4/requests/{requestUuid}/expenses).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
requestUuidstringJaTravel request UUID
userIdstringNeinUser UUID acting on the request (optional)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonArray of expected expense objects. Each entry includes id, href, expenseType {id,name}, transactionDate, transactionAmount, postedAmount, approvedAmount, remainingAmount, businessPurpose, location, exchangeRate, allocations, tripData, parentRequest {href, id}, comments {href, id}.

sap_concur_list_expenses

List expenses on a report (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringJaExpense report ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
dataarrayArray of expense summary entries (ReportExpenseSummary[])
↳ expenseIdstringExpense identifier
↳ expenseTypejsonExpense type {id, name, code, isDeleted}
↳ transactionDatestringTransaction date (YYYY-MM-DD)
↳ transactionAmountjsonTransaction amount {currencyCode, value}
↳ postedAmountjsonPosted amount
↳ approvedAmountjsonApproved amount
↳ claimedAmountjsonClaimed amount
↳ approverAdjustedAmountjsonApprover-adjusted amount
↳ paymentTypejsonPayment type {id, name, code}
↳ vendorjsonVendor info
↳ locationjsonLocation info
↳ allocationStatestringAllocation state
↳ allocationSetIdstringAllocation set identifier
↳ attendeeCountnumberAttendee count
↳ businessPurposestringBusiness purpose
↳ hasBlockingExceptionsbooleanHas submission-blocking exceptions
↳ hasExceptionsbooleanHas exceptions
↳ hasMissingReceiptDeclarationbooleanHas missing-receipt declaration
↳ isAutoCreatedbooleanAuto-created
↳ isPersonalExpensebooleanPersonal-expense flag
↳ isImageRequiredbooleanReceipt image required
↳ isPaperReceiptRequiredbooleanPaper receipt required
↳ imageCertificationStatusstringReceipt image certification status
↳ receiptImageIdstringReceipt image identifier
↳ ereceiptImageIdstringeReceipt image identifier
↳ ticketNumberstringTicket number
↳ exchangeRatejsonExchange rate
↳ travelAllowancejsonTravel allowance
↳ expenseSourceIdentifiersjsonExpense source identifiers
↳ linksarrayHATEOAS links

sap_concur_list_expense_reports

List expense reports (GET /api/v3.0/expense/reports). Returns a v3 envelope with Items and NextPage.

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (us, us2, eu, eu2, cn, emea — defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userstringNeinFilter by a specific user (login id or user identifier).
submitDateBeforestringNeinFilter to reports submitted on or before this date (YYYY-MM-DD)
submitDateAfterstringNeinFilter to reports submitted on or after this date (YYYY-MM-DD)
paidDateBeforestringNeinFilter to reports paid on or before this date (YYYY-MM-DD)
paidDateAfterstringNeinFilter to reports paid on or after this date (YYYY-MM-DD)
modifiedDateBeforestringNeinFilter to reports last modified on or before this date (YYYY-MM-DD)
modifiedDateAfterstringNeinFilter to reports last modified on or after this date (YYYY-MM-DD)
createDateBeforestringNeinFilter to reports created on or before this date (YYYY-MM-DD)
createDateAfterstringNeinFilter to reports created on or after this date (YYYY-MM-DD)
approvalStatusCodestringNeinFilter by approval status code (e.g. A_NOTF, A_PEND, A_APPR)
paymentStatusCodestringNeinFilter by payment status code
currencyCodestringNeinFilter by ISO currency code (e.g. USD, EUR)
approverLoginIDstringNeinFilter by approver login ID
limitnumberNeinNumber of records per page (default 25, max 100)
offsetstringNeinOpaque cursor token returned by a prior call (NextPage).

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonConcur v3 expense reports envelope
↳ ItemsarrayArray of report header objects
↳ IDstringReport ID
↳ NamestringReport name
↳ OwnerLoginIDstringOwner login ID
↳ OwnerNamestringOwner display name
↳ TotalnumberReport total
↳ TotalApprovedAmountnumberTotal approved amount
↳ TotalClaimedAmountnumberTotal claimed amount
↳ AmountDueEmployeenumberAmount due employee
↳ CurrencyCodestringISO currency code
↳ ApprovalStatusNamestringApproval status name
↳ ApprovalStatusCodestringApproval status code
↳ PaymentStatusNamestringPayment status name
↳ PaymentStatusCodestringPayment status code
↳ ApproverLoginIDstringApprover login ID
↳ ApproverNamestringApprover display name
↳ HasExceptionbooleanWhether the report has any exception
↳ ReceiptsReceivedbooleanWhether paper receipts were received
↳ CreateDatestringCreation date
↳ SubmitDatestringSubmit date
↳ LastModifiedDatestringLast modified date
↳ PaidDatestringPaid date
↳ URIstringSelf URI
↳ NextPagestringURI of the next page (use as offset cursor)

sap_concur_list_itineraries

List travel trips/itineraries (GET /api/travel/trip/v1.1).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
startDatestringNeinFilter trips starting on/after this date (YYYY-MM-DD)
endDatestringNeinFilter trips ending on/before this date (YYYY-MM-DD)
bookingTypestringNeinFilter by booking type (air, car, hotel, rail, etc.)
useridTypestringNeinUser identifier type (login, xmlsyncid, uuid)
useridValuestringNeinUser identifier value (paired with useridType)
itemsPerPagenumberNeinItems per page
pagenumberNein1-based page number
includeMetadatabooleanNeinInclude paging metadata in the response
includeCanceledTripsbooleanNeinInclude canceled trips in the result set
createdAfterDatestringNeinOnly trips created after this date (YYYY-MM-DD)
createdBeforeDatestringNeinOnly trips created before this date (YYYY-MM-DD)
lastModifiedDatestringNeinOnly trips modified on/after this date (YYYY-MM-DD)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonTrips list payload (Itinerary v1.1 ConnectResponse)
↳ MetadatajsonPaging metadata (when includeMetadata=true)
↳ PagingjsonPagination details
↳ TotalPagesnumberTotal pages
↳ TotalItemsnumberTotal items
↳ PagenumberCurrent page
↳ ItemsPerPagenumberItems per page
↳ PreviousPageURLstringPrevious page URL
↳ NextPageURLstringNext page URL
↳ ItineraryInfoListarrayList of itinerary summary records
↳ ItinLocatorstringTrip locator (trip ID)
↳ ClientLocatorstringClient trip locator
↳ ItinSourceNamestringBooking source name
↳ BookedViastringBooking channel
↳ TripNamestringTrip name
↳ StatusstringTrip status
↳ DescriptionstringTrip description
↳ StartDateUtcstringStart (UTC)
↳ EndDateUtcstringEnd (UTC)
↳ StartDateLocalstringStart (local)
↳ EndDateLocalstringEnd (local)
↳ DateCreatedUtcstringCreated (UTC)
↳ DateModifiedUtcstringModified (UTC)
↳ DateBookedLocalstringBooked (local)
↳ UserLoginIdstringTrip owner login id
↳ BookedByFirstNamestringBooker first name
↳ BookedByLastNamestringBooker last name
↳ IsPersonalbooleanPersonal trip flag

sap_concur_list_lists

List custom lists (GET /list/v4/lists).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
pagenumberNeinPage number (1-based; page size is fixed at 100)
sortBystringNeinSort field: name, levelcount, or listcategory
sortDirectionstringNeinSort direction: asc or desc
valuestringNeinFilter by list name
categoryTypestringNeinFilter by category type (mapped to category.type query param)
isDeletedbooleanNeinInclude deleted lists
levelCountnumberNeinFilter by number of levels

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonPaginated lists collection
↳ contentarrayLists in the current page
↳ idstringList UUID
↳ valuestringName of the list
↳ levelCountnumberNumber of levels in the list
↳ searchCriteriastringSearch attribute (TEXT or CODE)
↳ displayFormatstringDisplay order ((CODE) TEXT or TEXT (CODE))
↳ categoryjsonList category
↳ idstringCategory UUID
↳ typestringCategory type
↳ isReadOnlybooleanWhether the list is read-only
↳ isDeletedbooleanWhether the list has been deleted
↳ managedBystringManaging application or service identifier
↳ externalThresholdnumberThreshold from where the level starts being external
↳ pagejsonPagination metadata
↳ numbernumberCurrent page number
↳ sizenumberItems per page
↳ totalElementsnumberTotal item count
↳ totalPagesnumberTotal page count
↳ linksarrayNavigation links (next, previous, first, last)
↳ relstringLink relation
↳ hrefstringLink URL

sap_concur_list_list_items

List the top-level items (children) for a custom list (GET /list/v4/lists/{listId}/children).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
listIdstringJaList ID
pagenumberNeinPage number (1-based; page size is fixed at 100)
sortBystringNeinSort field: value or shortCode
sortDirectionstringNeinSort direction: asc or desc
hasChildrenbooleanNeinInclude only items that have children
isDeletedbooleanNeinInclude deleted items
shortCodestringNeinFilter by short code
valuestringNeinFilter by display value
shortCodeOrValuestringNeinFilter by short code OR value

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonPaginated list items collection
↳ contentarrayList items in the current page
↳ idstringList item UUID
↳ codestringLong code format for the item
↳ shortCodestringShort code identifier
↳ valuestringDisplay value of the item
↳ parentIdstringParent item UUID (omitted for first-level items)
↳ levelnumberHierarchy level (1 for root items)
↳ isDeletedbooleanDeletion status across all containing lists
↳ listsarrayLists containing this item
↳ idstringList UUID
↳ hasChildrenbooleanWhether this item has children in the list
↳ pagejsonPagination metadata
↳ numbernumberCurrent page number
↳ sizenumberItems per page
↳ totalElementsnumberTotal item count
↳ totalPagesnumberTotal page count
↳ linksarrayNavigation links (next, previous, first, last)
↳ relstringLink relation
↳ hrefstringLink URL

sap_concur_list_receipts

List receipts for a user (GET /receipts/v4/users/{userId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
dataarrayArray of e-receipt objects
↳ idstringReceipt id
↳ userIdstringOwner user UUID
↳ dateTimeReceivedstringTimestamp the receipt was received
↳ receiptjsonStructured receipt data
↳ imagestringReceipt image URL or reference
↳ validationSchemastringValidation schema URI
↳ selfstringSelf URL
↳ templatestringTemplate URL

sap_concur_list_report_comments

List comments on a report (GET /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/comments).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER or PROXY
reportIdstringJaExpense report ID
includeAllCommentsbooleanNeinInclude comments from all expenses in the report (default false)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
dataarrayArray of report comment entries
↳ commentstringComment text
↳ creationDatestringComment creation timestamp (ISO 8601)
↳ expenseIdstringRelated expense entry ID
↳ isAuditorCommentbooleanWhether the comment was added by an auditor
↳ isLatestbooleanWhether this is the latest comment
↳ createdForEmployeeIdstringEmployee ID the comment was created for
↳ authorjsonComment author
↳ employeeIdstringEmployee identifier
↳ employeeUuidstringEmployee UUID
↳ createdForEmployeejsonEmployee the comment was created for
↳ employeeIdstringEmployee identifier
↳ employeeUuidstringEmployee UUID
↳ stepInstanceIdstringWorkflow step instance identifier

sap_concur_list_reports_to_approve

List expense reports awaiting approval (GET /expensereports/v4/users/{userId}/context/MANAGER/reportsToApprove).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaManager user UUID
contextTypestringNeinAccess context: must be MANAGER (default)
sortstringNeinReport field name to sort by (e.g., reportDate)
orderstringNeinSort direction: asc or desc
includeDelegateApprovalsbooleanNeinWhether to include reports the caller can approve as a delegate

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
dataarrayArray of reports awaiting approval (ReportToApprove[])
↳ reportIdstringUnique report identifier
↳ namestringReport name
↳ reportDatestringReport date (YYYY-MM-DD)
↳ reportNumberstringUser-friendly report number
↳ submitDatestringSubmission timestamp (ISO 8601 UTC)
↳ approverjsonApprover employee { employeeId, employeeUuid }
↳ employeejsonReport owner employee { employeeId, employeeUuid }
↳ amountDueEmployeejsonAmount due employee { value, currencyCode }
↳ claimedAmountjsonTotal claimed amount { value, currencyCode }
↳ totalApprovedAmountjsonTotal approved amount { value, currencyCode }
↳ hasExceptionsbooleanWhether the report has exceptions
↳ reportTypestringReport creation method identifier
↳ linksarrayHATEOAS links

sap_concur_get_request_cash_advance

Get a single cash advance assigned to a travel request (GET /travelrequest/v4/cashadvances/{cashAdvanceUuid}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
cashAdvanceUuidstringJaCash advance UUID (returned as part of a travel request)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonCash advance detail
↳ cashAdvanceIdstringUnique cash advance identifier
↳ amountRequestedjsonRequested amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ amountnumberAmount (alias)
↳ approvalStatusjsonApproval status
↳ codestringStatus code
↳ namestringStatus name
↳ requestDatestringRequest datetime (ISO 8601)
↳ exchangeRatejsonExchange rate
↳ valuenumberRate value
↳ operationstringMultiply or divide

sap_concur_list_travel_profiles_summary

List travel profile summaries (GET /api/travelprofile/v2.0/summary). LastModifiedDate is required by Concur.

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
lastModifiedDatestringJaRequired UTC datetime in YYYY-MM-DDThh:mm:ss format
pagenumberNein1-based page number
itemsPerPagenumberNeinItems per page (max 200)
travelConfigsstringNeinComma-separated travel configuration ids

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonTravel profile summary list payload (Concur returns XML mapped to JSON)
↳ MetadatajsonPaging metadata
↳ PagingjsonPagination details
↳ TotalPagesnumberTotal number of pages
↳ TotalItemsnumberTotal number of items
↳ PagenumberCurrent page
↳ ItemsPerPagenumberItems per page
↳ PreviousPageURLstringURL to the previous page
↳ NextPageURLstringURL to the next page
↳ DataarrayArray of travel profile summaries
↳ StatusstringStatus (Active/Inactive)
↳ LoginIDstringLogin identifier
↳ XmlProfileSyncIDstringXML profile sync identifier
↳ ProfileLastModifiedUTCstringLast modified timestamp (UTC)
↳ RuleClassstringTravel rule class assigned to the profile
↳ TravelConfigIDstringTravel configuration identifier
↳ UUIDstringProfile UUID
↳ EmployeeIDstringEmployee ID
↳ CompanyIDstringCompany ID

sap_concur_list_travel_request_comments

List comments on a travel request (GET /travelrequest/v4/requests/{requestUuid}/comments).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
requestUuidstringJaTravel request UUID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
dataarrayArray of comment entries
↳ authorjsonComment author
↳ firstNamestringAuthor first name
↳ lastNamestringAuthor last name
↳ creationDateTimestringComment creation timestamp (ISO 8601)
↳ isLatestbooleanWhether this is the latest comment
↳ valuestringComment text

sap_concur_list_travel_requests

List travel requests (GET /travelrequest/v4/requests).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
viewstringNeinView filter (e.g., ALL, ACTIVE, PENDING, TOAPPROVE)
limitnumberNeinMax number of results per page
startnumberNeinPage start cursor (offset)
userIdstringNeinFilter by Concur user UUID
approvedBeforestringNeinISO 8601 date — return requests approved before this date
approvedAfterstringNeinISO 8601 date — return requests approved after this date
modifiedBeforestringNeinISO 8601 date — return requests modified before this date
modifiedAfterstringNeinISO 8601 date — return requests modified after this date
sortFieldstringNeinField to sort by: startDate, approvalStatus, or requestId (default startDate)
sortOrderstringNeinSort order: ASC or DESC (default DESC)

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonTravel requests list payload
↳ dataarrayArray of travel request summaries
↳ idstringTravel request UUID
↳ hrefstringResource hyperlink
↳ requestIdstringPublic-facing request ID
↳ namestringRequest name
↳ businessPurposestringBusiness purpose
↳ commentstringLast attached comment
↳ creationDatestringCreation timestamp
↳ submitDatestringLast submission timestamp
↳ startDatestringTrip start date (ISO 8601)
↳ endDatestringTrip end date (ISO 8601)
↳ startTimestringTrip start time (HH:mm)
↳ approvedbooleanWhether the request is approved
↳ pendingApprovalbooleanPending approval flag
↳ closedbooleanClosed flag
↳ everSentBackbooleanEver-sent-back flag
↳ canceledPostApprovalbooleanCanceled after approval flag
↳ approvalStatusjsonApproval status
↳ codestringStatus code (NOT_SUBMITTED, SUBMITTED, APPROVED, CANCELED, SENTBACK)
↳ namestringLocalized status name
↳ ownerjsonTravel request owner
↳ idstringUser UUID
↳ firstNamestringOwner first name
↳ lastNamestringOwner last name
↳ approverjsonApprover assigned to the request
↳ idstringUser UUID
↳ firstNamestringApprover first name
↳ lastNamestringApprover last name
↳ typejsonRequest type
↳ codestringRequest type code
↳ labelstringRequest type label
↳ totalApprovedAmountjsonTotal approved amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ totalPostedAmountjsonTotal posted amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ totalRemainingAmountjsonTotal remaining amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ expensesarrayResource links to expected expenses
↳ operationsarrayPagination links (next, prev, first, last)
↳ relstringLink relation
↳ hrefstringLink target
↳ methodstringHTTP method
↳ namestringLink name

sap_concur_list_users

List Concur user identities (GET /profile/identity/v4.1/Users).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
countnumberNeinMax number of users to return (default 100, max 1000)
cursorstringNeinSCIM v4.1 pagination cursor returned by a prior call
attributesstringNeinComma-separated list of attributes to include in the response
excludedAttributesstringNeinComma-separated list of attributes to exclude from the response

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonSCIM ListResponse with Resources array

sap_concur_move_travel_request

Move a travel request through workflow (POST /travelrequest/v4/requests/{requestUuid}/{action}). Valid actions: submit, recall, cancel, approve, sendback, close, reopen.

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
requestUuidstringJaTravel request UUID
actionstringJaWorkflow action: submit, recall, cancel, approve, sendback, close, reopen
userIdstringNeinOptional Concur user UUID — required when impersonating another user
bodyjsonNeinOptional payload (e.g., { "comment": "..." })

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonWorkflow transition response payload
↳ idstringTravel request UUID
↳ hrefstringResource hyperlink
↳ approvalStatusjsonApproval status after the workflow transition
↳ codestringStatus code (NOT_SUBMITTED, SUBMITTED, APPROVED, CANCELED, SENTBACK)
↳ namestringLocalized status name
↳ approverjsonApprover assigned after the transition
↳ idstringUser UUID
↳ firstNamestringApprover first name
↳ lastNamestringApprover last name
↳ operationsarrayAvailable follow-up workflow actions
↳ relstringLink relation
↳ hrefstringLink target
↳ methodstringHTTP method
↳ namestringLink name

sap_concur_recall_expense_report

Recall a submitted expense report (PATCH /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/recall — supported contexts: TRAVELER, PROXY). No request body is required.

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID who owns the report
contextTypestringJaAccess context: TRAVELER or PROXY
reportIdstringJaExpense report ID to recall
bodyjsonNeinOptional body. Concur docs don't define a payload for this action; pass an empty object if uncertain.

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_remove_all_attendees

Remove all attendees from an expense (DELETE /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/expenses/{expenseId}/attendees).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER or PROXY
reportIdstringJaExpense report ID
expenseIdstringJaExpense ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty response body (Concur returns 204 No Content)

sap_concur_search_locations

Search Concur location reference data (GET /localities/v5/locations).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
searchTextstringNeinFree-text query (city, airport, landmark, etc.)
locCodestringNeinIATA / location code
locationNameIdstringNeinConcur internal location name ID (UUID)
locationNameKeynumberNeinConcur internal numeric location name key
countryCodestringNein2-letter ISO 3166-1 country code
subdivisionCodestringNeinISO 3166-2:2007 country subdivision (e.g. US-WA)
adminRegionIdstringNeinAdministrative region ID

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonLocalities v5 search response
↳ locationsarrayArray of matching Location records
↳ idstringLocation ID (UUID)
↳ codestringIATA / location code
↳ legacyKeynumberLegacy numeric location key
↳ timeZoneOffsetstringIANA timezone or UTC offset
↳ activebooleanWhether the location is active
↳ pointjsonGeographic coordinates
↳ latitudenumberLatitude
↳ longitudenumberLongitude
↳ namesarrayLocalized location names
↳ idstringName ID
↳ keynumberNumeric name key
↳ localestringLocale tag
↳ namestringDisplay name
↳ administrativeRegionjsonAdministrative region (e.g., metro area)
↳ idstringRegion ID
↳ namestringRegion name
↳ countryjsonCountry reference
↳ idstringCountry ID
↳ codestringISO country code
↳ namestringCountry name
↳ subDivisionjsonCountry subdivision (state/province)
↳ idstringSubdivision ID
↳ codestringISO subdivision code
↳ namestringSubdivision name
↳ linksarrayHATEOAS links

sap_concur_search_users

Search users via SCIM .search endpoint (POST /profile/identity/v4.1/Users/.search).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
bodyjsonJaSCIM search request payload ({ schemas, attributes, filter, count, startIndex })

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonSCIM search ListResponse

sap_concur_send_back_expense_report

Send back an expense report to the employee (PATCH /expensereports/v4/reports/{reportId}/sendBack). Required body field: comment.

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
reportIdstringJaExpense report ID to send back
bodyjsonJaRequest body — comment is required by Concur (e.g., { "comment": "Missing receipt" }). Optional fields: expectedStepCode, expectedStepSequence.

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_submit_expense_report

Submit an expense report into the workflow via Expense Report v4 (PATCH /expensereports/v4/users/{userId}/reports/{reportId}/submit).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID who owns the report
reportIdstringJaExpense report ID to submit
bodyjsonNeinOptional body. Concur docs don't define a payload for this action; pass an empty object if uncertain.

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_update_allocation

Update an allocation (PATCH /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/allocations/{allocationId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID
contextTypestringJaAccess context: TRAVELER or PROXY (write requires expense.report.readwrite)
reportIdstringJaExpense report ID
allocationIdstringJaAllocation ID to update
bodyjsonJaFields to update on the allocation

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty body on success (Concur returns 204 No Content)

sap_concur_update_expected_expense

Update an expected expense (PUT /travelrequest/v4/expenses/{expenseUuid}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
expenseUuidstringJaExpected expense UUID to update
userIdstringNeinUser UUID acting on the request (required when using a Company JWT, optional otherwise)
bodyjsonJaFields to update on the expected expense

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonUpdated expected expense payload
↳ idstringExpected expense identifier
↳ hrefstringSelf-link
↳ expenseTypejsonExpense type {id, name}
↳ transactionDatestringTransaction date
↳ transactionAmountjsonTransaction amount {value, currencyCode}
↳ postedAmountjsonPosted amount {value, currencyCode}
↳ approvedAmountjsonApproved amount {value, currencyCode}
↳ remainingAmountjsonRemaining amount on the expected expense
↳ businessPurposestringBusiness purpose of the expense
↳ locationjsonLocation {id, name, city, countryCode, countrySubDivisionCode, iataCode, locationType}
↳ exchangeRatejsonExchange rate {value, operation}
↳ allocationsjsonBudget allocations array
↳ tripDatajsonTrip data {agencyBooked, selfBooked, tripType (ONE_WAY|ROUND_TRIP), legs[{id, returnLeg, startDate, startTime, startLocationDetail, startLocation, endLocation, class {code,value}, travelExceptionReasonCodes}], segmentType {category, code}}
↳ parentRequestjsonParent travel request resource link {href, id}
↳ commentsjsonComments sub-resource link {href, id}

sap_concur_update_expense

Update an expense (PATCH /expensereports/v4/reports/{reportId}/expenses/{expenseId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
reportIdstringJaExpense report ID
expenseIdstringJaExpense ID to update
bodyjsonJaPATCH body. Allowed fields: businessPurpose (string, max 64), customData (CustomData[]), expenseSource (required: EA|MOB|OTHER|SE|TA|TR|UI), isExpenseRejected (boolean), isPaperReceiptReceived (boolean).

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty body on success (HTTP 204 No Content). Error details when status is non-2xx

sap_concur_update_expense_report

Update an unsubmitted expense report (PATCH /expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId} — supported contexts: TRAVELER, PROXY). Body fields: businessPurpose, comment, customData, name, etc.

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID who owns the report
contextTypestringJaAccess context: TRAVELER (own report) or PROXY (editing on behalf of another user)
reportIdstringJaExpense report ID to update
bodyjsonJaFields to update on the report

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_update_list_item

Update a list item (PUT /list/v4/items/{itemId}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
itemIdstringJaList item UUID
bodyjsonJaList item payload. Required: shortCode, value. Other fields in the body are ignored.

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonUpdated list item
↳ idstringList item UUID
↳ codestringLong code format for the item
↳ shortCodestringShort code identifier
↳ valuestringDisplay value of the item
↳ parentIdstringParent item UUID (omitted for first-level items)
↳ levelnumberHierarchy level (1 for root items)
↳ isDeletedbooleanDeletion status across all containing lists
↳ listsarrayLists containing this item
↳ idstringList UUID
↳ hasChildrenbooleanWhether this item has children in the list

sap_concur_update_travel_request

Update a travel request (PUT /travelrequest/v4/requests/{requestUuid}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
requestUuidstringJaTravel request UUID to update
bodyjsonJaFields to update on the travel request

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonUpdated travel request payload
↳ idstringTravel request UUID
↳ hrefstringResource hyperlink
↳ requestIdstringPublic-facing request ID (4-6 alphanumeric characters)
↳ namestringRequest name
↳ businessPurposestringBusiness purpose
↳ commentstringLast attached comment
↳ creationDatestringCreation timestamp
↳ lastModifiedstringLast modification timestamp
↳ submitDatestringLast submission timestamp
↳ startDatestringTrip start date (ISO 8601)
↳ endDatestringTrip end date (ISO 8601)
↳ startTimestringTrip start time (HH:mm)
↳ endTimestringTrip end time (HH:mm)
↳ approvedbooleanWhether the request is approved
↳ pendingApprovalbooleanPending approval flag
↳ closedbooleanClosed flag
↳ everSentBackbooleanEver-sent-back flag
↳ canceledPostApprovalbooleanCanceled after approval flag
↳ approvalStatusjsonApproval status
↳ codestringStatus code (NOT_SUBMITTED, SUBMITTED, APPROVED, CANCELED, SENTBACK)
↳ namestringLocalized status name
↳ ownerjsonTravel request owner
↳ idstringUser UUID
↳ firstNamestringOwner first name
↳ lastNamestringOwner last name
↳ approverjsonApprover assigned to the request
↳ idstringUser UUID
↳ firstNamestringApprover first name
↳ lastNamestringApprover last name
↳ policyjsonResource link to the applicable policy
↳ idstringPolicy ID
↳ hrefstringPolicy hyperlink
↳ typejsonRequest type
↳ codestringRequest type code
↳ labelstringRequest type label
↳ mainDestinationjsonMain destination of the trip
↳ citystringCity
↳ countryCodestringISO country code
↳ countrySubDivisionCodestringISO country sub-division code
↳ namestringDestination name
↳ totalApprovedAmountjsonTotal approved amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ totalPostedAmountjsonTotal posted amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ totalRemainingAmountjsonTotal remaining amount
↳ valuenumberAmount value
↳ currencystringCurrency code
↳ operationsarrayAvailable workflow actions

sap_concur_update_user

Patch a user identity (PATCH /profile/identity/v4.1/Users/{id}).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userUuidstringJaUser UUID to update
bodyjsonJaSCIM PATCH operations payload ({ schemas, Operations: [...] })

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonUpdated SCIM User payload

sap_concur_upload_receipt_image

Upload an image-only receipt (POST /receipts/v4/users/{userId}/image-only-receipts).

Eingabe

ParameterTypErforderlichBeschreibung
datacenterstringNeinConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringNeinOAuth grant type: client_credentials (default) or password
clientIdstringJaConcur OAuth client ID
clientSecretstringJaConcur OAuth client secret
usernamestringNeinUsername (only for password grant)
passwordstringNeinPassword (only for password grant)
companyUuidstringNeinCompany UUID for multi-company access tokens
userIdstringJaConcur user UUID who owns the receipt
receiptjsonJaReceipt image file (UserFile reference). Supported formats: PDF, PNG, JPEG, GIF, TIFF
forwardIdstringNeinOptional client-supplied dedup id (max 40 chars). Sent as the concur-forwardid header.

Ausgabe

ParameterTypBeschreibung
statusnumberHTTP status code returned by Concur
datajsonImage-only receipt upload response (HTTP 202 Accepted; Location and Link response headers exposed in body)
↳ locationstringLocation header URL for the new receipt image (e.g. /receipts/v4/images/{receiptId})
↳ linkstringLink header URL pointing to /receipts/v4/status/{receiptId}

On this page

Nutzungsanweisungen
Tools
sap_concur_approve_expense_report
Eingabe
Ausgabe
sap_concur_associate_attendees
Eingabe
Ausgabe
sap_concur_create_cash_advance
Eingabe
Ausgabe
sap_concur_create_expected_expense
Eingabe
Ausgabe
sap_concur_create_expense_report
Eingabe
Ausgabe
sap_concur_create_list_item
Eingabe
Ausgabe
sap_concur_create_purchase_request
Eingabe
Ausgabe
sap_concur_create_quick_expense
Eingabe
Ausgabe
sap_concur_create_quick_expense_with_image
Eingabe
Ausgabe
sap_concur_create_report_comment
Eingabe
Ausgabe
sap_concur_create_travel_request
Eingabe
Ausgabe
sap_concur_create_user
Eingabe
Ausgabe
sap_concur_delete_expected_expense
Eingabe
Ausgabe
sap_concur_delete_expense
Eingabe
Ausgabe
sap_concur_delete_expense_report
Eingabe
Ausgabe
sap_concur_delete_list_item
Eingabe
Ausgabe
sap_concur_delete_travel_request
Eingabe
Ausgabe
sap_concur_delete_user
Eingabe
Ausgabe
sap_concur_get_allocation
Eingabe
Ausgabe
sap_concur_get_budget
Eingabe
Ausgabe
sap_concur_get_cash_advance
Eingabe
Ausgabe
sap_concur_upload_exchange_rates
Eingabe
Ausgabe
sap_concur_get_expected_expense
Eingabe
Ausgabe
sap_concur_get_expense
Eingabe
Ausgabe
sap_concur_get_expense_report
Eingabe
Ausgabe
sap_concur_get_itemizations
Eingabe
Ausgabe
sap_concur_get_itinerary
Eingabe
Ausgabe
sap_concur_get_list
Eingabe
Ausgabe
sap_concur_get_list_item
Eingabe
Ausgabe
sap_concur_get_purchase_request
Eingabe
Ausgabe
sap_concur_get_receipt
Eingabe
Ausgabe
sap_concur_get_receipt_status
Eingabe
Ausgabe
sap_concur_get_travel_profile
Eingabe
Ausgabe
sap_concur_get_travel_request
Eingabe
Ausgabe
sap_concur_get_user
Eingabe
Ausgabe
sap_concur_issue_cash_advance
Eingabe
Ausgabe
sap_concur_list_allocations
Eingabe
Ausgabe
sap_concur_list_attendee_associations
Eingabe
Ausgabe
sap_concur_list_budget_categories
Eingabe
Ausgabe
sap_concur_list_budgets
Eingabe
Ausgabe
sap_concur_list_exceptions
Eingabe
Ausgabe
sap_concur_list_expected_expenses
Eingabe
Ausgabe
sap_concur_list_expenses
Eingabe
Ausgabe
sap_concur_list_expense_reports
Eingabe
Ausgabe
sap_concur_list_itineraries
Eingabe
Ausgabe
sap_concur_list_lists
Eingabe
Ausgabe
sap_concur_list_list_items
Eingabe
Ausgabe
sap_concur_list_receipts
Eingabe
Ausgabe
sap_concur_list_report_comments
Eingabe
Ausgabe
sap_concur_list_reports_to_approve
Eingabe
Ausgabe
sap_concur_get_request_cash_advance
Eingabe
Ausgabe
sap_concur_list_travel_profiles_summary
Eingabe
Ausgabe
sap_concur_list_travel_request_comments
Eingabe
Ausgabe
sap_concur_list_travel_requests
Eingabe
Ausgabe
sap_concur_list_users
Eingabe
Ausgabe
sap_concur_move_travel_request
Eingabe
Ausgabe
sap_concur_recall_expense_report
Eingabe
Ausgabe
sap_concur_remove_all_attendees
Eingabe
Ausgabe
sap_concur_search_locations
Eingabe
Ausgabe
sap_concur_search_users
Eingabe
Ausgabe
sap_concur_send_back_expense_report
Eingabe
Ausgabe
sap_concur_submit_expense_report
Eingabe
Ausgabe
sap_concur_update_allocation
Eingabe
Ausgabe
sap_concur_update_expected_expense
Eingabe
Ausgabe
sap_concur_update_expense
Eingabe
Ausgabe
sap_concur_update_expense_report
Eingabe
Ausgabe
sap_concur_update_list_item
Eingabe
Ausgabe
sap_concur_update_travel_request
Eingabe
Ausgabe
sap_concur_update_user
Eingabe
Ausgabe
sap_concur_upload_receipt_image
Eingabe
Ausgabe