Salesforce CRM Collections: Turn Customer Data Into Collection Automation
There is often a "Great Wall" between Sales and Finance. Sales reps live in Salesforce, oblivious to overdue invoices. Finance teams live in their ledger, unaware of a renewed contract negotiation. This disconnection hurts customer relationships.
Tear down the wall. By integrating Salesforce with CollectLean, you bring financial context to your CRM data. Use your rich customer account details to drive smarter, more empathetic collection workflows—without manual data entry. Accounts sync automatically. Invoices and payments update in real-time. Customer relationship data powers automated collections. No manual transfers, no data gaps, no delays.
Here's how to turn Salesforce customer data into collection automation.
Why Turn Salesforce Data Into Collection Automation?
The Problem Without Integration:
- Manual Data Transfer: Copy invoice and payment data from Salesforce to CollectLean manually
- Data Silos: Collections data separate from CRM data
- Payment Updates: Record payments in Salesforce, then update CollectLean separately
- Delayed Collections: Invoices don't appear in CollectLean until manually entered
- Missed Opportunities: Can't leverage Salesforce's customer relationship data for collections
The Solution With Integration:
- Automatic Sync: Accounts, invoices, and payments sync automatically from Salesforce
- No Manual Transfer: Invoices and payments created in Salesforce appear in CollectLean automatically
- Real-Time Updates: Payments recorded in Salesforce update CollectLean immediately
- Unified Data: Collections leverage Salesforce's comprehensive customer relationship data
- Immediate Collections: Invoices available in CollectLean for automated reminders right away
What Gets Synced?
Accounts (Customers):
- Account names, addresses, contact information
- Account hierarchies and relationships
- Payment terms and credit limits
- Custom fields and notes
- Sync from Salesforce to CollectLean
Invoices:
- Invoice numbers, dates, amounts, line items
- Due dates and payment terms
- Status (draft, sent, paid, overdue)
- Linked to Salesforce accounts
- Automatic sync from Salesforce to CollectLean
Payments:
- Payment amounts, dates, methods
- Applied to specific invoices
- Automatic status updates in CollectLean
- Collection reminders stop automatically when payment is received
Contacts:
- Contact persons associated with accounts
- Email addresses and phone numbers
- Roles and responsibilities
- Used for multi-channel collection reminders
Prerequisites: What You Need
Salesforce Account:
- Active Salesforce subscription
- Administrator access to your Salesforce org
- API access enabled for your user
CollectLean Account:
- Active CollectLean subscription
- Admin access to integration settings
Salesforce Connected App:
- Connected App created in Salesforce
- OAuth 2.0 enabled
- Consumer Key (Client ID) and Consumer Secret generated
- Appropriate OAuth scopes configured
Step-by-Step Setup Guide
Step 1: Create Salesforce Connected App
Enable API Access:
- Log in to Salesforce as Administrator
- Go to Setup → Platform Tools → Apps → App Manager
- Click "New Connected App" button
Configure Connected App:
- Connected App Name: Enter name (e.g., "CollectLean Integration")
- API Name: Auto-generated from name
- Contact Email: Enter your email address
- Enable OAuth Settings: Check this box
Configure OAuth Settings:
- Callback URL: Enter the callback URL provided by CollectLean
- Selected OAuth Scopes: Select required scopes:
- "Access and manage your data (api)"
- "Perform requests on your behalf at any time (refresh_token, offline_access)"
- "Access your basic information (id, profile, email, address, phone)"
- Click "Save"
Get Credentials:
- After creating Connected App, you'll see app details
- Copy the Consumer Key (Client ID)
- Click "Click to reveal" to show Consumer Secret
- Copy the Consumer Secret
- Save these securely—you'll need them in CollectLean
Important Notes:
- Connected Apps require administrator access
- OAuth scopes determine what data CollectLean can access
- Keep Consumer Key and Consumer Secret secure
- Callback URL must match exactly
Step 2: Get Security Token
Reset Security Token:
- Log in to Salesforce
- Go to your Profile → Settings → Reset My Security Token
- Click "Reset Security Token"
- Check your email for the security token
- Copy the token exactly as shown in the email
Important Notes:
- Security token is sent via email
- Copy token exactly as shown (case-sensitive)
- Token is required for API authentication
- Keep security token secure
Step 3: Get Instance URL
Find Your Instance URL:
- Log in to Salesforce
- Look at the URL in your browser
- Instance URL is the base URL (e.g., https://yourorg.salesforce.com)
- Copy this value—you'll need it in CollectLean
Alternative Formats:
- Production: https://yourorg.salesforce.com
- Sandbox: https://yourorg--sandbox.salesforce.com
- Lightning: https://yourorg.lightning.force.com
Important Notes:
- Instance URL is required for API authentication
- Use the base URL, not a specific page URL
- Keep Instance URL secure
Step 4: Configure CollectLean Integration
Access Integration Settings:
- Log in to CollectLean
- Navigate to Settings → Integrations
- Find "Salesforce" in the integrations list
- Click "Connect" or "Configure"
Enter Credentials:
- Client ID: Paste your Consumer Key from Connected App
- Client Secret: Paste your Consumer Secret from Connected App
- Username: Enter your Salesforce username (with API access)
- Password: Enter your Salesforce password (without security token)
- Security Token: Paste your Security Token from email
- Instance URL: Paste your Salesforce Instance URL
- Click "Save" or "Test Connection"
Test Connection:
- Click "Test Connection" button
- CollectLean will verify credentials with Salesforce
- If successful, status changes to "Active"
- If failed, check credentials and try again
Step 5: Configure Sync Settings
Choose What to Sync:
- Accounts: Enable to sync account (customer) data
- Invoices: Enable to sync invoices automatically
- Payments: Enable to sync payment updates
- Contacts: Enable to sync contact persons
Set Sync Frequency:
- Real-Time: Sync immediately when changes occur (recommended)
- Scheduled: Sync every 15 minutes, 30 minutes, or hourly
- Manual: Sync on-demand when you click "Sync Now"
Configure Sync Direction:
- Salesforce → CollectLean: Invoices and accounts sync from Salesforce to CollectLean (most common)
- Bidirectional: Changes in either system sync to both (for accounts)
Step 6: Map Your Data
Account Mapping:
- Salesforce "Account" maps to CollectLean "Customer"
- Verify account names, addresses, and contact information match
- Review payment terms and credit limits
- Check account hierarchies
Invoice Mapping:
- Verify invoice numbers, dates, and amounts sync correctly
- Check that due dates and payment terms are accurate
- Ensure invoice statuses map correctly (draft, sent, paid, overdue)
- Verify invoices are linked to correct accounts
Payment Mapping:
- Verify payment amounts and dates sync correctly
- Check that payments apply to correct invoices
- Ensure payment methods are recognized
Step 7: Test Your Integration
Create Test Invoice:
- Create a test invoice in Salesforce (or sync from another system)
- Wait for sync (or click "Sync Now")
- Verify invoice appears in CollectLean
- Check that all details are correct
Record Test Payment:
- Record a test payment in Salesforce
- Wait for sync
- Verify payment updates in CollectLean
- Check that invoice status updates to "Paid"
Verify Collection Workflows:
- Create an overdue invoice in Salesforce
- Verify it appears in CollectLean
- Check that collection reminders are sent automatically
- Record payment in Salesforce
- Verify reminders stop automatically
How It Works: Understanding the Sync Process
Initial Sync:
When you first connect, CollectLean performs an initial sync:
- Syncs all accounts from Salesforce
- Syncs all open invoices from Salesforce
- Syncs recent payments from Salesforce
- This may take a few minutes depending on data volume
Ongoing Sync:
After initial sync, CollectLean syncs changes automatically:
- New invoices created in Salesforce sync to CollectLean
- Payments recorded in Salesforce update CollectLean
- Account changes sync bidirectionally
- Sync happens every few minutes or in real-time
Token Refresh:
Salesforce access tokens expire after a period of inactivity. CollectLean automatically refreshes tokens using the refresh token. You don't need to do anything—it happens automatically in the background.
Rate Limits:
Salesforce has rate limits based on your subscription tier. CollectLean respects these limits and queues requests if needed. Typical limits range from 1,000 to 15,000 API calls per day depending on your Salesforce edition.
Common Issues and Troubleshooting
Issue: Connection Test Fails
Possible Causes:
- Incorrect Client ID, Client Secret, Username, Password, Security Token, or Instance URL
- Connected App not properly configured
- OAuth scopes insufficient
- API access not enabled for user
Solutions:
- Double-check all credentials—copy and paste exactly
- Verify Connected App configuration
- Check OAuth scopes include required permissions
- Ensure API access is enabled for your user
Issue: Security Token Invalid
Possible Causes:
- Security token copied incorrectly
- Security token expired (rare)
- Password changed (requires new token)
Solutions:
- Copy security token exactly as shown in email
- Reset security token if needed
- Update security token in CollectLean if password changed
Issue: Invoices Not Syncing
Possible Causes:
- Sync disabled for invoices
- Invoice status filters excluding invoices
- Rate limit exceeded
- Insufficient OAuth scopes
Solutions:
- Check sync settings—ensure invoices are enabled
- Review invoice status filters
- Wait a few minutes and try manual sync
- Verify OAuth scopes include invoice access
Issue: Payments Not Updating
Possible Causes:
- Payment sync disabled
- Payment not applied to invoice in Salesforce
- Sync delay
- Insufficient OAuth scopes
Solutions:
- Check sync settings—ensure payments are enabled
- Verify payment is applied to invoice in Salesforce
- Wait for sync or trigger manual sync
- Verify OAuth scopes include payment access
Issue: Access Denied Errors
Possible Causes:
- Insufficient OAuth scopes
- User permissions insufficient
- Connected App not properly configured
Solutions:
- Review OAuth scopes—ensure required permissions
- Check user permissions in Salesforce
- Verify Connected App configuration
Best Practices
Create Dedicated Integration User:
- Create dedicated user for CollectLean integration
- Assign profile with minimum required permissions
- Don't use administrator account for integration
- Improves security and auditability
Grant Minimum Permissions:
- Grant only permissions needed for sync
- Don't grant full access unnecessarily
- Review permissions regularly
- Follow principle of least privilege
Keep Credentials Secure:
- Never share Client ID, Client Secret, Username, Password, Security Token, or Instance URL
- Store credentials securely
- Rotate credentials periodically
- Use different credentials for sandbox and production
Monitor Sync Status:
- Check integration status regularly
- Review sync logs for errors
- Monitor sync frequency
- Address issues promptly
Regular Maintenance:
- Review sync settings monthly
- Check for duplicate accounts
- Verify invoice and payment accuracy
- Update security token if password changed
The Bottom Line
Integrating CollectLean with Salesforce eliminates manual data transfer, reduces errors, and speeds up collections. Setup takes minutes, and sync happens automatically.
Key Benefits:
- No Manual Transfer: Invoices and payments created in Salesforce appear in CollectLean automatically
- Automatic Sync: Accounts, invoices, and payments sync automatically
- Real-Time Updates: Changes reflect in CollectLean within minutes
- Unified Data: Collections leverage Salesforce's comprehensive customer data
- Immediate Collections: Invoices available for automated reminders right away
Setup Steps:
- Create Salesforce Connected App
- Get Consumer Key and Consumer Secret
- Get Security Token
- Get Instance URL
- Enter credentials in CollectLean
- Test connection
- Configure sync settings
- Test with sample data
Start with Step 1. Create your Salesforce Connected App. Get your credentials. Enter everything in CollectLean. Test the connection. You'll be syncing in minutes.
Ready to turn Salesforce customer data into collection automation? Connect Salesforce CRM to CollectLean and sync accounts, invoices, and payments automatically. Leverage your CRM data for automated collections. No manual transfer, no data silos, no delays. Start your free 14-day trial and see how integration can streamline your collections process.
Author
Michael Chen
CollectLean Contributor