The Gift Aid package adds two objects to your Salesforce org:
- Gift Aid Declaration
- Gift Aid Distribution Scenario
The distribution relationships are only to Account and Contact, whereas the declaration has relationships as illustrated below.
In addition to the declaration and distribution objects, the following fields are added to the Installment object.
| Field Label | Field Name | Data Type | Description | Used on Record Type |
|---|---|---|---|---|
| Consider for Gift Aid | gaid__Consider_for_Gift_Aid__c | Text(1) (External ID) | This field is for internal performance optimization only. | Receivable |
| Contact has Active GAD | gaid__Contact_has_Active_GAD__c | Checkbox | Deprecated. | |
| Eligible for Gift Aid | gaid__Eligible_for_GiftAid_formula__c | Formula (Checkbox) | According to a specific formula, FinDock determines if this receivable installment is eligible for Gift Aid. If the installment is eligible, the checkbox is marked (true). | Receivable |
| Exclude from Gift Aid | gaid__Exclude_from_GiftAid__c | Checkbox | If true (checked), this receivable installment is not considered for Gift Aid. | Receivable |
| GA Claim Total | gaid__GA_Claim_Total__c | Currency (16, 2) | This field is calculated by FinDock. It shows the amount of the receivable installment (original donation) or the amount of the Gift Aidable field if that is used. In Gift Aid Distribution scenarios, the selected amount is multiplied by the distribution percentage. | Gift Aid |
| Gift Aid Claimed | gaid__GiftAid_Claimed__c | Checkbox | Indicates if Gift Aid has been claimed for this installment. | Receivable |
| Gift Aid Declaration | gaid__Gift_Aid_Declaration__c | Lookup (Gift Aid Declaration) | When a new Gift Aid installment is created as part of the payment, this field contains a link to the Gift Aid declaration which at the time of generation was proof that this installment was eligible. | Gift Aid |
| Gift Aidable Amount | gaid__Gift_Aidable_Amount__c | Currency (16, 2) | If only part of a donation is eligible for Gift Aid, enter the eligible amount in this field on the receivable installment. | Receivable |
| Related Transaction | gaid__Related_Transaction__c | Lookup (Installment) | This is the receivable installment that is the basis of the Gift Aid installment. | Gift Aid |
| Valid Gift Aid Declaration | gaid__Valid_Gift_Aid_Declaration__c | Lookup (Gift Aid Declaration) | The valid declaration at the receivable installment due date. If there is no currently valid declaration, but there is one in a cooling off period, that is selected. Otherwise, the field is empty. | Receivable |
The Contact object gets one new field.
| Field Label | Field Name | Data Type | Description |
|---|---|---|---|
| Has Valid GAD Now | gaid__Has_Valid_GAD_Now__c | Checkbox | This field is for marketing purposes only. The values can be set by running the batch Apex class ContactsUpdateHasValidNowGadJob or scheduling Apex class ContactsUpdateHasValidNowGadSchedule. The checkbox is marked if the contact had a valid declaration on the date when the Apex class was run. |
API name: gaid__Gift_Aid_Declaration__c
The Gift Aid Declaration object is used to register and track Gift Aid declarations made by your donors. All other functionality of the Gift Aid implementation for FinDock depends on the details in the Gift Aid declaration record.
| Field Label | Field Name | Data Type | Description |
|---|---|---|---|
| Account | gaid__Account__c | Lookup(Account) | The (Person) Account of the donor who has made the the Gift Aid declaration. |
| Acquisition Method | gaid__Acquisition_Method__c | Picklist | Define here how the declaration was received by your organization. The options are Written (paper), Oral or Digital. NOTE: There is no difference between Written and Digital acquisition for HMRC. We recommend using one or the other for non-oral declarations unless you have specific requirements for tracking the paper vs. digital acquisition. |
| Active | gaid__Active__c | Checkbox | When checked, the declaration can be used to claim Gift Aid. This checkbox typically does not need to be changed manually. It is primarily for process and workflow actions. |
| Close Reason | gaid__Close_Reason__c | Picklist | Reason for closing the declaration. Only the value “Termination of Employment” is pre-shipped. Other values can be added through customization according to your own charity’s needs. |
| Confirmation Date | gaid__Confirmation_Date__c | Date | The date on which the Gift Aid declaration has been confirmed to the customer. This is the start of the cooling-off period for oral declarations. By default the value of this field is set to Date Made when you save the declaration. |
| Contact | gaid__Contact__c | Donor who has made the Gift Aid declaration. This is prefilled using the contact where you are creating the new declaration. | |
| Cooling Off Period End Date | gaid__Cooling_Off_Period_End_Date__c | If the acquisition method is oral, this field indicates when the mandatory cooling off period ends. The date is automatically calculated based on the “Number of days cooling-off period” setting of the Gift Aid extension (under FinDock Setup) when you save the declaration. You can modify it later if needed. | |
| Custom First Name | gaid__Firstname__c | If a different name should be used than the name on the contact, you can enter it here. This overrides the contact name and remains as such (i.e. no further sync between contact and declaration names). | |
| Custom Last Name | gaid__Lastname__c | Handled the same as Custom First Name. See above. | |
| Date Made | gaid__Date_Made__c | Date the declaration was made by the donor (or when you received it). | |
| End Date | gaid__End_Date__c | Date when the declaration ceases to be valid. This field can be left empty if no end date is specified by the donor. | |
| Final First Name | gaid__First_Name__c | Formula (Text) | First name from the linked contact. |
| Final Last Name | gaid__Last_Name__c | Formula (Text) | Last name from the linked contact. |
| Gift Aid Declaration Name | Name | Auto Number | Auto-generated number of the distribution record. |
| House Name or Number | gaid__Housename_or_number__c | Text(40) | Enter the house or building number or name for UK residents, for non-UK residents, enter the Street, Number and City. NOTE: This field must be manually filled in or handled through custom business logic. Because the contact address can be stored in different ways in Salesforce, FinDock cannot automatically determine the correct address value. |
| In Cooling Off Period | gaid__In_Cooling_off_Period__c | Formula (Checkbox) | Formula field that indicates if the declaration is cooling off today. |
| Overseas | gaid__Overseas__c | Checkbox | If the address is a non-UK address, this checkbox must be marked. This parameter is required by HMRC. |
| Postal code | gaid__Postalcode__c | Text(15) | Enter the postal code for UK residents, for non UK Residents, enter "X". NOTE: This field must be manually filled in or handled through custom business logic. Because the contact address can be stored in different ways in Salesforce, FinDock cannot automatically determine the correct address value. |
| Reason for Deactivation | gaid__Reason_for_Deactivation__c | Text(255) | Optional free text field for a more detailed explanation for closing the declaration. This field can be used as input, for example, for later follow up as part of an internal donor management review process. |
| Start Date | gaid__Start_Date__c | Date | This field can be left empty to have the maximum allowed validity period (current fiscal year minus four years), or you can set a start date that limits validity of this declaration for past donations, making them ineligible for Gift Aid. |
| Title | gaid__Title__c | Formula (text) | Title from linked contact. |
| Type | gaid__Type__c | Picklist | Deprecated. |
| Valid Now | gaid__Valid_Now__c | Formula (Checkbox) | Formula field that calculates of the declaration is valid today. |
The Gift Aid Distribution Scenario is used to distribute Gift Aid claims on donations from partners to the individual contacts.
| Field Label | Field Name | Data Type | Description |
|---|---|---|---|
| Account | gaid__Account__c | Master-Detail(Account) | The organization (partnership) the distribution scenario applies to in a master-detail relationship. |
| Active | gaid__Active__c | Formula(Checkbox) | When checked, the scenario can be to automatically distribute amount percentages across contacts. |
| Contact | gaid__Contact__c | Lookup(Contact) | Contacts for the distribution scenario. |
| Declaration Start Date | gaid__Declaration_Start_Date__c | Formula (Date) | Earliest start date from the contacts' valid declarations. |
| Declaration Type | gaid__Declaration_Type__c | Formula (Text) | Deprecated. |
| Enabled | gaid__Enabled__c | Checkbox | If checked, the scenario can be used for new distributions. |
| Gift Aid Distribution Scenario Name | Name | Auto Number | Auto-generated number of the scenario record. |
| Set Percentage | gaid__Set_Percentage__c | Percent(18, 0) | Percentage of amount for the distribution scenario. |