Customer System Types and Codes

The following table describes the system types for the CUS subsystem. Prior to working with the customers, you must create codes (and in some cases, subcodes) for each of the non-fixed system types. If in Fixed Code column there is a letter y, you will be unable to make any changes to the code. For more information on adding a new system type and code, please see Defining System Types and Codes.

System Type

Fixed Code?

Description

Customer

ACTIVITY N Activities are certain system events that pertain to a constituent and are tracked in Personify. These are also sometimes referred to as "system activities", to distinguish them from manually generated contact tracking records. Both type of records may record communications with a constituent, such as emails sent.

 

The primary examples of these system activities are:

  • Email notification is sent (from the NTS system) to acknowledge an order, payment, change of address, or other system event.

  • Mass email, fax, or physical mailing was sent (from the MKT system) for some purpose – fundraising campaign, meeting invite, update on a congressional hearing, etc.

  • Some organizations may choose to convert orders or other data from an old system into Personify’s activity table. There is a record of that event but they do not need to capture all of the financials and other pieces of data required by the order tables.

  • Some organizations may also decide to manually enter activity records to track certain circumstances – this is not a best practice (manual items should be entered as Contact Tracking) but the system allows that just in case.

 

Prior to 7.4.1, the Contact Tracking screen only showed Contact Tracking items. Users did not see emails and other communications generated by the system (as discussed above). This did not give users a complete picture of all of the communications that took place between a constituent and the client. For instance, a constituent could be calling about an email that he/she received. Previously, the email may not have appeared in the Contact Tracking list if it was sent via NTS, Marketing, or Outlook, for instance. Therefore, the new constituent-specific CRM360® Activity and Contact Tracking screen is not limited to Cus_Activity. ACTIVITY_CODE = ‘CONTACTTRACKING’. This screen includes ALL activity records where Activity Code’s Option 1 field = "Y". The Option 1 field is labeled "‘Treat as Contact Tracking" in the System Types and Codes (APP005) screen.

Note.pngWhen creating a notification event, on the Activity and Contact Tracking screen in Notification Maintenance, if your organization checked both the Create Activity and Create Contact Tracking Record checkboxes, then the Activity and Contact Tracking screen in CRM360 may look like it has duplicates because one record would display for the activity and one for the contact tracking record. Best practice is to create one or the other.

Note.pngBecause system activities and contact tracking records are different, it is best practice to NOT have a system type called "Contact Tracking" to reduce confusion.

ADDRESS_DETAIL_FIELDS Y The fields that are used to define the personal components of the address structure. Some examples include, Attention Line, Mail Stop, Job Title, and etc. These fields are located on the Personal Address Structure (CUS008A) screen.
ADDRESS_FIELDS Y The fields that are used to define the street components of the address structure. These fields are located on the Personal Address Structure (CUS008A) screen. For example, Address 1, City, Country, and etc.
ADDRESS_STATUS N The status of the address related to the customer. For example, Good or Bad. This field is located on the Add Additional Customer Address (AdditionalAddress) screen.
ADDRESS_TYPE N The fields that are used to define the type of address related to the customer. For example, Home, Work, or Blank. If you select the “Blank” value, the application ignores the required fields from the CUS_ADDRESS_STRUCTURE table set up for the country selected, and allows the user to save an address with no data populating the Address fields. This field is located on the Add Additional Customer Address (AdditionalAddress) screen.
Option 1 is titled "Prompt for Title Adr Update?". In Personify, Adr is the abbreviation for address. Setting this to "Y" will give a prompt when the address Title field is updated.It will ask to "Update Primary Job title on Customer? Y/N.

"Work" is used on rosters and other reports. Therefore, it may be preferable to use "Business" or other user-defined codes. Similarly, "Home" is used on rosters.

Note.pngThe Address Type is part of the address primary key, meaning that it cannot be changed after a record has been saved.

ALIAS N A type of alias for the constituent. For example, Acronym, Maiden Name, or Also Known As. This field can be updated for a constituent in CRM360 from the Name Details task in the Background Information task category. For more information, please see Defining a Constituent's Name, Salutations, and Aliases in CRM360. Aliases help increase the chances a constituent will be found when users query the "Search Name" field. Typical aliases include company and agency acronyms and maiden names.
ANNUAL_INCOME_RANGE N A user-defined code that allows an organization to define ranges of income for categorizing their constituents. This is only used for individuals. This field is located on the Demographics screen in CRM360.
BARCODE_IDENTIFIER Y A two-digit value that indicates the degree of pre-sorting this mail piece received before being presented for mail delivery. Required if “Use Address Change Service” = “Y” on batch processes that generate mailing labels. The Barcode ID generally should be left as “00”. The exception is for flat mail bundles with an optional endorsement line, where the Intelligent Mail barcode must contain OEL coding corresponding to the correct sort level. This field is used on the  for the appropriate batch processes.
CMRA Y A code that identifies whether the address is a Commercial Mail Receiving Agency, such as Mail Boxes, etc. Valid values are Y (yes), N (no), and U (unknown). This is set by address-validation software.
COMM_LOCATION N The location associated with various pieces contact information. For example, Home or Work. Please note that while mobile devices are not tethered to a physical location, the codes set up in base indicate (more or less) personal contact information vs. business information, and allow for other client-defined designations. The "Location" field is located the Contact Method Details (CUS004) screen. As of 7.4.1, "CELL" is not a base option for COMM_LOCATION. "Mobile" should be used instead. Note that the Description of these communication locations display on the Contact Information screen in CRM360. Please make sure that the descriptions are meaningful. For example, if a user adds a "Phone" Type (defined as COMM_TYPE below) with a location of "Home" and a "Mobile" type with a location of "Home", then two "Home" phone numbers will display in CRM360, as shown below:

home.png

 

Instead, if you add a COMM_LOCATION of "Personal Mobile", the two phone numbers will display, as shown below:

personal_mobile.png

COMM_TYPE Y This identifies whether a communication method is a phone, fax, email, or web. The "Type" field is located on the Contact Method Details (CUS004) screen.

 

The Option 1 column, labeled "Phone/Web", determines if the system will display formatted text box for phone numbers or a plain text for email addresses. Valid values include "PHONE" and "WEB". This is used from any screen where users can update the communication methods for a customer (e.g., CUS004, CUS004A,and etc.).

 

The Option 3 column, labeled "CRM360 Contact Method Category", determines how the communication types will be grouped on the Contact Information screen in CRM360. Valid values include:

·            PHONE,

·            EMAIL,

·            WEB,

·            FAX.

For example, "FTP" or "IM" with a value of "WEB" would be grouped under Web/Social Media.

Note.pngThe "COMMITTEE" is delivered with base and can be used for committee rosters. The system does not use this option for anything else.

COMMENT_TYPE N Allows the organization to categorize what a comment is related to when a user adds Note on a customer. This field displays on the Miscellaneous Comments (CUS_Comments) screen in CRM360 and Donor360®. For more information, please see Adding Miscellaneous Comments to a Constituent's Record in CRM360.
CONSTITUENT_ROLE N This CUS type is used for Constituent Roles that are maintained on all the individual and company maintenance screens. Roles are manually defined and maintained. They are typically used to capture succinct details that cannot be system-generated because the role pertains to information not otherwise captured in Personify or that was too old to convert. For example, "Former Lobbyist".

 

Option 1 is titled "Add I &/or C for Customer Type" and is used to filter the codes in the Roles screen based on a Company or Individual record type in the event that some codes only apply to one type of constituent or the other. The display order column should be updated by the organization. Constituent roles should get a display order value that identifies the constituent role from lowest to highest in terms of the most important roles to the organization to the least important roles to the organization. The role code with the lowest display order value will be marked as the constituent's primary role. Primary roles can be easily selected in reports and queries.

 

If the organization wants to require that all individuals and companies must have at least one constituent role (application parameter: REQ_USE_OF_CONSTITUENT_ROLES equals "Y"), then the Auto Populate checkbox can be checked for one or more roles so that will be automatically populated for new individual or company records.

 

For more information, please see Defining a Constituent's Role Codes in CRM360.

CREDENTIALS N The field identifies the credentials related to the customer’s name. For example, MD or CPA. This field can be updated for a constituent in CRM360 from the Name Details task in the Background Information task category. For more information, please see Defining a Constituent's Name, Salutations, and Aliases in CRM360.
CREDIT_STATUS Y Identifies whether a customer is allowed to activate an order without paying for it. The default is "OK", but users can set the credit status to "Warning" if a customer has been problematic in paying his/her open orders. A credit status of "Stop" means the customer's order cannot be activated until the order is fully paid. This field is located on the Credit Limits screen in CRM360. For more information, please see Adding Credit Limits to a Constituent's Record in CRM360.
CREDIT_TERMS N The field identifies the length of time for which the credit limit is calculated. For example, 30 days or 10 days. This field can be updated for a constituent in CRM360 from the Credit Limits task in the Financial Data task category. For more information, please see Adding Credit Limits to a Constituent's Record in CRM360.
CUS_MARTIAL_STATUS Y This field is used to detail the marital status of a constituent and is used for informational purposes . This field is located on the Demographics screen in CRM360. For more information, please see Adding Demographic Information to a Constituent's Record in CRM360.
CUS_SALUTATION N The type salutation to be used on Fundraising correspondence. This field is located on the Individual Name Edit (CUS003INameDetails) screen. For more information, please see Defining a Constituent's Name, Salutations, and Aliases in CRM360.
  The following codes are delivered with Base Personify:

·            Family

·            Formal

·            Formal spouse

·            Formal with spouse

·            Informal

·            Informal spouse

·            Informal with spouse

·            Household (new as of 7.4.2)

CUS_SPECIALTY N The constituent’s special interest. For example, History, Technology, or Management. This field is located on the Special Interests screen in CRM360. For more information, please see Adding a Constituent's Special Interests in CRM360.
CUSTOMER_CLASS N The classification of the customer. This field is located on the Create New Customer (CUS001SF) screen and the Demographics screen in CRM360. Additionally, this displays as "Constituent Class" in the header on CRM360. Since Customer Class is hard-coded to “Individual” on the Web, verify that the Individual code has the “Available to Web” checkbox checked on the Types and Codes Maintenance screen.

 

The Option 1 column of "For Record Type" indicates that the customer class code can be used for the customer record type entered. Valid options include, I (Individual), C (Company), S (Subgroup), and T (Committee). For example, for the code "COUNCIL", if the For Record Type field is "CS", the code of Council can be used for companies and subgroups.

 

The following codes are delivered with Base Personify:

·            INDIVIDUAL

·            PROSPECT

·            COMPANY

·            FAMILY

·            REGION

·            BRANCH

·            GUILD

·            HOUSEHOLD (new as of 7.4.2)

CUSTOMER_DOCS N The type of customer-related document uploaded to the system. For example, Resume or Committee Minutes. This field is located on the Resume/Related Documents screen in CRM360. For more information, please see Attaching Files to a Constituent's Record in CRM360.
CUSTOMER_STATUS N The status of the customer. For example, Active or Inactive. This field is located on the Demographics screen in CRM360. For more information, please see Adding Demographic Information to a Constituent's Record in CRM360.
CUSTOMER_TYPE Y Identifies the record type of the customer. Personify currently supports four customer types: Individual (I), Company (C), Subgroup (S), and Committee (T).
DEMOGRAPHIC N This field is the type of demographic related to the customer. For example, gender, age, birth date, and etc.

 

You can also associate various customer records with specific mailing lists, such as promotional or media. For example, Hobbies or Civic Activities. This field is located on the Lists screen in CRM360. For more information, please see Adding Lists to a Constituent's Record in CRM360.

DPV Y Delivery Point Validation® (DPV™) status.

 

DPV validates the accuracy of address data to the physical delivery point. By incorporating DPV into the matching process, users can determine whether the address exists down to the finest delivery point, such as apartment or suite number. Available through licensed CASS vendors, the DPV data set is updated monthly and consists of the nearly 150 million addresses delivered by the USPS. DPV reduces undeliverable-as-addressed mail, offering mailers significant savings in postage costs.

 

The DPV status code is updated by address validation software. Status codes include:

·            N - Nothing confirmed,

·            Y - Everything confirmed (ZIP+4, primary, and secondary),

·            S - ZIP+4 and primary (house number) confirmed,

·            D - ZIP+4 and primary (house number) confirmed and a default match,

·            U - Non-matched input address to USPS ZIP+4 data, or DPV data not loaded.

DPVFOOTNOTE Y Additional delivery point validation code that expands on the DPV status. This is set by address-validation software.

 

The DPV footnote code is updated by address validation software.  Supported codes are:

·            AA - Input address matched to the ZIP+4 file,

·            A1 - Input address not matched to the ZIP+4 file,

·            BB - Input address matched to DPV (all components),

·            CC - Secondary number did not match,

·            N1 - High rise address missing secondary number,

·            M1 - Input address primary number missing,

·            M3 - Input address primary number invalid,

·            P1 - Input address missing PO, RR or HC Box number,

·            RR - Input address matched to CMRA,

·            R1 - Secondary number is missing.

EMAIL_FAX_USE Y This is not currently being used in Personify.
EMPLOYMENT_EMPLOYER_CODE N This is not currently being used in Personify.
ETHNITICY N The ethnicity of the customer. For example, Caucasian or Hispanic. This field is located on the Demographics screen in CRM360. For more information, please see Adding Demographic Information to a Constituent's Record in CRM360.
EVENT Y This is not currently being used in Personify.
GENDER N The gender of the customer. For example, Male or Female. This field is located on the Demographics screen in CRM360. For more information, please see Adding Demographic Information to a Constituent's Record in CRM360.
HINT_QUESTION N This is not currently being used in Personify.
HOUSEHOLD_CLASS N As of 7.4.2, this optional field allows organizations to classify households.

 

The following code is delivered with Base Personify:

·            Household

HOUSEHOLD_MEMBER_ROLE N As of 7.4.2, this identifies the household member’s role in the household. 

 

The following codes are delivered with Base Personify:

·            HEAD_OF_HOUSEHOLD - Head of Household

·            HOUSEHOLD MEMBER - Household Member

·            HOUSEHOLD - Household

HOUSEHOLD_STATUS Y As of 7.4.2, this identifies the status of the household.

 

The following codes are delivered with Base Personify:

·            Active

·            Dissolved

·            Duplicate

JOB_FUNCTION N The customer’s current job function. For example, CEO or Consultant. This field is located on the Demographics screen in CRM360. For more information, please see Adding Demographic Information to a Constituent's Record in CRM360.
LABEL_FORMAT Y Off the shelf label views for use with CUS500 batch process. For example, 3 Across, 10 Down: Avery5160 label. This is a fixed code because the CUS500 code Must be Changed in order to add a different label format.
MERGE_FAIL_ACTION Y This is used by the customer dedup process. It identifies whether records found in a child customer's table for the duplicate customer should be deleted (DELETE) or merged (MERGE) into the surviving customer record. If a customer record can only have one record in the child table (i.e., CUSTOMER ID is the primary key), the merge fail action needs to be set to DELETE.
NAME_PREFIX

N

The prefix of the customer’s name. For example, Mrs. or Mr. This field is located on the Individual Name Edit (CUS003INameDetails) screen and the Create New Customer (CUS001SF) screen.
NAME_SUFFIX

N

The suffix of the customer’s name. For example, Jr. or Sr. This field is located on the Individual Name Edit (CUS003INameDetails) screen and the Create New Customer (CUS001SF) screen.

OPT_IN_INTEREST_AREA

N

The types of interest areas the customer can subscribe or opt-in to. These interest areas display on the Unsubscribed Options (CUS_UnsubscribedOption) screen when you click Add More Options on the Opt-In/Opt-Out Selections screen in CRM360. For more information, please see Adding a Constituent's Opt-In/Opt-Out Preferences in CRM360.

OPT_OUT_REASON

N The reason the customer decided to opt-out of an interest area. For example, Duplicate or No Interest. This field is located on the Opt-In/Opt-Out Selections screen in CRM360. For more information, please see Adding a Constituent's Opt-In/Opt-Out Preferences in CRM360.
PHONE_FIELDS Y This is used when defining phone structures on the Address and Phone Structure (CUS008) screen. Valid values include:

·            PHONE_COUNTRY_CODE,

·            PHONE_AREA_CODE,

·            PHONE_NUMBER,

·            PHONE_EXTENSION.

PHONE_TYPE N This is used when defining emergency contacts for a constituent to identity the type of phone when a phone number is entered on the Emergency Contacts (CUS004E_Emergency_Contacts) screen. The following codes are delivered with base:

·            CELL,

·            HOME,

·            WORK.

 

For more information, please see Adding a Constituent's Emergency Contact in CRM360.

POSTAL_ERROR Y This is used by third-party address validation software. The codes identity problems with addresses. The base application is delivered with postal error codes used by Spectrum. Valid values include:

·            A (invalid apartment info),

·            B (insufficient information),

·            H (invalid house number),

·            S (invalid street),

·            X (database has expired),

·            Z (invalid zip code),

·            F (address not found),

·            INSUFFICIENTINPUTDATA (insufficient input data),

·            MULTIPLEMATCHESFOUND (possible multiple addresses found),

·            UNABLETOVALIDATE (address not found).

POSTAL_OVERRIDE N The reason you want to override the customer’s address upon validation. This field is located on the Address Validation screen.

PRODUCT_CATEGORY

N This user-defined code is used when products or services are defined for advertisers and exhibitors. This information is typically printed in directories and buyer guides.
PROG_DEGREE N The type of program or degree the customer will complete or has completed. For example, Bachelor of Arts or Doctor of Medicine. This field is located on the Education screen in CRM360. For more information, please see Adding Education Information to a Constituent's Record in CRM360.
PROG_TYPE N This further defines the program or degree. For example, Undergraduate or Continuing Education Credit. This field is located on the Education screen in CRM360. For more information, please see Adding Education Information to a Constituent's Record in CRM360.
RDI Y (Residential Delivery Indicator) These codes are used by address validation software that identity whether the address is a business or a residential address. Valid values include:

·            B (business),

·            R (residential).

REVENUE_RANGE N The range of revenue the subgroup earns in a fiscal year. For example, $1-5 million or $6-10 million. This field is located on the Subgroup Central > Subgroup Information screen.
SEGMENT_RULE N The segment rule related to the segment that the customer controls. For example Employee Segment Rule or Committee Segment Rule. This field is located on the Organization Segmentation (ORG002) screen.
SERVICE_TYPE_IDENTIFIER Y A 3-digit value representing both the class of the mail (such as first-class, standard mail, or periodical), and any services requested by the sender. This is set by user as a parameter value for batch processes using Address Change Service (ACS).  Values delivered with base include:

·            044 - Periodicals and Destination Confirm,

·            080 - First-Class Address Service Requested,

·            082 - First-Class Change Service Requested,

·            090 - Standard Address Service Requested,

·            092 - Standard Address Service Requested,

·            140 - First-Class Address Service Requested & Desti.Conf,

·            142 - Standard Address Service Requested & Desti.Conf,

·            144 - Periodicals Address Service Requested & Desti.Conf,

·            240 - First-Class Change Service Requested & Desti.Conf,

·            242 - Standard Change Service Requested & Desti.Conf,

·            704 - Periodicals,

·            782 - Periodicals Address Service Requested.

SPECIAL_NEEDS N The type of special need the customer has. For example, ADA or Allergies. This field is located on the Special Needs screen in CRM360. For more information, please see Adding a Constituent's Special Needs in CRM360.
SPECIALTY_STATUS N The level of expertise the customer has in his/her special interest. For example, Intermediate or Master. This field is located on the Special Interests screen in CRM360. For more information, please see Adding a Constituent's Special Interests in CRM360.
STAFF_RANGE N The number of people on staff for the subgroup. For example, 21-50 or 50-100. This field is located on the Subgroup Central > Subgroup Information screen.

Call Center

CALL_TOPIC N The topic of the contact record. To set the Topic field values, enter the appropriate codes for the type. To set the Subject field values, enter the appropriate codes for the subcode. This field is located on the Activities and Contact Tracking screen in CRM360 and the Contact Tracking screen.
CALL_TYPE N The type of contact you sent or received. For example, Phone Inbound or Email Outbound. This field is located on the Contact Tracking screen.
LDAP_SERVER_TYPE Y This is not currently being used in Personify.

MBR_RULE

Y This is not currently being used in Personify.
MESSAGE_RULE N This is not currently being used in Personify.
MRM_USER_OPTION Y This is not currently being used in Personify.
VIP_RULE Y This is not currently being used in Personify.