Bank Master to Party Entity Directory mapping
SIX Bank Master 3.0 provides two types of records:
-
Bank Master - This record provides details of the participant with an active participant which has not been taken over by another participant.
-
Bank Master Concatenated - This record provides details of the participant that has been taken over by another participant but is still being used actively using the identifiers issued to it before the merger.
Bank Master Concatenated records are loaded against the entities they have been taken over by to ensure a consistent entity look up can be performed for merged entities. When multiple mergers have taken place, the identifiers are loaded against the latest entity that has taken over rest of the entities through merger.
File Types Supported
| File Name | File Types Supported | File Formats Supported | File Naming Conventions |
|---|---|---|---|
Bank Master 3.0 |
FULL |
JSON |
bankmaster-v3.0-YYYY-MM-DD.json |
| AWS S3 Ingestion identifies this file when the file name starts with "bankmaster". |
| The client implementations should not modify the files names provided by industry sources and ingest the files as received. |
Mapping Definitions
Below table provides the mapping as performed from Bank Master 3.0 into Party Entity Directory.
| BankMaster 3.0 Property (Source) | PartyEntity directory Property (Destination) | Comment |
|---|---|---|
iid |
entityUniqueId |
|
- |
entityDataSource |
Constant value: SIX_Bank_Master |
bankOrInstitutionName |
entityName |
|
entryType |
entityType |
Constant value: BankMaster or BankMasterConcatenated |
- |
entityAddress.addressType |
Constant value: ADDR |
streetName |
entityAddress.streetName |
|
buildingNumber |
entityAddress.buildingNumber |
|
postCode |
entityAddress.postCode |
|
townName |
entityAddress.townName |
|
country |
entityAddress.country |
|
bic |
entityIdentifier[ ].identifier |
|
- |
entityIdentifier[ ].identifierType |
Constant value: BIC |
- |
entityIdentifier[ ].identifierSubType |
Constant value: ACCOUNT_ISSUING_BIC |
iid |
entityIdentifier[ ].identifier |
Map when national_id is specified on the record |
- |
entityIdentifier[ ].identifierType |
Constant value: NCC |
- |
entityIdentifier[ ].identifierSubType |
Constant value: CHBCC |
sicIid |
entityIdentifier[ ].identifier |
Map when sicIid is specified on the record |
- |
entityIdentifier[ ].identifierType |
Constant value: NCC |
- |
entityIdentifier[ ].IdentifierSubType |
Constant value: CHSIC, map when sicIid is specified on the record |
iidType = HEADQUARTERS |
isHeadOffice |
Boolean: Indicates if the entity is a head office entity in the group. |
| Party Entity records loaded through Bank Master 3.0 do not hold information about QR type IIDs. This is a clearing and membership information available on Industry Fields on CSM Participants loaded through Bank Master 3.0. |
Example Mapping
Source Record from Industry file
Bank Master
{
"totalSize": 1251,
"validOn": "2023-07-05",
"readTime": "2023-07-04T12:00:33.78389454+02:00",
"entries": [
{
"entryType" : "BankMaster",
"iid" : 4835,
"validOn" : "2023-07-05",
"sicIid" : "048358",
"headQuarters" : 4835,
"iidType" : "HEADQUARTERS",
"bankOrInstitutionName" : "CREDIT SUISSE (SCHWEIZ) AG (4)",
"streetName" : "Paradeplatz",
"buildingNumber" : "8",
"postCode" : "8070",
"townName" : "Zürich",
"country" : "CH",
"bic" : "CRESCHZZ80A",
"sicParticipation" : true,
"rtgsCustomerPaymentsChf" : true,
"ipCustomerPaymentsChf" : true,
"euroSicParticipation" : true,
"lsvBddChfParticipation" : true,
"lsvBddEurParticipation" : true
},
{
"entryType" : "BankMasterConcatenated",
"iid" : 5881,
"validOn" : "2023-07-05",
"newIid" : 4835
}
]
}Bank Master Concatenated
{
"totalSize": 1251,
"validOn": "2023-07-05",
"readTime": "2023-07-04T12:00:33.78389454+02:00",
"entries": [
{
"entryType" : "BankMaster",
"iid" : 4835,
"validOn" : "2023-07-05",
"sicIid" : "048358",
"headQuarters" : 4835,
"iidType" : "HEADQUARTERS",
"bankOrInstitutionName" : "CREDIT SUISSE (SCHWEIZ) AG (4)",
"streetName" : "Paradeplatz",
"buildingNumber" : "8",
"postCode" : "8070",
"townName" : "Zürich",
"country" : "CH",
"bic" : "CRESCHZZ80A",
"sicParticipation" : true,
"rtgsCustomerPaymentsChf" : true,
"ipCustomerPaymentsChf" : true,
"euroSicParticipation" : true,
"lsvBddChfParticipation" : true,
"lsvBddEurParticipation" : true
},
{
"entryType" : "BankMasterConcatenated",
"iid" : 5881,
"validOn" : "2023-07-05",
"newIid" : 4835
}
]
}Destination Record - Party Entity Directory
{
"_id": "DynamicSettings|partyentity-SIX_Bank_Master-CH-4835",
"payload": {
"entityUniqueId": "4835",
"entityDataSource": "SIX_Bank_Master",
"entityType": "BANKMASTER",
"entityName": "CREDIT SUISSE (SCHWEIZ) AG (4)",
"entityAddress": {
"addressType": "ADDR",
"streetName": "Paradeplatz",
"postCode": "8070",
"townName": "Zürich",
"country": "CH",
"addressLines": []
},
"entityIdentifiers": [
{
"identifier": "4835",
"identifierType": "BIC",
"identifierSubType": "ACCOUNT_ISSUING_BIC"
},
{
"identifier": "00761",
"identifierType": "NCC",
"identifierSubType": "CHBCC"
},
{
"identifier": "007616",
"identifierType": "NCC",
"identifierSubType": "CHSIC"
}
],
"isHeadOffice": true
}
}