# 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 | |