Using the Parsing Tool

This article describes setting up and using the Parsing Tool in the Forth CRM. It is organized into the following sections:

• Overview
• Accessing the Parsing Tool
• Using the Credit Report Parsing Tool
• Zero Dollar Debts
• Using the Enrollment Submission Parsing Tool
• Using the Rename Creditor Parsing Tool

IMPORTANT: Knowledge and understanding of JavaScript are required to use the Parsing Tool!

Overview

The Forth CRM offers a Parsing Tool (formerly called Script Editor). Standard parsing functionality includes enrolling or ignoring debts and adding notes. The Parsing tool allows the writing of rules to apply when retrieving credit report data, to determine the enrollment or unenrollment of a debt item. Many find this tool helpful in filtering out creditors or trade lines they do not want to enter the system.

Accessing the Parsing Tool

The Parsing Tool is accessible via the CRM's Admin tab. To access it, click “Settings” in the Navigation Bar, as shown below.

In the Navigation Bar, select “Parsing Tool”.

A toggle switch at the top of the newly opened page allows you to activate or deactivate the 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 Parsing Tool default page looks similar to the image shown below.

The dropdown menu at the top left of the page, provides three different tools for your use: Credit Report Parsing, Enrollment Submission, and Renaming Creditors (see image below).

Using the Credit Report Parsing Tool

The credit report parsing tool has three (3) core functions:

1. Enroll or unenroll a debt
2. Add notes to the debt
3. 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:

By default, all debts are marked as unenrolled.

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 > 2000the debt will be enrolled,

and a note will be created:

The output will reflect these results.

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.

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.

Final Note about the Credit Report Parsing Tool: 

We Updated the Object Reference Contact variable to include assigned company key-value-pair as assigned_company: '<Assigned Company ID>'. This was done so affiliates may customize debts loaded from a credit report pull based on the company to which clients  will be submitting. This results in the Contact Assigned Company ID being included as a new variable for the Credit Report Parsing Tool.

Using the Enrollment Submission Parsing Tool

By selecting the enrollment submission parsing tool, you may parse a listing of enrollment submissions.

Using the Rename Creditor Parsing Tool

By selecting this tool, you may update the name of a Creditor.

Should you have any questions or require assistance, contact us at support@setforth.com.