Approval Process when using Payment Proposals

Overview 

Payment Proposals is a feature that is used to provide a way to help businesses with a large number of bills to determine how to pay these bills. When using Payment Proposals, you might want to have an Approval Process in place. This process will help to ensure that payments are made accurately, in a timely manner, and to keep in line with your company’s financial budget.

You can configure a Salesforce Approval Process on Payment Proposals in support of your business requirements for approvals. Two examples are listed below:

• The Accounts Payable staff proposes Payables to pay and submits them to the Controller for approval. If the total batch of Payables exceeds a certain dollar amount, it will require the CFO’s approval.
• An External Accountant proposes Payables to pay and sends off to the Owner for approval.

Do you want to:

• Configure the Approval Process on Payment Proposals or Cash Disbursements
• Review the Best Practice – Payment Proposal Approval Process

Configure the Approval Process on Payment Proposals or Cash Disbursements

If you decide to configure an Approval Process on Payment Proposals, you may not need an Approval Process on Cash Disbursements since these records are created from Payment Proposals, and if a Payment Proposal is approved, then theoretically all Cash Disbursements created from it are also approved. However, if you decide to move the Approval Process from Cash Disbursements to Payment Proposals, you might want to consider preventing the creation of Cash Disbursements outside of the Payment Proposals screen. This can be accomplished, for example, by removing the following:

• New button from the Cash Disbursement screen and the list view
• Pay button from the Payable page layout and Pay Batch button from the Payable list view
  Note: If Contacts and/or Employees are paid using the Pay screens, you will need to keep these buttons. 
• New button from the Cash Disbursements tab on the Cash Disbursement Batch screen and also from the Cash Disbursement Batches list view.

Additionally, on any screen that includes a Cash Disbursement related list, such as on the Account record, the New button would need to be removed.

If you do not want to remove all of the above buttons, preventing the creation of Cash Disbursements outside of Payment Proposals can also be accomplished using permissions, by perhaps allowing certain team members to have access to Cash Disbursements. Since the Cash Disbursements are created automatically from the Payment Proposals, and you can configure a job to automatically post the Cash Disbursements, certain team members may no longer require access to Cash Disbursements or perhaps they might need read only access.

Return to top

Best Practice - Payment Proposal Approval Process

The information provided below presents our best practice recommendation to configure a Payment Proposal Approval Process.

Create Email Templates

The process starts with creating Classic Email Templates for email alerts that will be sent when a Payment Proposal is submitted for approval, as well as when it is rejected.

Payment Proposal Approval Request Email Template

1. Click the Gear icon, and select Setup.
2. Enter Classic Email Templates in the Quick Find textbox. Then, select it.
3. Click New Template.
4. Leave the Text radio button selected, and click Next.
5. Under Step 2. Test Email Template: New Template, enter/select the following:
   1. 1. Folder: enter Accounting Seed Email Templates
      2. Available for Use: select this checkbox
      3. Email Template Name: enter Payment Proposal Approval Request
      4. Template Unique Name: click in this field to display the Template Unique Name
      5. Encoding: leave the default that displays
      6. Description: enter Email template for emails sent when a Payment Proposal is submitted for approval
      7. Subject: enter Please approve this Payment Proposal: {!AcctSeed__Payment_Proposal__c.Name}
      8. Email Body: enter Please approve this Payment Proposal: {!AcctSeed__Payment_Proposal__c.Link}
6. Click Save.

Payment Proposal Rejected Email Template

1. Select Classic Email Templates.
2. Click New Template.
3. Leave the Text radio button selected, and click Next.
4. Under Step 2. Test Email Template: New Template, enter/select the following:
   1. 1. Folder: enter Accounting Seed Email Templates
      2. Available for Use: select this checkbox
      3. Email Template Name: enter Payment Proposal Rejected
      4. Template Unique Name: click in this field to display the Template Unique Name
      5. Encoding: leave the default that displays
      6. Description: enter Email template for emails sent when a Payment Proposal is rejected
      7. Subject: enter This Payment Proposal was rejected: {!AcctSeed__Payment_Proposal__c.Name}
      8. Email Body: enter This Payment Proposal was rejected: {!AcctSeed__Payment_Proposal__c.Link} Please review, adjust, and resubmit
5. Click Save.

Create the Approval Process

After creating the email templates, continue to create the actual Approval Process.

1. Enter Approval Processes in the Quick Find textbox. Then, select it.
2. From the Manage Approval Process For drop-down list, select Payment Proposal.
3. Select Use Standard Setup Wizard from the drop-down list.
   
   Note: Click here to view the above image in full screen. 
   
   
4. Enter Payment Proposal Approvals in the Process Name field.
5. Click in the Unique Name field to display it.    
6. Enter Approval Process for Payment Proposals in the Description textbox.
7. Click Next.
8. From the first Field drop-down list, select Payment Proposal: Status.
9. From the Operator drop-down list, select not equal to.
10. Enter Submitted, Approved, Inactive, Processed in the Value textbox.
11. Click Next.
12. Under the Record Editability Properties section, leave the Administrators ONLY can edit records during approval process radio button selected.
13. Click Next.
14. Enter Approval Process for Payment Proposals in the Description textbox.
15. Select the email template that you created for a Payment Proposal Approval Request.
    
    Note: Click here to view the above image in full screen. 
    
    
16. Click Next.
17. From the Available Fields listing, select and add the following fields into the Selected Fields listing, in the order below.
    1. 1. Payment Proposal Name
       2. Owner
       3. Type
       4. Payment Date
       5. Bank GL Account
       6. Aggregate by Payee
       7. Payables Total
       8. Credit Memos Total
       9. Total
18. Under Approval Page fields, select the Display approval history information in additional to the fields selected above checkbox.
19. Under the Security Settings, leave the Allow approvers to access the approval page only from within the Salesforce application (Recommended) radio button selected.
20. Click Next.
21. Under the Initial Submitters section, select Owner from the Search drop-down list.
22. From the Available Submitters listing, select and add Payment Proposal Owner to the Allowed Submitters listing.
23. Under the Page Layout Settings section, select the Add the Submit for Approval button and Approval History related list to all Payment Proposal page layouts checkbox.
24. Under the Submission Settings, select the Allow submitters to recall approval requests checkbox.
25. Click Save.
26. Select Approval Processes again from the left navigation menu. Then, click your Payment Proposal Approvals process.
    
    Note: Click here to view the above image in full screen. 
    
    
27. Under the Initial Submission Actions section, click Add New and select Field Update.
    
    Note: Click here to view the above image in full screen. 
    
    
28. Enter Update Status to Submitted in the Name field.
29. Click in the Unique Name field to display it.
30. Enter When a Payment Proposal is submitted for approval, update the Status field to Submitted in the Description textbox.
31. Select Status from the Field to Update drop-down list.
32. Under the Specify New Field Value section, with the A specific value radio button selected, select Submitted from the drop-down list.
33. Click Save.
34. Select Approval Processes again from the left navigation menu. Then, click your Payment Proposal Approvals process.
    Note: The same as in step 26 above. 
35. For a simple 1-step approval process, under the Approval Steps section, click New Approval Step.
36. Enter Step 1 in the Name field.
37. Click in the Unique Name field to display it.
38. Leave the default of 1 in the Step Number field.
39. Click Next.
40. Leave the All records should enter this step radio button selected.
41. Click Next.
42. Under the Select Approver section, select the Automatically assign to approver(s) radio button.
43. To the right of the User drop-down list, click the Lookup icon to search for and select the appropriate username.
44. (Optional) To configure multiple approvers, click Add Row. Then, select an additional approver(s), as necessary.
45. If you select more than one approver, select one of the following radio buttons:
    
    1. 1. Approve or reject based on the FIRST response – select this option if only one of the approvers is required to approve.
       2. Require UNANIMOUS approval from all selected approvers - select this option if all approvers must approve the Payment Proposal.
46. Select The approver’s delegate may also approve this request checkbox if you want to configure a “Delegated Approver” on the approver user accounts.
47. Click Save.
48. From the Final Approval Actions section, click Add New and select Field Update.  
49. Enter Update Status to Approved in the Name field.
50. Click in the Unique Name field to display it.
51. Enter When a Payment Proposal is Approved, update the Status field to Approved in the Description textbox.
52. Select Status from the Field to Update drop-down list.
53. Under the Specify New Field Value section, with the A specific value radio button selected, select Approved from the drop-down list.
54. Click Save.
55. From the Final Rejection Actions section, click Add New and select Field Update. 
56. Enter Update Status to Rejected in the Name field.
57. Click in the Unique Name field to display it.
58. Enter When a Payment Proposal is Rejected, update the Status field to Rejected in the Description textbox.
59. Select Status from the Field to Update drop-down list.
60. Under the Specify New Field Value section, with the A specific value radio button selected, select Rejected from the drop-down list.
61. Click Save.
62. From the Final Rejection Actions section, click Add New and select Email Alert.
63. Enter Email alert will be sent to inform the Payment Proposal Owner that the Payment Proposal was rejected in the Description textbox.
64. Enter Payment_Proposal_Rejected in the Unique Name field.
    Note: The Unique Name is the API Name, and therefore requires underscores between each word.
65. From the Email Template field, select the Lookup icon to search and select the email template that you created for Payment Proposal Rejection. 
    Note: From the Lookup search dialog box, remember to select the Accounting Seed Email Templates in order to view the Payment Proposal email templates that you created. 
66. From the Recipient Type, click the Search drop-down list and select Owner.
67. From the Available Recipients listing, select Payment Proposal Owner. Then, click Add to add it to the Selected Recipients listing.
68. Under Recall Actions, click Add New and select Field Update. 
69. Enter Update Status to In Progress in the Name field.
70. Click in the Unique Name field to display it.
71. Enter When a Payment Proposal is Recalled, update the Status field to In Progress in the Description textbox.
72. Select Status from the Field to Update drop-down list.
73. Under the Specify New Field Value section, with the A specific value radio button selected, select In Progress from the drop-down list.
74. Click Save.
75. Now, you will need to restrict access to the Status field using a Validation Rule. Click the Object Manager tab.
76. From the Quick Find search textbox, enter Payment Proposal. Then, select that object.
77. Click Validation Rules and then, click New.
78. Enter Requires Approval in the Rule Name field.
79. Select the Active checkbox.
80. Enter All Payment Proposals are required to be submitted for approval in the Description textbox.
81. In the Error Condition Formula field, enter the following:
    
    AND (

    ISCHANGED(AcctSeed__Status__c ),

    Name != "Automated Process"

    )
    
    

82. In the Error Message field, enter You must submit a Payment Proposal for approval.
83. From the Error Location, select the Top of Page radio button.
84. Click Save.

Return to top

Update the Lightning Record Page to add the Approval History Related List

If you are using a Lightning Record Page for Payment Proposals, and you do not already have the Approval History related list included, do the following.

1. Display a Payment Proposal record.
2. Click the Gear icon, and select Edit Page.
3. Click an insertion point where you want to display the related list, such under the Payment Proposal Lines.
4. From the left navigation Components list, select Related List – Single. Then, drag and drop it into the insertion point.
5. From the right panel, under Related List, click the Lookup icon to select Approval History.
6. Click Save.

Add an Approval Requests Navigation item to the Accounting application

Adding a navigation item for Approval Requests will make it easy for you to view the items that are awaiting your approval.

1. From the far right-side of any Accounting screen, click the Pencil icon to display the Edit Accounting App Navigation Items dialog box.
   
   
   Note: Click here to view the above image in full screen. 
2. Click Add More Items.
3. From the left panel, select All. Then, scroll down to Approval Requests and click the + (plus) sign.
4. Click Add 1 New Item.
5. Click Save. Approval Requests will be available as a navigation item (you might need to click the More drop-down list to see it).
6. Click the Approval Requests navigation item to display the Approval Requests page, which will allow you to view all the items that require your approval.
   
   Actions in the drop-down list to the right of each item/row will allow you to Approve, Reject, or Reassign each one. You can also click the link to access an item to view key fields from the Payment Proposal, and perform these same actions. Otherwise, you can access the source document to view all fields and then, scroll down to the Approval History related list to perform these actions.

Return to top

____________________

Spring '24 Release

Release Notes and Schedule

This article was new with the Spring '24 release.