Prerequisites
BEFORE STARTING
Installing the package
STEP #1
Please refer to the “Gonexa Doc Installation” section since the basic configuration for generating a document is common between Gonexa Doc and Gonexa RF.
Assign permissions to users
STEP #2
Authorization sets
Assign permission sets to the people you need
The “Gonexa RF Admin permission set” to administrators who will configure the tool
The “Gonexa RF User Permission Set” for users who will create tax receipts
Gonexa RF authorization set assignment
Assign permission sets to users
💡 As far as roles are concerned, access to the document template is managed via the sharing settings, which are by default “private”, which blocks access to the template, since no sharing rules have been created next to it. We recommend that you change the legal entity sharing and tax receipt setting to public read-only.
⚠️ Also remember to open read/write rights on the fields used in your document templates
Creating a legal entity
STEP #3
Creating a legal entity
From the application launcher, access the Legal Entity object
Create as many legal entities as needed by clicking on New
{Name} Ex. International Committee of the Red Cross
Fiscal year : {Current fiscal year} Ex. 2023
💡 Note that creating receipts whose payment date is not equal to that of the associated legal entity's fiscal year will be impossible.
Street: {Legal Entity Street}
Postal code : {Legal Entity Postal Code}
City: {City of legal entity}
Country: {Country of legal entity}
Logo: {Upload the legal entity logo}
Social purpose: {List the activities carried out by the association}
Signature: {Upload the president's signature image}
Receipt number prefix: {Add a fixed part and a dynamic part between brackets} Ex. Red Cross- {AAAA}
Next receipt number: {Add the starting number from the tax receipt}
Number length: {Fill in the number of the tax receipt number}
Legal Entity Setup
STEP #4
Tax receipt mapping
Always from the Legal Entity object you just created. Access the New button next to Legal Entity Setup to set up the mapping of your tax receipt.
Name your configuration
Choose the legal entity to associate with this configuration
Select the document template you have previously set up from the dropdown list.
Choose the default configuration to apply and, from there, check the “Default configuration” box
💡 Note that a default configuration is unique and mandatory
Mapping proposed by default
Gonexa RF offers a default mapping based on the fields in the Salesforce NPSP package.
💡 The Default Configuration provided to you is based on the Opportunity object and will search for the tax receipt and payment fields: the tax receipt lines.
Creating your own mapping
If your data model requires it, you can customize your own mapping by choosing the fields to fill in your tax receipt.
The default configuration thus validated, customize the header mapping on the one hand by clicking on the Modify symbol in the first step.
Choose the Salesforce object from which you want to create the tax receipt, it is from this that you will use the fields for mapping the tax receipt.
Ex. Contact, Opportunity, Don__c...
Search for the fields available on your object in order to define the elements of the tax receipt: Information on the corporate or individual donor, and on the donor's address.
💡 Leave fields empty if they are not to be used and go up the relationships of your objects to find information on lookups.
Record this first step.
Go to the second step, by clicking on the edit symbol next to the tax receipt mapping.
Choose the Salesforce object from which you want to create tax receipt child objects.
Ex. Payment
Search for the fields available on your object to define the amount elements of the tax receipt lines.
Add filters if you don't want to show all of the items in your donation. Build the filter by writing a SOQL condition.
Ex. status__c = 'settled'
Click on save.
⚠️ Please define fields of the expected type. If an amount is expected, only a number field must be chosen, a date field awaits a date field...
Add the “Create tax receipt” action
STEP #5
Create the quick action
From the Object Manager (object manager) From the configuration, go to the object from which you want to create the tax receipt.
From the Buttons, Links, and Actions tab (Buttons, Links, and Actions) click on New Action
Type: Lightning Web ComponentComponent
Web Lightning: GNX: GonexaQuickActionCreateTaxReceipt
Standard label type: None
Etiquette (Label) : {Name of the button according to your choices}
Name (Name) : {Autofill}
Description: {optional}
Save
💡 Note that this action is based on the Default Legal Entity Configuration, make sure you have selected one before.
Drop the action on the page
Add your button to the page layout, from the Page Layout tab (Layout page).
Select the presentation on which you want to drop the button (Donation, Grant...) and drag and drop it.
Save
List of receipts displayed from your context
STEP #6
You can create a personalized link on the tax receipt to your main original object in order to have quick access to your context once the document is generated using a flow.
Create a look-up to the tax receipt
From Salesforce Setup, go to Object Manager (Object manager)
From your main object, from which you create the tax receipt, create a new field such as Search relationship (Look-up) to the tax receipt
Drop it on your page
Create a field update flow
From Salesforce Setup, go to flow (flows)
Create a flow triggered by creating a record from the Tax Receipt object (GNX_Tax_Receipt__c)
Optimize flows for “Related Actions and Records”
Add a Record Update item
Name it to your liking
In the record search choice, select Use “Use the fiscal receipt record that triggered the flow”
Set trigger conditions to none
Set Tax Receipt Record field values to Don__c with the Tax Receipt Context Id value: $Record > Context Id
Save and activate
Validate the tax receipt
STEP #7
Validate the tax receipt manually by changing its status from draft to validated, in order to block the modification and create a tax receipt number legally.
Manually validate a tax receipt
From the tax receipt, change the status of draft to be validated
A tax receipt number will thus be created and the modification of items is now blocked.
Your user will have to cancel the tax receipt if they want to make changes to it
Cancel tax receipt
STEP #8
Create and file the action to cancel a tax receipt.
From the Object Manager (object manager) From Setup, access the object from which you want to create the tax receipt.
From the Buttons, Links and Actions tab (Buttons, Links, and Actions) click on New Action
Type: Lightning Web
ComponentLightning web component: GNX: GonexaQuickActionCancellationTaxReceipt
Standard label type: None
Etiquette (Label) : {Name of the button according to your choices}
Name (Name) : {Auto-fill}
Description: {optional} Save.
Add your button to the page layout, from the Page Layout tab (Layout page).
Select the presentation on which you want to drop the button (Donation, Grant...) and drag and drop it.
Save
Generate a tax receipt
STEP #9
Refer to modulus Gonexa Doc from Gonexa University to build your document model and file the generation action on the page.
Get the pre-designed Gonexa tax receipt template from our website.
Note that a tax receipt must contain the following legal information:
The contact details of the issuing association
The unique serial number of the tax receipt, this numbering must be unique for each of the donors (two numbers can co-exist if the association issues receipts via the HelloAsso donation platform, but also offline). However, be careful not to use the same numbering system), = a formula (sequence of single numbers)
The beneficiary organization (name, address, object, quality...) The donor (identity and contact details)
The Amount of the sum paid in numbers and letters (for tax receipts issued on a computer, all you have to do is frame the amount paid with asterisks: ***10 Euros***)
The payout date
The method of payment of the donation
The signature of the person authorized to collect the payment
Save your document and upload it.
Put into production and send by email
STEP #10
Put into production
In order to validate our tests, put the legal entity into production
Send by email
Use the Salesforce standard to send an email and attach the generated document.
Closing the fiscal year
When all your donors have received their tax receipts, close the fiscal year to move on to the next