A report that totals the amounts retained from project vendor invoices under vendor payment retention terms, summarized by vendor or by project, for a date range.
Project management and accountingInquiries and reportsRetention reports
output:PSAVendorRetention
Business process
Analyze project performance
Menu item
output:PSAVendorRetention
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone
1What it is and why
What it is
A report that totals the amounts retained from project vendor invoices under vendor payment retention terms, summarized by vendor or by project, for a date range.
What you do here
Use it before releasing retention to a vendor to see how much is still held per vendor or project.
Example
When PRJ-0042 reaches 80% completion in October 2026, BEAT's project accountant runs the report by vendor for V-1020: 3,000.00 was retained on phase 1 and 900.00 on phase 2, and 300.00 is due for release under term VRT-20.
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.
When to run it
When to run it
Before you release retained amounts to a vendor, or when a project reaches a percentage of completion set in the vendor retention terms.
How often
On demand, at project milestones or before vendor payments are released.
What the output shows
Amounts retained from vendor invoices, summarized by vendor or by project. A vendor with no retention usually has no vendor retention terms on the project's Vendor agreements.
No vendor retention terms are on the project's Vendor agreements for that vendor (or its vendor group); add the term there. Retention applies to purchase orders created afterwards. Microsoft Learn
Set Assessment to Vendor and select the vendor you plan to pay, with the date range from the start of the project.Retention terms are applied per vendor (or vendor group) on the project's Vendor agreements and released by percentage of completion, so a vendor view shows what that vendor is still owed.
On the live system, Project manager and Project accountant can run this page.
Checked in Dynamics 365
Solution architect
5Design impact
Shared or per company
Per legal entity: the report reads only the project data of the company you are signed in to, so run it in each company you close. Checked in Dynamics 365
Can it be undone
Reversible: the report changes no data: The vendor retention report only reads vendor invoice data; it changes nothing. Microsoft Learn
If you change it later
The report reads retained amounts on posted vendor invoices. A change to the retention terms or to the project's Vendor agreements applies to purchase orders and invoices created afterwards, so amounts already retained stay as they are. Microsoft Learn
Technical architect
6Technical
Menu item
output:PSAVendorRetentionChecked in Dynamics 365
Form
SysOperationTemplateFormChecked in Dynamics 365
Roles to set it up and use it
To use itProject manager ProjProjectManagerProject accountant ProjProjectAccountantGive people one of these roles. On this system, 2 roles can run this page.Checked in Dynamics 365
Load order: Vendor payment retention has no data entity in Data management: the menu item PSAVendorRetention opens a report that only reads posted project data. There is nothing to migrate for the report itself; load the project data it reads, for example opening balances through Journals > Beginning balance, then run the report in the new system and compare its totals with the old one.Checked in Dynamics 365