BeyondERP.Newsletter
Menu

Setup step on the Vendor write-off reason codes page · Accounts payable

Set up 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
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you create the write-off reason codes for vendor transactions, each with an assigned account.
What you do hereUse this page to provide the reason codes, and their accounts, that are used when you settle a remaining vendor amount with Settle remainder.
ExampleFor 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.
Vendor write-off reason codes page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Step by step, with screenshots

Set up Vendor write-off reason codes1 screen
  1. Screen 1

    Create the vendor write-off reason code

    Go to Accounts payable > Setup > Vendor write-off reason codes

    1. Select New
    2. Enter the reason code, description and write-off account
    3. Leave Default unticked
    1Reason codeBEAT-CRED
    DescriptionCredit adjustment
    Write-off account610100
    DefaultNo
    Create the vendor write-off reason code (zoomed on the outlined fields)
    Show the full screenCreate the vendor write-off reason code
    page title tab to open what to set or check

How to use it

  1. Go to Accounts payable > Setup > Vendor write-off reason codes.
  2. Select New to add a row.
  3. Enter the Reason code and its Description.
  4. Choose the Write-off account.
  5. Use the Default column to mark a default if it applies.
  6. Select a row and select Edit to change it, or select Delete to remove it.

Source: Checked in Dynamics 365

Fields on the page

FieldWhat it meansExampleTable column
Reason codeThe code that identifies the write-off reason.Checked in Dynamics 365SMALLBALReason
DescriptionA short description of the write-off reason.Checked in Dynamics 365Credit adjustmentDescription
Write-off account610100WriteOffLedgerDimension
DefaultNoIsDefault

Test checklist

  1. Create a write-off reason code with a write-off account.
  2. In Accounts payable parameters, Settlement tab, turn on Enable settle remainder, select the reason as default and a default journal name.
  3. Settle a payment that leaves a small remainder on an invoice and select Settle remainder.
  4. Check the journal line uses the reason's account as offset and the invoice is fully settled after posting.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Vendor write-off reason codesOne reason code per write-off cause with its write-off account, one of them selected as Default reason code on the Settlement tab of Accounts payable parametersSettle remainder needs a default reason code, and the default settle remainder account comes from the account on that reason code.Turning on Enable settle remainder before the reason codes and a Default journal name exist: the reason codes must already be set up, and a default journal name is required.
Solution architect

5Design impact

Can it be undoneReversible: The reason and account default into the Settle remainder dialog and can be changed there; edits affect later settlements only.
Technical architect

6Technical

Menu itemVendWriteOffFinancialReasonsSetup Checked in Dynamics 365
FormVendWriteOffFinancialReasonsSetup Checked in Dynamics 365
TableVendWriteOffFinancialReasonsSetupShown as “Vendor write-off reason codes” in Record infoKey field: RecIdChecked in Dynamics 365
Who can open itPrivilegesProcess settle remainder for vendors VendSettlementWriteOffProcessDutiesMaintain vendor payments PaymVendorPaymentsMaintain
1 security roleAccounts payable payments clerk PaymAccountsPayablePaymentsClerk
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itAccounts payable payments clerk PaymAccountsPayablePaymentsClerkGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=VendWriteOffFinancialReasonsSetup
Table definitionVendWriteOffFinancialReasonsSetup columns and relations Microsoft data model
Everyone

8Sources

To cite this step: AP-SETUP-190, Set up Vendor write-off reason codes. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/AP-SETUP-190