Doc. Number | Article Title | Effective Date | Version |
FHC-XX | Using the Credit Parsing Tool | October 22, 2024 |
0.2 |
This article describes setting up and using the Credit Report Parsing Tool in the Forth CRM. It is organized into the following sections:
IMPORTANT: Knowledge and understanding of JavaScript are required to use the Creditor Parsing Tool!
Overview
The Forth CRM offers a Credit Parsing Tool (formerly called Script Editor). Standard parsing functionality includes enrolling or ignoring debts and adding notes. The Credit Report Parsing tool allows the writing of rules to apply when retrieving credit report data to determine the enrolling or unenrolling of a debt item. Many clients find this tool helpful in filtering out creditors or trade lines they do not want to enter the system.
Credit Report Parsing Tool
The Credit Report Parsing Tool is accessible via the CRM's Admin tab. To access it, click “Settings” in the Navigation Bar, as shown below.
From there, select “Credit Report Parsing Tool”.
A toggle switch at the top of the newly opened page allows you to activate or deactivate the Credit Report Parsing capability. This capability allows users to specify conditions for automatically enrolling or not enrolling debts when they pull a credit report. These conditions are defined using JavaScript (JS) code.
The Credit Report Parsing Tool page looks similar to the one shown below.
Using the Credit Report Parsing Tool
The credit report parsing tool has three (3) core functions:
- Enroll or unenroll a debt
- Add notes to the debt
- Change the debt type_id
The credit report parsing tool can also insert data into debt custom fields. However, this functionality is only possible for Spinwheel reports. EXAMPLE: output.dcf_1234 = Tradeline.liabilitySubtype
As stated above, this tool allows you to enroll debts automatically, but the client may choose a particular creditor and a particular balance range (i.e., greater than $3,000, less than $8,000, etc.). For example, if you have a client with a set of debts (as shown below within the “Debts” Nested Tab on the Client Dashboard)…
…and you want to automatically enroll only debts with a ‘CHASE' creditor AND a balance greater than or equal to $5,000, OR debts with an 'AMAZON’ not BOA MBNA' creditor AND a balance less or equal to $2,000. Here's how the code would look:
var output = {enroll:false,notes:''};
if((Tradeline.balance >= 5000 && Tradeline.creditor_name == 'CHASE') || (Tradeline.creditor_name == 'AMAZON' && !(Tradeline.balance > 2000) )) {
output.enroll = true;
output.notes = 'Debt balance and creditor are eligible';
}
return output;
By default, all debts are marked as unenrolled.
var output = {enroll:false,notes:''};
The conditions are defined using logical operators: && for AND, || for OR, and ! for NOT.
So if balance >= 5000
AND creditor_name IS 'CHASE'
OR creditor_name IS 'AMAZON'
AND balance NOT > 2000
the debt will be enrolled,
output.enroll = true
and a note will be created:
output.notes = 'Debt balance and creditor are eligible';
The output will reflect these results.
return output;
You can create separate 'if' conditions for different scenarios.
NOTE: To experiment with how the JSON code works before implementation, click 'Save' (on the top right of the page) and go to the 'Test Sandbox' tab (as shown below).
Use the “Search Contact” field to find the client. The client's debts will then be displayed with columns for 'ENROLL?', 'NOTES,' and 'RESULTS.' See the example below.
Zero-Dollar Debts
With some of our integrations, clients may include zero-balance debts in their consumer credit reports. Activating these settings is as simple as clicking an "Import Zero Dollar Debts" toggle button on the particular integrations page. This will seamlessly incorporate any existing zero-balance debts into the consumer's credit report, if applicable. Please ensure that the credit parsing tool is configured to include zero-balance debts to leverage the import of zero-dollar debts.
Should you have any questions or require assistance, contact us at support@setforth.com.
Article Version History:
Version | Effective Date | Description |
Basic | 09/09/2024 | Initial Release |
0.1 | 10/04/2024 | Modified Header and Footer |
0.2 | 10/22/2024 | Updated the last section of the page. |