Non-JH
Overview
AcctMod Non-JH Account
This operation allows you to modify or delete a deposit, loan, time deposit, safe deposit, or non-JH account.
Behavior
Within the request, enter the account ID and type along with the other elements containing values to be changed.
The response contains an RsStat element, which indicates the result of the
operation, with a value of Success when completed or with an
HdrFault if the provider is unable to complete the request.
The AcctInq operation provides you with the ability to
determine an account’s Card Opt In/Out status by passing in the
following filter:
AccountId- A complex element containing the incoming account identification information. The simple elements within this complex are:AcctId(Account ID)AcctType(Account Type)
XPath Elements
XPath Elements
For this business service, certain template fields, or XPath elements, are sent in on the request and corresponding elements are returned in the response.
The following tables list the elements that you send on the request and what is sent back in the response. Each table also includes any pertinent notes, such as element values or whether it is required for input.
| XPath Element | File/Field | Description | Notes |
|---|---|---|---|
ErrCode | JHFREFAPI.ERROVRRD | Error Override? | N/A |
AcctID | JHTNEW.ACCTNO | Account Number | N/A |
AcctType | JHTNEW.ACTYPE | Account Type | N/A |
Dlt | N/A | Delete | N/A |
BrCode | JHTNEW.BRANCH | Branch Number | N/A |
IncCombStmt | JHTNEW.COMBIN | Include Comb Stmt | N/A |
AcctLvlSecCode | JHTNEW.SECURE | Account Level Security | N/A |
AddlName.ComName | CFALTN.CFAAL1 | Additional Name #1 | N/A |
AddlName.ComName | CFALTN.CFAAL2 | Additional Name #2 | N/A |
UserDefTxt | CFPAR3.CP3UID | UIC Description 1–53 | There are 53 total elements available for you to enter information into. |
UserDefCode | CFPARB.CBFDFT | Field Default Value 1–53 | There are 53 total elements available for you to enter information into. |
CurBal | JHTNEW.CBAL | Current Balance | N/A |
ComName | CFALTN.CFNA1 | Alias Name | N/A |
FirstName | CFALTN.CFNA1 | Alias First Name | N/A |
MiddleName | CFALTN.CFNA1 | Alias Middle Name | N/A |
LastName | CFALTN.CFNA1 | Alias Last Name | N/A |
AbbName | CFALTN.CFNA1 | Alias Short Name | N/A |
| XPath Element | File/Field | Description | Notes |
|---|---|---|---|
Rs.Stat | JHFREFAPI.PASSFAIL | Pass/Fail Status | N/A |
| Field/Field | Maintenance Description | Field Label |
|---|---|---|
| JHTNEW.ACCTNO | Account Number | Account Number |
| JHTNEW.ACTYPE | Account Type | Account Type |
All elements are evaluated and if the value sent in is different from the core file value and the process is completed successfully, then a maintenance record for that field with the field changes is written out.
Validations
Validations
Within the response, specific validations can appear in the response if incorrect or different information than what is required is sent in the request.
The following table lists the errors that can be returned and includes what prompts the validation to occur.
| Code | Element | System Message | Validation Trigger |
|---|---|---|---|
| 1 | AcctType | Account not found | Presents when the account type/number combination is not found within the Non-JH Account Master File (JHMAST) or the Non-JH Account Master File (JHTNEW). |
| 1 | AcctId | Account not found | Presents when the account type/number combination is not found within the Non-JH Account Master File (JHMAST) or the Non-JH Account Master File (JHTNEW). |
| 5 | N/A | Cannot allocate files | Presents when the files used within the procedure are not available at the time of the request. |
| 40 | IncCombStmt | Include on combined statements flag must be Y or N | Presents when the value in this element is not Y or N. |
| 43 | N/A | Date is not valid | Presents when the value of the date is not valid, such as fewer than six digits or all zeros. |
| 45 | N/A | Numeric data is not valid | Presents when a numeric value is not entered in this element. |
| 65 | AcctLvlSecCode | Security override code is not valid | Presents when the value in this element is not B, A, N, N, E, or blank. |
| 112 | UserDefTxt | Description is invalid | Presents when the code is sent in the request but no description is sent. |
| 112 | UserDefCode | Description is invalid | Presents when the code is sent in the request but no description is sent. |
| 130 | N/A | The value entered is longer than the field length | Presents when there are too many places left of the decimal position. |
| 131 | N/A | Incorrect number of decimal places | Presents when there are incorrect places after the decimal position. |
| 1005 | N/A | Date field has an invalid format | Presents when the date is not in a valid format, such as XX/XX/XXX or XX-XX-XXXX. |
| 2000 | N/A | Maintenance denied due to data not being current | Presents when the element modified has not changed since the last inquiry. |
| 600012 | AbbName | Short name is required | Presents when the Individual field is not set to Y and this element is blank. |
| 600013 | ComName | Alternate name is required | Presents when the FirstName and
LastName elements are not blank and the
Individual field is set to Y. |
| 600014 | LastName | First, Middle, and Last name information required to build Alternate Short Name | Presents when the Individual field is set to Y and these elements are sent as blank. |
| 600014 | MiddleName | First, Middle, and Last name information required to build Alternate Short Name | Presents when the Individual field is set to Y and these elements are sent as blank. |
| 600014 | FirstName | First, Middle, and Last name information required to build Alternate Short Name | Presents when the Individual field is set to Y and these elements are sent as blank. |
The following table lists the warnings that can be returned and includes what prompts the validation to occur.
| Code | Element | System Message | Validation Trigger |
|---|---|---|---|
| 400027 | N/A | Customer name closely matches OFAC suspect | Presents when the OFAC search has a match or one that closely matches. |
| 402500 | N/A | No OFAC match found | Presents when the OFAC search does not have a match. |
| 402527 | N/A | OFAC matching word | Presents when checking for OFAC keywords and gets a match. |
The following table lists the faults that can be returned and includes what prompts the validation to occur.
| Code | Element | System Message | Validation Trigger |
|---|---|---|---|
| 100002 | IncCombStmt | Account has a combined statement relationship that will be deleted | Presents when the value sent in this element is N and a combined statement record in the Combined Statement File (DDCOMB). |
| 600015 | ComName | Account has an alternate name record that will be deleted | Presents when the value sent in this element is blank and the alternate name is populated in the core file. |
Service Dictionary
Service Dictionary
Service Dictionary Search provides consumers a service that can convey a service provider's element XSD path, requirements, default values, open enumerated canonical values, help/knowledge content, and fault codes per operation.
Within the SvcDictSrch operation, you can send
AcctMod in the SvcDictName element and
Rq or Rs in the SvcDictType
element. Within the response, SvcDictSrch returns all mapped elements,
including any newly mapped elements, and any elements that have specific allowed values. The
following table lists the response information for elements with specified allowed values.
SvcDictFilterCode and ** in
SvcDictFilterVal to get values specific for the loan account
application.| Element Name | Field Value (ElemCanocVal) | Field Description (ElemCanocValDesc) |
|---|---|---|
AcctType | C | Mastercard® |
AcctType | E | Loan External |
AcctType | I | Investment |
AcctType | M | Mastercard® |
AcctType | N | Mortgage Account |
AcctType | P | ATM Card |
AcctType | Q | Wealth Management |
AcctType | V | Visa® Card |
AcctType | Z | Business Visa® Card |
BrCode | Pulls from JHTNEW.BRANCH | Branch Number |
IncCombStmt | N | No |
IncCombStmt | Y | Yes |
AcctLvlSecCode | A | All Access |
AcctLvlSecCode | B | Balance-Only Access |
AcctLvlSecCode | E | Existence Only |
AcctLvlSecCode | N | No Access Including Existence |