Setup page · General ledger
Ledger reasons
A setup page where reason codes are created for General ledger only.
- Used by
- Accountant, Accounting manager, Accounting supervisor and 6 more roles
- Business process
- Define financial reason codes in Dynamics 365 Finance
- Menu item
LedgerReasons- Main table
ReasonTable- Data entity
VendVendorReasonsEntity- Setup steps
- 1 on this page
Show what matters for
Everyone
1What it is and why
| What it is | A setup page where reason codes are created for General ledger only. |
|---|---|
| What you do here | Used to create reason codes, each with a default comment, that users select to record why a transaction or change was made. |
| Example | — |

Functional consultant · Solution architect
2Where it fits
| Business process | Define accounting policies › Define posting policies › Define financial reason codes in Dynamics 365 Finance |
|---|---|
| Menu path | General ledger › Journal setup › Ledger reasons |
| Set up first | — |
| Used next by | — |
| Related pages | Financial reasons Microsoft Learn ↗ |
End user · Functional consultant
3How to do it
Step by step, with screenshots
Set up Ledger reasons1 screen
Microsoft's steps
- Go to General ledger > Journal setup > Ledger reasons.
- Select New.
- In the Reason code field, enter a code.
- In the Default comment field, enter a description of the code.
Source: Microsoft Learn ↗
Field guide
| Field | What it means | Worked example | Table column |
|---|---|---|---|
| Reason code | A code users pick to record why a change or transaction was made, such as a write-down or payment reversal.Microsoft Learn ↗ | BEAT-ADJ | — |
| Default comment | The description that goes with the reason code.Microsoft Learn ↗ | Atlas demo adjustment | Description |
| Ledger | — | Yes | Ledger |
Functional consultant
4Setup decisions
| Setup step | Recommended value and why | Decision · common mistake · test |
|---|---|---|
| Set up Ledger reasons | — | — |
Solution architect
5Design impact
| Shared or per company | Per company: each legal entity has its own records. Microsoft data model ↗ |
|---|---|
| Can it be undone | — |
| Feature or country | — |
| If you change it later | — |
Technical architect
6Technical
| Menu item | LedgerReasons Checked in Dynamics 365 |
|---|---|
| Form | Reasons Checked in Dynamics 365 |
| Table | ReasonTableShown as “Reasons” in Record infoChecked in Dynamics 365 |
| Data entities | VendVendorReasonsEntityVendor reasons Microsoft data model ↗LedgerFinancialReasonEntityFinancial reasons Microsoft data model ↗ |
| Who can open it | PrivilegesMaintain ledger reason codes LedgerReasonsMaintainView ledger reason codes LedgerReasonsViewDutiesEnable budget process BudgetBudgetProcessEnableEnable general ledger process LedgerGeneralLedgerProcessEnableInquire into general ledger reference data LedgerGeneralLedgerReferenceDataInquireEnable general ledger process RentalLedgerGeneralLedgerProcessEnable9 security rolesBudget managerBudgetBudgetManagerChief financial officer CompanyChiefFinancialOfficerAccountant LedgerAccountantAccounting manager LedgerAccountingManagerAccounting supervisor LedgerAccountingSupervisorFinancial controller LedgerFinancialControllerRental manager RentalManagerRental purchasing manager RentalPurchasingManagerRental sales manager RentalSalesManager |
| Actions on the page | — |
Developer
7Developer
| Open it directly | https://<your-environment>/?mi=LedgerReasons |
|---|---|
| Integrate with | VendVendorReasonsEntity data entity Microsoft data model ↗ |
| Table definition | ReasonTable columns and relations Microsoft data model ↗ |
Everyone
8Sources and checks
- learn.microsoft.com/previous-versions/dynamicsax-2012/appuser-itpro/set-up-reason-codes-for-financial-modules
- https://aka.ms/BusinessProcessCatalog
- learn.microsoft.com/common-data-model/schema/core/operationscommon/tables/finance/ledger/group/reasontable
- Checked in a working Dynamics 365 system, version 10.0.49: the menu item, form, table and security, the page, the demo records and the values in the screenshots.

