Nonprofit Cloud Developer Guide

Introduction to Nonprofit Cloud
Nonprofit Cloud Data Model
Case Management
Fundraising
Fundraising Standard Objects
DonorGiftSummary
GiftBatch
GiftCommitment
GiftCmtChangeAttrLog
GiftCommitmentSchedule
GiftDefaultDesignation
GiftDesignation
GiftEntry
GiftRefund
GiftSoftCredit
GiftTransaction
GiftTransactionDesignation
GiftTribute
OutreachSourceCode
OutreachSummary
PaymentInstrument
Fundraising Fields on Standard Objects
Fundraising Business APIs
Fundraising Invocable Actions
Fundraising Metadata API Types
Fundraising Tooling API Objects
Program Management
Outcome Management Standard Objects
Grantmaking
Group Memberships and Households in Nonprofit Cloud
NonProfit Cloud Associated Objects
PDF

Newer Version Available

This content describes an older version of this product. View Latest

DonorGiftSummary

Represents gift summaries for accounts and contacts. This object is available in API version 59.0 and later.

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations. 

Important

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update(), upsert()

Special Access Rules

This object is available only if the Fundraising Access license is enabled and the Fundraising User system permission is assigned to users.

Fields

Field Details
AverageGiftAmount
Type
currency
Properties
Filter, Sort
Description
The average value of the gifts the donor directly contributed.
This value of this field is calculated using a formula: (TotalGiftTransactionAmount / GiftCount).
BestGiftYear
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The year when the donor directly contributed the largest value of gifts. Calculated nightly by Data Processing Engine.
CurrentRecurringStartDate
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The date of the donor's first recurring gift transaction for the active recurring gift. Calculated nightly by Data Processing Engine.
CurrentYearGiftCount
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The total number of gifts the donor directly contributed this year. Calculated nightly by Data Processing Engine.
DaysSinceLastGift
Type
int
Properties
Filter, Group, Nillable, Sort
Description
The number of days since the donor gave a direct contribution.
This value of this field is calculated using a formula: IF(ISBLANK(TEXT(LastGiftDate)), NULL, TODAY() - LastGiftDate).
DonorId
Type
reference
Properties
Create, Filter, Group, Sort
Description
The person, household, or organization account associated with the donor gift summary.
This field is a relationship field.
Relationship Name
Donor
Relationship Type
Master-Detail
Refers To
Account
FirstGiftAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The value of the first gift the donor directly contributed. Calculated nightly by Data Processing Engine.
FirstGiftCampaignId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The first campaign the donor contributed to. Calculated nightly by Data Processing Engine.
This field is a relationship field.
Relationship Name
FirstGiftCampaign
Relationship Type
Lookup
Refers To
Campaign
FirstGiftDate
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The date of the first gift directly contributed by the donor. Calculated nightly by Data Processing Engine.
FirstRecurringStartDate
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The date of the donor's first recurring gift transaction. Calculated nightly by Data Processing Engine.
FirstSoftCreditAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The value of the first gift the donor influenced but didn't directly contribute. Calculated nightly by Data Processing Engine.
FirstSoftCreditDate
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The date of the first gift the donor influenced but didn't directly contribute. Calculated nightly by Data Processing Engine.
GiftCount
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The total number of gifts the donor directly contributed. Calculated nightly by Data Processing Engine.
GiftsLastYearAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The value of gifts the donor directly contributed last year. Calculated nightly by Data Processing Engine.
GiftsThisYearAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The value of gifts the donor directly contributed this year. Calculated nightly by Data Processing Engine.
GiftsTwoYearsAgoAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The value of gifts the donor directly contributed two years ago. Calculated nightly by Data Processing Engine.
HighestGiftAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The largest single gift the donor directly contributed. Calculated nightly by Data Processing Engine.
HighestGiftYearAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The largest value of gifts the donor directly contributed in one year. Calculated nightly by Data Processing Engine.
HighestSoftCreditAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The value of the largest single gift the donor influenced but didn't directly contribute.
HighestSoftCreditDate
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The date of the largest single gift the donor influenced but didn't directly contribute. Calculated nightly by Data Processing Engine.
LastGiftAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The value of the donor's most recent, directly-contributed gift. Calculated nightly by Data Processing Engine.
LastGiftDate
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The date of the donor's most recent, directly-contributed gift.
LastRecurringPaymentDate
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The date when the donor last made a payment toward a recurring gift. Calculated nightly by Data Processing Engine.
LastReferencedDate
Type
dateTime
Properties
Filter, Nillable, Sort
Description
The timestamp when the current user last accessed this record indirectly, for example, through a list view or related record.
LastSoftCreditAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The value of the last gift the donor influenced but didn't directly contribute. Calculated nightly by Data Processing Engine.
LastSoftCreditDate
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The date of the last gift the donor influenced but didn't directly contribute. Calculated nightly by Data Processing Engine.
LastTwoYearGiftCount
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The total number of gifts the donor directly contributed two years ago. Calculated nightly by Data Processing Engine.
LastViewedDate
Type
dateTime
Properties
Filter, Nillable, Sort
Description
The timestamp when the current user last viewed this record or list view. If this value is null, and LastReferenceDate is not null, the user accessed this record or list view.
LastYearGiftCount
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The total number of gifts the donor directly contributed last year. Calculated nightly by Data Processing Engine.
LowestGiftAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The smallest single gift the donor directly contributed. Calculated nightly by Data Processing Engine.
Name
Type
string
Properties
Autonumber, Defaulted on create, Filter, idLookup, Sort
Description
The auto-numbered name that uniquely identifies the donor gift summary.
SecondGiftDate
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The date of the second gift directly contributed by the donor. Calculated nightly by Data Processing Engine.
SoftCreditCount
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The total number of gifts the donor influenced and didn't directly contribute. Calculated nightly by Data Processing Engine.
TotalGiftsAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The value of gifts the donor directly contributed. Calculated nightly by Data Processing Engine.
TotalHardSoftCredits
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The number of gifts the donor directly contributed and influenced. Calculated nightly by Data Processing Engine.
TotalHardSoftCreditsAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The total value of all gifts the donor directly contributed and influenced. Calculated nightly by Data Processing Engine.
TotalPaidRcrInstallments
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The number of recurring installments the donor directly contributed. Calculated nightly by Data Processing Engine.
TotalPaidRcrInstlAmt
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The value of all of the recurring installments the donor directly contributed. Calculated nightly by Data Processing Engine.