Skip to content

Commit a47fa93

Browse files
Merge remote-tracking branch 'upstream/main' into refactor/option-row-title
# Conflicts: # Mobile-Expensify
2 parents 5085e47 + 6f7947c commit a47fa93

97 files changed

Lines changed: 1316 additions & 982 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

Mobile-Expensify

android/app/build.gradle

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -111,8 +111,8 @@ android {
111111
minSdkVersion rootProject.ext.minSdkVersion
112112
targetSdkVersion rootProject.ext.targetSdkVersion
113113
multiDexEnabled rootProject.ext.multiDexEnabled
114-
versionCode 1009036903
115-
versionName "9.3.69-3"
114+
versionCode 1009036906
115+
versionName "9.3.69-6"
116116
// Supported language variants must be declared here to avoid from being removed during the compilation.
117117
// This also helps us to not include unnecessary language variants in the APK.
118118
resConfigs "en", "es"
Lines changed: 140 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,136 @@
11
---
22
title: Expense and Report Actions
3-
description: Learn how actions such as Approve, Pay, Export, and Hold behave in Expensify based on member roles and report status.
4-
keywords: [New Expensify, report actions, approver actions, submitter actions]
3+
description: Learn what actions (Submit, Approve, Pay, Export, Hold) are available on reports based on role and report status.
4+
keywords: [New Expensify, report actions Expensify, who can approve report, when can I pay report, report status actions, approver permissions]
5+
internalScope: Audience is all members. High level overview of what report actions are available based on role and report status. Does not cover step-by-step instructions for performing each action.
56
---
67

8+
# Expense and Report Actions
9+
10+
Expense and report actions vary depending on the member role and the expense or report's status.
711

8-
Expense and report actions vary depending on the member role (submitter, approver, payer, admin) and the report's status (draft, outstanding, approved, done, paid). This guide outlines what to expect when reviewing, approving, paying, exporting, or managing expenses and reports based on varying workspace settings and report status.
12+
Use this guide to understand:
13+
- What each action does
14+
- When actions appear
15+
- Who can perform them
916

1017
---
1118

12-
# Expense and Report Actions
19+
## What actions can I take on a report?
20+
21+
- You can **submit** a report when it is in **Draft** status and you are the **submitter**
22+
- You can **approve** a report when it is in **Outstanding** (submitted) status and you are the **assigned approver**
23+
- You can **pay** a report after it is **Approved** status and you are a **payer**
24+
- You can **export** a report when it is **Approved or Paid** status and you are an **admin or exporter**
25+
- You can **Hold** expenses when they should not move forward yet
26+
27+
[Learn more about report statuses](articles/new-expensify/reports-and-expenses/Understanding-Report-Statuses-and-Actions#report-statuses).
28+
29+
---
30+
31+
## What each report action means
32+
33+
- **Submit**: Available when a report is in Draft. Sends the report into the approval workflow.
34+
- **Approve**: Available when a report is Outstanding and awaiting approval. Confirms the report is ready to move forward.
35+
- **Pay**: Available after approval. Initiates payment or records a manual payment.
36+
- **Export**: Available when a report is Approved or Paid.
37+
- **Review**: Appears when there are issues (such as missing receipts or duplicates). Prompts fixes before continuing.
38+
- **Hold**: Prevents specific expenses from moving forward in approval or payment.
39+
40+
---
41+
42+
## What actions are available for each report status
43+
44+
**Draft reports**
45+
- Submit
46+
- Delete
47+
- Hold
48+
- Duplicate expense
49+
- Duplicate report
50+
51+
**Outstanding (submitted) reports**
52+
- Approve
53+
- Reject
54+
- Hold
55+
- Change approver
56+
57+
**Approved reports**
58+
- Pay
59+
- Export
60+
- Unapprove
61+
- Mark as exported
62+
63+
**Paid or Done reports**
64+
- Download
65+
- Print
66+
- Mark as exported
67+
68+
---
69+
70+
## What actions each role can take
71+
72+
**Submitter**
73+
- Submit reports
74+
- Delete Draft reports
75+
- Duplicate expenses and reports
76+
- Hold expenses
77+
- Invite members to their report
1378

14-
Report actions guide the submitter, approver, and payer regarding the report's status and what actions need to be taken next.
79+
**Approver**
80+
- Approve reports
81+
- Reject reports
82+
- Hold expenses
83+
- Unapprove reports (before payment)
1584

16-
## Understanding Primary vs. Secondary Actions
85+
**Payer**
86+
- Pay reports
87+
- Cancel payment (before processing)
1788

18-
| **Action Type** | **What It Means** | **Examples** |
19-
|------------------|------------------|-------------|
20-
| **Primary actions** | Actions that require your attention and drive the report forward. These are always visible at the top of a report or in the reports list. | Submit, Approve, Pay, Export |
21-
| **Secondary actions (More menu)** | Optional tools and adjustments that help manage or troubleshoot an expense or report. Appear in the More menu depending on the state, role, or integration settings. | Hold, Delete, Change workspace, Mark as exported |
89+
**Workspace Admin**
90+
- Export reports
91+
- Mark reports as exported
92+
- Change approver
93+
- Bypass approvers
94+
- Change workspace (before export)
2295

2396
---
2497

25-
## Primary Actions
98+
## How to understand report actions using the full action table
99+
100+
**Primary report actions**
26101

27102
| **Action** | **When It Appears** | **Who Can See It** | **What It Does** |
28103
|------------|---------------------|---------------------|------------------|
29-
| **Submit** | For draft/unsubmitted reports | Submitter | Sends the report into the approval workflow |
30-
| **Approve** | When the report is submitted and pending approval | Approver | Confirms the report is accurate and ready to move to payment or to the next approver |
31-
| **Pay** | After the report is approved | Payer | Initiates payment via Expensify or logs a manual payment |
32-
| **Export** | When the report is approved and not yet exported | Admin, Exporter | Sends report data to an integrated accounting system |
33-
| **Review** | When a report has violations (duplicate expenses, a missing receipt, etc.) | All roles | Prompts to resolve issues before submitting, approving, or paying |
104+
| **Submit** | Draft reports | Submitter | Sends the report into the approval workflow |
105+
| **Approve** | Outstanding awaiting approval | Approver | Confirms the report is accurate and moves it forward |
106+
| **Pay** | Approved reports with reimbursable expenses | Payer | Initiates or records payment |
107+
| **Export** | Approved or Paid reports not yet exported | Workspace Admin | Sends report data to an accounting system |
108+
| **Review** | When issues are detected | All roles | Prompts required fixes before continuing |
34109

35-
**Note:** If you selected "Track and budget expenses" during onboarding and your workspace does not use an approval workflow, **Submit** and **Approve** will both display as **Mark as done**.
110+
**Note:** If your workspace does not use approvals, **Submit** and **Approve** may appear as **Mark as done**.
36111

37112
---
38113

39-
## Secondary (“More menu) Actions
114+
**Additional report actions available from the More menu**
40115

41-
| **Action** | **When It Appears** | **Who Can See It** | **What It Does** |
116+
| **Action** | **When It Appears** | **Who Can Use It** | **What It Does** |
42117
|------------|---------------------|---------------------|------------------|
118+
| **Hold** | Draft, Outstanding, or Approved reports | Submitter, approver, Workspace Admin | Prevents expenses from moving forward |
119+
| **Change workspace** | Before export | Submitter, approver, Workspace Admin | Moves the report to another workspace |
120+
| **Change approver** | Submitted reports | Workspace Admin | Adds or bypasses approvers |
121+
| **Delete** | Draft reports only | Submitter | Permanently removes the report |
122+
| **Undelete** | Deleted expenses | Submitter | Restores a deleted expense |
123+
| **Unapprove** | After approval, before payment | Approver | Reverts approval |
124+
| **Mark as exported** | Approved or Paid reports | Workspace Admin | Marks report as exported manually |
125+
| **Export to accounting system** | When accounting integration is enabled | Workspace Admin | Sends data externally |
126+
| **Duplicate expense** | Non-card expenses | Submitter | Creates a copy of an expense |
127+
| **Duplicate report** | Any report owned by submitter | Submitter | Creates a copy of the report |
128+
| **Download** | Any report | All roles | Downloads a PDF copy |
129+
| **Print** | Any report | All roles | Opens print view |
130+
| **Reject** | Submitted reports | Approver | Sends report back for changes |
131+
| **Invite member** | Draft and Outstanding reports | All roles | Adds a member to the report |
132+
| **View details** | Any report | All roles | Opens report details |
133+
| **Cancel payment** | Before payment processing | Payer | Cancels a pending payment |
43134
| **Hold** | On draft or submitted reports | Submitter, Approver, Admin | Marks individual expenses that aren’t yet ready for approval or payment |
44135
| **Change workspace** | Before report is exported | Submitter, Approver, Admin | Moves the report to a different workspace |
45136
| **Change approver** | On submitted reports, before the report is final-approved | Admin | "Add Approver" allows an extra approver to be inserted into the approval workflow at the current point. "Bypass Approver" allows an admin to take control of the report approval and final approve |
@@ -59,27 +150,45 @@ Report actions guide the submitter, approver, and payer regarding the report's s
59150

60151
---
61152

62-
# FAQ
153+
## How to find available actions on a report
63154

64-
## Who can change a report's workspace?
155+
Open a report to see available actions.
65156

66-
- **Submitters**: Until the report is approved
67-
- **Approvers**: Until they approve the report
68-
- **Admins**: Until the report is exported
157+
- Primary actions (like **Submit**, **Approve**, or **Pay**) appear at the top of the report
158+
- Additional actions are available when you open the report and choose **More**
159+
- Available actions change based on:
160+
- Your role
161+
- Report status
162+
- Workspace settings
163+
- Integrations
69164

70-
## What happens if an export fails?
165+
---
71166

72-
If a report doesn’t export automatically or manually, you’ll see an error message with instructions on what to do next. You can try exporting it again using the same button.
167+
## What happens after you take a report action
73168

74-
The process works just like manual exports for automatic export issues, so you can fix the problem and retry the export on your own.
169+
- **Submit** → moves report to approval
170+
- **Approve** → moves report to next approver or payment
171+
- **Pay** → marks report as Paid or starts processing payment
172+
- **Export** → sends report data externally
173+
- **Reject** → sends report back for updates
174+
- **Unapprove** → reopens the report before payment
75175

76-
## Why can’t I cancel a payment?
176+
---
177+
178+
# FAQ
179+
180+
## What happens if an export fails?
181+
182+
An error message appears with next steps. You can fix the issue and retry the export.
77183

78-
The **Cancel payment** option is only available for in-app payments and only before Expensify starts processing the withdrawal. This is usually between 12 PM and 3 PM Pacific Time each day.
184+
## Why can’t I cancel a payment?
79185

80-
This option won't be available if the payment was made manually outside of Expensify. In that case, use **Unapprove** instead.
186+
Payments can only be canceled before processing begins. Manual payments cannot be canceled.
81187

82188
## Why can’t I see “Bypass approvers”?
83189

84-
Only workspace admins can bypass the prescribed approval workflow. If “Prevent Self-Approval” is enabled, an admin cannot bypass approvals to approve their own report.
190+
Only workspace admins can bypass approvers. Some settings may prevent self-approval.
191+
192+
## How do I invite a member to an expense report?
85193

194+
Open the report, select the header, then select **Members** and choose **Invite**.

docs/articles/new-expensify/reports-and-expenses/Getting-Started-with-the-Spend-Page.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ Filters help you narrow down expenses or reports so you can find exactly what yo
8787

8888
You can filter your **expenses** and **reports** using dropdowns, search bars, and chips.
8989

90-
- **Expenses:** can be filtered by `Date`, `Merchant`, `Category`, `Tag`, `Amount`, `Reimbursable`, `Billable`, `Status` (e.g. Unreported)
90+
- **Expenses:** can be filtered by `Date`, `Merchant`, `Category`, `Tag`, `Amount`, `Reimbursable`, `Billable`, `Status` (e.g. Unreported, Deleted)
9191

9292
- **Reports**: can be filtered by `Submitter`, `Workspace`, `Report Status` (e.g. Draft, Outstanding, Approved, Paid), `Date`
9393

docs/articles/new-expensify/reports-and-expenses/How-to-Delete-Expenses.md

Lines changed: 26 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: How to Delete Expenses
33
description: Learn how to delete expenses in New Expensify, including how to remove expenses from reports, when you need to retract a report, and why some expenses can’t be deleted.
4-
keywords: [New Expensify, delete expenses, remove expense, delete expense report, company card expense delete, retract report delete expense, cannot delete expense Expensify]
5-
internalScope: Audience includes all members. Covers deleting individual expenses, deleting expenses from reports, retracting reports to enable deletion, company card deletion rules. Does not cover editing expenses, reimbursement workflows, expense approvals beyond deletion requirements.
4+
keywords: [New Expensify, delete expenses, remove expense, delete expense report, company card expense delete, retract report delete expense, cannot delete expense Expensify, undelete expense, restore deleted expense, find deleted expenses]
5+
internalScope: Audience includes all members. Covers deleting individual expenses, deleting expenses from reports, retracting reports to enable deletion, company card deletion rules, finding and un-deleting deleted expenses. Does not cover editing expenses, reimbursement workflows, expense approvals beyond deletion requirements.
66
---
77

88
# How to delete expenses
@@ -38,10 +38,18 @@ Most expenses can be deleted directly. If an expense is on a submitted report or
3838
3. Select the expense you want to delete.
3939
4. Choose **Selected**, then **Delete**.
4040

41-
**Note:** You can only delete expenses from your own Unreported, Draft, and Outstanding reports. If the report is Approved, Done or Paid, it will need to be retracted first before deleting the expense. [Learn how to retract a report](https://help.expensify.com/articles/new-expensify/reports-and-expenses/Edit-Expense-Reports).
41+
**Note:** You can only delete expenses from your own Unreported, Draft, and Outstanding reports. If the report is Approved, Done or Paid, it will need to be retracted first before deleting the expense. [Learn how to retract a report](/articles/new-expensify/reports-and-expenses/Edit-Expense-Reports).
4242

4343
---
4444

45+
## What happens after you delete an expense
46+
47+
- If the expense was the only one on a report, the report is also deleted.
48+
- If the report contained multiple expenses, the remaining expenses stay on the report.
49+
- If you need to recover the deleted expense, it can be undeleted.
50+
51+
---
52+
4553
## Why you can’t delete an expense
4654

4755
Expenses can only be deleted when certain conditions are met.
@@ -62,7 +70,20 @@ https://github.com/Expensify/Expensify/issues/614406
6270
- The workspace setting **Allow deleting transactions** was enabled at the time the expense was imported
6371
- The expense is Unreported or on a Draft or Outstanding report
6472

65-
If an expense can't be deleted, you can [remove the expense from the report](https://help.expensify.com/articles/new-expensify/reports-and-expenses/Managing-Expenses-in-a-Report#how-to-move-or-remove-expenses-from-a-report) and move it to your personal space instead.
73+
If an expense can't be deleted, you can [remove the expense from the report](/articles/new-expensify/reports-and-expenses/Managing-Expenses-in-a-Report#how-to-move-or-remove-expenses-from-a-report) and move it to your personal space instead.
74+
75+
---
76+
77+
## How to find and undelete deleted expenses
78+
79+
Deleted expenses are not permanently removed. You can find and restore them from the **Spend** page.
80+
81+
1. In the navigation tabs (on the left on web, on the bottom on mobile) select **Spend** > **Expenses**.
82+
2. Filter by **Status** = **Deleted** and click **Apply**.
83+
3. Select the expenses you want to restore using the checkboxes.
84+
4. Choose **Selected**, then **Undelete**.
85+
86+
The restored expenses return to your account.
6687

6788
---
6889

@@ -72,7 +93,7 @@ If an expense can't be deleted, you can [remove the expense from the report](htt
7293

7394
You can only delete expenses in your own account.
7495

75-
If you need access to another member’s expenses, ask them to [add you as a Copilot](https://help.expensify.com/articles/new-expensify/settings/Copilot-Access). This allows you to manage expenses on their behalf.
96+
If you need access to another member’s expenses, ask them to [add you as a Copilot](/articles/new-expensify/settings/Copilot-Access). This allows you to manage expenses on their behalf.
7697

7798
## How can a Workspace Admin allow members to delete company card expenses?
7899

ios/NewExpensify/Info.plist

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@
4444
</dict>
4545
</array>
4646
<key>CFBundleVersion</key>
47-
<string>9.3.69.3</string>
47+
<string>9.3.69.6</string>
4848
<key>FullStory</key>
4949
<dict>
5050
<key>OrgId</key>

ios/NotificationServiceExtension/Info.plist

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
<key>CFBundleShortVersionString</key>
1414
<string>9.3.69</string>
1515
<key>CFBundleVersion</key>
16-
<string>9.3.69.3</string>
16+
<string>9.3.69.6</string>
1717
<key>NSExtension</key>
1818
<dict>
1919
<key>NSExtensionPointIdentifier</key>

ios/ShareViewController/Info.plist

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
<key>CFBundleShortVersionString</key>
1414
<string>9.3.69</string>
1515
<key>CFBundleVersion</key>
16-
<string>9.3.69.3</string>
16+
<string>9.3.69.6</string>
1717
<key>NSExtension</key>
1818
<dict>
1919
<key>NSExtensionAttributes</key>

package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "new.expensify",
3-
"version": "9.3.69-3",
3+
"version": "9.3.69-6",
44
"author": "Expensify, Inc.",
55
"homepage": "https://new.expensify.com",
66
"description": "New Expensify is the next generation of Expensify: a reimagination of payments based atop a foundation of chat.",

0 commit comments

Comments
 (0)