SironKYC Data Supply
SironKYC Data Supply
Date: 31/12/2012
Notes: u The red bordered fields should be completed by the financial institution.
u All files must be sorted by their respective KEY (Exception: Logfile, Eventfile)
u Date fields must be supplied in YYYYMMDD format.
u C 4 means fields with 4 characters. Key fields may be right-aligned. All other character fields must be left-aligned.
u FUX 15.2 means: 13 integer positions + 2 decimal positions + 1 position for the decimal point + 1 position for the minus sign (i.e. 17 bytes ) Maximum value:
-1234567890123.45
u FU 15.2 means: 13 integer positions + 2 decimal positions, no position for the decimal point (i.e. 15 bytes) Maximum value: 123456789012345
u For Y/N fields supplied by the financial institution, the mnemonic token of the system language can be used
(e.g. language = 'en', GWNKUNDE.BARJN='Y'
u The record length of all files is variable. The record length listed for each file is the maximum length.
u The Position of all fields within the records is fixed. That means, fields which cannot be supplied must be provided with a corresponding number of blanks, except
fields at the end of each record.
Exception: Customer Extension, Account Extension, Transaction Extension
These Files are comma separated files. Field delimiter is |, character fields have to be enclosed in " "
u Each tab corresponds to a fixed field length format (no separation between fields, fields without value must be filled with blanks. Fields at the and of the record may
be ommitted.)
Exception: Customer Extension, KYC Data, Beneficial Owner
These Files are comma separated files. Fields without value have to be represented by the delimiter.
u In each file the fields flagged as KEY correspond to the primary key (unicity)
u The foreign reference on the tables must be satisfied (foreign key)
u All fields flagged as mandatory have to be provided, otherwise the scoring will abort.
u A system currency must be choosen. All amount fields must be delivered in this currency
u For alphanumeric key fields (client no., customer no., account no., ...), the fields' contents may be arranged in any form (i.e. filled with
leading or trailing blanks, with leading or trailing zeros, without leading blanks or zeros). SironKYC will process and display
the data exactly as they are supplied in the GWN* files, i.e. SironKYC will not add or cut off leading blanks or zeros.
Please note: The data's filling with leading blanks or zeros influences their representation in lists and their sort order. If customer numbers include number ranges
with different lengths, it is recommended to use leading zeros.
u Special characters or country specific characters are not allowed for key fields. If you use them, the database order/collation must be switched to binary (which is not
possible e.g. for MS SQL Server or Unicode version of Oracle)! It is recommended that you use A-Z and 0-9 in key attributes. Please note: Do not use 'Z' as leading
character with MS-SQL-Server. With certain collations this would inevitably cause the scoring to abort.
Blanks, including leading blanks, in key fields are allowed. (see examples below).
u Encoding my be UTF-8 or local code page. Encoding must be declared with the variable KYC_CODEPAGE_INPUT_FILES. For more details refer to the system
documentation.
Examples:
The customer no. is supplied in the format ... The indicator will be true with specification of ...
" 01 10 030.735-06" Customer no. = " 01 10" (please note the blank in front of "01")
"000123456" Customer no. = "0001234" (without blanks)
"CW 396.123.800" Customer no. = "CW 396.123.800" (with blank and dots)
CUSTOMER (GWNKUNDE)
File name: in_customer.txt (old: GWNKUNDE.TXT)
Record length: 434
General remarks
This input file is used to insert all the customers of the bank
The file must be delivered with all customers for the first load. Daily only the delta can be sent
Customer-specific remarks
Field Name / Field Name / Description Remarks Source / Remarks / Format Pos Mandatory Key / Sort Foreign reference
Nom de champ Feldname Quelle / Bemerkungen / Order
Source Remarques
INSTITUTE INSTITUTSNR Client no. Multi-client capability: T24.COMPANY MNEMONIC C4 1 YES YES / 1
SironKYC allows to define
multiple clients (institutes).
A customer is assigned to
exactly one client (e.g.
productive bank, test
bank).
CUSTNO KUNDNR Customer no. Unique identifier of a T24.CUSTOMER @ID C 16 5 YES YES / 2
customer in the client.
FIRSTNAME VORNAME First name For name check against KDB.CUSTOMER.DETAI VORNAME || ' ' || MIDDLENAME C 32 21
the VIP list LS
LASTNAME NACHNAME Last name For name check against KDB.CUSTOMER.DETAI NACHNAME C 32 53 YES
the VIP list LS Defaulted with ***** when empty
STREET STRASSE Street KDB.CUSTOMER CASE C 32 85
WHEN TRIM (z.GB_ZUSATZ) IS
NOT NULL
AND TRIM (z.GB_STREET) IS
NULL
THEN
lpad(SUBSTR (NVL
(z.GB_ZUSATZ, ''), 1, 32), 32, ' ')
WHEN TRIM (z.GB_ZUSATZ) IS
NULL
AND TRIM (z.GB_STREET) IS
NOT NULL
THEN
lpad(SUBSTR(NVL(z.GB_STREET,
''), 1, 32), 32, ' ')
WHEN TRIM (z.GB_ZUSATZ || ' ' ||
z.GB_STREET)
IS NOT NULL
THEN
LPAD(SUBSTR
(NVL(TRIM(z.GB_ZUSATZ || ', ' ||
z.GB_STREET), ''), 1, 32), 32, ' ')
ELSE
lpad(NULL, 32, ' ')
END as STREET
S_COUNTRYFLAG V_LANDKZ Country of customer's NCCT check, reference to T24.DE.ADDRESS COUTNRY C 3 155 gwnland.countryext
shipping address (e.g. CH) country
CUSY KUSY Reference to customer Definition of the customer T24.CUSTOMER SECOTR C 8 158 gwnkusy.cusy
systematics category, reference to
GWNKUSY. Already
existing customer
categorization created by
the credit institute.
FK_CSMNO FK_BETRNR Reference to customer Reference to customer T24.DAO @ID C 12 166 gwnbetr.csmno
service manager service manager
PROFESSION BERUF Profession T24.CUSTOMER IF BERUFSGRUPPE = "" THEN C 32 178
9999
ELSE
BERUFSGRUPPE
BRANCH BRANCHE Sector of activity E.g. petrol, diamond, T24.CUSTOMER INDUSTRY C 32 210
building or car industry
BIRTHDATE GEBDAT Birth date Determination of the KDB.CUSTOMER BIRTH_DATE C 8 242
customer's age. If not Date field
available, leave empty or
pass 19000101.
CUSTCONTACT KDOEFF Date of customer first Standard indicator2: New T24.CUSTOMER CUSTOMER.SINCE C 8 250
contact customer with high cash Date field
deposits. If not available,
leave empty or pass
19000101.
EXEMPTIONFLAG FREISTJN Does an exemption order Only for Germany empty C 1 258
exist? Y/N field
EXEMPTIONAMOUNT FREISTBETR Amount of exemption order Only for Germany empty FUX 9.2 259
BRANCH_OFFICE BANKORG Bank organization (entire Branch responsible of the T24.DAO BJB_COUNTRY C 10 319
bank, subsidiary, branch customer
office, ...)
CUST_TYPE KU_ART Customer type (e.g. As of 030901: Used to T24.CUSTOMER If SECTOR = 1120 Then E (Employee) C1 329
employee = "E") determine the user rights Else If SECTOR < 2000 Then P
for the display of customer (Private)
data (e.g. employee, Else L (Legal Entity)
private customer,
corporate customer, etc.).
CUST_FLAG_01 KU_KZE_01 1-position flags to be As of 030901; Can be used T24.CUSTOMER IF LENGTH = 3 CUSTOMER.STATUS C1 330
specified by the credit to deliver any additional 1st position
institute (24-fold). Default: information. One piece of
empty information can be put on 1
or several characters. For
example: Is the customer a
PEP (Y/N on 1 character),
Other country of activity
(ISO on 3 characters)
CUST_FLAG_02 KU_KZE_02 1-position flags to be As of 030901; Can be used T24.CUSTOMER IF Length = 3 THEN C1 330
specified by the credit to deliver any additional CUSTOMER.STATUS 2nd position
institute (24-fold). Default: information. One piece of IF Length = 2 Then
empty information can be put on 1 CUSTOMER.STATUS 1st position
or several characters. For
example: Is the customer a
PEP (Y/N on 1 character),
Other country of activity
(ISO on 3 characters)
CUST_FLAG_03 KU_KZE_03 1-position flags to be As of 030901; Can be used T24.CUSTOMER IF Length = 3 Then C1 330
specified by the credit to deliver any additional CUSTOMER.STATUS 3rd position
institute (24-fold). Default: information. One piece of IF Length = 2 Then
empty information can be put on 1 CUSTOMER.STTAUS 2nd position
or several characters. For IF Length = 1 Then
example: Is the customer a CUSTOMER.STATUS
PEP (Y/N on 1 character),
Other country of activity
(ISO on 3 characters)
General remarks
This input file is used for additional fields in the customer record. Only the actual value of the fields supplied in this file are stored in the data base (Table GWGIKUND)
The file is not mandatory and may be left blank. Delta can be sent
Note: This file has a comma-separated format (see Guidelines and Overview)
Customer-specific remarks
English / French German English French German To Be Completed by Customer Technical Details
Field Name / Field Name / Description Remarks Description Remarks / Description / Remarks / Source / Remarks / Format Mandatory Key / Sort Foreign reference
Nom de champ Feldname Remarques Beschreibung Bemerkungen Quelle / Bemerkungen / Order
Source Remarques
INSTITUTE INSTITUTSNR Client no. Multi-client capability: No de mandant Capacité de mandants Mandanten-Nr. Mandantenfähigkeit: SironKYC C4 YES YES / 1 gwnkunde.institute
SironKYC allows to define multiples: SironKYC erlaubt die Definition mehrerer
multiple clients (institutes). permet de définir plusieurs Mandanten (Institute). Ein Kunde ist
A customer is assigned to mandants (instituts). Un genau einem Mandanten
exactly one client (e.g. client est attribué à un seul zugewiesen (z.B. produktive Bank,
productive bank, test mandant (p.ex. banque Testbank)
bank). productive, banque de test)
CUSTNO KUNDNR Customer no. Unique identifier of a No de client Identificateur unique du Kunden-Nr. Eindeutige Kennung des Kunden im C 16 YES YES / 2 gwnkunde.custno
customer in the client. client dans le mandant. Mandanten.
KD_SP_01.. KD_SP_01.. Freely definable field, The contents of the field Champ librement Le contenu du champ est Frei definierbares Feld, Der Inhalt des Feldes steht als C 64
KD_SP_48 KD_SP_48 alphanumeric may be used as définissable, disponible comme objet de alphanumerisch Vergleichsobjekt zur Verfügung. Die
comparision object. The alphanumérique comparaison. La Bedeutung ist in der Bezeichnung
meaning should be signification doit être des Vergleichsobjekts zu
documented in the name of documentée par le nom de hinterlegen.
the comparision object. l'objet de comparaison.
KD_NP_01.. KD_NP_01.. Freely definable field, The contents of the field Champ librement Le contenu du champ est Frei definierbares Feld, Der Inhalt des Feldes steht als FUX 15.2
KD_NP_10 KD_NP_10 numeric may be used as définissable, numérique disponible comme objet de numerisch Vergleichsobjekt zur Verfügung. Die
comparision object. The comparaison. La Bedeutung ist in der Bezeichnung
meaning should be signification doit être des Vergleichsobjekts zu
documented in the name of documentée par le nom de hinterlegen.
the comparision object. l'objet de comparaison.
Master Data
General remarks
This input file is used for additional fields in the customer record. The values of the fields supplied in this file are stored in the data base with history (Table GWGKUNDE). If the values change often this will result in considerable increase of storage space in the data base
The file is not mandatory and may be left blank. Delta can be sent
Note: This file has a comma-separated format (see Guidelines and Overview)
Customer-specific remarks
English / French German English French German To Be Completed by Customer Technical Details
Field Name / Field Name / Description Remarks Description Remarks / Description / Remarks / Source / Remarks / Format Mandatory Key / Sort Foreign reference
Nom de champ Feldname Remarques Beschreibung Bemerkungen Quelle / Bemerkungen / Order
Source Remarques
INSTITUTE INSTITUTSNR Client no. Multi-client capability: No de mandant Capacité de mandants Mandanten-Nr. Mandantenfähigkeit: SironAML T24.COMPANY MNEMONIC C4 YES YES / 1 gwnkunde.institutsnr
SironAML allows to define multiples: SironAML erlaubt die Definition mehrerer
multiple clients (institutes). permet de définir plusieurs Mandanten (Institute). Ein Kunde ist
A customer is assigned to mandants (instituts). Un genau einem Mandanten
exactly one client (e.g. client est attribué à un seul zugewiesen (z.B. produktive Bank,
productive bank, test mandant (p.ex. banque Testbank)
bank). productive, banque de test)
CUSTNO KUNDNR Customer no. Unique identifier of a No de client Identificateur unique du Kunden-Nr. Eindeutige Kennung des Kunden im T24.CUSTOMER @ID C 16 YES YES / 2 gwnkunde.kundnr
customer in the client. client dans le mandant. Mandanten.
CUST_SPH_01 KD_SPH_01 Freely definable The contents of the Champ librement Le contenu du champ Frei definierbares Der Inhalt des Feldes steht T24.CUSTOMER POSTING.RESTRICT C 64
field, alphanumeric field may be used as définissable, est disponible comme Feld, alphanumerisch als Vergleichsobjekt zur
comparision object. alphanumérique objet de Verfügung. Die Bedeutung
The meaning should comparaison. La ist in der Bezeichnung des
be documented in the signification doit Vergleichsobjekts zu
name of the être documentée par hinterlegen.
comparision object. le nom de l'objet de
comparaison.
CUST_SPH_02 KD_SPH_02 Freely definable The contents of the Champ librement Le contenu du champ Frei definierbares Der Inhalt des Feldes steht T24.POSTING.RESTRI DESCRIPTION concatenated with C 64
field, alphanumeric field may be used as définissable, est disponible comme Feld, alphanumerisch als Vergleichsobjekt zur CT ; (semicolon) and
comparision object. alphanumérique objet de Verfügung. Die Bedeutung substr(1,64)
The meaning should comparaison. La ist in der Bezeichnung des
be documented in the signification doit Vergleichsobjekts zu
name of the être documentée par hinterlegen.
comparision object. le nom de l'objet de
comparaison.
Master Data
General remarks
This input file is used for the relationship to beneficial owners. It contains only relationship data. Name, address, etc. must be supplied in the C
(Extension) files.
The file is not mandatory and may be left blank. Delta can be sent
Note: This file has a comma-separated format (see Guidelines and Overview)
Customer-specific remarks
INSTITUTE 1 C4 YES
PROCESSFLAG empty
me, address, etc. must be supplied in the Customer
Technical Details
YES / 1 gwnkunde.institutsnr
YES / 2 gwnkunde.kundnr
YES / 3 gwnkunde.kundnr
YES / 4
Master Data
General remarks
Customer-specific remarks
Field Name / Source / Remarks / Format Mandatory Key / Sort Foreign reference
Nom de champ Quelle / Bemerkungen / Order
Source Remarques