> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AR Aging

> Accounts receivable aging analysis showing open invoices bucketed by days past due with DSO metric.

Accounts receivable aging analysis showing open invoices bucketed by days past due at the in-app route `/fa/reports/ar-aging`.

<Frame caption="AR Aging Report — open invoices bucketed by days outstanding with total outstanding AR.">
  <img src="https://mintcdn.com/encoreos/9uGfYOeeHogjmoRk/images/fa/ar-aging-report.png?fit=max&auto=format&n=9uGfYOeeHogjmoRk&q=85&s=d24230bca3dfd4946cc0fdf496db80c7" alt="AR aging report surface with aging buckets and total outstanding AR" width="1440" height="1084" data-path="images/fa/ar-aging-report.png" />
</Frame>

## Overview

This screen provides a full accounts receivable aging analysis. It supports filters for customer type, customer, and as-of date. Key metrics displayed include Total Outstanding AR, Days Sales Outstanding (DSO), and Critical (120+ days). Aging buckets are shown in five cards: current, 31–60, 61–90, 91–120, and 120+ days. A "AR by Customer Type" breakdown and a detail table with all open invoices are also shown. The detail table links to individual invoice detail pages. An Export CSV button downloads all aging data.

## Who it's for

Access follows your organization's role and module configuration. The route is registered without a `RequirePermission` wrapper in fa.tsx.

## Before you start

* An organization must be selected.
* Invoices must exist with open `balance_due` amounts.

## Steps

<Steps>
  <Step title="Navigate to AR Aging">Go to `/fa/reports/ar-aging` via Finance & Revenue Reports, or use the Aging Reports hub.</Step>
  <Step title="Apply filters (optional)">Filter by customer type, specific customer, or as-of date.</Step>
  <Step title="Review key metrics">Check Total Outstanding AR, DSO, and the 120+ critical bucket.</Step>
  <Step title="Review aging buckets">Five cards show invoice counts and totals per aging tier.</Step>
  <Step title="Review customer type breakdown">The AR by Customer Type section shows totals per type.</Step>
  <Step title="Drill into an invoice">Click a customer link in the detail table to open the invoice detail page.</Step>
  <Step title="Export data">Click "Export CSV" to download the full aging detail.</Step>
</Steps>

## Key concepts

* DSO — Days Sales Outstanding, as computed by `useARAgingReport`
* Aging buckets: current, 31–60, 61–90, 91–120, 120+ days — based on `invoice.due_date`
* Customer types: `resident`, `insurance`, `government`, `grant`, `other`
* `ARAgingFilters` — filter object with `customerType`, `customerId`, and `asOfDate`

## Related

<Columns cols={2}>
  <Card title="Finance & Revenue" icon="building-columns" href="/fa/overview">
    Finance & Revenue core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/fa.tsx
  * src/cores/fa/pages/ARAgingReportPage.tsx
  * src/cores/fa/hooks/useARAgingReport.ts
</Accordion>
