Safe Deposit Box
Overview
AcctHistSrch Safe Deposit Box
This operation allows you to obtain account transaction history associated with a specific safe deposit box account.
Behavior
Use the AcctHistSrch operation to find an amount, check number, or date number range of transaction history, as well as a specific transaction type for a given account, by sending in the following elements on the request:
AccountIdA complex element containing the incoming account identification information. The simple elements within this complex are:AcctId(Account ID)AcctType(Account Type)
LowAmt(Starting point for amount selections)HighAmt(Ending point for amount selections)ChkNumEnd(Ending point for check number selections)ChkNumStart(Starting point for check number selections)EndDt(Ending point for date selections)StartDt(Starting point for date selections)TrnType(Monetary transaction code)
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 |
|---|---|---|---|
| JHFREFAPI.MAXREC | Maximum Records | N/A |
| JHFREFAPI.BEGREC | Beginning Record | N/A |
| SDMAST.ACCTNO | Account Number | N/A |
| SDMAST.ACTYPE | Account Type | N/A |
| DDHIST.SERIAL | Check Number | N/A |
| DDHIST.SERIAL | Check Number | N/A |
| SDHIST.STDATE | Transaction Date | N/A |
| SDHIST.STDATE | Transaction Date | N/A |
| SDHIST.STAMT | Transaction Amount | N/A |
| SDHIST.STAMT | Transaction Amount | N/A |
| N/A | Sort Method | Canonical
|
| SDHIST.STDORC | Debit/Credit Code | N/A |
| N/A | Electronic Funds Transfer Only | N/A |
| XPath Element | File/Field | Description | Notes |
|---|---|---|---|
SentRec | JHFREFAPI.SENTREC | Number Sent Records | N/A |
MoreRec | JHFREFAPI.MOREREC | More Records? | N/A |
Cursor | JHFREFAPI.NEXTREC | Next Record | N/A |
TotRec | JHFREFAPI.TOTRECS | Total Records | N/A |
AcctId | SDMAST.ACCTNO | Box Number | N/A |
AcctType | SDMAST.ACTYPE | Account Type | N/A |
TrnCodeCode | SDHIST.STTRAN | Transaction Code | N/A |
TrnCodeDesc | SDPAR3.S3DESC | Transaction Description | N/A |
PostDt | SDHIST.STDATE | Date Posted | N/A |
Amt | SDHIST.STAMT | Amount Posted | N/A |
BatchNum | SDHIST.STBAT# | Batch Number | N/A |
SeqNum | SDHIST.STSEQ# | Sequence Number | N/A |
SrcCodeDesc | N/A | Source Code Description | N/A |
TrnType | SDHIST.STDORC | Transaction Type | N/A |
AffCode | SDHIST.STAFFT | Affects Code | N/A |
ImgNum | SDHIST.IMAGE# | Image Number | N/A |
TrnUsrId | SDHIST.SDMUID | User ID | N/A |
TrnWsId | SDTRAN.SDMWID | Workstation ID | N/A |
AffCodeDesc | N/A | Affects Code Description | N/A |
TrnStm | SDPAR3.S3STMD | Statement Description | N/A |
HistRecId | N/A | History Record ID | N/A |
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 errors to occur.
| Code | Element | System Message | Validation Trigger |
|---|---|---|---|
| 7 | AcctType | Account type is not valid | Presents when the value in this field is not set to B. |
| 11 | Cursor | Beginning Record cannot be negative | Presents when the value in this element is a negative number. |
| 43 | StartDt | Date is not valid | Presents when the value in this element is less than zero or an invalid date. |
| 45 | MaxRec | Numeric data is not valid | Presents when the data entered in this element is not numeric. |
| 45 | Cursor | Numeric data is not valid | Presents when the data entered in this element is not numeric. |
| 45 | AcctId | Numeric data is not valid | Presents when the data entered in this element is not numeric. |
| 45 | ChkNumStart | Numeric data is not valid | Presents when the data entered in this element is not numeric. |
| 45 | ChkNumEnd | Numeric data is not valid | Presents when the data entered in this element is not numeric. |
| 45 | EndDt | Numeric data is not valid | Presents when the data entered in this element is not numeric. |
| 45 | StartDt | Numeric data is not valid | Presents when the data entered in this element is not numeric. |
| 45 | LowAmt | Numeric data is not valid | Presents when the data entered in this element is not numeric. |
| 45 | HighAmt | Numeric data is not valid | Presents when the data entered in this element is not numeric. |
| 48 | MaxRec | Maximum records must be greater than zero and less than or equal to 4000 | Presents when the value in this field is less than 0 or greater than 4000. |
| 700000 | AcctId | Box does not exist | Presents when the account number/type combination is not found in CIF Account File (CFACCT). |
| 700000 | AcctType | Box does not exist | Presents when the account number/type combination is not found in CIF Account File (CFACCT). |
The following table lists the warnings that can be returned and includes what prompts the warnings to occur.
| Code | Element | System Message | Validation Trigger |
|---|---|---|---|
| 49 | AcctId | No Records Match Selection Criteria | Presents when a valid account number/type is sent on the request but no collection records are returned. |
| 49 | AcctType | No Records Match Selection Criteria | Presents when a valid account number/type is sent on the request but no collection records are returned. |
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 AcctHistSrch 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 B in SvcDictFilterVal to get values specific for the time deposit application.| Element Name | Field Value (ElemCanocVal) |
|---|---|
SrtMthd | Amt |
SrtMthd | ChkNum |
SrtMthd | EffDt |
SrtMthd | PostDt |