Fundraising business objects

Access required

To access business objects and IQA, you must be a system administrator.

This article covers the many different fundraising business objects that will help you report fundraising data.

📘

Note

Product Codes are not populated in Fundraising business objects for Split gifts entered in iMIS Desktop.

Overview tables

Table 1: Summarization and properties of the fundraising business objects

Rows are summarized for:

Business ObjectAdjustmentsSplit GiftsPledge PaymentsPledge Installments
Gifts (including pledge payments)
Gift
GiftsReceivedY
GiftsReceivedForReceiptingY
GiftsReceivedSummaryY
GiftTransaction
GiftSummaryYY
Pledges
CsPledgesYY
Gifts and pledges (Donations)
CsDonationsYYNot includedY
DonationPerformanceYYNot included
DonationSummaryYYYY
Gifts, pledges, and soft credits
GiftHistoryYYYY

Includes properties for:

Business ObjectGift Item (Product Code)Financial Entity (Fund)InvoicePayment TypeCampaignSource Code (Appeal)Tribute DetailsMoves Manager (SolicitorID)Receipt DetailsRequest NumberList AsFair Market ValueFiscal YearFiscal Month
Gifts (including pledge payments)
GiftYYRef NumYYYYYYYYY
GiftsReceivedYYInvoice NumberYYYYYYY
GiftsReceivedForReceiptingYYRef NumYYYYY
GiftsReceivedSummaryYYRef Num (as InvoiceId)YYYYYY
GiftTransactionYYRef NumYYYYYYYY
GiftSummary
Pledges
CsPledgesYYRef Num (separate for each installment)YYYYYYYYY
Gifts and pledges (Donations)
CsDonationsRef NumYYYYYYY
DonationPerformanceYYInvoice Number and Ref Num (as InvoiceId)Y
DonationSummaryYYYYYYYYY
Gifts, pledges, and soft credits
GiftHistoryYYYYYYYYYYYYY
Table 2: Recommendations by purpose

The following table lists the recommended business objects to use for various fundraising purposes:

PurposeBusiness Object
A listing of gifts received that incorporates adjustments with related detailsGiftsReceivedSummary
A listing of gifts received that includes information about the receipting statusGiftsReceivedForReceipting
A summary of gift counts and sums either overall, by donor, or by gift dateGiftSummary
A listing or summary of gifts a donor should receive credit for, including soft creditGiftHistory
One row per donor with information about their giving historyGiftsHistorySummaryBasic
A listing of gifts and pledges for analyzing the performance of funds and source codes. Paid and unpaid pledges are included, and pledge payments are not included as gifts.DonationPerformance
A listing of gifts and pledges, regardless of how much money has been receivedCsDonations
One row per gift or pledge that incorporates split gifts, pledge payments, installment pledges, and financial adjustmentsDonationSummary

Gifts (including pledge payments)

Gift

The Gift business object uses the GiftReport table to create a list of gifts received along with their details. The list includes pledge payments but not unpaid pledges. Split gifts (gifts to more than one product or item) and financial adjustments appear in separate rows. The list reports the fiscal month and a less granular gift type than the GiftsReceived business object.

Common joins

Some common joins include:

Business ObjectRelation
CsContactGift.Id = CsContact.iMIS Id
CsProductGift.Fund = CsProduct.Product Code
Gift.Product code = CsProduct.Product code
GiftSummaryGift.Original Transaction = GiftSummary.Original Transaction
📘

Note

If any gifts included in the query are for charitable events or membership items, then the CsProduct relationship should be a Left join.

Properties

Properties
AmountAmountAsMoneyAppealCampaign
CheckNumberDateReceivedFairMktValueFiscalMonth
FiscalYearFundGiftTypeIsMatchingGift
IDInstallmentDateInvoiceReferenceNumberMemorialNameText
ListAsMatchingTransactionMemorialIDReceiptID
OriginalTransactionPaymentTypePledgeIDTransactionDate
RequestNumberSolicitorIDSourceSystem
TransactionNumberNoteProductCode
GiftsReceived

The GiftsReceived business object uses the GiftReport table to create a detailed list of all gifts received, including pledge payments, but not unpaid pledges. Separate rows appear on the list for financial adjustments and split gifts (gifts to more than one product or item). The GiftType property differentiates between split gifts and charitable event gifts.

Common joins

Some common joins include:

Business ObjectRelation
NetContactDataGiftsReceived.ID = NetContactData.Id
CsContactGiftsReceived.ID = CsContact.iMIS Id
CsOrg_ControlGiftsReceived.Fund = CsOrg_Control.Org Code
CsDonorDataGiftsReceived.ID = CsDonorData.ID
CsTransSoftCreditGiftsReceived.Transaction Number = CsTransSoftCredit.Transaction Number
CsTransNotifyGiftsReceived.Original Transaction = CsTransNotify.Trans Number
GiftsReceivedSummaryGiftsReceived.Original Transaction = GiftsReceivedSummary.Original Transaction
MemorialTributeTypeRefGiftsReceived.Memorial Tribute Type = MemorialTributeTypeRef.Code
CsProductGiftsReceived.Product code = CsProduct.Product code
📘

Note

If any gifts included in the query are for charitable events or membership items, then the CsProduct relationship should be a Left join.

Properties

Properties
AmountAppealCalendarYear
CampaignDateReceivedFiscalYear
FundGiftTypeID
OriginalTransactionPaymentMethodSolicitorID
TransactionDateTransactionNumberMemorialTributeMessage
MemorialTributeTypeMemorialNameTextNote
RequestNumberProductCode
GiftsReceivedForReceipting

This business object contains information from the GiftTransaction and Receipting tables and lists all gifts received that are eligible for receipting. The list includes one row per receipt. If multiple receipts exist for the same gift, each receipt will have a separate row. If applicable, rows will include the receipt status, receipt number, and any financial adjustments made to the gift.

Common joins

Some common joins include:

Business ObjectRelation
NetContactDataGiftsReceivedForReceipting.Party Id = NetContactData.Id
EffectiveFundraisingPreferencesDataGiftsReceivedForReceipting.Party Id = EffectiveFundraisingPreferencesData.Id
ReceiptStatusRefGiftsReceivedForReceipting.Receipt Status = ReceiptStatusRef.Receipt Status Code
InvoiceNumberGiftsReceivedForReceipting.Invoice Reference Number = InvoiceNumber.Invoice Reference Number

Properties

Properties
AddressAssociatedReceiptKeyAssociatedReceiptNumberCommunicationLogRecipientKey
DaysSincePaymentWasMadeDonationItemDonorEligibleAmount
EligibleReceiptedAmountEmailFairMarketValueGiftAmount
GiftDateInvoiceReferenceNumberIsReceiptableListAs
NotePartyIdPaymentIdPaymentMethod
ProductCodeReceiptDateReceiptedAmountReceiptKey
ReceiptLineIdReceiptNumberReceiptStatusReceiptStatusDescription
RequestNumberTransactionNumberFund
GiftsReceivedSummary

Used to report on specific gift information, such as amount, fair market value, tribute type, and more. This business object uses data from the GiftReport table to generate a list with one row per gift item. The list includes pledge payments but not unpaid pledges. Financial adjustments to gifts are incorporated into the same row, but split gifts (gifts to more than one product or item) appear in separate rows.

Common joins

Some common joins include:

Business ObjectRelation
CsAppealGiftsReceivedSummary.Appeal = CsAppeal.Appeal Code
NetContactDataGiftsReceivedSummary.ID = NetContactData.Id
CsCampaignGiftsReceivedSummary.Campaign = CsCampaign.Campaign Code
CsOrg_ControlGiftsReceivedSummary.Fund = CsOrg_Control.Org Code
MemorialTributeTypeRefGiftsReceivedSummary.Memorial Tribute Type = MemorialTributeTypeRef.Code
CsProductGiftsReceivedSummary.Product code = CsProduct.Product code
📘

Note

If any gifts included in the query are for charitable events or membership items, then the CsProduct relationship should be a Left join.

Properties

Properties
AmountEligibleAmountIDMemorialTributeType
AppealFairMarketValueInvoiceIdNote
CalendarYearFiscalYearInvoiceNumberOriginalTransaction
CampaignFundMemorialNameTextSolicitorID
DateReceivedGiftTypeMemorialTributeMessageTransactionDate
ProductCode
GiftSummary

This business object returns total gift counts and sums. It contains a listing of gifts with their basic details: the donor ID, gift amount, gift date, and original transaction number. The list combines financial adjustments and split gifts into one row per gift.

Common joins

Some common joins include:

Business ObjectRelation
NetContactDataGiftSummary.ID = NetContactData.Id
CsActivityGiftSummary.Original Transaction = CsActivity.Transaction Number
GiftGiftSummary.Original Transaction = Gift.Original Transaction
GiftHistorySummaryBasicGiftSummary.ID = GiftHistorySummaryBasic.Donor Id

Properties

Properties
AmountIDOriginalTransaction
TransactionDateNote
GiftTransaction

This business object retrieves data from the GiftTransaction table to generate a transaction-focused listing of gifts. This list is the basis for receipting. It includes pledge payments but not unpaid pledges. Financial adjustments to gifts and split gifts (gifts to more than one product or item) appear in separate rows.

Common joins

Some common joins include:

Business ObjectRelation
NetContactDataGiftTransaction.DonorId = NetContactData.Id
GiftAidClaimDetailGiftTransaction.Gift Transaction Id = GiftAidClaimDetail.Gift Transaction Id

Properties

Properties
AmountDateReceivedDescriptionDonorId
DoNotReceiptFairMktValueFiscalMonthFiscalYear
FundGiftItemGiftTransactionIdGiftType
InstallmentDateInvoiceReferenceNumberIsGiftAidExcludedListAs
NoteOriginalTransactionPaymentCategoryPaymentId
PaymentMethodPaymentOwnerOrgPledgeIDRequestNumber
SolicitorIDSourceCodeSourceSystemTransactionDate
TransactionNumberTransactionPayLineNumberTransactionType

Pledges

CsPledges

The CsPledges business object is based on the PledgeReport table and contains a list of pledges and their details. Some details include the payment amount, balance, and adjustments amount. Each pledge installment appears as a new row on the list.

Common joins

Some common joins include:

Business ObjectRelation
NetContactDataCsPledges.Id = NetContactData.Id
CsOrg_ControlCsPledges.Fund = CsOrg_Control.Org Code
InvoiceScheduledPaymentCsPledges.Invoice Reference Number = InvoiceScheduledPayment.Native Invoice Id
CsProductCsPledges.Product code = CsProduct.Product code
📘

Note

If any gifts included in the query are for charitable events or membership items, then the CsProduct relationship should be a Left join.

Properties

Properties
AdjustmentsAmountAppealCampaignDateReceived
FiscalMonthFiscalYearFundId
InstallmentDateInvoiceReferenceNumberIsMatchingGiftLastPaymentDate
ListAsMatchingTransactionMemorialIDMemorialNameText
NetPledgeAmountPaymentsAmountPledgeAmountPledgeBalance
PledgeFairMarketValueRequestNumberSolicitorIDSourceSystem
TransactionDateTransactionNumberNoteProduct Code
MemorialTributeMessageMemorialTributeType

Gifts and pledges (donations)

CsDonations

The CsDonations business object is based on the DonationReport table and contains a listing of gifts and pledges. The GiftType property differentiates gifts and pledges. The Amount property represents the total amount for pledges (there is no information in this BO about how much of a pledge balance has been paid). Any financial adjustments and split gifts are combined into one row per gift, and pledge installments are summarized into one row.

Common joins

Some common joins include:

Business ObjectRelation
NetContactDataCsDonations.ID = NetContactData.Id

Properties

Properties
AmountCheckNumberDateReceivedFiscalMonth
FiscalYearGiftTypeIDInvoiceRefNum
IsMatchingGiftListAsMatchingTransactionMemorialID
MemorialNameTextOriginalTransactionPaymentTypeRequestNumber
SolicitorIDSourceSystemTransactionDateNote
MemorialTributeTypeMemorialTributeMessage
DonationPerformance

The DonationPerformance business object contains a listing of gifts and pledges for analyzing the performance of particular funds and source codes. Paid and unpaid pledges are included, and pledge payments are not included as gifts.

Properties

Properties
AmountFund CodeGift TypeTransaction Date
IdProduct CodeSource CodeTransaction Number
DonationSummary

DonationSummary lists all gifts and pledges, and combines split gifts, pledge payments, installment pledges, and financial adjustments into one row per donation. Each row includes properties such as GiftType, which differentiates between gifts and pledges, and IsSplitGift, which denotes split gifts.

Common joins

Some common joins include:

Business ObjectRelation
NetContactDataDonationSummary.ID = NetContactData.Id

Properties

Properties
AmountAmountPaidAppealBalance
CalendarYearCampaignDateReceivedEligibleAmount
FairMarketValueFiscalMonthFiscalYearGiftType
IdInstallmentsInvoiceIdInvoiceNumber
IsSplitGiftListAsMemorialNameTextMemorialTributeMessage
MemorialTributeTypeNoteOriginalTransactionRequestNumber
SolicitorIDTransactionDate

Gifts, pledges, soft credits

GiftHistory

The GiftHistory business object lists all gifts and pledges a donor should receive credit for and includes details such as the amount received, balance, and soft credit. The GiftType property identifies the source system and differentiates between In-Kind gifts, pledges, cash gifts, split gifts, and soft credits. Separate rows appear for split gifts and soft credits, the gift itself and its soft credit, and the row of the gift incorporates any financial adjustments.

Common joins

Some common joins include:

Business ObjectRelation
NetContactGiftHistory.ID = NetContact.iMIS ID
CsContactGiftHistory.ID = CsContact.iMIS Id
GiftHistorySummaryGiftHistory.ID = GiftHistorySummary.ID
MemorialTributeTypeRefGiftHistory.Memorial Tribute Type = MemorialTributeTypeRef.Code
CsTransNotifyGiftHistory.Original Transaction = CsTransNotify.Trans Number
CsProductGiftHistory.Product code = CsProduct.Product code
📘

Note

If any gifts included in the query are for charitable events or membership items, then the CsProduct relationship should be a Left join.

Properties

Properties
Invoice IdIs Installment PledgeAmount
AppealBalanceCalendar Year
CampaignDate ReceivedFair Mkt Value
Fiscal MonthFundGift Type
IDInvoice NumberIs Pledge
Is Soft CreditIs Split GiftList As
Memorial Name TextMemorial Tribute MessageMemorial Tribute Type
NoteNumber of InstallmentsOriginal Transaction
Payment TypeSoft CreditSoft Credit Donor ID
Solicitor IDTotal CreditsTransaction Date

Donors

GiftHistorySummary

The GiftHistorySummary business object contains a list with one row per donor outlining their giving history, including their first gift, last gift, highest gift amount, lifetime gift value, average gift value, and more.

Common joins

Some common joins include:

Business ObjectRelation
NetContactDataGiftHistorySummary.ID = NetContactData.Id
CsContactGiftHistorySummary.ID = CsContact.iMIS Id
CsAppealGiftHistorySummary.First Gift Appeal = CsAppeal.Appeal Code
GiftHistorySummary.Last Gift Appeal = CsAppeal.Appeal Code
GiftHistorySummary.Next to Last Gift Appeal = CsAppeal.Appeal Code
CsDonorDataGiftHistorySummary.ID = CsDonorData.ID
GiftHistoryGiftHistorySummary.ID = GiftHistory.ID

Properties

Properties
ConsecutiveYearsGivingFirstGiftAmountFirstGiftAppeal
FirstGiftDateHighestGiftAmountID
LastGiftAmountLastGiftAppealLastGiftDate
LifetimeGiftValueLowestGiftAmountNextLastGiftAmount
NextLastGiftAppealNextLastGiftDateNumberofGifts
AverageGiftValueConsecutiveYearsGivingToDateGiftsInLast12Months
GiftValueLast12Months
GiftHistorySummaryBasic

The GiftHistorySummaryBasic business object draws directly from the GiftHistorySummary table to find donor data, including ID, gift amounts, lifetime gift value, and more. This business object uses fewer columns than GiftHistorySummary to improve performance.

Common joins

Some common joins include:

Business ObjectRelation
CsContactBasicGiftHistorySummaryBasic.Donor Id = CsContactBasic.iMIS Id

Properties

Properties
AverageGiftValueHighestGiftAmountLifetimeGiftValue
ConsecutiveYearsGivingHighestTransNumProcessedLowestGiftAmount
DonorIdLastGiftAmountNextLastGiftAmount
FirstGiftAmountLastGiftAppealNextLastGiftAppeal
FirstGiftAppealLastGiftDateNextLastGiftDate
FirstGiftDateLastUpdatedOnNumberOfGifts

Soft credits

CsTransSoftCredit

Common joins

Some common joins include:

Business ObjectRelation
GiftHistoryCsTransSoftCredit.Transaction Number = GiftHistory.Original Transaction

Properties

Properties
AmountPercentageTransaction Number
Fundraiser TypeProduct Code
Originating Activity SeqnSoft Credit Id

Not recommended for use in IQA

CsDonationsDetail

This business object is not recommended for use in IQA queries.

Properties

Properties
AmountAppealCampaignCheckNumber
DateReceivedFiscalMonthIDFiscalYearFund
GiftTypeIDInvoiceRefNumIsMatchingGift
ListAsMatchingTransactionMemorialIDMemorialNameText
OriginalTransactionPaymentTypeRequestNumberSolicitorID
SourceSystemTransactionDate
GiftDetail

The GiftDetail business object is used by the gift adjustments feature in staff gift entry to retrieve the current state of the gift or pledge. Includes both gifts and pledges. Adjustments are incorporated into the same row (there are not separate rows for adjustments). Includes columns for the properties used in the staff gift entry.

Split gifts are combined into a single row; therefore, the ProductCode should not be used for split gifts.

Common joins

Some common joins include:

Business ObjectRelation
InvoiceSummaryInvoiceSummary.Invoice ID = GiftDetail.Invoice Reference Number

Properties

Properties
AmountProductCode (first value only for split gifts)
AmountPaidRequestNumber
GiftDateSolicitorID
InvoiceReferenceNumberSourceCode
ListAsTransactionNumber
MemorialNameTextTributeNotifyID
MemorialTributeMessageDonorId
MemorialTributeTypeGiftType
GiftMessage

Did this page help you?