Merge branch 'Expensify:main' into fix-spinner-assign-card

Author: fedirjh

docs/articles/new-expensify/expensify-card/View-and-Reconcile-Expensify-Card-Expenses.md

@@ -1,70 +1,68 @@
 ---
-title: Filter and Reconcile the Expensify Cards
-description: Learn how to reconcile Expensify Card transactions using filters and exports in New Expensify, with tips for both card and payment reconciliation.
-keywords: [New Expensify, Expensify Card reconciliation, card filters, export transactions, payment reconciliation, report filters, posted date, settlement matching]
+title: View and Reconcile Expensify Card Expenses
+description: Learn how to view, verify, and export Expensify Card expenses by matching settlement withdrawals to grouped transactions in Expensify.
+keywords: [New Expensify, Expensify Card reconciliation, reconcile Expensify Card withdrawals, view Expensify Card expenses, verify Expensify Card totals, export Expensify Card expenses, withdrawal-based reconciliation, Workspace Admin]
+internalScope: Audience is Workspace Admins reconciling Expensify Card activity. Covers the withdrawal-based reconciliation workflow under Reconciliation > Expensify Card. Does not cover company card statement matching, reimbursement reconciliation, or manual export-based reconciliation.
 ---
 
-Once employees use the Expensify Card, you can easily view and reconcile their transactions from the Reports page in New Expensify.
+# View and Reconcile Expensify Card Expenses
 
+Expensify Card reconciliation helps you match each bank withdrawal (also known as a settlement) to the group of card expenses it covers. You can review and verify these withdrawals directly in Expensify. 
 
-# View Card Transactions by Employee or Company
-
-To view card transactions for a specific employee or for the entire company:
+---
 
-1. Go to the **Reports** page.
-2. Click **Filters** in the top-right corner.
-3. Click **Card** to filter cards:
-   - Select a feed from **Card feeds** to view expenses from all cards in the feed.
-   - Select a card from **Individual cards** to view expenses from that card.
+## Who Can Reconcile Expensify Card Expenses
 
-This view allows you to review all transactions made on the Expensify Card, grouped by employee or feed.
+Workspace Admins can reconcile Expensify Card expenses when the Expensify Card is enabled on the Workspace.
 
 ---
 
-# Export Card Transactions by Date
+## How to View Expensify Card Withdrawals
 
-You can export transactions from a specific date range to help with monthly reconciliations:
-
-1. From the **Reports** page, select **Expenses** in the left-hand-bar.
-2. Select **All** above the expenses list.
-3. Click **Filters**.
-4. Apply the following filters:
-   - **Card**: select the applicable card feed.
-   - **Posted date**: Set the appropriate date range (e.g., `posted<2025-02-28 AND posted>2025-02-01`)
-5. Alternatively, you can enter this directly in the search bar (e.g., `type:expense feed:"all in cards" posted<2025-02-28 posted>2025-02-01`)
-6. Once filtered, click the **Export** icon in the top-right corner to download the report as a spreadsheet.
+1. Click the navigation tabs (on the left on web, on the bottom on mobile) and go to **Reports**.
+2. In the **Reconciliation** section, select **Expensify Card**.
+3. Choose the **Withdrawn** filter to select a date range (for example, **Last month**).
+4. Review the list of withdrawals. Each row represents a single settlement withdrawal from your bank account.
 
 ---
 
-# Reconcile Card Payments Manually
+## How to View Expenses Included in an Expensify Card Withdrawal
+
+1. From the Expensify Card reconciliation view, locate the withdrawal you want to review.
+2. Click the arrow next to the withdrawal amount to expand the row.
+3. Review the individual expenses included in that withdrawal.
+   
+---
 
-To align exported card expenses with bank withdrawals:
+## How to Verify Expensify Card Withdrawal Totals Against Your Bank Statement
 
-- Group the **posted dates** in your spreadsheet by **day** or **month**.
-- This allows you to match the totals with the amounts withdrawn from your **settlement account**.
+1. On your bank statement, locate Expensify Card settlement charges.
+2. From the reconciliation view, find the matching withdrawal.
+3. Compare the withdrawal total to the bank charge.
 
-**Note:** This manual method is currently the best way to reconcile card payments. We're working on a more streamlined reconciliation tool, but it's not yet available.
+- If the totals match, the withdrawal is reconciled.
+- If the totals do not match, expand the withdrawal to review individual expenses and identify discrepancies.
 
 ---
 
-# FAQ
+## How to Export Expensify Card Expenses
 
-## Where do I find the Card filter?
+1. From the Expensify Card reconciliation view, select the expenses you want to export using the checkboxes.
+2. Click the **Selected** button that appears above the results.
+3. Choose an export template to download the results as a CSV file.
 
-On the **Reports** page:
-- Click **Filters**.
-- Click into the **Card** section.
-- Choose a specific card feed or select all feeds to view all transactions.
+---
 
-## Can I reconcile card transactions for a custom date range?
+# FAQ
 
-Yes. Use the **Posted date** filter or add the search query directly to the search bar.
+## Why is Expensify Card not showing under Reconciliation?
 
-## Is there a reconciliation tool available?
+The Expensify Card option only appears when the feature is enabled for your Workspace. If you don’t see it, confirm that the Expensify Card is enabled and active.
 
-Not yet. A more automated reconciliation tool is in development, but for now, we recommend using the manual export and filter method.
+## How is Expensify Card reconciliation different from statement matching?
 
-## Where can I learn more about using the Reports page?
+Expensify Card reconciliation uses withdrawal-based matching, where each bank withdrawal corresponds to grouped expenses. Company card reconciliation uses statement matching, where transactions are compared against an external card statement.
 
-Check out [Using Reports in New Expensify](https://docs.expensify.com/help/using-reports-in-new-expensify) for more details.
+## Why don't I see any withdrawals in the Expensify Card reconciliation view? 
 
+If you don’t see any withdrawals, adjust the **Withdrawn** filter and select a different date range.

docs/articles/new-expensify/reports-and-expenses/Reconcile-Reimbursements.md

@@ -0,0 +1,58 @@
+---
+title: Reconcile Reimbursements
+description: Learn how to match reimbursement payments to bank charges, trace payments to expense reports, and troubleshoot discrepancies with your accounting system.
+keywords: [New Expensify, reconcile reimbursements, match reimbursements bank statement, reimbursement payments Expensify, reimbursement mismatch NetSuite QuickBooks, trace reimbursement to expense reports]
+internalScope: Audience is Workspace Admins reconciling reimbursement payments. Covers payment-based reconciliation under Reconciliation > Reimbursements. Does not cover Expensify Card reconciliation or company card statement matching.
+---
+
+# Reconcile Reimbursements
+
+Reimbursement reconciliation helps you match each reimbursement payment to the bank charge it creates, then trace that payment back to the expense reports it covers. You can review and verify these payments directly in Expensify.
+
+---
+
+## Who Can Reconcile Reimbursements
+
+Workspace Admins can reconcile reimbursements when Payments is enabled on the Workspace with a verified business bank account.
+
+---
+
+## How to View Reimbursements 
+
+1. Click the navigation tabs (on the left on web, on the bottom on mobile) and go to **Reports**.
+2. In the **Reconciliation** section, select **Reimbursements**.
+3. Choose the **Withdrawn** filter to select a date range (for example, **Last month**).
+4. Review the list of reimbursements. Each row represents a reimbursement for a single report and shows the total amount.
+
+---
+
+## How to Trace a Reimbursement Payment to Expense Reports
+
+1. From the Reimbursements reconciliation view, locate the payment you want to investigate.
+2. Click the arrow next to the reimbursement amount to expand the row.
+3. Review each report to confirm the payment matches expected activity.
+
+---
+
+## How to Verify Reimbursement Totals Against Your Bank Statement
+
+1. On your bank statement, locate the reimbursement charges for the period you are reconciling.
+2. In the reimbursement reconciliation view, compare each payment total to the corresponding charge on your bank statement.
+   - If the totals match, the reimbursement is reconciled. 
+   - If a total does not match, expand the reimbursement to review the underlying expenses and identify discrepancies.
+
+---
+
+# FAQ
+
+## How do I identify an unknown bank charge?
+
+If you see a charge on your bank statement that you cannot identify, go to the Reimbursements reconciliation view and filter to the date range when the charge occurred. Match the charge amount to a payment in the list, then expand it to see which report(s) were reimbursed.
+
+## What does a reimbursement payment include?
+
+A single reimbursement payment may cover one expense report. Expanding the payment row shows all the expenses on the report that was reimbursed. 
+
+## Why don't I see Reimbursements under Reconciliation?
+
+The Payments option only appears when your workspace has Payments enabled with a verified business bank account. If you don’t see it, confirm that the Payments is enabled and a verified business bank account is connected. 

docs/articles/new-expensify/reports-and-expenses/Statement-Matching-and-Reconciliation.md

@@ -1,88 +1,61 @@
 ---
 title: Statement Matching and Reconciliation
-description: Learn how Workspace Admins can use suggested search  to match card statements and reconcile bank activity.
-keywords: [statement matching, reconciliation, accounting workflows, Expensify Card, reimbursements, Workspace Admin, bank reconciliation, accounting, suggested search]
+description: Learn how to reconcile company card transactions in Expensify against your credit card statement.
+keywords: [New Expensify, company cards, statement matching, company card reconciliation, reconciliation, card statement, card feed, statement close date, statement mismatch]
+internalScope: Audience is Workspace Admins reconciling third-party company card spend. Covers statement-based reconciliation under Reconciliation > Card statements. Does not cover Expensify Card withdrawal-based reconciliation or reimbursement reconciliation.
 ---
-<div id="new-expensify" markdown="1">
-
-Statement matching and reconciliation workflows bring your financial data together in one place so you can confirm card statement totals and reconcile bank withdrawals from within Expensify. These shortcuts help Workspace Admins keep their books accurate and close periods faster.
 
 # Statement Matching and Reconciliation
 
-Suggested search includes shortcuts for **Statement Matching** and **Reconciliation** so Workspace Admins can close the books faster. These workflows let you compare card statements against recorded spend, and reconcile reimbursements or Expensify Card withdrawals with your bank statement — all without leaving Expensify.
+Company card reconciliation helps you match the transactions in Expensify to your card statement for a given period. This ensures the totals line up and all card activity is accounted for before you close your books.
 
 ---
 
-## Who can access Statement Matching and Reconciliation
-Workspace Admins with:
-- the Expensify Card, or
-- at least one company card feed connected, or
-- Reimbursements enabled with a verified business bank account.
-
----
+## Who Can Reconcile Company Cards
 
-## Where to find Statement Matching and Reconciliation
-Go to:
-- **Reports > Reconciliation > Card statements** — compare card statement totals against recorded spend
-- **Reports > Reconciliation > Expensify Card** — match Expensify Card withdrawals with your bank statement
-- **Reports > Reconciliation > Reimbursements** — match reimbursement payments with your bank statement
+Workspace Admins whose workspace has at least one company card feed connected can reconcile company cards in Expensify.
 
 ---
 
-## Statement Matching
-Statement Matching helps you verify that all company card transactions in Expensify match your card statement total.
-
-The Statement Matching view shows:
-- **Grouped by card** view with subtotals per card
-- **Feed filter** if you have more than one card feed
-- **Posted filter** with a preset for **Last statement**
-- **Total footer** showing the sum of transactions for the statement period
+## How to Reconcile Company Card Transactions Against a Statement
 
-**Steps:**
-1. Open **Reports > Reconciliation > Card statements**.
-2. Apply the **Feed** filter for the correct card account.
-3. Use the **Posted** filter with **Last statement**.
-4. Compare the **Total** footer with your card statement.
-   - If totals match, you’re done.
-   - If not, expand the card groups to find missing or unmatched transactions.
-
-**Note:** Admins can configure a **Statement close date** in card settings. By default, this is the last day of the month, but you can update the statement close date any time.
+1. Click the navigation tabs (on the left on web, on the bottom on mobile) and go to **Reports**.
+2. In the **Reconciliation** section, select **Card statements**.
+3. Choose the **Feed** filter to select the card feed or account you want to reconcile.
+4. Choose the **Posted** filter to select the date range that matches your statement period. 
+5. Review the **Total spend** shown at the bottom of the results and compare it to your card statement total.
+   - If the totals match, the statement period is reconciled.
+   - If the totals do not match, expand the card groups to review individual transactions and identify missing expenses. 
 
 ---
 
-## Reconciliation
-Reconciliation helps you match payments and withdrawals to ensure your books reflect reality.
+## How to Identify and Fix Discrepancies in Company Card Reconciliation
 
-**Expensify Card Reconciliation**
-1. Open **Reports > Reconciliation > Expensify Card**.
-2. Group expenses by **Withdrawal ID**, apply the **Withdrawn** filter (e.g. **Last month**), and compare totals per withdrawal against your bank statement.
+If the Expensify total does not match your card statement:
 
-**Out-of-pocket Reconciliation**
-1. Open **Reports > Reconciliation > Reimbursements**.
-2. Group expenses by **Withdrawal ID**, apply the **Withdrawn** filter (e.g. **Last month**), and compare totals per reimbursement against your bank statement.
+1. From the reconciliation view, click the arrow next to the total to see individual transactions. 
+2. Compare each transaction against your card statement line items.
+3. Look for missing transactions that appear on your card statement but not in Expensify, or duplicate transactions that may have been recorded twice.
+4. Check the posting dates — a transaction may fall into a different statement period in Expensify than on your card statement if posting dates differ.
 
 ---
 
-## Multi-currency
-If your workspace has multiple currencies:
-- Apply the **Group currency** filter to convert all spend into a single currency (for example, GBP).
-- This ensures grouped totals match your accounting system’s reporting currency.
+## How Multi-Currency Works With Company Card Reconciliation
+
+If your workspace uses multiple currencies, apply the **Group currency** filter to convert all transactions into a single currency. This ensures the grouped totals match your accounting system's reporting currency.
 
 ---
 
 # FAQ
 
-## What’s the difference between Statement Matching and Reconciliation?
-Statement Matching checks that all card transactions in Expensify equal the card statement total.  
-Reconciliation ensures payments (card withdrawals or reimbursements) match what cleared your bank account.
+## What Is the Difference Between Company Card Reconciliation and Expensify Card Reconciliation?
+
+Company card reconciliation is statement-based and matches Expensify transaction totals to an external card statement. Expensify Card reconciliation is withdrawal-based and matches bank withdrawals to grouped expenses within Expensify. See [View and Reconcile Expensify Card Expenses](/articles/new-expensify/expensify-card/View-and-Reconcile-Expensify-Card-Expenses) for the Expensify Card workflow.
 
-## Can I expand grouped results to see individual transactions?
-Yes. You can expand or collapse groups (by card or withdrawal ID) inline to view the underlying transactions.
+## Why Don't I See Card Statements Under Reconciliation?
 
-## Why don’t I see the Reconciliation section or some of its options?
-The **Reconciliation** section appears only when your workspace has at least one of: company card feeds, Expensify Card, or reimbursements (verified business bank account). Under Reconciliation, only the options that apply to your workspace are shown: **Card statements** (card feeds), **Expensify Card**, and **Reimbursements**.
+The Card statements option appears only when your workspace has at least one company card feed connected. If you don’t see it, confirm that a company card feed is set up and active.
 
-## What’s the default Statement close date?
-For new card feeds, the last day of the month is automatically selected. You can update the statement close date anytime in **Settings > Workspaces > [Workspace Name] > Company Cards**.
+## What Does the Last Statement Filter Show?
 
-</div>
+The **Last statement** filter shows transactions posted during the most recent completed statement period, based on your configured statement close date.

src/libs/TransactionUtils/index.ts

@@ -580,6 +580,21 @@ function hasReceiptSource(transaction: OnyxInputOrEntry<Transaction>): boolean {
     return !!transaction?.receipt?.source;
 }
 
+/** Check if odometer image has the source file */
+function hasOdometerImageSource(transaction: OnyxInputOrEntry<Transaction>, imageType: string): boolean {
+    const odometerImage = imageType === CONST.IOU.ODOMETER_IMAGE_TYPE.START ? transaction?.comment?.odometerStartImage : transaction?.comment?.odometerEndImage;
+    if (!odometerImage) {
+        return false;
+    }
+    if (typeof odometerImage === 'string') {
+        return odometerImage.length > 0;
+    }
+    if ('uri' in odometerImage) {
+        return typeof odometerImage.uri === 'string' && odometerImage.uri.length > 0;
+    }
+    return true;
+}
+
 function isDemoTransaction(transaction: OnyxInputOrEntry<Transaction>): boolean {
     return transaction?.comment?.isDemoTransaction ?? false;
 }
@@ -2939,6 +2954,7 @@ export {
     removeTransactionFromDuplicateTransactionViolation,
     getCardName,
     hasReceiptSource,
+    hasOdometerImageSource,
     shouldShowAttendees,
     getAllSortedTransactions,
     getFormattedPostedDate,

src/pages/iou/request/step/IOURequestStepConfirmation.tsx

@@ -1535,7 +1535,7 @@ function IOURequestStepConfirmation({
             shouldEnableMaxHeight={canUseTouchScreen()}
             testID="IOURequestStepConfirmation"
         >
-            <DragAndDropProvider isDisabled={!showReceiptEmptyState}>
+            <DragAndDropProvider isDisabled={!showReceiptEmptyState || isOdometerDistanceRequest}>
                 <View style={styles.flex1}>
                     <HeaderWithBackButton
                         title={headerTitle}