5.3 IOD file naming convention¶
Source: TI_Host_to_Host_Client_User_Manual_v52.pdf Document pages: 78-80 PDF pages: 78-80
H. Adding new or maintaining IOD Instances¶
An Administrator who has client self-maintenance on NetBank Business (NBB) can setup IOD instances. You can however only select email as your delivery method if you choose to setup an instance on NBB. For all Host delivery methods, you may contact your Transactional Banker for assistance.
If you do not have NBB, you may contact your Transactional Banker for assistance in adding or maintaining your instances.
An IOD file, used for the near real time delivery protocols, contains multiple images of deposit slips and associated cheques and/or cash slips. These images will be zipped into a single zip file. This file will have the following naming convention.
Example: PNGG00.CDTIPK.A13O P678.EN0610.I1 234C.ZIP
Field numbers Data Element Valid Values Description Notes 1 2 3 4 5 6 Applicable environment QNGG00 PNGG00 Q = Test environment P = Production environment These are standard fields and cannot be amended Field 1 - 4 are alpha Field 5 and 6 are numeric ie zero, zero P N G G 0 0 7 Separator . To separate data elements The full stop cannot be replaced with a comma as the file validation will fail . 8 9 10 11 12 13 Product environment CDTIPK To identify the file as a Transaction Information product
C D T I P K 14 Separator . To separate data elements The full stop cannot be replaced with a comma as the file validation will fail . 15 16 17 Client Prefix Please refer to description Field 15:Only alpha character are valid Field 16 and 17: Only alpha or numeric characters are valid To identify the client to whom the file will be delivered. This prefix will be issued by Nedbank A 1 3 18 Input / Output indicator O = Output I = Input
Only the specified alphanumeric characters are valid
O = When you receive a file from Nedbank I = When you send the file back to Nedbank eg this will only be applicable if you use a delivery protocol that has the capability for file acknowledgeme nt O
Example: PNGG00.CDTIPK.A13O P678.EN0610.I1234 C.ZIP
Field numbers Data Element Valid Values Description Notes 19 Product ID N = Notifications P = PTI I = IOD F = FTI R = IR Only specified alphanumeric characters are valid To identify which product you are receiving the file for P 20 21 22 File sequence numbers 001 to 999 These fields represent the file's sequential numbers and will be numeric It will be sequentially incremented by 1 for every file sent for that day. The number is reset to 001 the next day at midnight 6 7 8 23 Separator . To separate data elements The full stop cannot be replaced with a comma as the file validation will fail . 24 File type D = Data file and E = End of day file Only the specified alpha characters are valid E = End of day file is applicable to the PTI end of day file only E 25 Resend indicator R = Resend N = Normal Only the specified alpha characters are valid If you receive a file with a R value in the field the system must not automatically process the file N 26 27 Day indicator 01 to 31 Only numeric characters are valid
DD = Indicates day of the month that the file was created and does not indicate the date of the transactions
0 6 28 29 Month indicator 01 to 12 Only numeric characters are valid MM = Indicates the month of the year that file was created and does not indicate the date of the transactions
1 0 30 Separator . To separate data elements The full stop cannot be replaced with a comma as the file validation will fail . 31 Instance ID I = Instance Only the specified alpha character is valid
I 32 33 34 35 Instance number 0001 to 9999 Each TI product can have up to 9999 instances per profile An instance is a grouping of your accounts, settings and delivery protocol eg Instance 0001 account1 selected settings 'credits only' and delivered via email 1 2 3 4
Example: PNGG00.CDTIPK.A13OP678.EN0610.I1234 C.ZIP
Field numbers Data Element Valid Values Description Notes 36 Protocol ID C = Connect: Direct E= Email S = Swift W = Web Services M = IBM MQ A = FileAct F = FTP P = SFTP Q = IBM MQ FTP Only the specified alpha characters are valid This is the delivery protocol selected for this instance. Please note if the file is resent to the alternative email address the file name will contain the original protocol ID and not the email ID C 37 Separator . To separate data elements The full stop cannot be replaced with a comma as the file validation will fail . 38 39 40 Compressed file zip Only the specified alpha characters are valid in fields 38, 39 and 40. ZIP is a format that compresses large files allowing them to be sent more conveniently over the Internet. Files that are zipped will end with a .zip extension. When you open a zipped file or "unzip" it, you will often find that multiple files have been compressed into a single zip file. An example of this would be if you wanted to send a large number of images to someone and you compressed all of the images into a single zip file. Z I P
Note: If you happen to get an error message when you attempt to open or extract the zip file then you should report the problem to your local IT staff. Chances are that you do not have a WinZip program loaded on your computer and they can remedy this problem fairly easily.