---
# System prepended metadata

title: Onboarding Field Mapping

---

# Onboarding Field Mapping

This document provides a mapping between the UI labels seen in the Onboarding forms and the corresponding keys used in the application state and API payloads.

## 1. Product Selection

**File:** `src/ui/components/Onboarding/ProductSelection.js`

| UI Selection                         | ID / Key                 |
| :----------------------------------- | :----------------------- |
| Run compliant payroll with ease      | `payroll`                |
| Fast & secure international payments | `international_payments` |
| Open your business bank account      | `business_account`       |

---

## 2. Business Information

**File:** `src/ui/components/Onboarding/BusinessInfo.js`

### General Information

| Label                              | Key                                  | Type     | Notes               |
| :--------------------------------- | :----------------------------------- | :------- | :------------------ |
| Legal Type                         | `legal_type`                         | Select   |                     |
| Upload Trade License               | `trade_license_doc`                  | File     | Maps to `record_id` |
| Registered Company Name            | `company_name`                       | Text     |                     |
| Trade License Number               | `trade_lic_number`                   | Text     |                     |
| Issue Date                         | `trade_lic_issue_date`               | Date     |                     |
| Expiry Date                        | `trade_lic_expiry_date`              | Date     |                     |
| Issuing Authority                  | `trade_lic_issuing_authority`        | Select   |                     |
| License Type                       | `trade_lic_type`                     | Text     |                     |
| Country of HeadQuarters            | `country_of_headquarters`            | Select   |                     |
| Country of Operations/Business     | `country_of_operations`              | Select   |                     |
| Address Type                       | `address_type`                       | Text     |                     |
| Country of Incorporation           | `country_of_incorporation`           | Select   |                     |
| Ministry of Labor Establishment ID | `ministry_of_labor_establishment_id` | Text     |                     |
| Emirates of Registration           | `emirates_of_registration`           | Select   |                     |
| Nature of Business                 | `nature_of_business`                 | Select   |                     |
| License Issuing Country            | `trade_lic_issuing_country`          | Select   |                     |
| Country of Registration            | `country_of_registration`            | Select   |                     |
| Registration Number                | `registration_number`                | Text     |                     |
| Date of Registration               | `date_of_registration`               | Date     |                     |
| Missing VAT Reason                 | `missing_vat_reason`                 | Text     |                     |
| Company Profile                    | `company_profile`                    | Textarea |                     |

### Registered Address

| Label            | Key                | Type   | Notes |
| :--------------- | :----------------- | :----- | :---- |
| Address Line 1   | `address_line_1`   | Text   |       |
| Address Line 2   | `address_line_2`   | Text   |       |
| City             | `city`             | Select |       |
| Emirates         | `emirates`         | Select |       |
| Nearest Landmark | `nearest_landmark` | Text   |       |
| Postal Code      | `postal_code`      | Text   |       |

### Communication Address

| Label                            | Key                             | Type     | Notes |
| :------------------------------- | :------------------------------ | :------- | :---- |
| Is Communication Address same... | `is_communication_address_same` | Checkbox |       |
| Address Line 1                   | `comm_address_line_1`           | Text     |       |
| Address Line 2                   | `comm_address_line_2`           | Text     |       |
| City                             | `comm_city`                     | Select   |       |
| Emirates                         | `comm_emirates`                 | Select   |       |
| Nearest Landmark                 | `comm_nearest_landmark`         | Text     |       |
| Postal Code                      | `comm_postal_code`              | Text     |       |

### Contact Details

| Label                   | Key                | Type  | Notes |
| :---------------------- | :----------------- | :---- | :---- |
| Primary Mobile Number   | `primary_mobile`   | Phone |       |
| Secondary Mobile Number | `secondary_mobile` | Phone |       |
| Primary Email ID        | `primary_email`    | Text  |       |
| Secondary Email ID      | `secondary_email`  | Text  |       |

### Other Information

| Label                   | Key                | Type   | Notes |
| :---------------------- | :----------------- | :----- | :---- |
| Industry                | `industry`         | Select |       |
| Sub Industry            | `sub_industry`     | Select |       |
| Customer Segment        | `customer_segment` | Select |       |
| Central Bank Sector     | `cb_sector`        | Select |       |
| Central Bank Sub Sector | `cb_sub_sector`    | Select |       |

---

## 3. Business Activity

**File:** `src/ui/components/Onboarding/ActivityInfo.js`

### General & Wealth

| Label                 | Key                     | Type   | Notes |
| :-------------------- | :---------------------- | :----- | :---- |
| Date of Incorporation | `date_of_incorporation` | Date   |       |
| Company Website       | `company_website`       | Url    |       |
| Source of Wealth      | `source_of_wealth`      | Select |       |
| Number of Employees   | `number_of_employees`   | Text   |       |

### Financial Position

| Label                  | Key                      | Type   | Notes |
| :--------------------- | :----------------------- | :----- | :---- |
| Authorized Capital     | `authorized_capital`     | Text   |       |
| Total Paid up Capital  | `total_paid_up_capital`  | Text   |       |
| Company Capital        | `company_capital`        | Text   |       |
| Total Assets           | `total_assets`           | Text   |       |
| Total Liabilities      | `total_liabilities`      | Text   |       |
| Net Profit             | `net_profit`             | Text   |       |
| Annual Income          | `annual_income`          | Text   |       |
| Current Turnover       | `current_turnover`       | Select |       |
| Current Turnover Range | `current_turnover_range` | Select |       |

### Nature of Business

| Label                   | Key                          | Type           | Notes |
| :---------------------- | :--------------------------- | :------------- | :---- |
| Business Nature Summary | `business_nature_summary`    | Textarea       |       |
| Main Business Activity  | `main_business_activity`     | Text           |       |
| Operational Countries   | `operational_countries_list` | Select (Multi) |       |

### Transaction Expectations

| Label                                 | Key                                        | Type   | Notes |
| :------------------------------------ | :----------------------------------------- | :----- | :---- |
| Expected No of Transactions (Monthly) | `expected_no_of_transactions_monthly`      | Text   |       |
| Expected No of Inward Transfers...    | `expected_no_of_inward_transfers_monthly`  | Text   |       |
| Expected No of Outward Transfers...   | `expected_no_of_outward_transfers_monthly` | Text   |       |
| Avg Expected Transaction Value        | `avg_expected_transaction`                 | Select |       |

### Supplier & Customer Information

| Label            | Key               | Type   | Notes |
| :--------------- | :---------------- | :----- | :---- |
| Supplier Company | `supp_company`    | Text   |       |
| Supplier Country | `supp_country`    | Select |       |
| Supplier %       | `supp_percentage` | Text   |       |
| Customer Company | `cus_company`     | Text   |       |
| Customer Country | `cus_country`     | Select |       |
| Customer %       | `cus_percentage`  | Text   |       |

### Banking & Compliance

| Label               | Key                   | Type   | Notes |
| :------------------ | :-------------------- | :----- | :---- |
| Bank                | `bank`                | Select |       |
| Bank Account Type   | `bank_account_type`   | Select |       |
| Licensing Authority | `licensing_authority` | Select |       |

### Corporate Structure (Arrays)

- **Parent/Holding Companies**: `parent_holding_companies`
  - Name: `legal_entity_name`
  - License: `license_number`
  - Country: `country_of_incorporation`
- **Subsidiaries**: `subsidiaries`
  - (Same structure as Parent)
- **Associated Companies**: `associated_companies`
  - (Same structure as Parent)
- **Non-UAE Operations**: `other_country_operations`
  - Type: `operation_type`
  - Country: `country`
  - % Assets (Entity): `asset_percentage_entity`
  - % Assets (Group): `asset_percentage_group`

### Additional Information

| Label                            | Key                         | Type     | Notes |
| :------------------------------- | :-------------------------- | :------- | :---- |
| Authorized Distributor Details   | `auth_distributor_details`  | Textarea |       |
| Ownership Change Information     | `ownership_change_info`     | Textarea |       |
| Entity Status Change Information | `entity_status_change_info` | Textarea |       |
| Name of Parent Entity            | `name_of_the_parent_entity` | Text     |       |
| Year of Incorporation            | `year_of_incorporation`     | Text     |       |
| Beneficial Owner Profile         | `beneficial_owner_profile`  | Text     |       |

---

## 4. Business Representatives (Owners/Stakeholders)

**File:** `src/ui/components/Onboarding/OwnerForm.js`

### Basic Information

| Label                 | Key                       | Type        | Notes                             |
| :-------------------- | :------------------------ | :---------- | :-------------------------------- |
| Shareholder Type      | `shareholder_type`        | Select      |                                   |
| Option Type           | `option_type`             | Select      |                                   |
| First Name            | `first_name`              | Text        | Visible for Individual            |
| Last Name             | `last_name`               | Text        | Visible for Individual            |
| Company Name          | `company_name`            | Text        | Visible for Corporate             |
| Registration Number   | `registration_number`     | Text        | Visible for Corporate             |
| Email ID              | `email_id`                | Email       |                                   |
| Ownership %           | `percentage_of_ownership` | Number      |                                   |
| Relationship Type     | `relationship_type`       | Select      |                                   |
| Authorised Signatory? | `is_authorised_signatory` | Select/Bool |                                   |
| Portal Access         | `portal_access`           | Bool        | (Handled in `Representatives.js`) |

### Personal Details (Individual)

| Label                | Key                    | Type   | Notes |
| :------------------- | :--------------------- | :----- | :---- |
| Nationality          | `nationality`          | Select |       |
| Dual Nationality     | `dual_nationality`     | Select |       |
| Country of Residence | `country_of_residence` | Select |       |
| Date of Birth        | `date_of_birth`        | Date   |       |
| Country of Birth     | `country_of_birth`     | Select |       |

### Contact & Address

| Label                 | Key                  | Type   | Notes |
| :-------------------- | :------------------- | :----- | :---- |
| Address Line 1        | `address_line_1`     | Text   |       |
| Address Line 2        | `address_line_2`     | Text   |       |
| City                  | `city`               | Text   |       |
| Emirates              | `emirates`           | Select |       |
| PO Box                | `po_box`             | Text   |       |
| Nearest Landmark      | `nearest_landmark`   | Text   |       |
| Residential Status    | `residential_status` | Select |       |
| Mobile No             | `mobile_no`          | Phone  |       |
| Email (Communication) | `email`              | Email  |       |

### Tax Information

| Label                           | Key                     | Type        | Notes |
| :------------------------------ | :---------------------- | :---------- | :---- |
| Do you have a TIN?              | `has_tax_ident_num`     | Select/Bool |       |
| Tax Identification Number (TIN) | `tax_ident_number`      | Text        |       |
| Tax Residency Country           | `tax_residency_country` | Select      |       |
