citidirect administrator guide a4 en - · pdf fileinstitutional internet bank globally. it...

CitiDirect Guide

Administrator Manual

> Automated File and Report Delivery

> Import

May 2010

Dear User,

We glad that you have decided to use CitiDirect® Online Banking system to access your Account in Citi.

CitiDirect® Online Banking system is recognized as Best Corporate and Institutional Internet Bank Globally. It utilizes leading edge technologies and international standards and continuously receives international awards. We hope you will find CitiDirect® Online Banking useful and it will help you to save your time and resources with Citi.

We would like to highlight that your opinion is very important for us. You are always welcome to send your suggestions and comments to CitiDirect implementation and support team [email protected]. It will help us to become best servicing bank for you.

Best regards,

Saule Zhakayeva

Vice-President JSC “Citibank Kazakhstan”

Content 3

Automated File and Report Delivery 4

Public certificate 5

Library 6

Statement 8

Statement Schedule 11

Outlook private certificate 13

Import 15

Import > Import File 16

Import file for single payments 19

Import file for cumulative payments 22

Import > CitiDirect Profile 43


Automated file and report delivery (“AFRD”) tool allows users to receive daily statements via e-mail, which saves your time while account access, as to get an information you should not spent time for CitiDirect login. What you just need is open your e-mail box and find the information there, received as message with enclosed statement.

As electronic mail vehicle is not secure channel, so to provide full security of the information, the statements passed to users in encrypted mode. Client administrators should apply security certificates in Outlook on each user computer thus providing information readable on the users end.


Public Certificate

The client setups one public certificate independently on number of users, as the certificate relates to client profile, not user profiles. To get a certificate you should contact CitiDirect implementation and support. Before the certificate installment you need to be sure that the certificate has not been installed yet.

1 In menu choose “Maintenance > S/MIME Security Admin”.

2 Make sure that “Input/ Modify” tab is blank. Otherwise, if it already contains a certificate, please pass this step and go to next “Library” section.

3 Click “New” button to install the certificate

4 Please name the certificate.

5 Click “Browse” button to search the certificate.

6 Click “Submit” button to submit your settings.

Note: please first copy the certificate locally before

its browse and upload.

1

2

3

54

6


Library

1 In menu choose “Maintenance > Library maintenance”.

2 Double click “Automated File and Report Delivery” to come into the library.

3 Click “Input” tab.

4 Click “New” button. 1

2

3

4


1Enter user name and last name (in English).

2 Indicate “E-Mail” delivery.

3 Click drop-down menu button to retrieve public certificate.

4 Indicate user e-mail for statements receipt.

5 Indicate “Citi report” in message subject.

6 Indicate “Citi_report” as statement name.

7 Click “Submit” button to save your settings; enter next user details.

8 After all user details completion, click “Return to summary” button.

9 Make sure that all user records received “Processed” status.

Note: If the status differs from processed, say, is “Authorization required”, then 2

nd Administrator

should login to CitiDirect and authorize settings to receive “Processed” status for the user records.

To authorize user records, 2nd

Administrator logins to CitiDirect and in menu chooses “Maintenance > Library maintenance > Automated File and Report Delivery”; there on “Authorization Req’d” tab, the Administrator highlights required records and clicks “Authorize” button.

1 1

2

3

4

5

67 8

9


Statement

For each required user you should set detailed statement.

1 In menu choose “All reports > Cash Statement Reports”.

2 Choose “Account Statement Details Report”.

3 Click “Edit Report” button.

2

1

3


1Set statement format, for that click “Format” field.

In opened window “Run options ” please choose “Adobe (PDF)…” in “Report Format” field; in “Delivery options” field click look-up button; choose delivery option from the list:

Click “��” button.

1


1 Set statement date. For that click “Statement Date”field.

In opened window “Date range” choose “Relative” tab and there set from “-1” to “-1” range; bank “Business Days” check-box; click “��” button.

2 To save statement criteria click “Save” button.

Name the statement and click “��”.

Set statement for next user.

3 After all users’ statements completion, click “Return to Summary” button to return to summary screen.

1

2 3


Statement Schedule

For each user set separate schedule (all fields in English).

1 In menu choose “Maintenance > Automated file and report delivery”.

2 Click “Input/ Modify” tab.

3 Click “New” button” for schedule creation.

4 Name schedule.

5 Click button to look-up “Event type” and choose “Report”.

6 Click button to look-up and choose required statement from the statements list.

7 Choose “Every 1 or more days” interval for statement daily delivery.

8 For “Holiday Options“, choose “Run on all days” to indicate daily delivery including weekends.

9 Set “1” to run every 1 day.

10 Set delivery time in “HH:MM:SS” format; say, for 9.00 morning indicated time is 09:00:00.

11 Click “Submit” to save settings; set scheduler for next user. After set completion click “Return to Summary” to return to summary screen.

4

1

2

3

11

5

7

8

6

9 10


1 Make sure that the schedule got “Scheduled” status.

Note: The schedule may accept “Authorization

required” status, indicating that its requires authorization by 2

nd Administrator.

For the authorization, 2nd

Administrator should login to CitiDirect, in menu choose “Maintenance > Automated File and Report delivery”; on “Authorization Requ’d” tab highlight required records and click “Authorize” button.

1


Outlook private certificate

On each user computer you should implement private certificate for statement decryption to Outlook post service mail box. For the certificate receipt please contact CitiDirect implementation and support. To upload the certificate to Outlook, please do the next.

1 In Outlook menu choose “Tools > Options...”.

2 In “Options” window click “Security” tab and there

click “Import/Export…” button.

1

2


1 In “Import/Export Digital ID” window click “Browse”button in “Import file” filed to search the certificate, previously copied locally to your computer.

2 In “Password” field please type password for the certificate upload.

3 In “Digital ID Name” field type user mail address for the statement receipt. If e-mail address is long and exceeds the field length, the please type just those part of the address, which you can.

4 Click “OK” button to save. If system gives an error, please reconfirm the password.

Note: You just completed the automated delivery

setup. Effective next day the users will receive the statements via e-mail.

1

3

2

4

Import 15

By use of the import, clients prevent duplication of payment input thus preventing time wasting and human errors.

CitiDirect allows clients to upload (import) the files, formed by them in their own ERP or by use of any tool like Excel or Access files.

Though the import process the client ERP or resource file communicate to CitiDirect. First, clients form import files from their ERP or resource tool files. Then clients log to CitiDirect and there run import mode, described in CitiDirect user guide. Through the import mode, CitiDirect uploads import file, finds payment there in the file and validates them for correctness. After validation done, CitiDirect routes them to next process level like 1st authorization or pending release.

The process of import set is the next:

• Clients update their ERP to generate import files for single and cumulative payments; please refer to “Import files” section of this document.

• Clients update their CitiDirect for upload of the files through import mode; please refer to “CitiDirect import profile” section of this document.


CitiDirect sets rest of requirements to import files. Import files may have any name and extension. Files may be in next coding:

• DOS 866

• Win 1251

• UTF-8

• KZ-1048

Tag Format Legend

In matrixes below describing import formats, “Tag format” column indicates format of tags and fields in import file. Section below specifies all parameters, used to indicate requirements to a field or tag.

Values structure in “Tag format” field is indicated as follows below:

LX, where:

• [LX] format indicates optional parameter, say, [2n] field is optional;

• L is field length. Underlined number indicates that the value has strong length. For example, 12n indicates that the value is strongly 12 digits length;

• X indicates field type:

a – alpha format, allowing only letters specified in matrix 1 below. n – numeric format, allowing only digits, specified in matrix 2 below. x - alpha-numeric format, allowing letters, digits and special symbols, specified in matrixes 1-3 below. s1 – sum; decimal number with mandatory 2 digit after decimal point and “,” as decimal point, can vary from 0,01till 922337203685477,58. s2 – sum; decimal number with mandatory 2 digit after decimal point and “.” as decimal point. d1 – date in YYMMDD format, where YY is year number (last 2 digits), MM is month number, DD is day number. d2 – date in YYYYMMDD format, where YYYY is year number, MM is month number, DD is day number. d3 – date in MMYYYY format, where YYYY is year number, MM is month number.


Matrix 1

Character Character Character Character Character Character Character Character Comment

A (a) B (b) C (c) D (d) E (e) F (f) G (g) H (h) Capital (small) English letter

I (i) J (j) K (k) L(l) M (m) N (n) O (o) P (p) Capital (small) English letter

Q (q) R (r) S (s) T (t) U (u) V (v) W (w) X (x) Capital (small) English letter

Y (y) Z (z) Capital (small) English letter

� (�) �(�) �(�) () �(�) (�) �(�) �(�) Capital (small) Russian / Kazak letter

�(�) �(�) �(�) �(�) �(�) �(�) �(�) �( ) Capital (small) Russian / Kazak letter

!(") #($) %(&) '(() )(*) +(,) -(.) /(0) Capital (small) Russian / Kazak letter

1(2) 3(4) 5(6) 7(8) 9(:) ;(<) =(>) ?(@) Capital (small) Russian / Kazak letter

A(B) Capital (small) Russian / Kazak letter

C(D) E(F) G(H) I(J) K(L) M(N) O(P) Q(R) Capital (small) �� letter

S(T) Capital (small) �� letter

Matrix 2

Character Character Character Character Character Character Character Character Comment

0 1 2 3 4 5 6 7 Digit

8 9 Digit


Matrix 3

Character Comment Character Comment Character Comment Character Comment

( Left parenthesis . Period = Equals sign ‘ Apostrophe

) Right parenthesis + Plus Sign ? Question sign Space

/ Slash - Hyphen @ At sign ! Exclamation sign

: Colon # Hash sign “ Quotation sign

, Comma * Star sign > Right angle bracket % Percentage sign

& Ampersand ; Semicolon < Left angle bracket


Import file for single payments

Tags are separated in the file by use of ‘#’ character. One import file may have up to 10’000 payments.

#T1#T2#T3##T4#T5##T6#T7##T8##########T9###T10##T11#################T12#T13#####T14#T15####T16#T17#T18#T19#T20#T21#T22#T23#T24#T25########T26#T27#T28#T29##T30######T31#T32#T33#T34#735

Tag Tag Name

M/O

/C Tag

Format Comments / Business Rules

T1 Country code M 2a Tag must contain ‘KZ’

T2 Payment method M 3a Tag must contain ‘EFT’

T3 Value date M 8d2

T4 Preformat Group Code O 16x

T5 Preformat Code O 35x

T6 Payment currency M 3a

T7 Payment amount M 19s2 Amount can be inputted with leading zeros if it fit into field length

T8 Debit account number M 9n Account number in Citibank format

T9 Charges indicator M 3x Valid values are: BEN – beneficiary; OUR or null – our; SHR – shared

T10 Transaction reference number M 16x

T11 Confidential M 1a Valid values are: Y – confidential payment; N – not confidential payment.

T12 Beneficiary account number M 34x

T13 Beneficiary name M 70x

T14 Beneficiary bank routing method O 2a Valid values are: IS – SWIFT; CP - Chips participant identifier; CH - Chips universal identifier; FW - Fed wire routing identifier; RU – Russia routing identifier.


T15 Beneficiary bank routing code O 11x

T16 Beneficiary bank name O 35x

T17 Beneficiary bank address (1st line) M 35x

T18 Beneficiary bank address (2nd

line) O 35x

T19 Beneficiary bank address (3rd line) O 35x

T20 Intermediary bank routing method O 2a Valid values are: IS – SWIFT; CP - Chips participant identifier; CH - Chips universal identifier; FW - Fed wire routing identifier.

T21 Intermediary bank routing code O 11x SWIFT code, CHIPS code etc.

T22 Intermediary bank name M 35x

T23 Intermediary bank address (1st line) M 35x

T24 Intermediary bank address (2nd

line) O 35x

T25 Intermediary bank address (3rd line) O 35x

T26 Payment details (1st line) M 64x

T27 Payment details (2nd

line) O 64x

T28 Payment details (3rd line) O 64x

T29 Payment details (4th line) O 64x

T30 Payment ID code M RBCP Combination of remitter code (R), beneficiary code (B), currency code (C) and payment details code (P).

Sample code is: 2717USD710

R Remitter code M 2x

B Beneficiary code M 2x

C Currency code M 3a

P Payment details code M 3n


T31 Budget code M 6n

T32 Beneficiary tax code O 12n

T33 Beneficiary IIN / BIN O 12n

T34 Currency legislation amendments O 1x Valid values are: Y – ticks legislation check-box; N or null blanks check-box

T35 Currency legislation details O 105x

Record separator M Carriage return + line feed

Sample import file for single payments:

#KZ#EFT#20100331#####KZT#920176.12##250018003##########OUR###07012##N#################KZ3483201T0200241002#�� “��&��:� $��B(�”#####IS#CITIKZKA#####################�"��(� " &(��* � �"<@(�$ � & �. &2�(*. ��.1201 ( 19202008 # # # ##1717KZT310##########


Import file for cumulative payments

Specification for import file provided below. Each import file is used for one cumulative payment. Number of employees in one file must not exceed 10’000.

Import file contains blocks, blocks contain tags; and tags may contain fields and subfields.

Block starts from 1st position of new line and opens with “{“sign, followed by number of block and “:” sign. Block closes with “}” sign. 4th block closes with “-}”, indicated in 1st position of new line.

Tag starts from 1st position of new line and opens with “:” sign, followed by name of tag, and closes with “:” sign. Then tag value is indicated. Tag value cannot start with “{“, “CrLf:” or “CrLf-}”. Tag might contain only fields indicated in the specification matrix below. Tags format and description section. If any other fields are present in the tag then fail the transaction with level 1 error.

Field starts from 1st position of new line and opens with “/” sign, followed by field name in Latin capital and closes with “/” sign. Then field value is indicated. Fields within one tag might be in any order. Field can contain subfields.

Subfield also starts from 1st position of new line and opens with “//” sign, followed by subfield name in Latin capital and closes with “/” sign. Then subfield value is indicated.

Carriage return character separates the header and individual records.

Import file structure

The import file contains next parts:

• Header Details;

• Common Details;

• Repetitive Details;

• Repetitive OPV Details;

• Footer Details.


I Header Details

Tag Tag Name

M/O

/C Tag Format Comments / Business Rules

{1:25x} Main header O Not pass to CitiDirect

{2:47x} Application header O Not pass to CitiDirect

{4: Opening Text body M Not pass to CitiDirect

If field missing in the file, transaction is failed with level 1 error.


II Common Details

Tag Tag Name

M/O

/C Tag


Tag:20: Operation reference M 16x Pass to transaction reference number field in CitiDirect

If no value is passed in tag 20 then transaction will be failed with level2 error.

Tag:50:/O/A Remitter info 10*70x If debit account number is missing, transaction is failed with level1 error.

O Remitter operation type M 1a Not pass to CitiDirect

A Remitter account number M 20x Pass to Debit Account Number field in CitiDirect

/NAME/ Remitter name O 60x Not pass to CitiDirect

/RNN/ Remitter tax ID O 12n Not pass to CitiDirect

/IDN/ Remitter IIN / BIN O 12n Not pass to CitiDirect

/CHIEF/ Remitter manager’s name O 60x Not pass to CitiDirect

/MAINBK/ Remitter accountant’s name O 60x Not pass to CitiDirect

/IRS/ Remitter residency flag O 1n Not pass to CitiDirect

/SECO/ Remitter economy sector O 1x Not pass to CitiDirect

Tag:52B:B Remitter bank info O 10*70x Citibank branch number. If tag 52B is missing, then the file will not throw an error message. If tag 52B is present with incorrect format then file will fail the transaction with level 1 error.

B Remitter bank BIC O 11x Not pass to CitiDirect

/NAME/ Remitter bank name O 60x Not pass to CitiDirect


/RNN/ Remitter bank tax ID O 12n Not pass to CitiDirect

/IDN/ Remitter bank IIN / BIN O 12n Not pass to CitiDirect

/CHIEF/ Remitter bank manager’s name O 60x Not pass to CitiDirect

/MAINBK/ Remitter bank accountant’s name O 60x Not pass to CitiDirect

/IRS/ Remitter bank residency flag O 1n Not pass to CitiDirect

/SECO/ Remitter bank economy sector O 1x Not pass to CitiDirect

Tag:53B:B (or) Tag:53C:B

Remitter corresponding bank info O 10*70x If tag 53B is missing, then the file will not throw an error message. If tag 53B is present in incorrect format then file will fail the import with level 1 error. If both 53B and 53C tags are given in the file, there should be a level 1 error.

B Remitter corresponding bank BIC O 11x (or) 11x/20x

Not pass to CitiDirect

/NAME/ Remitter corresponding bank name O 60x Not pass to CitiDirect

/RNN/ Remitter corresponding bank tax ID O 12n Not pass to CitiDirect

/IDN/ Remitter corresponding bank IIN / BIN

O 12n Not pass to CitiDirect

/CHIEF/ Remitter corresponding bank manager’s name

O 60x Not pass to CitiDirect

/MAINBK/ Remitter corresponding bank accountant’s name


/IRS/ Remitter corresponding bank residency flag


/SECO/ Remitter corresponding bank economy sector


Tag:54B:B (or)

Beneficiary corresponding bank info O 10*70x If tag 54B is missing, then the file will not throw an error message. If tag 54B is present with incorrect format then file will fail the transaction


Tag:54C:B with level 1 error. If both 54B and 54C tags are given in the file, there should be a level 1 error.

B Beneficiary corresponding bank BIC O 11x (or) 11x/20x

Not pass to CitiDirect

/NAME/ Beneficiary corresponding bank name O 60x Not pass to CitiDirect

/RNN/ Beneficiary corresponding bank tax ID


/IDN/ Beneficiary corresponding bank IIN / BIN


/CHIEF/ Beneficiary corresponding bank manager’s name


/MAINBK/ Beneficiary corresponding bank accountant’s name


/IRS/ Beneficiary corresponding bank residency flag


/SECO/ Beneficiary corresponding bank economy sector


Tag:57B:BB Beneficiary bank info M 10*70x Any value passed in this tag (one line) will be validated against Beneficiary Bank library. If no match transaction is rejected with level 2 error.

BB Beneficiary bank BIC M 11x Pass to Beneficiary bank routing code field in CitiDirect

/NAME/ Beneficiary bank name O 60x Not pass to CitiDirect

/RNN/ Beneficiary bank tax ID O 12n Not pass to CitiDirect

/IDN/ Beneficiary bank IIN / BIN O 12n Not pass to CitiDirect

/CHIEF/ Beneficiary bank manager’s name O 60x Not pass to CitiDirect


/MAINBK/ Beneficiary bank accountant’s name O 60x Not pass to CitiDirect

/IRS/ Beneficiary bank residency flag O 1n Not pass to CitiDirect

/SECO/ Beneficiary bank economy sector O 1x Not pass to CitiDirect

Tag:59: Beneficiary info M 10*70x Customer will use either 9 or 10 or 20 digit accounts. If any field is missing, transaction is failed with level 2 error. Additional fields will throw an error.

Tag:59: Beneficiary account number M 20x Pass to beneficiary account number field in CitiDirect

/NAME/ Beneficiary name M 60x Pass to beneficiary name field in CitiDirect

/RNN/ Beneficiary tax ID O 12n Pass to beneficiary tax code field in CitiDirect

/IDN/ Beneficiary IIN / BIN O 12n Pass to beneficiary IIN / BIN field in CitiDirect

/IRS/ Beneficiary residency flag M 1n Pass to beneficiary code (1st digit) field in CitiDirect

/SECO/ Beneficiary economy sector M 1x Pass to beneficiary code (2nd digit) field in CitiDirect

Tag:70: Payment details C 16*70x

/NUM/ Payment number C 16x Not pass to CitiDirect

/KNP/ Payment purpose code M 3n Pass to payment details code

Any value passed in this tag (one line) will be validated against Payment details code library. If no match transaction is rejected with level 2 error.

/ASSIGN/

Payment purpose M 256x Pass to payment details field in CitiDirect.

Value should be combined in following order: extract 62 chars from right to line 1; extract 70 chars to line 2 & 3; extract 54 chars from left (70 chars -16 chars from right) to line 4. If field is missing, file will not throw an error message. If field is present with incorrect format then fail the transaction with level 1 error. If /ASSIGN/ sub field is completely missing or if value is missing then fail the transaction with level 2 error. Spaces should be counted as chars. Ignore empty lines if


no data is passed in any of the lines (Payment Details).

/PERIOD/ Period O 6n Pass to period field in CitiDirect.

Convert to ‘MM/YYYY’. If 6n value from /PERIOD/ of Common information (Payment Header) is passed then map it. If 6n value from /PERIOD/ of Common information (payment header) is not passed then map 6n value from /PERIOD/ of Repetitive information (employee details). If 6n value is missing in both Common and Repetitive information, then pass a Blank. If field is missing, file will not throw an error message. If field is present with incorrect format then fail the transaction with level 1 error.

/CONF/ Confidential payment flag O 1a Pass to confidentiality field in CitiDirect.

Valid values are Y or N. If Blank and no value exist then pass ‘N’. Any values other than ‘N’ or ‘Y’ is passed, transaction is failed with level 2. If field is missing, file will not throw an error message. If field is present with incorrect format then fail the transaction with level 1 error.

/DATE/ Payment date O 6d1 Not pass to CitiDirect

/SEND/ Payment delivery method O 2n Not pass to CitiDirect

07 – electronic document.

/VO/ Payment type O 2n Not pass to CitiDirect

01 – payment order; 03 – tax collection for taxpayer with tax debt; 04 – tax collection for debtor; 05 – customs collection for taxpayer with tax debt; 06 – memorial order; 08 – receipt; 09 – tax collection for taxpayer with social tax debt.

/PSO/ Special processing flag O 2n Not pass to CitiDirect

01 – ordinary payment; 02 – final turnover.

/BCLASS/ Budget classification code O 6x Not pass to CitiDirect

/PRT/ Payment priority O 2n Not pass to CitiDirect


/SIM/ Reporting symbol O 3n Not pass to CitiDirect

/OPV/TS Not pass to CitiDirect

T Payment type C 1a Pass to payment type field in CitiDirect.

For pension / social / free / disbursement payments only. If 1a = ‘C’ then Payment type (Payment option) = P (Pension Contribution). If 1a = ‘S’ then Payment type (Payment option) = S (Social). If 1a = ‘V’ then Payment type (Payment option) = V (Free). If 1a = ‘D’ then Payment type (Payment option) = D (Disbursement). If any lower case value is passed, transaction is failed with level 1 error.

S SIC code O [16x] Pass to individual SIC code field in CitiDirect.

For pension / social / free payments only.

/NAME/ Company or individual name O 60x Not pass to CitiDirect

/FM/ Individual last name O 30x Not pass to CitiDirect

/NM/ Individual first name O 30x Not pass to CitiDirect

/FT/ Individual patronymic O 30x Not pass to CitiDirect

/LA/ Individual personal account O 20x Not pass to CitiDirect

/RNN/ Individual tax ID O 12n Not pass to CitiDirect

/IDN/ Individual IIN / BIN O 12n Not pass to CitiDirect


III Repetitive Details

Tag Tag Name

M/O

/C Tag


Tag:21: Operation reference O 16x Not pass to CitiDirect.

If tag 21 is missing, File will not throw an error message. If tag 21 is present with incorrect format, then fail the transaction with level 1 error.

Tag:32B:CA

C Employee amount currency O 3x Not pass to CitiDirect

A Employee amount M 18s1 Pass to individual amount.

Always pass only the numeric value. Ex: :32B:KZT1600,00 - numeric value 1600,00 is passed in the transaction. If numeric value is missing, fail the transaction with level 1 error.

Tag:50:/O/A Remitter info 10*70x If tag 50 is missing, File will not throw an error message. If tag 50 is present with incorrect format then fail the transaction with level 1 error.

O Remitter operation type M 1x Not pass to CitiDirect

A Remitter account number M 20x Not pass to CitiDirect

/NAME/ Remitter name O 60x Not pass to CitiDirect

/RNN/ Remitter tax ID O 12n Not pass to CitiDirect

/IDN/ Remitter IIN / BIN O 12n Not pass to CitiDirect

/CHIEF/ Remitter manager’s name O 60x Not pass to CitiDirect

/MAINBK/ Remitter accountant’s name O 60x Not pass to CitiDirect

/IRS/ Remitter residency flag O 1n Not pass to CitiDirect


/SECO/ Remitter economy sector O 1x Not pass to CitiDirect

Tag:52B:B Remitter bank info O 10*70x If tag 52B is missing, then the file will not throw an error message. If tag 52B is present with incorrect format then fail the transaction with level 1 error.

B Remitter bank BIC O 11x Not pass to CitiDirect

/NAME/ Remitter bank name O 60x Not pass to CitiDirect

/RNN/ Remitter bank tax ID O 12n Not pass to CitiDirect

/IDN/ Remitter bank IIN / BIN O 12n Not pass to CitiDirect

/CHIEF/ Remitter bank manager’s name O 60x Not pass to CitiDirect

/MAINBK/ Remitter bank accountant’s name O 60x Not pass to CitiDirect

/IRS/ Remitter bank residency flag O 1n Not pass to CitiDirect

/SECO/ Remitter bank economy sector O 1x Not pass to CitiDirect

Tag:57B:B Beneficiary bank info O 10*70x If tag 57B is missing, then the file will not throw an error message. If tag 57B is present with incorrect format then file will fail the transaction with level 1 error.

B Beneficiary bank BIC O 11x Not pass

/NAME/ Beneficiary bank name O 60x Not pass to CitiDirect

/RNN/ Beneficiary bank tax ID O 12n Not pass to CitiDirect

/IDN/ Beneficiary bank IIN / BIN O 12n Not pass to CitiDirect

/CHIEF/ Beneficiary bank manager’s name O 60x Not pass to CitiDirect

/MAINBK/ Beneficiary bank accountant’s name O 60x Not pass to CitiDirect

/IRS/ Beneficiary bank residency flag O 1n Not pass to CitiDirect

/SECO/ Beneficiary bank economy sector O 1x Not pass to CitiDirect

Tag:59:B Beneficiary info O 10*70x If tag 59 is missing, then the file will not throw an error message. If tag 59 is


present with incorrect format then fail the transaction with level 1 error.

B Beneficiary account number O 20x Not pass to CitiDirect

/NAME/ Beneficiary name O 60x Not pass to CitiDirect

/RNN/ Beneficiary tax ID O 12n Not pass to CitiDirect

/IDN/ Beneficiary IIN / BIN O 12n Not pass to CitiDirect

/IRS/ Beneficiary residency flag O 1n Not pass to CitiDirect

/SECO/ Beneficiary economy sector O 1x Not pass to CitiDirect

Tag:70 Payment details M 16*70x If (/OPV/ exists) and (/LA/ doesn’t exist) then payment type is either P (Pension), or S (Social), or V (Free Voluntary), or D (Disbursement). If (/OPV/ doesn’t exist) and (/LA/ exists) then payment type is Z (Salary). If both /OPV/ and /LA/ exist then fail the transaction with level 2 error. If both /OPV/ and /LA/ do not exist then fail the transaction with level 2 error.

/OPV/PS

P Payment type C 1x Pass to payment type field in CitiDirect.

For pension / social / free / disbursement payments only. If 1a = ‘C’ then Payment type (Payment option) = P (Pension Contribution). If 1a = ‘S’ then Payment type (Payment option) = S (Social). If 1a = ‘V’ then Payment type (Payment option) = V (Free). If 1a = ‘D’ then Payment type (Payment option) = D (Disbursement). If any lower case value is passed, transaction is failed with level 1 error.

S SIC code O 16x Pass to individual SIC code field in CitiDirect.

For pension / social / free payments only.


IV Repetitive OPV Details

Tag Tag Name

M/O

/C Tag Format Comments / Business Rules

//FM/ Individual last name / last name during registration

C 30x[/30x] Pass to individual last name field in CitiDirect

For pension / social / free / disbursement payments only. Value should be passed in at least one of the subfields. Any lower case values passed convert them to upper case. Value for each subfield is passed in single line. If no value in all 3 subfields, transaction will be failed with level 2 error.

//NM/ Individual first name / first name during registration

C 30x[/30x] Pass to individual first name field in CitiDirect

//FT/ Individual patronymic / patronymic during registration

C 30x[/30x] Pass to individual patronymic field in CitiDirect

//DT/ Individual date of birth O 8d2 Pass to individual date of birth field in CitiDirect.

For pension / social / free / disbursement payments only. If field is missing, file will not throw an error message. If field is present with incorrect format then fail the transaction with level 1 error.

//RNN/ Individual tax ID O 12n Pass to individual tax code field in CitiDirect.

For pension / social / free / disbursement payments only. If a value is entered, this needs to be validated as per Kazakhstan tax code validation. If transaction fails special validation then level 2 error.

//IDN/ IIN / BIN O 12n Pass to individual IIN / BIN field in CitiDirect.

For pension / social / free / disbursement payments only. If a value is entered, this needs to be validated as per Kazakhstan IIN / BIN validation. If transaction fails special validation then level 2 error.

//LA/ Personal account O 20x Pass to individual account number field in CitiDirect.


For pension / social / free / disbursement payments only.

/PERIOD/ Period O 6d3 Pass to period field in CitiDirect.

If 6n value from /PERIOD/ of Common information (Payment Header) is passed then map it. If 6n value from /PERIOD/ of Common information (payment header) is not passed then map 6n value from /PERIOD/ of Repetitive information (employee details). If 6n value is missing in both Common and Repetitive information then pass a blank. If field is missing, file will not throw an error message. If field is present with incorrect format then fail the transaction with level 1 error.

/ASSIGN/ Individual details O 256x Pass to individual details field in CitiDirect.

Value should be combined in following order: 62 chars from right passed to 1st line; 70 chars passed to 2 & 3 lines; 54 chars from left (70 chars -16 chars from right) passed to 4 line. If field is missing, file will not throw an error message.

If field is present with incorrect format then fail the transaction with level 1 error. Spaces should be counted as chars. Ignore empty lines if no data is passed in any of the lines (Payment Details).

/FM/ Individual last name C 30x Pass to individual last name field in CitiDirect.

Used for salary payments only. Value should be passed in at least one of next tags: /FM/, /NM/ or /FT/, otherwise, transaction will be failed with level 2 error. Any lower case values passed convert them to upper case.

/NM/ Individual first name C 30x Pass to individual first name field in CitiDirect.


/FT/ Individual patronymic C 30x Pass to individual patronymic field in CitiDirect.



/RNN/ Individual tax ID O 12n Pass to individual tax code field in CitiDirect.

For salary payments only. If a value is entered, this needs to be validated as per Kazakhstan tax code validation. If transaction fails special validation then level 2 error.

/IDN/ Individual IIN / BIN O 12n Pass to individual IIN / BIN field in CitiDirect.

For salary payments only. If a value is entered, this needs to be validated as per Kazakhstan IIN / BIN validation. If transaction fails special validation then level 2 error.

/LA/ Personal account M 20x Pass to individual account number field in CitiDirect.

For salary payments only. This field is Mandatory if Payment type (payment option) is equal to Salary. This field is Optional if Payment type (payment option) is equal to Pension or Social or Free.

/NUM/ Payment number O 16x Not pass to CitiDirect

/KNP/ Payment purpose code O 3n Not pass to CitiDirect

/DATE/ Payment date O 6d1 Not pass to CitiDirect

/SEND/ Payment delivery method O 2n Not pass to CitiDirect

/VO/ Payment type O 2n Not pass to CitiDirect

/PSO/ Special processing flag O 2n Not pass to CitiDirect

/BCLASS/ Budget classification code O 6x Not pass to CitiDirect

/PRT/ Payment priority O 2n Not pass to CitiDirect

/SIM/ Reporting symbol O 3n Not pass to CitiDirect


V Footer Details

Tag Tag Name

M/O

/C

Tag Format

Comments / Business Rules

Tag:32�:VCA Payment date, currency and amount

M

V Value date M 6d1 Pass to value date field in CitiDirect.

System will automatically computes a default value date, if no date is passed by file. If tag 32A is present with incorrect format then fail the transaction with level 1 error.

C Currency code M 3a Pass to payment currency field in CitiDirect.

3-letter currency code per ISO). If currency is missing then fail the transaction with level 1 error. If tag 32A is present with incorrect format then fail the transaction with level 1 error

A Amount M 18s1 Pass to payment amount field in CitiDirect.

If no value passed in the file then fail the transaction with level 2 error. If Payment amount in tag 32A is not equal to sum of Employee amount in tag 32B, then fail the transaction with level 2 error. If tag 32A is with incorrect format then fail the transaction with level 1 error.

Tag:72: Additional info from initiator to beneficiary

O 6*70x If tag 72 is missing, the file will not throw an error message. If tag 72 is present with incorrect format then fail the transaction with level 1 error.

/RETN/ Return flag O Not pass to CitiDirect

/MREF/ Main related reference O 16x Not pass to CitiDirect

/TREF/ T21 reference O 16x Not pass to CitiDirect

/TEXT/ Free text O 64x Not pass to CitiDirect

-} Closing Text body R Not pass to CitiDirect.

This value must be present; otherwise, transaction is failed with level 1 error.


Sample import file for salary:

{1:F01K538870000000000000000} {2:I102SGROSS000000U3003} {4: :20:HJK56984 :50:/D/KZ445678901234567890 /NAME/'�� %�/RNN/620400054784 /IDN/546372819098 /CHIEF/#�� .'. /MAINBK/�� .�. /IRS/1 /SECO/3 :52B:CITIKZKA :57B:KZKOKZKX :59:KZ345123451234567890 /NAME/�&(��&�� ,�� '�� %($ �� (��/RNN/600400080570 /IRS/1 /SECO/3 :70: /NUM/25 /DATE/991110 /VO/01 /SEND/07 /KNP/182 /ASSIGN/! # 1�%� �� #��'�� !��'9 �� #��'�� 'A�#; 1999. :21:HJK56984-1 :32B:KZT850,00 :70: /FM/��-��/NM/�� /FT/��#��1/IDN/987654321098 /LA/KZ345000001234567890 :21:HJK56984-2 :32B:KZT1600,00


:70: /FM/��#��;��/NM/��'#��/FT/��1/RNN/600345876123 /IDN/102938475612 /LA/KZ098000001234567890 :32A:000120KZT2450,00 -}


Sample import file for pension payments:

{1:F01�538870000000000000000} {2:I102SGROSS000000U3003} {4: :20:GD1712031 :50:/D/KZ870121210987654321 /NAME/'�� *(/RNN/620400054784 /IDN/102938475612 /CHIEF/�-� '�� .'. /MAINBK/�)#�� .�. /IRS/1 /SECO/7 :52B: HSBKKZKX :57B: KZKOKZKX :59:KZ896000120987654321 /NAME/�%)��#%'� ��9� / �'# !� �9!��' ! �%��/RNN/600400080570 /IDN/564738291009 /IRS/1 /SECO/7 :70: /NUM/25 /DATE/991110 /VO/01 /SEND/07 /KNP/010 /ASSIGN/��A��' �;�9 ! �%��9 ��%9 � �!+ �� 'A�#; 1999. :21:GD1712031-01 :32B:KZT850,00 :70: /OPV/C //FM/�)�;��//NM/�� //FT/ #�%��1//DT/19710508 //RNN/600500090570


//IDN/019283746512 /PERIOD/091999 :21:GD1712031-012 :32B:KZT1600,00 :70: /OPV/CUA3U7N4YKRF9800W //FM/��#��;//NM/��//FT/��1//DT/19741106 //RNN/600203090550 //IDN/123456789012 /PERIOD/101999 :32A:000120KZT2450,00 -}


Sample import file for social payments:

{1:F01SGCVP00000000000000000} {2:I102SGROSS000000U3003} {4: :20:REFERENCE :50:/D/KZ091234561234567890 /NAME/ �� ( "�$�/RNN/301203016659 /IDN/098765432109 /CHIEF/�� .�. /MAINBK/! '#�� .�. /IRS/1 /SECO/7 :52B: HSBKKZKX :57B: KZKOKZKX :59:KZ345000009998887776 /NAME/#�! « &*��$&(��:� 0��($ " �:"��(� "��&��» /RNN/600400073391 /IDN/098765432156 /IRS/1 /SECO/1 :70: /NUM/2014 /DATE/050110 /VO/01 /SEND/07 /KNP/012 /PERIOD/012005 /ASSIGN/1.5 % �B��(��<�:� &($�. �:� (2�&��B � &*��$&(��:� , �� & 0��<� &($�. ��B �� B��$< 2005 �� & ��&� "$�� &"�&��. ��% �� (&B. :21:REF-001 :32B:KZT1500,00 :70: /OPV/SDAZFJ6C8K6KVZ00Y //FM/��#��//NM/��//FT/��'�#��


//DT/19590204 //RNN/600406290550 //IDN/098567432198 :21:REF-002 :32B:KZT2000,00 :70: /OPV/S //FM/%��//NM/��#��//FT/% # ��//DT/19540220 //RNN/600203290550 //IDN/098765123432 :32A:050110KZT3500,00 -}


After you set your accountant program to form import files in required format, then you need to setup CitiDirect. Setup should be done by 2 CitiDirect Administrators acting together: 1

st Administrator sets CitiDirect import profile, 2

nd Administrator authorizes the profile.

Actually, the Administrators should set 2 different import profiles; each of them processes different type of import file:

• 1st import profile, called “Single payments”, will be used for process of import file with single payments;

• 2nd

one, called “Cumulative payments”, will be used for import of cumulative payments.

I Creation of Import Profiles

So, 1st Administrator will create 2 import profiles. For that the Administrator will do next actions:

Import profile summary window

1 In CitiDirect main menu please choose “Maintenance > Import Profile”.

2 You will be routed to “Input / Modify” tab containing import profile summary.

3 There on the tab click “New” button; the system will route you to import profile detail window to be entered.

1

2

3


Cumulative import profile creation

1 In “Profile name” field enter “Cumulative payments” name for the profile.

2 In “Profile description” field enter description of the profile, like “Import of Cumulative payments”.

3 Please add import map, actually responsible for process of import files. For that please click “Add Map” button; CitiDirect will open list of import maps:

There in the window choose “C KZ CPI MT102” map and click “OK”.

4 In “Encoding set” field please indicate coding page of the import files from drop-down menu. Say, if you import files are in Win 1251 coding, please set here “Cp1251 Window Cyrillic”.

5 Please indicate files location by use of “Browse” hyperlink; in window below click “No” and indicate full path to the files.

6 Click “Submit” button to save profile.

1 2

3

5

4

6


Single import profile creation

1 In “Profile name” field enter “Single payments” name for the profile.

2 In “Profile description” field enter description of the profile, like “Import of Single payments”.

3 Please add import map, actually responsible for process of import files. For that please click “Add Map” button; CitiDirect will open list of import maps:

There in the window choose “C CDSS CIS” map and click “OK”.

4 In “Encoding set” field please indicate coding page of the import files from drop-down menu. Say, if you import files are in Win 1251 coding, please set here “Cp1251 Window Cyrillic”.

5 Please indicate files location by use of “Browse” hyperlink; in window below click “No” and indicate full path to the files.

6 Click “Submit” button to save profile. After 2

nd profile

creation you will have 2 import profiles in CitiDirect to be used for single and cumulative payments.

1 2

3

5

4

6


Import profile summary window

1 So, after you submit import profiles, you will get them in summary screen.

2 “Test required” status of the profiles indicates that they are pending test. Actually, no special tests in test mode required. You will just need to confirm test part completion as described in next secton.

Import profile test

1 In menu choose “Import Transactions”.

2 System will route you to “Test” tab.

3 Highlight required profile.

4 Click “Test Complete” button. System will complete creation part of import profiles and route them to authorization mode; you will need to request 2

nd

Administrator to login to CitiDirect and authorize Import profiles there.

1

2

1

2

3

4


Import profile authorization

1 To authorize import profiles, 2

nd Administrator logs

on to CitiDirect and in main menu chooses “Maintenance > Import profile”.

2 In “Authorization Req’d” tab you will see 2 import profiles pending authorization.

3 You will need to authorize both of them from summary screen or in detailed mode (by double clicking required profile CitiDirect will route you to detailed screen) by click “Authorize” button.

Note: CitiDirect setup is done. Please ask users to try import in CitiDirect. 1

2

3

citidirect administrator guide a4 en - · pdf fileinstitutional internet bank globally. it...

Documents