Skip to main content
Aegis
Updated over 2 months ago

Aegis Premier Solutions is a nonprofit CRM platform used for donor management, fundraising tools, analytics and reporting.


Connect Anedot to Aegis

To connect your Anedot fundraising account to Aegis, follow the steps below:

  1. Access the Settings>Integrations>Directory tab within your fundraising account.

  2. Next, click the blue + New Connection button in the upper right corner of the page.

  3. Select Aegis from the integrations directory.

  4. Select the Action Pages you would like synced with Aegis. The default is All Pages.

    1. To exclude pages, enter a comma-separated list of the Action Page IDs.

    2. Optionally, you can scope the integration to only send team-specific data to Aegis.

  5. Enter your Aegis Premier Solutions URL.

  6. Enter your Aegis Premier Solutions Username.

  7. Enter your Aegis Premier Solutions Password.

  8. Apply your Context Key.

  9. Add your Fund Code.

  10. Click the blue Save button to complete the connection!

The Action Pages, Team, and credentials can be modified at any time post-setup.

For further assistance locating these items, please contact Aegis Technical Support directly.


Data Relays

Anedot will relay data to Aegis for both Donation and Lead Pages.

Donation and Lead Pages are required to have an appeal_id Custom Hidden Fields applied for successful relays.

We process custom_flag and custom_data_field as Custom Hidden Fields to get the corresponding data sent to new partners in Aegis.


Custom Flags (custom_flag)

In the Action Page Builder, add a Custom Hidden Field with the key: custom_flag_1. Subsequent fields should be set up as custom_flag_2, custom_flag_3, etc.

A Page Specific Value will need to be applied to each Custom Hidden Field within the Settings>Sharing>Page Specific Values tab of the Builder.

All custom field names and values must be exact in Action Pages (or data will not relay properly and cause issues in Aegis).


Custom Data Fields (custom_data_field)

In the Action Page Builder, add a Custom Hidden Field with the key: custom_data_field_1.

To better support Aegis product handling, we provide support for a Custom Hidden Field called product_sku.

When added, the product_sku field will appear under the productOrders area of relays as productSKU.


Data in Aegis

Once the relay is successful, you should be able to look up the Transaction under the Partners > Locate Transactions tab (you will need to look up the individual transaction or contact).

Sample transaction from Anedot viewed in Aegis CRM.


Field Mappings

Relay Fields

Anedot Field

Aegis Field


fundcode (from Setup, Aegis Field)

amount (x100)

“true” or “false”

gifts {

fundCode

pledgeID

giftAmount

applyToPledge

}

“internet”

channel

donation {

amount (x100)

lastDigits

“Paid”

payMethod (Donations)

}

payment {

amount

number

status

paymentType

}


"[firstName] [lastName]"

address {

city

region

country

line1

line2

postalCode

}

shipping {

shipto

shiptoCity

shiptoState

shiptoCountry

shiptoAddress1

shiptoAddress2

shiptoPostalCode

}

Aegis Field

partnerID

appeal_id*

appealCode


value (from Product Details)

“0.0”**

fundcode (from Setup, Aegis Field)

“1”

InternalSKU (from Product Details)

productOrders {

price

discount

fundCode

quantity

productSKU

}

(Submission) id

referenceNumber

created_at

transactionDate

“Anedot UID: [Submission id]

OnlineContribution (Source:[source_code])”

transactionNote

totalAmount (x100) [Anedot stores amounts in cents]

totalTransactionAmount

*Custom hidden field that must be added to the Anedot AP in order to be relayed.

** The discount will be greater than 0 if the donation amount is below the value amount specified in the Product’s Details.


Payload Data

Request Headers

{}

Request Body (Success) (Create Partner)

{
"createPartner": {
"city": "New Orleans",
"email": "[email protected]",
"address1": "1340 Poydras St",
"address2": null,
"lastName": "Dot",
"firstName": "Annie",
"stateProv": "LA",
"postalCode": "70112",
"countryCode": "US",
"customFlags": [],
"originSource": "Web",
"partnerPhones": [
{
"number": "2015550123"
}
],
"customDataFields": []
},
"createDonation": {
"gifts": [
{
"fundCode": "DEFAULT",
"pledgeID": null,
"giftAmount": 25,
"applyToPledge": false
}
],
"channel": "Internet",
"payment": {
"amount": 25,
"number": "5454",
"status": "Paid",
"paymentType": "CreditCard"
},
"shipping": {
"shipto": "Annie Dot",
"shiptoCity": "New Orleans",
"shiptoState": "LA",
"shiptoCountry": "US",
"shiptoAddress1": "1340 Poydras St",
"shiptoAddress2": null,
"shiptoPostalCode": "70112"
},
"partnerID": "2617081",
"appealCode": "W2403_TPOC",
"productOrders": [
{
"price": 11.55,
"discount": 0,
"fundCode": "DEFAULT",
"quantity": 1,
"productSKU": "PK_POC_3DAY_GEN1"
}
],
"referenceNumber": "53b5e566-7b92-4913-9c50-b2caf262d56d",
"transactionDate": "2024-03-29T14:30:13.738Z",
"transactionNote": "Anedot UID: 53b5e566-7b92-4913-9c50-b2caf262d56d\nOnline Contribution (Source: WEB)",
"totalTransactionAmount": 25
},
"findPartnerByEmail": {
"get": "partner/Email"
},
"findPartnerByNameAndAddress": {
"get": "partner/Search"
}
}

Request Body (Success) (Create Donation)

{
"gifts": [
{
"fundCode": "DEFAULT Test Fund",
"pledgeID": null,
"giftAmount": 50,
"applyToPledge": false
}
],
"channel": "Internet",
"payment": {
"amount": 50,
"number": "1111",
"status": "Paid",
"paymentType": "CreditCard"
},
"shipping": {
"shipto": "Annie Dot",
"shiptoCity": "New Orleans",
"shiptoState": "LA",
"shiptoCountry": "US",
"shiptoAddress1": "1340 Poydras Street",
"shiptoAddress2": null,
"shiptoPostalCode": "70113"
},
"partnerID": "0000000",
"appealCode": "W0000A0A",
"productOrders": null,
"referenceNumber": "affa9ef5-f4c3-4984-be25-5616abe46237",
"transactionDate": "2023-01-25T15:30:55.851Z",
"transactionNote": "Anedot UID: affa9ef5-f4c3-4984-be25-5616abe46237\nOnline Contribution (Source: stub)",
"totalTransactionAmount": 50
}

Request Body (Error)

null

Response Body (Success)

{
"Gifts": [
{
"FundCode": "DEFAULT Test Fund",
"PledgeID": null,
"GiftAmount": 50,
"ApplyToPledge": false,
"MatchingContactID": null,
"EstimatedPercentage": null
}
],
"Notes": [],
"Channel": "Internet",
"Payment": {
"Bank": null,
"City": null,
"Amount": 50,
"Number": "1111",
"Status": "Received",
"Country": null,
"ExpDate": null,
"ExtraID": null,
"Address1": null,
"Address2": null,
"LastName": null,
"FirstName": null,
"MiddleName": null,
"PostalCode": null,
"PaymentType": "CreditCard",
"ContactPhone": null,
"EmailAddress": null,
"StateProvince": null,
"UpdatePrimaryEmailAddress": false,
"UpdatePrimaryMailingAddress": false
},
"Shipping": {
"Shipto": "Annie Dot",
"ShiptoCity": "New Orleans",
"ShiptoState": "LA",
"ShippingNote": null,
"ShiptoCountry": "US",
"ShippingMethod": null,
"ShiptoAddress1": "1340 Poydras Street",
"ShiptoAddress2": null,
"ShiptoPostalCode": "70113",
"ShippingOverridden": false
},
"BatchType": "Web",
"PartnerID": "0000000",
"TaxAmount": 0,
"AppealCode": "W0000A0A",
"Attributes": [],
"RecordedBy": null,
"MediaOutlet": null,
"SegmentCode": null,
"MediaProgram": null,
"ShippingCost": 0,
"BatchCategory": null,
"InvoiceNumber": "2213291",
"ProductOrders": [],
"ReferenceNumber": "affa9ef5-f4c3-4984-be25-5616abe46237",
"TransactionDate": "2023-01-25T15:30:55.851+00:00",
"TransactionNote": "Anedot UID: affa9ef5-f4c3-4984-be25-5616abe46237\nOnline Contribution (Source: stub)",
"Acknowledgements": [],
"DefaultPaymentType": null,
"ResponsesOverridden": false,
"TotalTransactionAmount": 50
}

Response Body when productOrders is present

{
"create_donation": {
"gifts": [
{
"fundCode": "DEFAULT Pathway to Victory Ministry Fund",
"pledgeID": null,
"giftAmount": 12,
"applyToPledge": false
}
],
"channel": "Internet",
"payment": {
"amount": 12,
"number": "5454",
"status": "Paid",
"paymentType": "CreditCard"
},
"shipping": {
"shipto": "Annie Dot",
"shiptoCity": "New Orleans",
"shiptoState": "LA",
"shiptoCountry": "US",
"shiptoAddress1": "1340 Poydras St",
"shiptoAddress2": null,
"shiptoPostalCode": "70114"
},
"partnerID": "2557459",
"appealCode": "W2207A1A",
"productOrders": [
{
"discount": 0,
"fundCode": "DEFAULT Pathway to Victory Ministry Fund",
"quantity": 1,
"productSKU": "2452808"
}
],
"referenceNumber": "ae2f4940-1c3e-4a07-9d2e-69653e3bce2c",
"transactionDate": "2023-11-17T20:37:16.867Z",
"transactionNote": "Anedot UID: ae2f4940-1c3e-4a07-9d2e-69653e3bce2c\nOnline Contribution (Source: Web)",
"totalTransactionAmount": 12
},
"find_partner_by_email": {
"get": "partner/Email"
},
"find_partner_by_name_and_address": {
"get": "partner/Search"
}
}

Response Body (Error)

{}

Response Body (Failure)

{
"Message": "The appeal could not be found in Aegis CRM. Appeal Code: 'W0000A0A'."
}

Response Status (Success)

201

Response Status (Error)

null

Response Status (Failure)

400




Did this answer your question?