Introduction > Customer 360 SaaS data dictionary > Person business entity model
  

Person business entity model

Person business entity stores information about people. This business entity contains some basic fields and some field groups.

General fields of Person business entity

The general fields store basic information about a person, such as name and date of birth.
The following table lists the general fields that the Person business entity contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
First Name
firstName
Text
255
NA
First name of the person.
Middle Name
middleName
Text
255
NA
Middle name of the person.
Last Name
lastName
Text
255
NA
Last name of the person.
Full Name
fullName
Text
255
NA
Full name of the person.
Title
title
Text
255
NA
Title associated with the person's name.
Birth Place
birthPlace
Text
255
NA
Place of birth of the person.
Birth Date
birthDate
Date Time
NA
NA
Date of birth of the person.
Gender
gender
Lookup
NA
Gender
Gender of the person.
Image
imageUrl
Text
255
NA
URL of the image of the person.
Prefix Name
prefixName
Lookup
NA
PrefixName
Prefix for the name of the person. For example, Dr, Mr, or Mrs.
Suffix Name
suffixName
Lookup
NA
SuffixName
Suffix name of the person. For example, Sr, Jr, II, or III.
Designation
designation
Text
255
NA
Designation or position of the person.
Marital Status
maritalStatus
Lookup
NA
MaritalStatus
Marital status of the person. For example, single, married, or divorced.

Address field group of Person business entity

The Address field group stores the postal addresses of a person. Postal address is a physical address associated with the person. A person can have multiple addresses.
The following table lists the fields that the Address field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Default Indicator
defaultIndicator
Boolean
NA
NA
Indicates whether the address is the default address.
Address Type
addressType
Lookup
NA
AddressType
Type of postal address. For example, home, office, shipping, or mailing.
Usage Type
usageType
Lookup
NA
AddressUsageType
Usage type. For example, business or personal.
Address Line 1
addressLine1
Text
200
NA
Line 1 of the address.
Address Line 2
addressLine2
Text
200
NA
Line 2 of the address.
Address Line 3
addressLine3
Text
200
NA
Line 3 of the address.
City
city
Text
50
NA
City of postal address.
County
county
Text
50
NA
County of postal address.
State
state
Lookup
NA
State
State of postal address.
Country
country
Lookup
NA
Country
Country of postal address.
Postal Code
postalCode
Text
10
NA
Postal code of the address.
Postal Code Extension
postalCodeExtension
Text
10
NA
Postal code extension of the address.
Coordinate System
coordinateSystem
Text
100
NA
Coordinate system used to determine the location of the address.
Location Coordinate Desc
locationCoordinateDesc
Text
50
NA
Location of the address using coordinate system.
Address Status
addressStatus
Lookup
NA
AddressStatus
Status of the address. For example, active, current, old address, or changed.
Latitude
latitude
Text
20
NA
Latitude for the address.
Longitude
longitude
Text
NA
NA
Longitude for the address.
Start Date
effectiveStartDate
Date Time
NA
NA
Start date from when the address is active.
End Date
effectiveEndDate
Date Time
NA
NA
Expiry date of the address.
Enriched Indicator
enrichedIndicator
Lookup
NA
AddressEnrichedIndicator
Validation status of the address. For example, error, valid, or not validated.

Alternate Names field group of Person business entity

The Alternate Names field group stores the details of alternate names. Alternate names can be alias, previous name, doing business as and maiden name.
The following table lists the fields that the Alternate Names field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Alternate Name Type
alternateNameType
Lookup
NA
AlternateNameType
Type of the alternate name.
Alternate Name
AlternateName
Text
255
NA
Alternate name of the person such as alias, previous name and maiden name.
Effective Start Date
effectiveStartDate
Date Time
NA
NA
Start date from when the alternate name is valid.
Effective End Date
effectiveEndDate
Date Time
NA
NA
Expiry date of the alternate name.

Citizenship field group of Person business entity

The Citizenship field group stores the details of citizenship of a person, such as country and status of citizenship.
The following table lists the fields that the Citizenship field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Citizen of Country
citizenOfCountry
Lookup
NA
Country
Country to which the person belongs.
Citizenship Status
citizenshipStatus
Text
255
NA
Status of the citizenship.
Supporting Document Name
supportingDocumentName
Text
255
NA
Name of the supporting document that proves the citizenship.
Effective Start Date
effectiveStartDate
Date Time
NA
NA
Start date from when the citizenship is valid.
Effective End Date
effectiveEndDate
Date Time
NA
NA
Expiry date of citizenship.

Demographics field group of Person business entity

The Demographics field group stores the demographic details of a person.
The following table lists the fields that the Demographics field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Demographic Type
demographicType
Lookup
NA
DemographicType
Type of demographic factors. For example, ethnicity, income level, age, and profession.
Demographic Value
demographicValue
Lookup
NA
DemographicValue
Demographic values for a demographic type. For example, if ethnicity is a demographic type, then Hispanic and Asian are demographic values.

Documents field group of Person business entity

The Documents field group stores the document details, such as bank statement, salary slip, qualification certificate, identity proof, and residence proof.
The following table lists the fields that the Documents field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Document Type
documentType
Lookup
NA
DocumentType
Type of document.
Document Name
documentName
Text
255
NA
Name of the document.
Document Link
documentLink
Text
255
NA
URL to access the document.
File Name
fileName
Text
255
NA
Name of the file.
Valid From
validFrom
Date Time
NA
NA
Date from when the document is valid.
Valid To
validTo
Date Time
NA
NA
Date until when the document is valid.

Education field group of Person business entity

The Education field group stores the education details of a person. The education details can include the name of the institution where a person graduated, address of the institution, and year of passing.
The following table lists the fields that the Education field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Qualification Type
qualificationType
Lookup
NA
QualificationType
Type of qualification, such as illiterate, certification, diploma, bachelor, master, or doctoral.
Qualification Status
qualificationStatus
Lookup
NA
QualificationStatus
Status of the qualification.
Qualification Name
qualificationName
Text
255
NA
Name of the qualification.
Institution Name
institutionName
Text
255
NA
Name of the institution.
Student Number
studentNumber
Text
255
NA
Student number in the institution.
Effective Start Date
effectiveStartDate
Date Time
NA
NA
Start date of the qualification.
Effective End Date
effectiveEndDate
Date Time
NA
NA
End date of the qualification.
Address Line 1
addressLine1
Text
255
NA
Line 1 of the address of the educational institution.
Address Line 2
addressLine2
Text
255
NA
Line 2 of the address of the educational institution.
City
city
Text
255
NA
City in which the institution is located.
Postal Code
postalCode
Text
255
NA
Postal code of the address.
Postal Code Extension
postalCodeExtension
Text
255
NA
Postal code extension of the address.
State
state
Lookup
NA
State
State in which the institution is located.
Country
country
Lookup
NA
Country
Country in which the institution is located.

Email field group of Person business entity

The Email field group stores information about the electronic addresses, such as email addresses or URL of the websites.
The following table lists the fields that the Email field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Usage Type
usageType
Lookup
NA
ElectronicAddressUsageType
Usage type indicates the intended use or purpose of the electronic address. For example, business, work, or personal.
Electronic Address
electronicAddress
Text
255
NA
Electronic address of the person.
Default Indicator
defaultIndicator
Boolean
NA
NA
Indicates whether the electronic address is primary or default.
Hygiene Status
hygieneStatus
Text
255
NA
Hygiene status for the electronic address. For example, safe to send, invalid, or spam.
Electronic Address Status
electronicAddressStatus
Lookup
NA
ElectronicAddressStatus
Status of the email address. For example, active, blocked, or not in use.
Validation Status
validationStatusCode
Text
255
NA
Validation status of the electronic address.
Validation Message
validateMessage
Text
255
NA
Message that the address validation service generates to indicate how valid and trusted the address is.
Enriched Indicator
enrichedIndicator
Boolean
NA
NA
Indicates whether the address verification service verified the address.
Effective Start Date
effectiveStartDate
Date Time
NA
NA
Start date for the electronic address.
Effective End Date
effectiveEndDate
Date Time
NA
NA
End date for the electronic address.
Net Protect Code
netProtectCode
Text
255
NA
Net protect codes identify which service or appliance is monitoring a given network.

Employment field group of Person business entity

The Employment field group stores the employment details, such as the employer name, the type of employment, and the status of employment.
The following table lists the fields that the Employment field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Employer Name
employerName
Text
255
NA
Name of the employer.
Employment Type
employmentType
Lookup
NA
EmploymentType
Type of employment, such as permanent, contract, and part-time.
Employment Status
employmentStatus
Lookup
NA
EmploymentStatus
Status of employment, such as active, inactive, resigned, and terminated.
Designation
designation
Text
255
NA
Designation of the person.
Line of Business
lineOfBusiness
Text
255
NA
Line of business, such as retail or mortgage.
Effective Start Date
effectiveStartDate
Date Time
NA
NA
Start date of employment.
Effective End Date
effectiveEndDate
Date Time
NA
NA
End date of employment.
Location
location
Text
255
NA
Location of the employer.

Financial field group of Person business entity

The Financial field group stores financial information of a person.
The following table lists the fields that the Financial field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Finance Info Type
financeInfoType
Lookup
NA
FinanceInfoType
Type of financial information. For example, equity, annual income, and debt.
Amount
amount
Double
NA
PersonStatusValue
Total value of the finance.
Unit
unit
Lookup
NA
FinancialUnit
Unit of the amount. For example, thousands, millions, or billions.
Currency
currency
Lookup
NA
Currency
Currency in which the financial information is provided.
Time Period
timePeriod
Text
255
NA
Finance period for which the data is collected.
Financial Reliability
financeReliability
Lookup
NA
FinanceReliability
Reliability of the financial data. For example, actual or estimate.
Time Period Type
timePeriodType
Lookup
NA
TimePeriodType
Type of the finance period. For example, quarterly or yearly.

Identifier field group of Person business entity

The Identifier field group stores the alternate identifier details of a person, such as Social Security number, driver's license number, or passport number. Alternate identifiers are known identifiers that uniquely identify a person.
The following table lists the fields that the Identifier field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Alternate Identifier Type
alternateIdentifierType
Lookup
NA
AlternateIdType
Type of alternate identifier.
Alternate Identifier Value
alternateIdentifierValue
Text
255
NA
Value of alternate identifier, such as driver's license number, or passport number.
Issuing Authority
issuingAuthority
Lookup
NA
IssuingAuthority
Authority that has issued the identifier to the person.
Status
identifierStatus
Lookup
NA
IdentifierStatus
Status of the alternate identifier. For example, effective, disqualified, expired, and temporary.
Effective Start Date
effectiveStartDate
Date Time
NA
NA
Issued date of the identifier.
Effective End Date
effectiveEndDate
Date Time
NA
NA
Expiry date of the identifier.

Insurance field group of Person business entity

The Insurance field group stores the insurance details, such as the name of the insurance provider, the policy number, the insurance type, and the validity.
The following table lists the fields that the Insurance field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Policy Number
policyNumber
Text
255
NA
Policy number of the insurance.
Insurance Value
insuranceValue
Double
NA
NA
Amount insured.
Unit
unit
Lookup
NA
FinancialUnit
Unit for the amount.
Currency
currency
Lookup
NA
Currency
Currency in which the person is insured.
Insurance Provider
insuranceProvider
Text
255
NA
Company that provides the insurance.
Insurance Type
insuranceType
Lookup
NA
InsuranceType
Type of insurance, such as life, health and accident, professional indemnity, or medical malpractice.
Insurance Sub Type
insuranceSubType
Lookup
NA
InsuranceSubType
Insurance subtype. For example, if the insurance type is life, the subtypes might be non-participating, participating, indeterminate premium, economic, limited pay, or single premium.
Insurance Status
insuranceStatus
Lookup
NA
InsuranceStatus
Status of the insurance. For example, active or expired.
Insurance Holder
insuranceHolder
Text
255
NA
Name of the insurance holder.
Effective Start Date
effectiveStartDate
Date Time
NA
NA
Start date of the insurance.
Effective End Date
effectiveEndDate
Date Time
NA
NA
Expiry date of the insurance.

Lifestyle field group of Person business entity

The Lifestyle field group stores the details related to the lifestyle of a person. Lifestyle details give additional information about the person, such as behavior and interests. Lifestyle information includes travel style, hobbies, and entertainment preferences.
The following table lists the fields that the Lifestyle field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Lifestyle Type
lifestyleType
Lookup
NA
LifestyleType
Type of lifestyle, such as classical music listener, decision maker or movie maniac.
Lifestyle Value
lifestyleValue
Text
255
NA
Value for a specified lifestyle.

Loyalty field group of Person business entity

The Loyalty field group stores the loyalty account details of a person.
The following table lists the fields that the Loyalty field group entity contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Account Type
accountType
Lookup
NA
LoyaltyAccountType
Type of loyalty accounts. For example, elite, silver, gold, or privileged.
Account Number
AccountNumber
Text
255
NA
Loyalty account number.
Redemption Preferences
redemptionPreferences
Lookup
NA
RedemptionPreferences
Preference for the redemption of loyalty points. For example, cash back or credit.
Effective Start Date
effectiveStartDate
Date Time
NA
NA
Start date of the loyalty account.
Effective End Date
effectiveEndDate
Date Time
NA
NA
End date of the loyalty account.
Account Status
accountStatus
Lookup
NA
LoyaltyAccountStatus
Status of the account. For example, active, inactive, or dormant.

Phone field group of Person business entity

The Phone field group stores the phone details of a person.
The following table lists the fields that the Phone field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Phone Type
phoneType
Lookup
NA
PhoneType
Type of phone. For example, landline, mobile, home, or business.
Phone Usage Type
phoneUsageType
Lookup
NA
PhoneUsageType
Usage type of the phone. For example, personal, business, and customer service.
Phone Number
phoneNumber
Text
255
NA
Phone number of the person.
Phone Number Extension
phoneNumberExtension
Text
255
NA
Extension to phone number.
Prefix Number
prefixNumber
Text
255
NA
Country dialing code.
International Prefix
internationalPrefix
Text
255
NA
Prefix used to select an international telephone circuit.
National Prefix
nationalPrefix
Text
255
NA
Digit or combination of digits which must be dialed before an area or city code.
Cell Prefix
cellPrefix
Text
255
NA
Prefix that must prepend the National Significant Number for inbound international calls.
Default Indicator
defaultIndicator
Boolean
NA
NA
Indicates whether the phone number is the default number.
Do Not Call Indicator
doNotCallIndicator
Boolean
NA
NA
Indicates whether the person is interested to receive unsolicited phone calls from marketers.
National Destination Code
nationalDestinationCode
Text
255
NA
Code that identifies a numbering area within a country or a group of countries.
National Destination Code Indicator
nationalDestinationCodeIndicator
Boolean
NA
NA
Indicates whether the phone number includes the National Destination Code.
Validation Status
validationStatusCode
Text
255
NA
Validation status that the phone number validation service returns.
Enriched Indicator
enrichedIndicator
Boolean
NA
NA
Indicates whether the phone number validation service verified the phone number.
Validation Message
validationMessage
Text
255
NA
Validation message that the phone number validation service returns.
Effective Start Date
effectiveStartDate
Date Time
NA
NA
Date from when the phone number is active.
Effective End Date
effectiveEndDate
DateTime
NA
NA
Date until when the phone number was active or will be active.
Status
status
Lookup
NA
PhoneStatus
Status of the phone number, such as the phone number is publicly available or active.
National Format
nationalFormat
Text
50
NA
National format for the phone number.
International Format
internationalFormat
Text
50
NA
International format for the phone number.
ISO
iso
Text
2
NA
ISO country code.

Segment field group of Person business entity

The Segment field group stores the segment of a person. Segmentation can help marketers to design targeted campaigns.
The following table lists the fields that the Segment field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Segment Type
segmentType
Lookup
NA
SegmentType
Segment type of the person. For example, income, age, location, or spending pattern.
Segment Value
segmentValue
Lookup
NA
SegmentValue
A segment type can have segment values. For example, if income is a segment type, then lower middle class, upper high class and upper middle class are segment values.

Social Media field group of Person business entity

The Social Media field group stores information about the social media identifiers of a person.
The following table lists the fields that the Social Media field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Social Media Type
socialHandleType
Lookup
NA
SocialHandleType
Type of social media platform, such as Facebook or Twitter.
Social Media Value
socialMediaValue
Text
255
NA
Social media identifier or name of the person.

Specialization field group of Person business entity

The Specialization field group stores information about the specialities or specializations of a person. For healthcare professionals, a speciality can be cardiology, pediatrics, dermatology, or endocrinology.
The following table lists the fields that the Specialization field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Specialty Type
specialtyType
Lookup
NA
SpecialityType
Speciality type. For example, cytopathology, nephrology, or geriatrics.
Speciality
speciality
Text
255
NA
Name of speciality.
Board Certification Flag
boardCertificationFlag
Boolean
NA
NA
Indicates whether the board certification is active or not.

Status field group of Person business entity

The Status field group stores the statuses of a person. A status can be registered, approved, submitted, rejected, active, or inactive.
The following table lists the fields that the Status field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Status Type
statusType
Lookup
NA
PersonStatusType
Status type of the person. For example, onboarding, legal, or credit.
Status Value
statusValue
Lookup
NA
PersonStatusValue
Status value of the person.

Tax Details field group of Person business entity

The Tax Details field group stores tax-related information of a person, such as the taxpayer type, tax authority, taxpayer identification number, and amount of tax paid.
The following table lists the fields that the Tax Details field group contains:
Display Name
Internal ID
Field Type
Length
Reference Data
Description
Tax Number Type
taxNumberType
Lookup
NA
TaxNumberType
Type of the tax number. Tax number can be Individual Taxpayer Identification Number (ITIN), Employer Identification Number (EIN), Inland Revenue Department (IRD) number, and Permanent Account Number (PAN).
Tax Number
taxNumber
Text Field
255
NA
Unique number that identifies the person for tax purposes.
Taxpayer Type
taxPayerType
Lookup
NA
TaxPayerType
Type of tax payer. For example, individual, company, partnership, or trust.
Currency
currency
Lookup
NA
Currency
Currency in which the tax is paid.
Country
country
Lookup
NA
Country
Country of taxation.
State
state
Lookup
NA
State
State within the country of the taxation.
Tax Authority
taxAuthority
Lookup
NA
TaxAuthority
Tax authority. For example, Internal Revenue Service (IRS), HM Revenue and Customs (HMRC), and Inland Revenue Department.
Effective Start Date
effectiveStartDate
Date Time
NA
NA
Start date of the tax period.
Effective End Date
effectiveEndDate
Date Time
NA
NA
End date of the tax period.
Tax Paid
taxPaid
Text Field
255
NA
Tax amount that the person has paid.