Manage customer deductions on payments in Dynamics 365 Finance
Menu item
TAMDeductionWriteOffReason
Main table
TAMDeductionWriteOffReasonTable
Data entity
TAMPaymentDeductionWriteOffReasonCodeEntity
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 is
A setup page where you create reason codes that explain why a deduction is written off on the deduction workbench.
What you do here
Use this page to give users a reason code to select when they write off a deduction, with a posting account and an optional maximum amount.
Example
For example, BEAT writes off small deduction balances up to 25.00 with reason SMALLBAL to account 681200, so a 12.40 rounding short-pay from BEAT-000123 is closed in one step.
The page in Dynamics 365. page title tab to open what to set or check
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 Deduction write-off reasons1 screen
Use this page to give users a reason code to select when they write off a deduction, with a posting account and an optional maximum amount.
Screen 1
Create a deduction write-off reason
Go to Sales and marketing > Trade allowances > Deductions > Deduction write-off reasons
Select New
Enter the reason code and description
Optionally enter the maximum amount that can be written off with this reason
Select the main account the write-off posts to
Select Save
1Reason code
BEAT-DWO
Description
Write-off reason
Maximum write-off
100.00
Main account
610100
Show the full screen page title tab to open what to set or check
Steps from Microsoft
Go to Sales and marketing > Trade allowances > Deductions > Deduction write-off reasons.
Select New.
Enter a reason code and a description.
Enter the maximum write-off amount allowed for the reason code (0 means no maximum).
Give each write-off reason the Main account that write-offs of that kind must post to.When a deduction with a claim journal is written off, a claim journal is posted to the deduction's write-off reason code, so the reason decides where the write-off lands in the ledger.
Using one generic reason for every write-off puts all write-offs in one account and loses the reason for analysis on the Deduction events tab.Test: Write off and reverse a deduction
Feature management and licence
Licence or add-in
On the live system, Collections manager use this page.
Reversible: A write-off can be undone with Reverse write-off, which posts a reversing claim journal and reopens the deduction.
If you change it later
When a deduction with a claim journal is written off, a claim journal is posted to the deduction's write-off reason code and the deduction closes with Claim status Write-off; Reverse write-off posts a reversing claim journal. Microsoft Learn
Technical architect
6Technical
Menu item
TAMDeductionWriteOffReasonChecked in Dynamics 365
Form
TAMDeductionWriteOffReasonChecked in Dynamics 365
Table
TAMDeductionWriteOffReasonTableShown as “Deduction write-off reasons” in Record infoKey field: TAMDeductionWriteOffReasonChecked in Dynamics 365
Data entities
TAMPaymentDeductionWriteOffReasonCodeEntityPayment deduction write off reason code Microsoft data model
Who can open it
PrivilegesMaintain deduction write-off reasons TAMDeductionWriteOffReasonMaintainDutiesMaintain customer deductions information TAMCustDeductionMaintain1 security roleCollections manager CollectionLetterCollectionsManagerChecked in Dynamics 365
Roles to set it up and use it
To set it up or change itCollections manager CollectionLetterCollectionsManagerGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Actions on the page
Options: Personalize, Page options, ShareChecked in Dynamics 365
TAMPaymentDeductionWriteOffReasonCodeEntity (Payment deduction write off reason code): loaded for each company.Load order: No default configuration template places this entity. Load the write-off reasons after the main accounts they post to.Load first: Main accountsMicrosoft Learn
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.
To cite this step: SM-TAM-040, Set up Deduction write-off reasons. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/SM-TAM-040