AP Preferences, Hold Documents on Entry and Automatically Release Retainage

  • 2 February 2021
  • 2 replies


Going to AP Preferences and unchecking “Hold Documents on Entry” and or checking “Automatically Release Retainage Bills” does not seem to do anything.

Can anyone explain what toggling these two button will do?

We would like, upon release of the retainage bill the bill is created with an Open status.  Our retainage bills are going to a Hold status, which creates extra work.

See screen shot below from the Acumatica help menu.

Financial Management/
Accounts Payable/
Processing Bills with Retainage


2 replies


what about “Hold Documents on Entry” checkbox on the “AP Preferences” (AP101000) screen - it is related to “Hold” checkbox on the “Bills and Adjustments” (AP301000) screen. When it is equal to true then all your new Bills will be created with “Hold” flag equal to true by default, otherwise false.

what about “Automatically Release Retainage Bills” checkbox on the “AP Preferences” (AP101000) screen - it is related to “Release AP Retainage” (AP510000) screen. When it is equal to true then all your Retainage Bills, created during the process, will be released automatically even if “Hold Documents on Entry” is equal to true. As a result, they will be in Open status, otherwise Balanced.

:exclamation: the only one exception - is when you should Approve your Bill before release. In this case, all Retainage Bills, created during the “Release AP Retainage” process will be on “Hold”, no matter what values “Hold Documents on Entry” or “Automatically Release Retainage Bills” flags have.

here is complete logic on how we set Retainage Bill "Hold" flag value: “Automatically Release Retainage Bills” = false AND “Hold Documents on Entry” = true OR Approval required


Thank you ekralko.


About Acumatica ERP system
Acumatica Cloud ERP provides the best business management solution for transforming your company to thrive in the new digital economy. Built on a future-proof platform with open architecture for rapid integrations, scalability, and ease of use, Acumatica delivers unparalleled value to small and midmarket organizations. Connected Business. Delivered.
© 2008 — 2020  Acumatica, Inc. All rights reserved