Annual Statements - FAQ

1. PDFs are not being stored against the Contact

Please check all of the following:

  1. PDFs are only created and saved during Generate phase.  They are not generated and saved again when sending
  2. Statements are only generated for Contacts that are Campaign members of the Statement Campaign
  3. Check if there are any errors logged on Payments2us Error logs. If any, please see FAQ 5.
  4. The Statements are stored in Notes & Attachments related list of Contact and NOT in Files related list.
  5. Make sure you have Statement Letter specified on the Campaign.

6.  If you are on a release prior to 5.4, then you need to disable a critical update for "PageReference getContent() and getContentAsPDF() Methods Treated as Callouts"

This is done by going to setup (top right), then enter "Critical Update" in the Quick find/search.  Click into "Critical Update" and press the "Deactivate" link next too "PageReference getContent() and getContentAsPDF() Methods Treated as Callouts".  

If this Critical Update option no longer exists, you'll need to update to a new version.  See the upgrade procedure at: How to perform an upgrade

2. I don't want the membership number to show on the statement header

If you would rather have say "Supporter No." then:

  • On the Campaign you are running the Statements from, click into the Payment Form that you've linked to this Campaign.  Alternatively, go to the Merchant Facility Tab, click into the Merchant Facility, scroll down to the Payment Forms related list and click into the Payment Form that you'd use for your annual statements or the Payment Txn's are linked to.
  • Update the value in the field "Membership Id Label" to be what you would like - e.g. "Supporter No."

If the changing of the label is not what you are after, then you can replace the entire heading.  See How to put your company letterhead on the Receipt Template

3. What are the various Campaign Status's used for

The Campaign Members of the Campaign for will have the Status updated for the various steps.  These are:

  • Statement Generated : This is for the first step where a PDF is generated and stored against the Campaign Members related contact record
  • Statement Send: This is the status initially assigned when a request is made to send (email) the statement to the Contact.  The workflow "Send Annual Statement" is triggered by the Campaign Member Status of "Statement Send" and is the mechanism for emailing the statement.

To manually resend a statement, you could simply change the Campaign Member Status to "Send Annual Statement" and it will send it again.

4. How to I apply a letterhead to an Annual Statement but not change the general letterhead on the Merchant Facility?

Different Letterheads can be applied at the Letter level. Use the following procedure, but apply to the Notes and Attachements on the Letter record.

 

5. Why getting error - "PDFStatementGenerateProcessor- Apex Batch Error, Exception: System.Unexpected Exception, PHASE:EXECUTE......."?

Please check the merge fields on the letter object. 

  • The most common issue with the statement generation is merge fields are not valid. 
  • Use the letter builder/email templates to add fields to the merge text.

If you've added custom fields to the field sets, try removing those and testing again.   Please note, for field sets, you can only add fields from that Object and NOT  related object (e.g contact >FirstName).

On the statement campaign, related list campaign members. 

  • Click into a campaign member - press the annual statement button there. 
  • This might show an individual statement PDF generation error message that might be helpful.

Another item to try is removing most of the text from the receipt letter body and retrying.  NOTE: please do not remove all text, but leave a little - e.g "Hi Donor".  
If the removing of text works, use the Letter Builder to add fields back in.

6. How to change the name of the pdf. that is send?

The Pdf name is maintained in the email template that is sent along with the statement pdf.

To change PDF name

Go to Setup->Classic Email Templates-> select folder: "Payments2Us" -> search for 'Mass Annual Statement w/PDF' -> click into the Email --> press "Edit Template" button.

Scroll down to "<messaging:attachment renderAs="PDF" filename="Annual Statement {!YEAR(TODAY())}.pdf">" section and then replace the file name with your custom text.

 

Please note:

1. The Statement Generated will not have the new text. As this is rendered when the email is sent.

2. The Pdf sent with the email will have the new custom text you have given. To test the new wording for the pdf, you will need to press Statement Send button.

3.The fields that you can use in this template are from Contact and Campaign Member.

7. How do I change the reporting period for the Single Annual Statement?

The Pdf name is maintained in the email template that is sent along with the statement pdf.

To change PDF name

Go to Setup->Classic Email Templates-> select folder:  "Payments2Us" -> search for 'Single Annual Statement w/ PDF' -> click into the Email --> press "Edit Template" button.

Scroll down to "<c:PDFStatementComponent aid="{!recipient.accountId}" cid="{!recipient.Id}" layoutType="NONE" subject="Statement {0} - {1}" reportingPeriod="CurrentFY"/>" and adjust the reportingPeriod to either "CurrentFY" or "PreviousFY"

The Fiscal year date range is maintained in standard Salesforce setup under: setup - search "Fiscal Year" (Consult Salesforce online help for more information if needed)