Check21 Component
Properties Methods Events Configuration Settings Errors
The Check21 component is used to construct a file containing scanned images of paper checks, and optionally upload it to an FTPS server.
Syntax
nsoftware.InPay.Check21
Remarks
An X9.37 file created by this component will contain the following records:
- File Header Record (1)
- Cash Letter Header Record (1)
- Bundle Header Record (1)
- Check detail record structure (0 to Checks.Count), which contains:
- Check Detail Record (1)
- Check Detail Addenda A (1)
- Front Image View Detail Record (0 or 1)
- Front Image View Data Record (0 or 1)
- Back Image View Detail Record (0 or 1)
- Back Image View Data Record (0 or 1)
- Bundle Control Record (1)
- Cash Letter Control Record (1)
- File Control Record (1)
This component makes creating the above file very easy.
First set the Origin fields with information about the institution that is originating this file, and
the destination it is to be deposited to. Also set the ReturnRoutingNumber.
Check21.Origin.OriginName = "First Bank of Thor" Check21.Origin.RoutingNumber = "111012822" Check21.Origin.ContactName = "Jake Olsen" Check21.Origin.ContactPhone = "800-555-5555" Check21.DestinationRoutingNumber = "051000321" Check21.DestinationName = "First Bank of Loki" Check21.ReturnRoutingNumber = "111012822"This file must be differentiated from other files, so now set the CashLetterId and CycleNumber properties, as well as the Filename. (Alternatively Filename may be left empty, and the component will write the file to memory and store it in the FileData property).
Check21.CashLetterId = "123456" Check21.CycleNumber = "01" Check21.Filename = "sample_output.dat"This file is going to contain scanned images of paper checks, so RecordType should be set to rtChecksAndImages and make sure the DocumentationType is set to a compatible value ("G" through "J" are valid when RecordType is rtChecksAndImages).
Check21.RecordType = rtChecksAndImages Check21.DocumentationType = "G"This sample file is to contain only one check, but a real file may contain any number of checks. To add a check, create a new CheckDetail object and fill the fields with information read off the check's MICR line, as well as the Payee's name and the amount of the check.
CheckDetail check = new CheckDetail() check.MICROnUs = "1234567890101" ' Account number on the check check.MICRRoutingNumber = "902113700" check.Amount = "50000" ' $500.00 check.SequenceNumber = "407" check.PayeeName = "Bruce Banner"Then set information about the Bank of First Deposit. This may be identical to the Origin. The BOFDConversionIndicator should also be set to "2" if this bank converted the original check into the image being included.
check.BOFDRoutingNumber = "111012822" check.BOFDAccountNumber = "181818181818181818" check.BOFDBranch = "Asgard" check.BOFDConversionIndicator = "2"Finally, you must include images of the front and back of the check, and indicate the format and compression used to create those images. You may use FrontImageFilename and BackImageFilename fields to point to image files on disk, or you may set the binary data directly in FrontImageData and BackImageData. You also need to set a unique identifier that can be used to retrieve the images at a later date.
check.ImageFormat = ifTIFF ' default check.ImageCompression = icJPEG ' default check.CanRecreateImages = True ' default check.FrontImageFilename = "front.jpg" check.FrontImageReferenceKey = "72234215front" check.BackImageFilename = "back.jpg" check.BackImageReferenceKey = "72234215back"Finally add the check image to the component's Checks collection.
Check21.Checks.Add(check)Now call BuildFile to build the file and save it to the Filename you indicated earlier. If you have an FTPS server (TLS/SSL-secured FTP) to upload the files to, you may set the FTP fields and call BuildAndUploadFile method instead.
Property List
The following is the full list of the properties of the component with short descriptions. Click on the links for further details.
| BusinessDate | The year, month, and day that designates the business date at the Bank of First Deposit. |
| CashLetterId | A code used to uniquely identify the cash letter inside the file. |
| Checks | Collection of checks to be written to the file. |
| CollectionType | A code that indicates the type of cash letter and bundle contained in the file. |
| CycleNumber | Denotes the cycle under which the file is created. |
| DestinationName | The short name that identifies the institution that receives the file. |
| DestinationRoutingNumber | This number identifies the institution that receives the file. |
| DocumentationType | A code that indicates the type of documentation that supports all Checks records in the file. |
| FileData | Contains the binary contents of the X9.37 file created by the BuildFile method. |
| Filename | Path and name of the file to be written to disk by the BuildFile method. |
| FTP | Information about the FTP or FTPS server you're uploading to. |
| Origin | Contains information about the originator of this file and the checks contained within. |
| RecordType | A code that indicates the type of records contained in this file. |
| ReturnRoutingNumber | A routing number indicating the location to which returns and return notifications should be sent. |
| SettlementDate | The date that the institution that created the file expects settlement. |
| SSLAcceptServerCert | Instructs the component to unconditionally accept the server certificate that matches the supplied certificate. |
| SSLCert | The certificate to be used during SSL negotiation. |
| SSLServerCert | The server certificate for the last established connection. |
| SSLStartMode | Determines how the component starts the SSL negotiation. |
Method List
The following is the full list of the methods of the component with short descriptions. Click on the links for further details.
| BuildAndUploadFile | Builds an X9.37 file and uploads it to an FTP server. |
| BuildFile | Builds an X9.37 file. |
| Config | Sets or retrieves a configuration setting . |
| Interrupt | Interrupt the current method. |
| Reset | Reset the internal state of the component and all properties to their default values. |
Event List
The following is the full list of the events fired by the component with short descriptions. Click on the links for further details.
| Error | Information about non-fatal errors encountered during file construction. |
| SSLServerAuthentication | Fired after the server presents its certificate to the client. |
| SSLStatus | Shows the progress of the secure connection. |
| Status | Traces the commands sent to the server, and the respective replies. |
Configuration Settings
The following is a list of configuration settings for the component with short descriptions. Click on the links for further details.
| ASCIIOutput | Indicates whether to output ASCII or EBCDIC. |
| Overwrite | Indicates whether local files can be overwritten. |
| OverwriteRemoteFile | Indicates whether remote files can be overwritten on the FTP server. |
| ArchiveType | Indicates the type of archive that supports each Check in this file. |
| BOFDIndicator | Indicates whether the origin is also the bank of first deposit. |
| AllowAllBOFDIndicators | Allows for any value to be specified within the BOFDIndicator field. |
| TestFile | Indicates whether the file being built is a test file or a production file. |
| ResendIndicator | Indicates whether the file being built has been previously transmitted in its entirety. |
| FileCreationDate | The date the file is created. |
| FileCreationTime | The time the file is created. |
| FileUserField | A User Field. |
| FedWorkType | Federal Reserve work type. |
| IncludeAddendA | Whether to include Detail Addendum A Record. |
| ReservedField | A field reserved for future use. |
| CashLetterCreationDate | The date the cash letter is created. |
| CashLetterCreationTime | The time the cash letter is created. |
| CountryCode | A code that identifies the country in which the payor bank is located. |
| FileId | A code used to uniquely identify this file. |
| BundleCount | Total number of bundles in the file. |
| BundleCreationDate | The date the bundle is created. |
| BundleId | Unique identifier for the bundle inside the Cash Letter. |
| BundleIndex | Index of the current bundle. |
| ReturnAcceptance | A code that indicates whether the institution that creates this file will or will not support electronic return processing. |
| DetailAddendumRecordNumber | The Check Detail Addendum A Record Number. |
| CheckIsCredit[i] | Indicates whether a Check is to be sent as a Credit (61) Record. |
| CodePage | The system code page used for Unicode to Multibyte translations. |