Skip to Content
ModulesExpense TrackerRecording an expense

Recording an expense

There are three ways to get an expense into CartonCrew: type it in by hand, snap a receipt on your phone and let AI read it, or import a batch from CSV. All three need at least a date and an amount — everything else is optional.

Who this is for: anyone with editor access or above.

Manual entry

  1. On the Expenses screen, open Actions → New expense (or use + New expense from the empty state).
  2. Leave the form on the Enter manually tab.
  3. Fill in the fields:
    • Vendor / payee — free text, with autocomplete suggestions drawn from vendors you’ve used before.
    • Date (required) and Category (from your organization’s category list).
    • Amount (required) and Tax amount (optional).
    • Payment method — Card, Cash, Check, Bank transfer, or Other.
    • Paid by — who or what account paid, e.g. “Org card” or “Jane”.
    • Reference — an invoice or reference number.
    • Reimbursable and Reimbursed checkboxes.
    • Notes.
  4. Click Save expense.

To edit later, click the expense in the list. The edit form is the same, plus a Receipt panel where you can attach a photo or file. Admins can Delete from here.

Snap a receipt (mobile capture + AI parse)

The fastest way to log spend on a phone. CartonCrew is an installable PWA, so adding it to your home screen makes this a one-tap, camera-first flow.

  1. Open the capture screen — the Snap receipt button (desktop), the floating camera button (phones), or Actions → Snap a receipt. This goes to /expenses/capture.
  2. Take photo to open the rear camera, or Upload image or PDF to pick an existing file. (Or tap or enter manually to skip the photo.)
  3. The photo is held on your device and previewed — nothing is uploaded yet.
  4. Read the receipt:
    • If AI is on, tap ✨ Read receipt. CartonCrew uploads the photo, reads it, and prefills the vendor, date, amount, tax, category, and notes. A ”✓ Read by AI — verify below” note appears.
    • If AI is off, you’ll see “Auto-read off” with a link to enable AI. You can still type the fields in.
  5. Check every field — AI can misread amounts and dates. The Amount field is front and center; expand More details for tax, payment method, paid by, reimbursable, and notes.
  6. Tap Save expense. On the confirmation screen, Add another keeps you in the flow for the next receipt, or Done — view all returns to the list.

Notes on the capture flow

  • Photos are auto-compressed before upload (a multi-megabyte phone capture becomes a few hundred KB), so parsing is faster and cheaper.
  • The 25MB limit and the JPG/PNG/WebP/HEIC/PDF allowlist apply here too.
  • If you hit a network blip, your photo is kept in memory — just tap Read receipt or Save again; nothing is lost.
  • AI’s category guess is mapped to the closest one of your category labels; if there’s no good fit it’s left blank for you to set.

Receipt-first entry on desktop

The full New-expense form also has an Upload receipt tab. Choose a file (or take a photo), and CartonCrew stores it against a draft expense. Click Parse with AI to prefill the fields, review them next to the receipt preview, then Save expense. The same AI-on requirement applies.

Bulk import from CSV

Use this to load many expenses at once — for example a card statement export.

  1. Open Actions → Import from CSV.
  2. Upload a .csv file or paste CSV text. You need a header row and at least a date column and an amount column. Dates must be in YYYY-MM-DD format.
  3. CartonCrew auto-matches your columns to the expense fields. On the Match your columns step, fix any mapping using the dropdowns. Mappable fields: Date (required), Amount (required), Vendor, Category, Tax, Payment method, Paid by, Reference, Notes, and Reimbursable.
  4. The preview shows how many rows are ready to import and how many will be skipped (a row is skipped if its date or amount is missing or invalid). Skipped rows are highlighted.
  5. Click Import to create the valid rows. You’ll get a toast confirming how many were inserted (and how many were skipped).

Bulk import does not attach receipts — add those afterward by editing the expense.

Last updated: 2026-06-09 · Applies to: CartonCrew v1.110+

OverviewOverview