Notification Service Documentation
V2.2
1.Notification Options
This document provides a standardized web service definition for mortgage insurance coverage and invoice notification.
1.1.putMortgageNotice
The default method of sending mortgage notifications data for a policy.
1.1.1.Service Details
Key to data types:
Code
Description
A/N
Alpha/Numeric Data
N
Numeric Data Only
DT
Date in YYMMDD format
TM
Time in HHMM format
ID
Coded value
SP
Spaces for filler
R
Real Number Data. Must use a decimal point
1.1.2.Legend
* Required fields
** Include only one HEADER 1 and HEADER 2 per file.
Additional Required fields for Mortgage Billing
1.1.3.Input: MortgageBill
Name
Data Type
Required
Length
Valid values
Description
insuranceMFT
A/N
Yes
20
Insurer’s 3 digit HPE MFT code.
netInvoice
Calender
Yes
12
Net invoice amount.
1.1.4.Input: BillSender
Name
Data Type
Required
Length
Valid values
Description
senderName
A/N
Yes
35
Insurance Company Name.
senderTaxID
A/N
Yes
10
Insurance Company primary tex-id or NAIC code.
senderMFT
A/N
Yes
17
senderContact
A/N
Yes
35
senderPhone
A/N
No
26
dataDate
A/N
Yes
6
YYMMDD format – Date insurance company processed the transactions.
dueDate
A/N
Yes (Invoice Only)
8
CCYYMMDD Format.
1.1.5.Input: BillDetails
Name
Data Type
Required
Length
Valid values
Description
recordCode
A/N
Yes
2
20
compnayName
A/N
No
35
companyTaxID
A/N
Yes
10
Use Co. Tax ID & NAIC Code
companyNAIC
A/N
Yes
10
Both are required
1.1.5.1.Input: Insured
Name
Data Type
Required
Length
Valid values
Description
nameInsured
A/N
Yes
35
Preferred order: Last name, First name.
additionalInsured
A/N
No
35
companyTaxID
A/N
Yes
35
Use Co. Tax ID & NAIC Code.
premisesAddress1
A/N
Yes
35
Address of the insured property.
premisesAddress2
A/N
Yes
30
premisesCity
A/N
Yes
30
premisesState
A/N
Yes
2
premisesZip
A/N
Yes
9
policyNumer
A/N
Yes
30
effectiveDate
A/N
Yes
8
CCYYMMDD format
expirationDate
A/N
Yes
8
CCYYMMDD format
activityDate
A/N
Yes
8
CCYYMMDD format;
This field is required for all transaction types. (DTM177 for XLC; DTM152 for all other.)
This field is required for all transaction types. (DTM177 for XLC; DTM152 for all other.)
processDate
A/N
Yes
8
CCYYMMDD format (same as data)
activityDate
A/N
Yes
8
See Appendix 1
transactionType
A/N
Yes
5
CCYYMMDD format; This field is required for all transaction types. (DTM177 for XLC; DTM152 for all other.)
cancellationCode
A/N
No
5
See Appendix 2; If transaction type = Cancellation, this field is required.
acordType
A/N
No
5
See Appendix 3, can be a code from the list or spaces.
acordLine
A/N
Yes
5
See Appendix 4
1.1.5.2.Input: Agent
Name
Data Type
Required
Length
Valid values
Description
agentNumber
A/N
No
10
Preferred order: Last name, First name.
agentName1
A/N
No
35
agentName2
A/N
No
35
Use Co. Tax ID & NAIC Code.
agentAddress1
A/N
No
35
Address of the insured property.
agentAddress2
A/N
No
35
agentCity
A/N
No
30
agentState
A/N
No
2
agentZip
A/N
No
9
agentPhone
A/N
No
26
1.1.5.3.Input: Mortgagee
Name
Data Type
Required
Length
Valid values
Description
mortgageeTaxID
A/N
No
10
Blank.
mortgageeName1
A/N
Yes
35
mortgageeName2
A/N
No
35
mortgageeAddress1
A/N
Yes
35
mortgageeAddress2
A/N
Yes
35
mortgageeCity
A/N
Yes
30
mortgageeState
A/N
Yes
2
mortgageeZip
A/N
Yes
9
1.1.5.4.Input: Coverage
Status Code
0
Success
1
No policy found
2
Policy not enforce
3
Policy format invalid
-1
System failure
2.Appendix 1: Policy Transaction Type
Status Code
0
Success
1
No policy found
2
Policy not enforce
3
Policy format invalid
-1
System failure