> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/sap-concur.md).

# SAP Concur

Read and manage SAP Concur expense reports, entries, receipts, and submissions.

## Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector  | Authentication |
| ---------- | -------------- |
| SAP Concur | Credentials    |

### SAP Concur

Connect to SAP Concur with a Client ID, Client Secret, and Refresh Token from the Concur Authentication Admin app. The access token is minted and refreshed automatically.

#### Set up in SAP Concur

1. Prepare the SAP Concur account or service that the workflow will access. Grant access to the required resources and operations.
2. **Client ID:** The Client ID of the OAuth application registered in SAP Concur's Authentication Admin app (App Center > Authentication Admin).

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **SAP Concur**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field   | Required                 | What to enter                                                                                                                                                                                                                            |
| --------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Refresh Token   | Yes                      | A refresh token issued for this client, e.g. via the Concur Authentication Admin app's refresh token generator. Valid for 6 months of inactivity; Concur may rotate it on each use, in which case the new value is stored automatically. |
| Client Secret   | Yes                      | The Client Secret paired with the Client ID above.                                                                                                                                                                                       |
| Client ID       | Yes                      | The Client ID of the OAuth application registered in SAP Concur's Authentication Admin app (App Center > Authentication Admin).                                                                                                          |
| Datacenter Host | Optional / as applicable | Bootstrap host for the first token request only. After that, every request uses the tenant-specific host Concur returns (geolocation). Only change this if your company was not provisioned on us2.                                      |

### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

## Use an action

1. Add the required **SAP Concur** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### List Expense Reports

Find expense reports by owner, approval status, payment status, dates, and more. Use it to pull unsubmitted, pending, or paid reports.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field                          | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------ | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Report owner                   | string          | No       | The employee whose reports to fetch (their Concur login ID, usually their email). Defaults to ALL (every user's reports).                                                                                                                                                                                                                                                                                                                                                                    |
| Approval status                | select (string) | No       | Filter by where the report is in the approval flow. 'A\_NOTF' means not yet submitted (drafts), 'A\_PEND' means awaiting manager approval, 'A\_APPR' means approved. Available values: Not submitted (draft), Submitted, Pending manager approval, Approved, Needs resubmission, Pending reviews, Pending external validation, Pending budget approval, Pending cost object approval, Pending prepayment validation, Pending receipt images, Expired in approval queue, Anomaly/fraud check. |
| Payment status                 | select (string) | No       | Filter by whether the report has been paid. Available values: Not paid, Processing payment, Payment confirmed, Paid.                                                                                                                                                                                                                                                                                                                                                                         |
| Currency                       | string          | No       | Only return reports in this currency.                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Country                        | string          | No       | Only return reports for this country.                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Expense type code              | select (string) | No       | Only return reports containing entries of this expense type. Options load from the selected connection.                                                                                                                                                                                                                                                                                                                                                                                      |
| Vendor name                    | string          | No       | Only return reports containing entries from this vendor.                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Current approver               | string          | No       | Only return reports sitting with this approver.                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Reimbursement method           | select (string) | No       | Only return reports reimbursed a certain way (payroll, check, Concur Pay, payment service). Available values: ADP payroll, AP check, Concur Pay, Payment service.                                                                                                                                                                                                                                                                                                                            |
| Has receipt images             | boolean         | No       | Only reports that do (or do not) have receipt images attached.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Has attendees                  | boolean         | No       | Only reports whose entries do (or do not) list attendees.                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Has VAT details                | boolean         | No       | Only reports with (or without) VAT details.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Has billable expenses          | boolean         | No       | Only reports with (or without) billable expenses.                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Created after                  | string          | No       | Only reports created on or after this date. Dates here are report dates, not transaction dates.                                                                                                                                                                                                                                                                                                                                                                                              |
| Created before                 | string          | No       | Only reports created before this date.                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Submitted after                | string          | No       | Only reports submitted on or after this date.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Submitted before               | string          | No       | Only reports submitted before this date.                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Modified after                 | string          | No       | Only reports changed on or after this date. Useful for incremental syncs.                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Modified before                | string          | No       | Only reports changed before this date.                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Paid after                     | string          | No       | Only reports paid on or after this date.                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Paid before                    | string          | No       | Only reports paid before this date.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Entry transaction date after   | string          | No       | Only reports containing expense entries dated on or after this date (the actual purchase date).                                                                                                                                                                                                                                                                                                                                                                                              |
| Entry transaction date before  | string          | No       | Only reports containing expense entries dated before this date.                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Expense group configuration ID | string          | No       | Only reports under a specific expense group configuration (policy group). Get IDs from List Expense Group Configurations.                                                                                                                                                                                                                                                                                                                                                                    |
| Payment batch ID               | string          | No       | Only reports in a specific payment batch.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Max results                    | integer         | No       | How many reports to return at most.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Cursor                         | string          | No       | Continue a previous listing from where it left off.                                                                                                                                                                                                                                                                                                                                                                                                                                          |

#### Outputs

| Field       | Type          | Description                                                                                                           |
| ----------- | ------------- | --------------------------------------------------------------------------------------------------------------------- |
| Reports     | object\_array | The matching expense reports with ID, name, owner, totals, approval and payment status, policy ID, and custom fields. |
| Next cursor | string        | Pass back as Cursor to fetch the next page; empty when there are no more results.                                     |

### Get Expense Report

Fetch one expense report by its ID, including totals, statuses, policy, and custom fields.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field        | Type   | Required | Description                                                                                                     |
| ------------ | ------ | -------- | --------------------------------------------------------------------------------------------------------------- |
| Report ID    | string | Yes      | The expense report to fetch. Get it from List Expense Reports.                                                  |
| Report owner | string | No       | The employee who owns the report (their Concur login ID). 'ALL' is not accepted here - name the specific owner. |

#### Outputs

| Field  | Type   | Description                                                                                          |
| ------ | ------ | ---------------------------------------------------------------------------------------------------- |
| Report | object | The full report: name, owner, totals, approval and payment status, dates, policy, and custom fields. |

### Create Expense Report

Create a new (draft) expense report for the connected Concur account. Entries are added afterwards with Create Expense Entry.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field                | Type    | Required | Description                                                                                                          |
| -------------------- | ------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
| Report name          | string  | Yes      | A short name for the report, e.g. the trip or the month it covers.                                                   |
| Show advanced fields | boolean | No       | Reveal currency, country, report date, and custom fields. Default: false.                                            |
| Currency             | string  | No       | Report currency if different from the owner's default.                                                               |
| Country              | string  | No       | Country the report applies to.                                                                                       |
| Report date          | string  | No       | A date shown on the report, e.g. the period it covers.                                                               |
| Custom field 1       | string  | No       | Company-specific report field 1. Many companies use custom fields for legal entity, fund, or cost-center allocation. |
| Custom field 2       | string  | No       | Company-specific report field 2.                                                                                     |
| Custom field 3       | string  | No       | Company-specific report field 3.                                                                                     |
| Custom field 4       | string  | No       | Company-specific report field 4.                                                                                     |
| Custom field 5       | string  | No       | Company-specific report field 5.                                                                                     |
| Custom field 6       | string  | No       | Company-specific report field 6.                                                                                     |

#### Outputs

| Field      | Type   | Description                 |
| ---------- | ------ | --------------------------- |
| Report ID  | string | The new report's ID.        |
| Report URI | string | API link to the new report. |

### Update Expense Report

Change a report's name, date, or company-specific custom fields (often used for allocations like legal entity or fund).

**Required permissions:** `EXPRPT`.

#### Inputs

| Field                | Type    | Required | Description                                                                       |
| -------------------- | ------- | -------- | --------------------------------------------------------------------------------- |
| Report ID            | string  | Yes      | The report to update. Get it from List Expense Reports.                           |
| Report name          | string  | No       | New name for the report.                                                          |
| Show advanced fields | boolean | No       | Reveal report owner, report date, and custom fields. Default: false.              |
| Report owner         | string  | No       | The employee who owns the report, if not the connected account.                   |
| Report date          | string  | No       | New report date.                                                                  |
| Custom field 1       | string  | No       | New value for company-specific report field 1 (often legal entity or allocation). |
| Custom field 2       | string  | No       | New value for custom field 2.                                                     |
| Custom field 3       | string  | No       | New value for custom field 3.                                                     |
| Custom field 4       | string  | No       | New value for custom field 4.                                                     |
| Custom field 5       | string  | No       | New value for custom field 5.                                                     |
| Custom field 6       | string  | No       | New value for custom field 6.                                                     |

#### Outputs

| Field          | Type   | Description                  |
| -------------- | ------ | ---------------------------- |
| Updated report | string | The report after the update. |

### List Expense Entries

List the line items (individual expenses) on a report, or search entries across reports by type, payment method, and more.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field              | Type            | Required | Description                                                                                                                                                                |
| ------------------ | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Report ID          | string          | No       | Only entries on this report. Get the ID from List Expense Reports.                                                                                                         |
| Entry owner        | string          | No       | The employee whose entries to fetch (their Concur login ID). Use ALL for every user.                                                                                       |
| Expense type code  | select (string) | No       | Only entries of this expense type. Options load from the selected connection.                                                                                              |
| Payment type ID    | select (string) | No       | Only entries paid with this payment type (e.g. company card vs out of pocket). IDs come from List Expense Group Configurations. Options load from the selected connection. |
| Billable only      | boolean         | No       | Only billable (or non-billable) entries.                                                                                                                                   |
| Has attendees      | boolean         | No       | Only entries with (or without) attendees.                                                                                                                                  |
| Has VAT            | boolean         | No       | Only entries with (or without) VAT details.                                                                                                                                |
| Attendee type code | string          | No       | Only entries with attendees of this type.                                                                                                                                  |
| Attendee ID        | string          | No       | Only entries that include a specific attendee.                                                                                                                             |
| Payment batch ID   | string          | No       | Only entries in a specific payment batch.                                                                                                                                  |
| Max results        | integer         | No       | How many entries to return at most.                                                                                                                                        |
| Cursor             | string          | No       | Continue a previous listing from where it left off.                                                                                                                        |

#### Outputs

| Field       | Type          | Description                                                                                                      |
| ----------- | ------------- | ---------------------------------------------------------------------------------------------------------------- |
| Entries     | object\_array | The expense line items, each with amount, date, vendor, expense type, receipt status, and card-transaction link. |
| Next cursor | string        | Pass back as Cursor to fetch the next page; empty when there are no more results.                                |

### Get Expense Entry

Fetch one expense line item by its ID, including amount, vendor, expense type, receipt status, and custom fields.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field       | Type   | Required | Description                                                                                                    |
| ----------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------- |
| Entry ID    | string | Yes      | The expense entry to fetch. Get it from List Expense Entries.                                                  |
| Entry owner | string | No       | The employee who owns the entry (their Concur login ID). 'ALL' is not accepted here - name the specific owner. |

#### Outputs

| Field              | Type   | Description                                                                                          |
| ------------------ | ------ | ---------------------------------------------------------------------------------------------------- |
| Entry              | object | The full expense entry.                                                                              |
| List field details | object | For dropdown (list-typed) custom fields: the display value plus the code and list item ID behind it. |

### Create Expense Entry

Add a new expense line item (a single purchase) to a report.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field                       | Type            | Required | Description                                                                                             |
| --------------------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------- |
| Report ID                   | string          | Yes      | The report to add the expense to. Get it from List Expense Reports or Create Expense Report.            |
| Expense type                | select (string) | Yes      | What kind of expense this is (e.g. lunch, hotel, taxi). Options load from the selected connection.      |
| Payment type                | select (string) | Yes      | How the expense was paid (company card, out of pocket, ...). Options load from the selected connection. |
| Amount                      | number          | Yes      | The amount of the expense.                                                                              |
| Currency                    | string          | Yes      | Currency of the amount.                                                                                 |
| Transaction date            | string          | Yes      | The date of the purchase.                                                                               |
| Entry owner                 | string          | No       | The employee the expense belongs to, if not the connected account.                                      |
| Description                 | string          | No       | A short note about the expense, e.g. 'Lunch with client in NYC'.                                        |
| Vendor                      | string          | No       | Who was paid, e.g. the restaurant or hotel name.                                                        |
| Show advanced fields        | boolean         | No       | Reveal billable/personal flags, comment, and custom fields. Default: false.                             |
| Billable                    | boolean         | No       | Whether this expense is billable to a client.                                                           |
| Personal (non-reimbursable) | boolean         | No       | Mark the expense as personal / non-reimbursable.                                                        |
| Comment                     | textarea        | No       | A longer comment for approvers.                                                                         |
| Custom field 1              | string          | No       | Company-specific entry field 1 (often used for allocations like legal entity or fund).                  |
| Custom field 2              | string          | No       | Company-specific entry field 2.                                                                         |
| Custom field 3              | string          | No       | Company-specific entry field 3.                                                                         |
| Custom field 4              | string          | No       | Company-specific entry field 4.                                                                         |
| Custom field 5              | string          | No       | Company-specific entry field 5.                                                                         |
| Custom field 6              | string          | No       | Company-specific entry field 6.                                                                         |

#### Outputs

| Field     | Type   | Description                |
| --------- | ------ | -------------------------- |
| Entry ID  | string | The new entry's ID.        |
| Entry URI | string | API link to the new entry. |

### Update Expense Entry

Edit an expense line item's description, comment, vendor, flags, or text custom fields. Cannot change the expense type.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field                       | Type     | Required | Description                                                                         |
| --------------------------- | -------- | -------- | ----------------------------------------------------------------------------------- |
| Entry ID                    | string   | Yes      | The expense entry to update. Get it from List Expense Entries.                      |
| Entry owner                 | string   | No       | The employee who owns the entry, if not the connected account.                      |
| Description                 | string   | No       | New short note about the expense.                                                   |
| Show advanced fields        | boolean  | No       | Reveal vendor, comment, billable/personal flags, and custom fields. Default: false. |
| Vendor                      | string   | No       | New vendor name.                                                                    |
| Comment                     | textarea | No       | New comment for approvers.                                                          |
| Billable                    | boolean  | No       | Change whether the expense is billable.                                             |
| Personal (non-reimbursable) | boolean  | No       | Change whether the expense is personal / non-reimbursable.                          |
| Custom field 1              | string   | No       | New value for company-specific entry field 1 (often allocation).                    |
| Custom field 2              | string   | No       | New value for custom field 2.                                                       |
| Custom field 3              | string   | No       | New value for custom field 3.                                                       |
| Custom field 4              | string   | No       | New value for custom field 4.                                                       |
| Custom field 5              | string   | No       | New value for custom field 5.                                                       |
| Custom field 6              | string   | No       | New value for custom field 6.                                                       |

#### Outputs

| Field         | Type   | Description                 |
| ------------- | ------ | --------------------------- |
| Updated entry | string | The entry after the update. |

### Change Expense Type

Recategorize an expense via Concur's v4 API. NOTE: SAP does not yet route this endpoint for API clients on all tenants; a 404 means the tenant is not enabled.

**Required permissions:** `expense.report.readwrite`.

#### Inputs

| Field           | Type   | Required | Description                                                                        |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------- |
| User ID (UUID)  | string | Yes      | The expense owner's Concur user UUID (from Get User ID).                           |
| Report ID       | string | Yes      | The report containing the expense. Get it from List Expense Reports.               |
| Expense ID (v4) | string | Yes      | The expense's v4 ID - the 'ExpenseID' field on the entry, not the long 'ID' token. |
| Expense type ID | string | Yes      | The new expense type for this expense.                                             |
| Context type    | string | No       | How the caller acts on the report: TRAVELER (default) or PROXY.                    |

#### Outputs

| Field  | Type   | Description                                     |
| ------ | ------ | ----------------------------------------------- |
| Status | string | Confirmation that the expense type was changed. |

### Get User ID

Look up a person's Concur user ID (UUID) from their login email.

**Required permissions:** `identity.user.ids.read`.

#### Inputs

| Field                  | Type   | Required | Description                                             |
| ---------------------- | ------ | -------- | ------------------------------------------------------- |
| Username (login email) | string | Yes      | The person's Concur login, usually their email address. |

#### Outputs

| Field          | Type    | Description                                      |
| -------------- | ------- | ------------------------------------------------ |
| User ID (UUID) | string  | The user's Concur UUID.                          |
| Username       | string  | The matched login, echoed back for confirmation. |
| Active         | boolean | Whether the user's Concur account is active.     |

### Get Expense Allocations

See how one expense is allocated across cost centers, funds, or projects - including the IDs needed to change the allocation.

**Required permissions:** `expense.report.read`.

#### Inputs

| Field           | Type   | Required | Description                                                     |
| --------------- | ------ | -------- | --------------------------------------------------------------- |
| User ID (UUID)  | string | Yes      | The expense owner's Concur user UUID (from Get User ID).        |
| Report ID       | string | Yes      | The report containing the expense.                              |
| Expense ID (v4) | string | Yes      | The expense's v4 ID (the 'ExpenseID' field, not 'ID').          |
| Context type    | string | No       | How the caller acts on the report: TRAVELER (default) or PROXY. |

#### Outputs

| Field       | Type          | Description                                                                                             |
| ----------- | ------------- | ------------------------------------------------------------------------------------------------------- |
| Allocations | object\_array | The expense's allocations, each with its percentage and the accounting fields (custom data) it carries. |

### Update Allocation

Change which cost center, fund, or project an expense's allocation points at.

**Required permissions:** `expense.report.readwrite`.

#### Inputs

| Field           | Type   | Required | Description                                                     |
| --------------- | ------ | -------- | --------------------------------------------------------------- |
| User ID (UUID)  | string | Yes      | The expense owner's Concur user UUID (from Get User ID).        |
| Report ID       | string | Yes      | The report containing the allocation.                           |
| Allocation ID   | string | Yes      | The allocation to change. Get it from Get Expense Allocations.  |
| Expense ID (v4) | string | Yes      | The expense this allocation belongs to (the 'ExpenseID' field). |
| Custom field    | string | Yes      | Which accounting field to set, e.g. 'custom2'.                  |
| Value           | string | Yes      | The new value - for dropdown fields, the list item's ID.        |
| Context type    | string | No       | How the caller acts on the report: TRAVELER (default) or PROXY. |

#### Outputs

| Field  | Type   | Description                                   |
| ------ | ------ | --------------------------------------------- |
| Status | string | Confirmation that the allocation was updated. |

### Update Expense Custom Field

Set a dropdown or text custom field on an expense - e.g. re-point the allocation field - using IDs the modern list API provides.

**Required permissions:** `expense.report.readwrite`.

#### Inputs

| Field           | Type   | Required | Description                                              |
| --------------- | ------ | -------- | -------------------------------------------------------- |
| Report ID       | string | Yes      | The report containing the expense.                       |
| Expense ID (v4) | string | Yes      | The expense to update (the 'ExpenseID' field, not 'ID'). |
| Custom field    | string | Yes      | Which custom field to set, e.g. 'custom2'.               |
| Value           | string | Yes      | The new value - for dropdown fields, the list item's ID. |

#### Outputs

| Field  | Type   | Description                              |
| ------ | ------ | ---------------------------------------- |
| Status | string | Confirmation that the field was updated. |

### List Expense Group Configurations

Read your company's expense setup: policies, valid expense types, payment types, and attendee types. Start here to learn which codes other actions accept.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field       | Type    | Required | Description                                                 |
| ----------- | ------- | -------- | ----------------------------------------------------------- |
| User        | string  | No       | Read the configuration that applies to a specific employee. |
| Max results | integer | No       | How many configurations to return at most.                  |
| Cursor      | string  | No       | Continue a previous listing.                                |

#### Outputs

| Field          | Type          | Description                                                                                             |
| -------------- | ------------- | ------------------------------------------------------------------------------------------------------- |
| Configurations | object\_array | The expense group configurations with their policies, expense types, payment types, and attendee types. |
| Next cursor    | string        | Pass back as Cursor for the next page; empty when done.                                                 |

### List Itemizations

List how an expense entry is broken into sub-items (e.g. a hotel bill split into room, tax, and meals).

**Required permissions:** `EXPRPT`.

#### Inputs

| Field             | Type            | Required | Description                                                                        |
| ----------------- | --------------- | -------- | ---------------------------------------------------------------------------------- |
| Entry ID          | string          | No       | Only itemizations of this expense entry. Get the ID from List Expense Entries.     |
| Report ID         | string          | No       | Only itemizations on this report.                                                  |
| Expense type code | select (string) | No       | Only itemizations of this expense type. Options load from the selected connection. |
| Owner             | string          | No       | The employee who owns the expenses, if not the connected account.                  |
| Max results       | integer         | No       | How many itemizations to return at most.                                           |
| Cursor            | string          | No       | Continue a previous listing.                                                       |

#### Outputs

| Field        | Type          | Description                                                 |
| ------------ | ------------- | ----------------------------------------------------------- |
| Itemizations | object\_array | The itemization lines with their expense types and amounts. |
| Next cursor  | string        | Pass back as Cursor for the next page; empty when done.     |

### Create Itemization

Split an expense entry into parts - e.g. a hotel bill into room rate and taxes, or a meal into the within-policy portion and a personal remainder.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field                       | Type            | Required | Description                                                                                                |
| --------------------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
| Entry ID                    | string          | Yes      | The expense entry to split. Get it from List Expense Entries.                                              |
| Expense type                | select (string) | Yes      | What kind of expense this split is (e.g. room rate, tax, meal). Options load from the selected connection. |
| Amount                      | number          | Yes      | The amount of this split.                                                                                  |
| Transaction date            | string          | Yes      | The date of this split (usually the entry's date).                                                         |
| Entry owner                 | string          | No       | The employee who owns the entry, if not the connected account.                                             |
| Description                 | string          | No       | A short note about this split.                                                                             |
| Show advanced fields        | boolean         | No       | Reveal billable/personal flags, comment, and custom fields. Default: false.                                |
| Billable                    | boolean         | No       | Whether this split is billable to a client.                                                                |
| Personal (non-reimbursable) | boolean         | No       | Mark this split as personal / non-reimbursable.                                                            |
| Comment                     | textarea        | No       | A longer comment for approvers.                                                                            |
| Custom field 1              | string          | No       | Company-specific field 1 for this split.                                                                   |
| Custom field 2              | string          | No       | Company-specific field 2 for this split.                                                                   |
| Custom field 3              | string          | No       | Company-specific field 3 for this split.                                                                   |
| Custom field 4              | string          | No       | Company-specific field 4 for this split.                                                                   |
| Custom field 5              | string          | No       | Company-specific field 5 for this split.                                                                   |
| Custom field 6              | string          | No       | Company-specific field 6 for this split.                                                                   |

#### Outputs

| Field           | Type   | Description                      |
| --------------- | ------ | -------------------------------- |
| Itemization ID  | string | The new split's ID.              |
| Itemization URI | string | API link to the new itemization. |

### List Allocations

See how expenses are split across cost centers, funds, or projects (allocations) for a report, entry, or itemization.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field          | Type    | Required | Description                                                            |
| -------------- | ------- | -------- | ---------------------------------------------------------------------- |
| Report ID      | string  | No       | Only allocations on this report. Get the ID from List Expense Reports. |
| Entry ID       | string  | No       | Only allocations of this expense entry.                                |
| Itemization ID | string  | No       | Only allocations of this itemization line.                             |
| Owner          | string  | No       | The employee who owns the expenses, if not the connected account.      |
| Max results    | integer | No       | How many allocations to return at most (up to 100 per page).           |
| Cursor         | string  | No       | Continue a previous listing.                                           |

#### Outputs

| Field       | Type          | Description                                                                                     |
| ----------- | ------------- | ----------------------------------------------------------------------------------------------- |
| Allocations | object\_array | The allocation lines showing how costs are split, including company-specific accounting fields. |
| Next cursor | string        | Pass back as Cursor for the next page; empty when done.                                         |

### List Lists

See the company's configuration lists - the catalogs of values behind dropdown fields such as cost centers, departments, or allocations.

**Required permissions:** `spend.list.read`.

#### Inputs

| Field       | Type    | Required | Description                                            |
| ----------- | ------- | -------- | ------------------------------------------------------ |
| Max results | integer | No       | How many lists to return at most (up to 100 per page). |
| Cursor      | string  | No       | Continue a previous listing.                           |

#### Outputs

| Field       | Type          | Description                                                                                                                    |
| ----------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Lists       | object\_array | The company's configuration lists - the catalogs of values behind dropdown (list-typed) fields like cost center or allocation. |
| Next cursor | string        | Pass back as Cursor for the next page; empty when done.                                                                        |

### List List Items

See the valid values of a dropdown (list-typed) field - e.g. every allocation, cost center, or department - with the IDs the API accepts.

**Required permissions:** `spend.listitem.read`.

#### Inputs

| Field          | Type    | Required | Description                                                |
| -------------- | ------- | -------- | ---------------------------------------------------------- |
| List ID        | string  | No       | The list whose values to read. Get the ID from List Lists. |
| Parent item ID | string  | No       | Drill into a multi-level list: only children of this item. |
| Name filter    | string  | No       | Only items whose display value matches.                    |
| Max results    | integer | No       | How many items to return at most (100 per page).           |
| Cursor         | string  | No       | Continue a previous listing.                               |

#### Outputs

| Field       | Type          | Description                                                                                                          |
| ----------- | ------------- | -------------------------------------------------------------------------------------------------------------------- |
| List items  | object\_array | The values of the list level, each with its display name and the codes the API accepts when writing dropdown fields. |
| Next cursor | string        | Pass back as Cursor for the next page; empty when done.                                                              |

### Upload Receipt Image

Attach a receipt (JPEG, PNG, or PDF) to an expense entry from a file URL.

**Required permissions:** `IMAGE`.

#### Inputs

| Field            | Type            | Required | Description                                                                                                                                           |
| ---------------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Entry ID         | string          | Yes      | The expense entry to attach the receipt to. Get it from List Expense Entries.                                                                         |
| Receipt file URL | string          | Yes      | A link to the receipt file (JPEG, PNG, or PDF). The action downloads it and attaches it to the entry.                                                 |
| File type        | select (string) | No       | The receipt's file type. Leave on auto to detect it from the file. Available values: Auto-detect, JPEG image, PNG image, PDF document. Default: auto. |

#### Outputs

| Field         | Type   | Description                                                                           |
| ------------- | ------ | ------------------------------------------------------------------------------------- |
| Image URL     | string | Link to the uploaded receipt image in Concur (may take a moment to become available). |
| Upload status | string | Whether Concur accepted the receipt.                                                  |

### Get Receipt Image URL

Get a temporary link to the receipt image attached to an expense entry or report.

**Required permissions:** `IMAGE`.

#### Inputs

| Field     | Type   | Required | Description                                                          |
| --------- | ------ | -------- | -------------------------------------------------------------------- |
| Entry ID  | string | No       | The expense entry whose receipt image to fetch.                      |
| Report ID | string | No       | The report whose receipt image to fetch (for report-level receipts). |

#### Outputs

| Field     | Type   | Description                                                   |
| --------- | ------ | ------------------------------------------------------------- |
| Image URL | string | Temporary link to the receipt image (valid about 15 minutes). |

### Submit Expense Report

Submit a finished report into the company's approval workflow. This hands the report to approvers and it can no longer be edited like a draft.

**Required permissions:** `EXPRPT`.

#### Inputs

| Field        | Type   | Required | Description                                                               |
| ------------ | ------ | -------- | ------------------------------------------------------------------------- |
| Report ID    | string | Yes      | The draft report to submit. Get it from List Expense Reports.             |
| Report owner | string | Yes      | The employee who owns the report; the submission is made on their behalf. |

#### Outputs

| Field             | Type   | Description                                                                                      |
| ----------------- | ------ | ------------------------------------------------------------------------------------------------ |
| Submission status | object | Concur's response: whether the report entered the approval workflow, plus any policy exceptions. |

## Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/sap-concur.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
