Recurring Forms Guidelines
There are three possible recurring behaviors for lending documents: Recurring, Non-recurring, and None.
- Recurring: This option takes relationships into account to ensure personal information is not distributed to other applicants. For example, the Primary Applicant and Spouse are on one document because personal information can be shared between spouses, and then a separate document is generated for each Co-applicant/Other applicant.
- Non-recurring: The non-recurring behavior ignores relationships between applicants. When this option is selected, Spouses and Co-applicants/Other applicants are treated the same.
- None: “None” is ideal for applicant-specific documents, such as an adverse action document. For example, a loan guarantee is for a Guarantor applicant only.
There are two components involved in determining the behavior of documents:
- Document Mapping: The fields used in a PDF template.
- Data Source: An XML file that is passed from the Host System to eSign. For example, the Data Source can have data for the following applicants:
- Primary Applicant: The field label for this group is A_ or P_.
- Spouse: The field label for this group is C_.
- Co-applicant/Other Applicant: The field label for this group is O_ (O1, O2, etc.)
- Guarantor: The field label for this group is G_ (G1_, G2_, etc.)
The recurring behavior allows the applicant information to display automatically for each applicant if the following elements are correct:
- The applicant’s role or association with the loan/account (Refer to the “Required Fields’ Prefix with Data Source” column in the following table.)
- The required fields’ prefixes (Refer to the “Required Fields’ Prefix with Data Source” column in the following table.)
- The field mapping of the document (Refer to the “Document Mapping” column in the following table.)
| Behavior |
Document Mapping |
Required Fields’ Prefix with Data Source |
Result |
|---|---|---|---|
|
Recurring (Lending Dictionary - Optional) |
1st applicant: A_ or P_
2nd applicant: C_ |
Primary Applicant: A_ or P_
Spouse: C_
Co-applicant/ Other Applicant: O1_, O2_, etc. |
Generates one document copy for Primary AND Spouse
AND
Generates a separate document for each Co-applicant/Other |
|
Non-recurring (Lending Dictionary - Optional) |
1st applicant: A_ or P_
2nd applicant: C_ |
Primary Applicant: A_ or P_
Spouse: C_
Co-applicant/ Other Applicant: O1_, O2_, etc. |
Generates one document copy for Primary AND Spouse OR Co-applicant/Other
AND
Generates a separate document for each additional Co-applicant/ Other |
|
None (Lending and Membership Dictionaries - Mandatory) |
1st applicant: A_ or P_
2nd applicant: O1_ |
Primary Applicant: A_ or P_
Co-applicant/ Other Applicant: O1_, O2_, etc. |
Generates a document for Primary AND/OR Co-applicant/Other |
Stop:
Refer to the following tables of examples where the Data Source for Primary Applicant is A_, Spouse is C_, First Co-applicant/Other Applicant is O1_, Second Co-applicant/Other Applicant is O2_, and Guarantor is G1_. The guidelines provided below apply to lending application forms only.
|
Document Mapping |
Behavior |
Result |
|---|---|---|
|
Primary (A_) Spouse (C_) |
Recurring and Non‑recurring | Document 1 – Primary and Spouse (A_ and C_) |
|
Primary (A_) Co-applicant/ Other Applicant (O1_) |
Recurring |
Document 1 – Primary Applicant (A_) Document 2 – Co-applicant/Other Applicant (O1_) |
| Non‑recurring | Document 1 – Primary and Co-applicant/Other Applicant (A_ and O1_) | |
|
Primary (A_) Two Co-applicant/ Other Applicants (O1_ and O2_) |
Recurring |
Document 1 – Primary Applicant (A_) Document 2 – First Co-applicant/Other Applicant (O1_) Document 3 – Second Co-applicant/Other Applicant (O2_) |
| Non‑recurring | Document 1 – Primary and Co-applicant/Other Applicant (A_ and O1_) Document 2 – Second Co-applicant/Other Applicant (O2_) | |
|
Primary (A_) Spouse (C) Co-applicant/ Other Applicant (O1_) |
Recurring and Non‑recurring |
Document 1 – Primary and Spouse (A_ and C_) Document 2 – Co-applicant/Other Applicant (O1_) |
|
Primary (A_) Spouse (C_) Two Co-applicant/ Other Applicants (O1_ and O2_) |
Recurring and Non-recurring |
Document 1 – Primary and Spouse (A_ and C_) Document 2 – First Co-applicant/Other Applicant (O1_) Document 3 – Second Co-applicant/Other Applicant (O2_) |
|
Primary (A_) Spouse (C) Co-applicant/ Other Applicant (O1_) Guarantor (G1_) |
Recurring and Non-recurring |
Document 1 – Primary and Spouse (A_ and C_) Document 2 – First Co-applicant/Other Applicant (O1_) Document 3 – Guarantor (G1_) In this case, the Guarantor (G1_) is the applicant that is particular to the “applicant-specific” document. |
When “None” is selected, all of the applicants are grouped together except the applicant that is particular to the “applicant-specific” document.
| Document Mapping | Behavior | Result |
|---|---|---|
| Primary (A_) Spouse (C_) | None | Document 1 – Primary and Spouse (A_ and C_) |
|
Primary (A_) Spouse (C) Co-applicant/ Other Applicant (O1_) |
None | Document 1 – Primary, Spouse (A_ and C_), and Co applicant/Other Applicant (O1_) |
|
Primary (A_) Spouse (C) Co-applicant/ Other Applicant (O1_) Guarantor (G1_) |
None |
Document 1 – Primary, Spouse, and Co-applicant/Other Applicant (A_, C_, and O1_) Document 2 – Guarantor (G1_) In this case, the Guarantor (G1_) is the applicant that is particular to the “applicant-specific” document. |