AptlyStar

SAP Concur

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

使用方法

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.

ツール

sap_concur_approve_expense_report

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

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
reportIdstringはいExpense report ID to approve
bodyjsonはいRequest 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").

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER or PROXY
reportIdstringはいExpense report ID
expenseIdstringはいExpense ID
bodyjsonはいAttendee associations payload (e.g., { "attendeeAssociations": [...] })

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
bodyjsonはいCash advance payload

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
requestUuidstringはいTravel request UUID
userIdstringいいえUser UUID acting on the request (required when using a Company JWT, optional otherwise)
bodyjsonはいExpected expense payload

出力

パラメータ型説明
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.

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID who will own the report
contextTypestringはいAccess context: TRAVELER (creating own report) or PROXY (creating on behalf of another user)
bodyjsonはいReport payload — name and policyId are required. Optional fields: businessPurpose, comment, customData, countryCode, countrySubDivisionCode, etc.

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
bodyjsonはいList item payload. Required: listId, shortCode, value. Optional: parentId or parentCode (mutually exclusive). Note: Concur rejects shortCode/value containing hyphens.

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
bodyjsonはいPurchase request payload

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID who owns the quick expense
contextTypestringはいAccess context: must be TRAVELER
bodyjsonはいQuick expense payload (expenseTypeId, transactionAmount, transactionDate, etc.)

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: must be TRAVELER
receiptjsonはいReceipt image (UserFile). Allowed: PDF, PNG, JPEG, TIFF (max 50MB)
bodyjsonはいQuick expense payload (transactionAmount, transactionDate, expenseTypeId, vendor, ...)

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER or PROXY
reportIdstringはいExpense report ID
commentstringはいComment text to add

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringいいえOptional Concur user UUID — required when impersonating another user
bodyjsonはいTravel request payload (name, purpose, startDate, endDate, requestPolicyId, etc.)

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
bodyjsonはいSCIM User payload (schemas, userName, name, emails, active, etc.)

出力

パラメータ型説明
statusnumberHTTP status code returned by Concur
datajsonCreated SCIM User payload

sap_concur_delete_expected_expense

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

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
expenseUuidstringはいExpected expense UUID to delete
userIdstringいいえUser UUID acting on the request (required when using a Company JWT, optional otherwise)

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
reportIdstringはいExpense report ID
expenseIdstringはいExpense ID to delete

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
reportIdstringはいExpense report ID to delete

出力

パラメータ型説明
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_delete_list_item

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

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
itemIdstringはいList item UUID

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
requestUuidstringはいTravel request UUID to delete
userIdstringいいえOptional Concur user UUID — required when impersonating another user

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userUuidstringはいUser UUID to delete

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER or PROXY
reportIdstringはいExpense report ID
allocationIdstringはいAllocation ID

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
budgetIdstringはいBudget item header ID (syncguid)

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
cashAdvanceIdstringはいCash advance ID

出力

パラメータ型説明
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.

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
bodyjsonはいBulk upload body: { currency_sets: [{ from_crn_code, to_crn_code, start_date: "YYYY-MM-DD", rate }] } (max 100 entries)

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
expenseUuidstringはいExpected expense UUID
userIdstringいいえUser UUID acting on the request (optional)

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringはいExpense report ID
expenseIdstringはいExpense ID

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID who owns the report
contextTypestringはいAccess context: TRAVELER (own report), MANAGER (report under approval), PROCESSOR, or PROXY
reportIdstringはいExpense report ID

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringはいExpense report ID
expenseIdstringはいExpense ID

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
tripIdstringはいTrip ID
useridTypestringいいえUser identifier type (login, xmlsyncid, uuid)
useridValuestringいいえUser identifier value (paired with useridType)
systemFormatstringいいえOptional system format (e.g., GDS) for the response

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
listIdstringはいList ID

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
itemIdstringはいList item ID

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
purchaseRequestIdstringはいPurchase request ID

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
receiptIdstringはいReceipt ID

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
receiptIdstringはいReceipt ID

出力

パラメータ型説明
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.

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
useridTypestringいいえIdentifier type: login, xmlsyncid, or uuid
useridValuestringいいえIdentifier value (login id, xml sync id, or UUID)

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
requestUuidstringはいTravel request UUID
userIdstringいいえOptional Concur user UUID — required when impersonating another user

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userUuidstringはいUser UUID
attributesstringいいえComma-separated SCIM attributes to include in the response
excludedAttributesstringいいえComma-separated SCIM attributes to exclude from the response

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
cashAdvanceIdstringはいCash advance ID to issue
bodyjsonいいえOptional request body

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER or PROXY
reportIdstringはいExpense report ID
expenseIdstringはいExpense ID

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER or PROXY
reportIdstringはいExpense report ID
expenseIdstringはいExpense ID

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens

出力

パラメータ型説明
statusnumberHTTP status code returned by Concur
datajsonBudget categories collection payload

sap_concur_list_budgets

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

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
adminViewbooleanいいえWhen true, returns all budgets the caller can administer (default false)
offsetnumberいいえPage offset (Concur returns up to 50 budget headers per page)
responseSchemastringいいえResponse schema variant: "COMPACT" returns a smaller payload

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringはいExpense report ID

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
requestUuidstringはいTravel request UUID
userIdstringいいえUser UUID acting on the request (optional)

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER, MANAGER, or PROXY
reportIdstringはいExpense report ID

出力

パラメータ型説明
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.

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (us, us2, eu, eu2, cn, emea — defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userstringいいえFilter by a specific user (login id or user identifier).
submitDateBeforestringいいえFilter to reports submitted on or before this date (YYYY-MM-DD)
submitDateAfterstringいいえFilter to reports submitted on or after this date (YYYY-MM-DD)
paidDateBeforestringいいえFilter to reports paid on or before this date (YYYY-MM-DD)
paidDateAfterstringいいえFilter to reports paid on or after this date (YYYY-MM-DD)
modifiedDateBeforestringいいえFilter to reports last modified on or before this date (YYYY-MM-DD)
modifiedDateAfterstringいいえFilter to reports last modified on or after this date (YYYY-MM-DD)
createDateBeforestringいいえFilter to reports created on or before this date (YYYY-MM-DD)
createDateAfterstringいいえFilter to reports created on or after this date (YYYY-MM-DD)
approvalStatusCodestringいいえFilter by approval status code (e.g. A_NOTF, A_PEND, A_APPR)
paymentStatusCodestringいいえFilter by payment status code
currencyCodestringいいえFilter by ISO currency code (e.g. USD, EUR)
approverLoginIDstringいいえFilter by approver login ID
limitnumberいいえNumber of records per page (default 25, max 100)
offsetstringいいえOpaque cursor token returned by a prior call (NextPage).

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
startDatestringいいえFilter trips starting on/after this date (YYYY-MM-DD)
endDatestringいいえFilter trips ending on/before this date (YYYY-MM-DD)
bookingTypestringいいえFilter by booking type (air, car, hotel, rail, etc.)
useridTypestringいいえUser identifier type (login, xmlsyncid, uuid)
useridValuestringいいえUser identifier value (paired with useridType)
itemsPerPagenumberいいえItems per page
pagenumberいいえ1-based page number
includeMetadatabooleanいいえInclude paging metadata in the response
includeCanceledTripsbooleanいいえInclude canceled trips in the result set
createdAfterDatestringいいえOnly trips created after this date (YYYY-MM-DD)
createdBeforeDatestringいいえOnly trips created before this date (YYYY-MM-DD)
lastModifiedDatestringいいえOnly trips modified on/after this date (YYYY-MM-DD)

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
pagenumberいいえPage number (1-based; page size is fixed at 100)
sortBystringいいえSort field: name, levelcount, or listcategory
sortDirectionstringいいえSort direction: asc or desc
valuestringいいえFilter by list name
categoryTypestringいいえFilter by category type (mapped to category.type query param)
isDeletedbooleanいいえInclude deleted lists
levelCountnumberいいえFilter by number of levels

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
listIdstringはいList ID
pagenumberいいえPage number (1-based; page size is fixed at 100)
sortBystringいいえSort field: value or shortCode
sortDirectionstringいいえSort direction: asc or desc
hasChildrenbooleanいいえInclude only items that have children
isDeletedbooleanいいえInclude deleted items
shortCodestringいいえFilter by short code
valuestringいいえFilter by display value
shortCodeOrValuestringいいえFilter by short code OR value

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER or PROXY
reportIdstringはいExpense report ID
includeAllCommentsbooleanいいえInclude comments from all expenses in the report (default false)

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいManager user UUID
contextTypestringいいえAccess context: must be MANAGER (default)
sortstringいいえReport field name to sort by (e.g., reportDate)
orderstringいいえSort direction: asc or desc
includeDelegateApprovalsbooleanいいえWhether to include reports the caller can approve as a delegate

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
cashAdvanceUuidstringはいCash advance UUID (returned as part of a travel request)

出力

パラメータ型説明
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.

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
lastModifiedDatestringはいRequired UTC datetime in YYYY-MM-DDThh:mm:ss format
pagenumberいいえ1-based page number
itemsPerPagenumberいいえItems per page (max 200)
travelConfigsstringいいえComma-separated travel configuration ids

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
requestUuidstringはいTravel request UUID

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
viewstringいいえView filter (e.g., ALL, ACTIVE, PENDING, TOAPPROVE)
limitnumberいいえMax number of results per page
startnumberいいえPage start cursor (offset)
userIdstringいいえFilter by Concur user UUID
approvedBeforestringいいえISO 8601 date — return requests approved before this date
approvedAfterstringいいえISO 8601 date — return requests approved after this date
modifiedBeforestringいいえISO 8601 date — return requests modified before this date
modifiedAfterstringいいえISO 8601 date — return requests modified after this date
sortFieldstringいいえField to sort by: startDate, approvalStatus, or requestId (default startDate)
sortOrderstringいいえSort order: ASC or DESC (default DESC)

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
countnumberいいえMax number of users to return (default 100, max 1000)
cursorstringいいえSCIM v4.1 pagination cursor returned by a prior call
attributesstringいいえComma-separated list of attributes to include in the response
excludedAttributesstringいいえComma-separated list of attributes to exclude from the response

出力

パラメータ型説明
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.

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
requestUuidstringはいTravel request UUID
actionstringはいWorkflow action: submit, recall, cancel, approve, sendback, close, reopen
userIdstringいいえOptional Concur user UUID — required when impersonating another user
bodyjsonいいえOptional payload (e.g., { "comment": "..." })

出力

パラメータ型説明
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.

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID who owns the report
contextTypestringはいAccess context: TRAVELER or PROXY
reportIdstringはいExpense report ID to recall
bodyjsonいいえOptional body. Concur docs don't define a payload for this action; pass an empty object if uncertain.

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER or PROXY
reportIdstringはいExpense report ID
expenseIdstringはいExpense ID

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
searchTextstringいいえFree-text query (city, airport, landmark, etc.)
locCodestringいいえIATA / location code
locationNameIdstringいいえConcur internal location name ID (UUID)
locationNameKeynumberいいえConcur internal numeric location name key
countryCodestringいいえ2-letter ISO 3166-1 country code
subdivisionCodestringいいえISO 3166-2:2007 country subdivision (e.g. US-WA)
adminRegionIdstringいいえAdministrative region ID

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
bodyjsonはいSCIM search request payload ({ schemas, attributes, filter, count, startIndex })

出力

パラメータ型説明
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.

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
reportIdstringはいExpense report ID to send back
bodyjsonはいRequest body — comment is required by Concur (e.g., { "comment": "Missing receipt" }). Optional fields: expectedStepCode, expectedStepSequence.

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID who owns the report
reportIdstringはいExpense report ID to submit
bodyjsonいいえOptional body. Concur docs don't define a payload for this action; pass an empty object if uncertain.

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID
contextTypestringはいAccess context: TRAVELER or PROXY (write requires expense.report.readwrite)
reportIdstringはいExpense report ID
allocationIdstringはいAllocation ID to update
bodyjsonはいFields to update on the allocation

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
expenseUuidstringはいExpected expense UUID to update
userIdstringいいえUser UUID acting on the request (required when using a Company JWT, optional otherwise)
bodyjsonはいFields to update on the expected expense

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
reportIdstringはいExpense report ID
expenseIdstringはいExpense ID to update
bodyjsonはいPATCH body. Allowed fields: businessPurpose (string, max 64), customData (CustomData[]), expenseSource (required: EA|MOB|OTHER|SE|TA|TR|UI), isExpenseRejected (boolean), isPaperReceiptReceived (boolean).

出力

パラメータ型説明
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.

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID who owns the report
contextTypestringはいAccess context: TRAVELER (own report) or PROXY (editing on behalf of another user)
reportIdstringはいExpense report ID to update
bodyjsonはいFields to update on the report

出力

パラメータ型説明
statusnumberHTTP status code returned by Concur
datajsonEmpty (204 No Content)

sap_concur_update_list_item

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

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
itemIdstringはいList item UUID
bodyjsonはいList item payload. Required: shortCode, value. Other fields in the body are ignored.

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
requestUuidstringはいTravel request UUID to update
bodyjsonはいFields to update on the travel request

出力

パラメータ型説明
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}).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userUuidstringはいUser UUID to update
bodyjsonはいSCIM PATCH operations payload ({ schemas, Operations: [...] })

出力

パラメータ型説明
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).

入力

パラメータ型必須説明
datacenterstringいいえConcur datacenter base URL (defaults to us.api.concursolutions.com)
grantTypestringいいえOAuth grant type: client_credentials (default) or password
clientIdstringはいConcur OAuth client ID
clientSecretstringはいConcur OAuth client secret
usernamestringいいえUsername (only for password grant)
passwordstringいいえPassword (only for password grant)
companyUuidstringいいえCompany UUID for multi-company access tokens
userIdstringはいConcur user UUID who owns the receipt
receiptjsonはいReceipt image file (UserFile reference). Supported formats: PDF, PNG, JPEG, GIF, TIFF
forwardIdstringいいえOptional client-supplied dedup id (max 40 chars). Sent as the concur-forwardid header.

出力

パラメータ型説明
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

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