Beruflich Dokumente
Kultur Dokumente
Contents
The purpose of this document is to provide a detailed layout on all required file formats and data types.
Record Type – (0 for Header Record, 1 for Transaction Record, 2 for Trailer Record)
File Type – (001 for Master File, 002 for Payments File, 003 for Synchronization File)
Refer to Annexure B.
File Sequence Number – First File = 000001 and increments by 1 for each new file submitted.
Version Number – Refer to Annexure B
Field Lengths – Refer to Annexure B
Client Code
The Client Code is a unique identifier supplied to you by ourselves on take-on. This unique number should be used
in all correspondence as it uniquely identifies the data.
Account Number
This is the unique number identifying each Debtor.
Language
Language spoken by the debtor.
Hand-Over Details
This can be anything relating to the handover for e.g. Hand-Over Name (Jan 2000 Handover)
Special Instruction
This is displayed on the front-end application. It can contain any information e.g.) if data is segregated between
different stores namely CENTURIAN, EASTGATE, SANDTON and so forth. This data is displayed for the collector to
use during collection.
Charge-Off Date
This is the date of Handover. The date the debtor accounts are being handed over for collection.
Charge-Off Amount
This is the amount that needs to be collected. If for example the debtor needs to pay his arrears amount only and
not the entire outstanding balance, the arrears amount needs to go into this field.
Magic Columns
The following 8 fields are dynamic and can contain any information that will be useful during collections.
Magic Column 1 contains an extra search facility. If for e.g.) there is a member number as well as a contract number,
the unique number would go into the Account Number field while the Contract Number would appear in
Magic Column 1.
The remainder of these columns is dynamic. These fields have the ability to be static or changeable. This needs to
be specified once on take-on.
Magic Column 1
Magic Column 2
Magic Column 3
Magic Column 4
Magic Column 5
Magic Column 6
Magic Column 7
Magic Column 8
Employer Details
Company Name - Name of Company to which the debtor is Employed.
Company Address
Company Address Line 2
Company Address Line 3
Company Address Line 4
Company Address Code
th
Payroll Closure Date – The date at which the company payroll closes. E.g. 20 of the Month.
Occupation – Debtors Occupation
Magic Data 1
Magic Data 2
Magic Data 3
Magic Data 4
Magic Data 5
Magic Data 6
Magic Data 7
Magic Data 8
Magic Data 9
Magic Data 10
Magic Data 11
Magic Data 12
Magic Data 13
Magic Data 14
Magic Data 15
Magic Data 16
Magic Data 17
Magic Data 18
Magic Data 19
Magic Data 20
Interest Rate
Interest rate is the rate that is applicable to be applied per account. This should be zero if the entire group of
accounts use a standard interest rate. The standard interest rate would have been specified initially and would
appear in the Client File on initial take over.
Filler Fields
The following filler fields are dynamic and can contain any information that will be useful during collections. These
fields are optional and are not necessary however, any additional information can be supplied in these fields. The
field types are determined on take-on and data should then be supplied accordingly.
Filler1
Filler2
Filler3
Filler4
Filler5
TakeOnFees
Fee charged on principle debt while a/c was not handed over.
TakeOnInterest
Interest charged on principle debt while a/c was not handed over.
Any additional information/data that is deemed important as part of the collection process can be supplied in these
fields:
Magic Data 21
Magic Data 22
Magic Data 23
Magic Data 24
Magic Data 25
Magic Data 26
Magic Data 27
Magic Data 28
Magic Data 29
Magic Data 30
Magic Data 31
Magic Data 32
Magic Data 33
Magic Data 34
Magic Data 35
Magic Data 36
Magic Data 37
Magic Data 38
Magic Data 39
Magic Data 40
Magic Data 41
Magic Data 42
Magic Data 43
Magic Data 44
Magic Data 45
Magic Data 46
Magic Data 47
Magic Data 48
Magic Data 49
Magic Data 50
BillingDate
Date a/c becomes charged off and is put into status to be handed over to collector.
EffectiveHandoverDate
Clients handed over date
EmailAddress
The debtors e-mail address
E.g. HOVR#1#356.TXT
Record Type – (0 for Header Record, 1 for Transaction Record, 2 for Trailer Record)
File Type – (001 for Master File, 002 for Payments File, 003 for Synchronization File)
Refer to Annexure B.
File Sequence Number – First File = 000001 and increments by 1 for each new file submitted.
Client Code
The Client Code is a unique identifier supplied to you by ourselves on take-on. This unique number should be used in
all correspondence as it uniquely identifies the data.
Account Number
This is the unique number identifying each Debtor.
Main Reference
This is the reference number of the payment. With this reference number, the payment date and the payment
amount you should be able to link back to the original bank statement.
Payment Date
This is the date when the debtor made payment. This should be supplied in the format ddmmyyyy.
Payment Amount
The amount paid by the debtor.
Payment Indicator
P indicates a Positive Payment, N indicates a Negative Payment (reversals).
E.g. PAY#1#356.TXT
Record Type – (0 for Header Record, 1 for Transaction Record, 2 for Trailer Record)
File Type – (001 for Master File, 002 for Payments File, 003 for Synchronization File)
Refer to Annexure B.
Version Number – Refer to Annexure B.
Field Lengths – Refer to Annexure B.
Interest Amount – In some cases, Clients specify interest should not be raised daily, in these cases the procedure to
Action Type – This is an identifier indicating the type of action that needs to be carried out on a specific account.
Record Type – (0 for Header Record, 1 for Transaction Record, 2 for Trailer Record)
File Type – (001 for Master File, 002 for Payments File, 003 for Synchronization File, 004 for SMS Files)
File Sequence Number – First File = 000001 and increments by 1 for each new file submitted.
SMS Message
This is the actual sms message you want to send out. Please note that if this exceeds 160 characters, they will be
omitted from the extract to be sent.
Phone Number
This is the phone number you want the message to be sent to. The number could appear as “0821234567 “ or
“27821234567”
The length of this field is 11 characters which means that if you send the number starting with a “0” you will have to
put in a filler space at the end.
MagicData39 Char 25
MagicData40 Char 25
MagicData41 Char 25
MagicData42 Char 25
MagicData43 Char 25
MagicData44 Char 25
MagicData45 Char 25
MagicData46 Char 25
MagicData47 Char 25
MagicData48 Char 25
MagicData49 Char 25
MagicData50 Char 25
Record Type – (0 for Header Record, 1 for Transaction Record, 2 for Trailer Record)
File Type – (001 for Master File, 002 for Payments File, 003 for Recon File)
Refer to Annexure B.
Version Number – Refer to Annexure B.
Field Lengths – Refer to Annexure B.
Client Code
The Client Code is a unique identifier supplied to you by ourselves on take-on. This unique number should be used in
all correspondence as it uniquely identifies the data.
Account Number
This is the unique number identifying each Debtor.
Capital Amount
This is the original amount on handover. This is the amount client hands over to MBD on day 1 of collection.
Interest Amount
In some cases, Clients specify interest should not be raised daily, in these cases the procedure to calculate interest
will not execute. Some clients request that they will provide an interest amount on a monthly/weekly basis. This is
the value that can either be the monthly outstanding interest amount that is raised by the client or an accumulative
interest outstanding on an account.
Fees Amount
Fees raised /charged on the handover debt. This is the value that can either be the monthly outstanding fee amount
that is raised by the client or accumulative fees outstanding on an account.
Magic Columns
The following 8 fields are dynamic and can contain any information that will be useful during collections.
Magic Column 1 contains an extra search facility. If for e.g.) there is a member number as well as a contract number,
the unique number would go into the Account Number field while the Contract Number would appear in
Magic Column 1.
The remainder of these columns is dynamic. These fields have the ability to be static or changeable. This needs to
be specified once on take-on.
Magic Column 1
Magic Column 2
Magic Column 3
Magic Column 4
Magic Column 5
Magic Column 6
Magic Column 7
Magic Column 8
Magic Data 1
Magic Data 2
Magic Data 3
Magic Data 4
Magic Data 5
Magic Data 6
Magic Data 7
Magic Data 8
Magic Data 9
Magic Data 10
Magic Data 11
Magic Data 12
Magic Data 13
Magic Data 14
Magic Data 15
Magic Data 16
Magic Data 17
Magic Data 18
Field Descriptions are based on the Transactional Record Type. Record Type is
compulsory for all Transactional Records.
The Header Record contains vital information that will be used during processing. The Sequence Number together with the
Client Code is used for validation. The File Type is an indicator that specifies the type of file being submitted.
000100010000012608200401
0 Record Type (Header Record = 0)
001 File Type (001 indicate Master File)
0001 Client Code (Supplied by ourselves)
000001 File Sequence Number (First File is 000001)
26082004 Date in the format ddmmyyyy
01 Version Number
Record Type
The Record Type identified the data within the file. The file will contain a Header Record, Transactional Records and a Trailer
Record. For successful upload, the Record Type indicator is important as it identifies each record within the file.
File Type
The File Type indicator identifies the Type of File. The file type is essential for successful processing.
Version Number
This is the file version number based on the File Format Supplied. If this document is updated, and the File Formats modified
or changed, the version number will be modified as well. The current Handover Version Number is 04 and Payment 03.
Field Lengths
The results that get appended to the header and trailer records should be equivalent to the to the specified field lengths. If
the result is less the then the specified field length, the field should be zero filled. E.g. If no of records is equal to 250 then
the result appended to the trailer record should be zero filled as 00000250 as the length of this filed is 8 characters.
<FileType>#<ClientCode>#<Sequence No>.txt
The # delimiter is to be used to separate the File Type, Client Code and Sequence Number of the File.