> ## 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.

# Finance & Revenue Collections Queue

> Collections Queue provides a workflow view for managing accounts-receivable collection activity, with tabbed access to the new structured queue and legacy…

Collections Queue provides a workflow view for managing accounts-receivable collection activity, with tabbed access to the new structured queue and legacy in-collection invoices, AR aging bucket summaries, and status and search filters. Route: `/fa/collections`

<Frame caption="Collections Queue — overdue invoices in the AR collections workflow with aging summaries.">
  <img src="https://mintcdn.com/encoreos/9uGfYOeeHogjmoRk/images/fa/collections-queue.png?fit=max&auto=format&n=9uGfYOeeHogjmoRk&q=85&s=b9a925bd329a2a1133f26e4cf8dacdf1" alt="Collections queue surface with overdue invoices and aging buckets" width="1440" height="900" data-path="images/fa/collections-queue.png" />
</Frame>

## Overview

The page has two queue systems shown in separate tabs: the new structured queue (`fa_collection_queue`) accessed via `useCollectionQueueList` and rendered in `CollectionQueueWorkflowTable`; and the legacy queue (invoices flagged `in_collection`) accessed via `useCollectionQueue` and rendered in `CollectionQueueTable`. Collection stats are loaded via `useCollectionStats`. AR aging buckets are loaded via `useArAgingBuckets`. Independent search and filter state is maintained for each queue. `CollectionQueueStatus` filters the new queue.

## Who it's for

Requires permission: `fa.collections.view`

## Before you start

* Invoices must be outstanding and have been flagged for collection (legacy), or records must exist in `fa_collection_queue` (new queue).
* You must hold the `fa.collections.view` permission.

## Steps

<Steps>
  <Step title="Navigate to Collections Queue">
    Go to `/fa/collections`.
  </Step>

  <Step title="Review collection statistics">
    Stat cards at the top show summary counts from `useCollectionStats`.
  </Step>

  <Step title="Review AR aging buckets">
    Aging bucket cards show overdue balances by age bucket from `useArAgingBuckets`.
  </Step>

  <Step title="Switch between queue tabs">
    Use the tabbed interface to toggle between the new structured queue and the legacy in-collection view.
  </Step>

  <Step title="Filter and search">
    Each tab has independent search and status filter controls.
  </Step>

  <Step title="Take action on items">
    Select items in the queue to perform available collection workflow actions.
  </Step>
</Steps>

## Key concepts

* **`CollectionQueueStatus`** — Type for queue item status used to filter the new queue.
* **`useCollectionQueueList`** — Hook for the structured `fa_collection_queue` table.
* **`useCollectionQueue`** — Hook for legacy invoices flagged `in_collection`.
* **`useArAgingBuckets`** — Hook returning AR aging bucket totals.

## 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" />
</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/CollectionWorkflowPage.tsx
  * src/cores/fa/hooks/useCollectionQueueList.ts
  * src/cores/fa/hooks/useCollectionWorkflow\.ts
  * src/cores/fa/hooks/useArAgingBuckets.ts
  * src/cores/fa/types/collectionQueue.ts
</Accordion>
