GAU & Allocation

The GAU & Allocation mapping between WeGive and Salesforce is a crucial component of the integration, enabling seamless tracking of fund distributions and accounting units between the two platforms. This mapping ensures that fund details, allocation percentages, and financial tracking are properly synchronized, providing a comprehensive view of your fund management and distribution strategy.

Key Concepts

The integration between WeGive Funds and Salesforce GAUs is designed to provide a robust fund management solution. Understanding these key concepts is essential for effective implementation and usage.

Object Mapping

  • WeGive Funds map to Salesforce GAUs
  • WeGive Allocations map to Salesforce Allocations
  • Requires WeGive Managed Package installation
  • Bi-directional sync capabilities
  • Standard object integration

Managed Package Details

  • Standard object names:
    • General_Accounting_Unit__c
    • Allocation__c
  • Package source: WeGive Managed Package
  • Installation required for functionality
  • Custom fields included

Sync Behavior

  • Bi-directional synchronization
  • Real-time updates
  • Fund creation and modification
  • Allocation tracking
  • Distribution management

Dependencies

  • Transaction synchronization
  • Payment processing
  • Fund management
  • Allocation tracking

Field Mappings

The field mappings between WeGive and Salesforce GAU objects are designed to ensure comprehensive data synchronization. These mappings cover all essential fund and allocation information, from basic details to complex distribution rules.

GAU Field Mappings

Salesforce FieldWeGive FieldDirectionCreate OnlyDefault MappingNotes
namenameBothNoYesGAU name
descriptiondescriptionBothNoYesGAU description
typetypeBothNoYesGAU type
statusstatusBothNoYesGAU status
activeactiveBothNoYesActive status
created_datecreated_dateBothNoYesCreation timestamp
modified_datemodified_dateBothNoYesLast modified date
owner_idowner_idBothNoYesGAU owner

Allocation Field Mappings

Salesforce FieldWeGive FieldDirectionCreate OnlyDefault MappingNotes
gau_idgau_idBothNoYesRelated GAU
opportunity_idopportunity_idBothNoYesRelated opportunity
amountamountBothNoYesAllocation amount
percentagepercentageBothNoYesAllocation percentage
typetypeBothNoYesAllocation type
statusstatusBothNoYesAllocation status
created_datecreated_dateBothNoYesCreation timestamp
modified_datemodified_dateBothNoYesLast modified date

Important Notes

Understanding these important aspects of the GAU & Allocation integration is crucial for successful implementation and ongoing management.

Package Requirements

  • WeGive Managed Package must be installed
  • Standard objects must be configured
  • Field-level security must be set
  • User permissions must be configured

Sync Behavior

  • Real-time synchronization
  • Bi-directional updates
  • Fund tracking
  • Allocation monitoring
  • Distribution management

Field Considerations

  • Required fields must be mapped
  • Custom fields can be added
  • Field types must match
  • Validation rules apply
  • Default values supported

Best Practices

Following these best practices will help ensure a smooth and successful GAU & Allocation integration:

Data Management

  • Regular data validation
  • Monitor sync status
  • Check for duplicates
  • Verify field mappings
  • Review error logs

Integration Configuration

  • Test in sandbox first
  • Verify permissions
  • Check field security
  • Monitor performance
  • Regular maintenance

Troubleshooting

  • Check sync logs
  • Verify connections
  • Review error messages
  • Test field mappings
  • Contact support if needed

Common Scenarios

Understanding these common scenarios will help you effectively manage GAUs and Allocations across both platforms:

New GAU Creation

  1. Create GAU in WeGive
  2. Sync to Salesforce
  3. Configure settings
  4. Set up allocations
  5. Monitor sync status

Allocation Management

  1. Process allocations
  2. Update percentages
  3. Track distributions
  4. Monitor status
  5. Handle updates

Fund Updates

  1. Modify GAU details
  2. Update allocations
  3. Change settings
  4. Adjust distributions
  5. Sync changes

The GAU & Allocation integration provides a robust solution for managing funds and distributions across both WeGive and Salesforce, ensuring that all fund-related data is properly synchronized and maintained.