BeyondERP.Newsletter
Menu

Job page · Procurement and sourcing

Purchase update history cleanup

A periodic cleanup job that deletes the update history created when purchase order confirmations, picking lists, product receipts and invoices are posted.

Business process
Procure goods and services
Menu item
action:PurchParmCleanUp
Show what matters for
PAGE GUIDEWhat the page does and how to use it7 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA periodic cleanup job that deletes the update history created when purchase order confirmations, picking lists, product receipts and invoices are posted.
What you do hereUse this periodic task to remove purchase update history records, up to a date you choose.
Purchase update history cleanup 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

Business processProcure goods and services
Menu pathProcurement and sourcing › Periodic tasks › Clean up › Purchase update history cleanup
Related pagesDelete requests for quotations Microsoft Learn Draft consignment replenishment order journal cleanup Microsoft Learn All purchase orders Microsoft Learn
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.

When to run it

When to run itWhen the update history from posting purchase confirmations, picking lists, product receipts and invoices has grown and the old entries are no longer needed.
How oftenOn demand, for example once or twice a year, after the business has agreed the retention period.
Batch settingsRun it in the background outside business hours when years of history are deleted at once.
What the output showsPurchase update history created up to the date you entered, with the status you chose, is deleted. Posted documents and their journals are not affected.

Source: Microsoft Learn

Steps from Microsoft

  1. Go to Procurement and sourcing > Periodic tasks > Clean up > Purchase update history cleanup.
  2. In Clean up, choose Executed to delete only history from updates that completed, or Executed and erroneous to also delete history from updates that failed.
  3. In Created until, enter the last creation date to delete. Keep recent history so you can still look into current confirmations, product receipts and invoices.
  4. Run the job in a test environment first and agree with the business that the history isn't needed.
  5. Select OK, then open the history on update for a recent purchase order to make sure newer history is still there.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
Clean upThe status of the update history to delete, such as Executed or Executed and erroneous.Microsoft Learn
Created untilHistory created up to this date is deleted.Microsoft Learn

Test checklist

  1. History created before the date is gone.
  2. History after the date is still shown on the order.
  3. Posted purchase documents still open normally.

Source: Microsoft Learn

Solution architect

4Design impact

Can it be undoneNo: Deleted update history can't be restored. Run it only after the business confirms the history is no longer needed. Microsoft Learn
If you change it laterDeletes purchase update history records of confirmations, picking lists, product receipts and invoices up to the date you entered. Microsoft Learn
Technical architect

5Technical

Menu itemaction:PurchParmCleanUp Checked in Dynamics 365
FormDialog Checked in Dynamics 365
Roles to set it up and use itTo use itInformation technology manager SysServerITManagerGive people one of these roles. On this system, 1 role can run this page.Checked in Dynamics 365
Developer

6Developer

Open it by URLhttps://<your-environment>/?mi=action:PurchParmCleanUp
Everyone

7Sources