# commission_ledger_update

> Update mutable fields of a commission ledger entry — typically advancing status (pending → processing → paid), recording the actual payout date / check number, or correcting amounts.

<!-- Source: https://docs.actuallycare.com/tools/commission-ledger/commission_ledger_update -->

Update mutable fields of a commission ledger entry — typically advancing status (pending → processing → paid), recording the actual payout date / check number, or correcting amounts. Use as payouts move through processing. Setting status to paid without an actual_payout_date stamps the current date automatically. Only entries the caller can see may be updated. Returns the updated ledger entry.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | UUID of the commission ledger entry to update · Format: UUID |
| `status` | enum | No | New payment status · One of: `pending`, `processing`, `paid`, `cancelled` |
| `sale_price` | number | No | Corrected sale price in dollars · Min: 0 |
| `commission_rate` | number | No | Corrected commission rate (percent) · Min: 0 |
| `brokerage_split` | number | No | Corrected brokerage split percentage · Min: 0 |
| `gross_commission` | number | No | Corrected gross commission in dollars · Min: 0 |
| `agent_commission` | number | No | Corrected agent commission in dollars · Min: 0 |
| `net_commission` | number | No | Corrected net commission in dollars · Min: 0 |
| `referral_fee` | number | No | Corrected referral fee in dollars · Min: 0 |
| `transaction_fee` | number | No | Corrected transaction fee in dollars · Min: 0 |
| `projected_payout_date` | string | No | Projected payout date (YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `actual_payout_date` | string | No | Actual payout date (YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `check_number` | string | No | Check number for the payout |
| `deposit_account` | string | No | Deposit account the payout went to |
| `notes` | string | No | Free-text notes about this commission |

## Example prompts

- "Update one of my commission ledger."

## Safety

**Updates data.** Changes an existing record. The change is visible immediately in the app and can be edited back.