---
updatedAt: 2025-03-11T14:08:03.000Z
agentTools:
  projectIndex: https://customise.toq.io/llms.txt
---

# Guide for Modelers

### **Personal Information Panel Section**

On the **Personal Information page**, two **subforms** handle personal information:

1️⃣ **Editable Form** (Displayed when the status is **"In Progress"**)\
2️⃣ **Read-Only Form** (Displayed when the status is **"Under Review"** or **"Completed"**)

<Image align="center" src="https://files.readme.io/c7fa34ffea7c0a0487cd2c90813aa7513f1ab53c2356b05e41cb1578855ebc35-AD_4nXfJH5mwLK-Oip5DzkomPI2lYnI7c1Pn9P_WnvqZctKxo_Od9YztlYUlpx2gHFCB9rYuVULrgK3BHk1v05BLxRpgpkHqpbiL_DvMcboQp9449ksCMNcm3JS3jlyjl3bn2dxYj4Pm9Q.png" />

<br />

### **Handling Identity Files**

The "Complete Personal Information" subform allows users to upload, remove, and download identity files.

Custom Components Used:

* [File Upload](https://customise.toq.io/docs/file-upload#/)
* [File](https://customise.toq.io/docs/file) - displays file lists & manages download/removal actions

<Image align="center" src="https://files.readme.io/3133e26d7b17c9bab834efba36779d6b2abbb1f8563e6eea18271766fb461ec5-AD_4nXf6GyzU5BXcKHo7FRiLp06yb_XWY6xJGxuHacQDNe4Hpz2zqDM77_muZjn8lVtTcknJ41kRXipl1xi6vMH-MR7a2RGVKE50AiOfog8T1BdlY0m0KqUTCzi8G2mdtPN3J7Cg9X_EOw.png" />

<br />

### **Checking Personal Information Subform**

* When status is "Under Review", a read-only version of the subform is displayed.
* Custom Components Used:
  * [Data Item](https://customise.toq.io/docs/data-item#/) -  shows previously submitted details.

<br />

### **Adding New Fields to the Personal Information Subform**

To add new fields, update subforms:

* Editable Subform – Add the new fields & map them to variables.
* Process Mapping – Update CPT\_P003 to include the new fields in the Update Director Compliance Service Registry.
* Read-Only Subform – Display the new fields sent for compliance validation.
* File Upload Handling – If the new fields involve files, follow the approach used in the Complete Personal Information Subform.

#### User Data Fields for Personal Information Subform

| **Template Display Name** | **Toqio DB param** | **Required** | **Type** |
| ------------------------- | ------------------ | ------------ | -------- |
| **Email**                 | email              | Mandatory    | string   |
| **First Name**            | firstName          | Mandatory    | string   |
| **Last Name**             | lastName           | Mandatory    | string   |
| **Address**               | address            | Optional     | string   |
| **Address 2**             | address2           | Optional     | string   |
| **Birth Date**            | birthDate          | Optional     | date     |
| **City**                  | city               | Optional     | string   |
| **Country**               | country            | Optional     | string   |
| **Postal Code**           | postalCode         | Optional     | string   |
| **Phone Country**         | phoneCountry       | Optional     | string   |
| **Phone Number**          | phoneNumber        | Optional     | string   |
| **Document Number**       | documentNumber     | Optional     | string   |
| **Document Type**         | documentType       | Optional     | string   |
| **Id number**             | idNumber           | Optional     | string   |
| **Address Lane**          | addressLane        | Optional     | string   |
| **Address Number**        | addressNumber      | Optional     | string   |

#### **Requirement Definitions:**

* **Mandatory** – this field is required in the form and cannot be removed.
* **Optional** – this field can be included or removed in the template-based application.

If you want to add additional information fields (e.g., alternative contact details), you can add them through the panel to send them to the provider.

🔹 **Note:** These fields **will not be stored** in the Toqio database or used in other processes.

<br />

#### KYC Documents Table

| **KYC Document Label** | **Document Type** | **Mandatory** (At Least 1 File) | **Max Files** | **Max Size (MB)** |
| ---------------------- | ----------------- | ------------------------------- | ------------- | ----------------- |
| **DNI**                | DNI               | ✅                               | 2             | 5                 |
| **TIE**                | TIE               | ✅                               | 2             | 5                 |
| **Passport**           | PASSPORT          | ✅                               | 1             | 5                 |
| **NIE**                | NIE               | ✅                               | 2             | 5                 |
| **NEW DOC**            | NEW\_DOC\_TYPE    | ⚠️ Optional                     | Customizable  | Customizable      |

#### **Table Definitions:**

* **KYC Document Label** → The name of the User document. Can be custom in the template.
* **Document Type** → The specific type of document collected.
* **Mandatory (At Least 1 File)** → This requirement is **defined in the template** and can be modified if needed.
* **Max Files That Can Be Uploaded** → The maximum number of files allowed for a document type. This parameter **can be modified**.
* **Max File Size (MB)** → The maximum size limit per file. **Changing this setting is not recommended**, as it may cause errors.

#### **Adding a New Document**

You can **add a new document type** into their template-based app by assigning it the **Document Type:`NEW_NAME`**. This new document type **will be stored on the Toqio side** and used within the compliance workflow.

> 📘 **Note:** KYC documents are stored and managed at the provider level.
>
> If a User is undergoing verification with multiple providers, they will need to **upload the required KYC documents separately for each provider** to ensure compliance data consistency across processes.

***

### **Managing Data & API Endpoints**

#### Fetching Compliance Status for the Section validation component

* **Triggered via**: REST button invoking the `C_P014` process.
* **Requirement**: The provider name must be dynamically assigned.
* **REST configuration:**

<Image align="center" src="https://files.readme.io/c30306a6c72b31eaad2801b4e48dbd1ff808515da424352072a40affee647e70-AD_4nXeS3bRINFZP61BuNR-coBiePjwlyjgdSq0woBPtViiSYbUXyJ-Pk97bcpB528mOpGytRAHWRphw3XcuLnLKfVnrdF1z3LwcoMcZgDFVAnykGEWW1IcdwkgK-YAqpKTc1bvDpCZOJg.png" />

<br />

#### Fetching Available Countries

* **Triggered via** the `C_P010` process.
* **REST configuration:**

<Image align="center" src="https://files.readme.io/67c1e0232208b5226e061f0c45244a4234890fca900f8fe9d5bafae57d8c41af-AD_4nXeW1Mc72wIZXC-IrPCqbaVyhdddn2V2Dx4kkkDxIkl7FZSKJryyMPa7gmsVY8vplbHTrdAL2W1MUrxptG760RRDc90Ep5SyHsHU-O8iD68U0e9UeZ25sBvyWgHdInTVnuvC1adfiA.png" />

<br />

#### Fetching User Data (Read-Only Mode)

* **Triggered via**: REST button invoking the `C_P012` process.
* **REST configuration:**

<Image align="center" src="https://files.readme.io/18e0aac7657874436f96605ae98c71c0b6de1113b655af9c488e79c46e294e0b-AD_4nXepU83qyDAjgxBp2Z0lGbg3Z05BmLxQ8Yczv4Wxem4fMV_wIq9VmmVft0nupIXfn_w4XiV2ya6YeyMmZpxaXNXXmL__kbCSaeKUa70avrIzoHV42iM8psL7gsMFOxsxq_AoD03aXA.png" />

<br />

#### Fetching User Info for Editing

* **Triggered via**: REST button invoking the `CPT_P005` process.
* **REST configuration:**

<Image align="center" src="https://files.readme.io/1ab8fc5a24af3432c4e7194926f4d7d781d3971570a1e34de24c069017fb5a54-AD_4nXdv6pn5Okp0TAC7NfhfyFRbXggDAT-t16lqW7fRx9agBqxoRa6ntxEXRTkaXpPdZAEv0tAQVENKkNsUVzCXXIAgVjDhNAdwktT_FVvtPfDqkKHqGXyPtOhD1uIrXNO6EDz3CaWtSQ.png" />

<br />

#### Fetching Merchant Data

* **Triggered via**: REST button invoking the `C_P013` process.
* **REST configuration:**

<Image align="center" src="https://files.readme.io/2f06a3dacc0d4c947b7b90bb6e72754ca8e05612793dcae9dcada58cc29495a9-AD_4nXdaOexbUlEI_OMI9RfQtqygg14A8Ok1y6A3empxSrNzS_L5X0dAN4qDkljIa90kqzTaVCLNUwewEKE8cEHV4xTE8yBulQNwWAugFBh7d6qZ2ZSGJ_Em4TXK6sNxX3hLCkrBun0I.png" />

<br />

#### Submitting Personal Information

* On the complete Personal Information subform, to submit information process `CPT_P013` is invoked by the REST button and providing following arguments to the process:
  * complianceProvider
  * director
  * documents
  * documentsToRemove
* **REST configuration:** ➜ Update director data

<Image align="center" src="https://files.readme.io/dee530edbc1045852c874062bb072ea7966f7747e87f5946227ef9703a5b8d27-AD_4nXdxi93lSSFQaUfraXo1_uT0OkKV9JXbkHF0pa2Oh5UhcJmJc5-JOrGmsv_vVc_OoKB-h2YjaJqQ-_b669g7CkKZ4ls7uH55xa50Evl0m-5izLJUc5vgWUb-4gmV4-Tm4jmxyQx2mQ.png" />

<br />

**REST configuration:**  ➜ Update director compliance status

<Image align="center" src="https://files.readme.io/542e8c11038d6a34d2b6d20a929fc396782daf7282e375969961996dd0ef4d0e-AD_4nXdhqqjjYPiyk0-LtugpQynwSqNA9saTWjCgNGyQlX8XszRFCj6WqYhUeMYRDqCnXKGYQzBjbzOwV3E1DP9jD9JFcnBm2pq4MLnw6LLO6-cRTPDz-mEF_BGnnDBqmdFdmnYz4MzU0Q.png" />

**REST configuration:**  ➜ Upload KYC documents

<Image align="center" src="https://files.readme.io/f76d1afe2881496cc2879bfedd528fab0eec359acd0e8bb8054555a1cd2aa490-AD_4nXcUSfT10lelkwzSRfHP89ZYB791yHgb3rxVawl8Iie7P1VvFLDCnhasd3ojBh8VMRm_J7sEbWsm1ErPPxpFX8lbCu3ju0c8zca5FtHq9Nom-_XvSjx30-npYzN9e6aRCZFlp6xbMw.png" />

**REST configuration:**  ➜ Remove KYC documents

<Image align="center" src="https://files.readme.io/8d265a8cc7fcbc1c34ca545ac5f34538d41c03bfc62294ba40393d8d60f19dbf-AD_4nXenQq4heBQMtwPUSn5nnd_JvtY6mh3sN3tfLWJHvfqiu5jiX_fSptygDHoT5ClFjXp2ygqSsb8LrmR1dgyadNOWd77331m7pYrS52yrID7YETUSFfooyl16fBReK3Lk1355HMRP-g.png" />