Setup page · Accounts payable
Vendor write-off reason codes
A setup page where you create the write-off reason codes for vendor transactions, each with an assigned account.
- Used by
- Accounts payable payments clerk
- Business process
- Manage supplier settlements in Dynamics 365 Finance
- Menu item
VendWriteOffFinancialReasonsSetup- Main table
VendWriteOffFinancialReasonsSetup- Data entity
- —
- Setup steps
- 1 on this page
Show what matters for
Everyone
1What it is and why
| What it is | A setup page where you create the write-off reason codes for vendor transactions, each with an assigned account. |
|---|---|
| What you do here | Used to provide the reason codes, and their accounts, that are used when you settle a remaining vendor amount with Settle remainder. |
| Example | For example, when a payment does not fully settle a vendor invoice, you can settle the remaining amount to a ledger account with a reason code instead of leaving the invoice open. |

Functional consultant · Solution architect
2Where it fits
| Business process | Manage accounts payable › Issue and settle supplier payments › Manage supplier settlements in Dynamics 365 Finance |
|---|---|
| Menu path | Accounts payable › Setup › Vendor write-off reason codes |
| Set up first | — |
| Used next by | Accounts payable parameters Microsoft Learn ↗ |
| Related pages | — |
End user · Functional consultant
3How to do it
Step by step, with screenshots
Set up Vendor write-off reason codes1 screen
Screen 1
Create the vendor write-off reason code
Go to Accounts payable > Setup > Vendor write-off reason codes
- Select New
- Enter the reason code, description and write-off account
- Leave Default unticked
1Reason code BEAT-CRED Description Synthetic BEAT credit test Write-off account 610100 Default No 
page title tab to open what to set or check
Microsoft's steps
—
Field guide
| Field | What it means | Worked example | Table column |
|---|---|---|---|
| Reason code | — | BEAT-CRED | — |
| Description | — | Synthetic BEAT credit test | Description |
| Write-off account | — | 610100 | WriteOffLedgerDimension |
| Default | — | No | IsDefault |
Functional consultant
4Setup decisions
| Setup step | Recommended value and why | Decision · common mistake · test |
|---|---|---|
| Set up Vendor write-off reason codes | — | — |
Solution architect
5Design impact
| Shared or per company | — |
|---|---|
| Can it be undone | — |
| Feature or country | — |
| If you change it later | — |
Technical architect
6Technical
| Menu item | VendWriteOffFinancialReasonsSetup Checked in Dynamics 365 |
|---|---|
| Form | VendWriteOffFinancialReasonsSetup Checked in Dynamics 365 |
| Table | VendWriteOffFinancialReasonsSetupShown as “Vendor write-off reason codes” in Record infoKey field: RecIdChecked in Dynamics 365 |
| Data entities | — |
| Who can open it | PrivilegesProcess settle remainder for vendors VendSettlementWriteOffProcessDutiesMaintain vendor payments PaymVendorPaymentsMaintain1 security rolesAccounts payable payments clerkPaymAccountsPayablePaymentsClerk |
| Actions on the page | Options: Personalize, Page options, ShareChecked in Dynamics 365 |
Developer
7Developer
| Open it directly | https://<your-environment>/?mi=VendWriteOffFinancialReasonsSetup |
|---|---|
| Integrate with | — |
| Table definition | VendWriteOffFinancialReasonsSetup columns and relations Microsoft data model ↗ |
Everyone
8Sources and checks
- learn.microsoft.com/dynamics365/finance/cash-bank-management/settle-remainder
- https://aka.ms/BusinessProcessCatalog
- 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.
