IBAN Structure Directory
IBAN Structure, que contiene información sobre los formatos ISO IBAN registrados por los países que adoptaron IBANs en sus sistemas de pago.
La configuración dinámica IBAN Structure se utiliza durante la deconstrucción de IBAN por IPF CSM Reachability Service.
Iban Structure Directory Data Structure
| Iban Structure property | Description |
|---|---|
ibanCountryCode |
El país que ha emitido el IBAN |
ibanCountryCodePosition |
Posición del Iban Country Code |
ibanCountryCodeLength |
Tamaño del Iban country Code |
ibanCheckDigitsPosition |
La posición de los valores de check digit en el IBAN (para el país dado) |
ibanCheckDigitsLength |
La longitud de los valores de check digit en el IBAN para el país dado |
bankIdentifierPosition |
Posición del Bank Identifier |
bankIdentifierLength |
Tamaño del Bank Identifier |
branchIdentifierLength |
Tamaño del Branch identifier |
ibanNationalIdLength |
Tamaño del Iban National ID |
accountNumberLength |
Tamaño del Account Number |
accountNumberPosition |
Posición del Account Number |
ibanTotalLength |
Tamaño total del Iban |
ibanNationalIdType |
Tipo del IBAN National Id |
ibanNationalIdPosition |
Posición del IBAN National Id |
File Types Supported
| File Name | File Types Supported | File Formats Supported | File Naming Conventions |
|---|---|---|---|
IBAN Structure |
FULL |
TXT, XML |
IBANSTRUCTURE_FULL_YYYYMMDD |
IBAN Structure |
DELTA |
TXT, XML |
IBANSTRUCTURE_DELTA_YYYYMMDD |
| La ingesta desde AWS S3 identifica este archivo cuando el nombre del archivo comienza con "IBANSTRUCTURE". El archivo Full se identifica usando el texto FULL en el nombre y el archivo delta se identifica usando el texto DELTA. |
| Las implementaciones de cliente no deben modificar los nombres de archivo proporcionados por las fuentes del sector y deben ingerir los archivos tal y como se reciben. |
Mapping Definitions
Iban Structure V2 file to Iban Structure Directory mapping
| Iban Structure V2 property | Iban Structure property | Comment |
|---|---|---|
iban_country_code |
ibanCountryCode |
|
iban_country_code_position |
ibanCountryCodePosition |
|
iban_country_code_length |
ibanCountryCodeLength |
|
iban_check_digits_position |
ibanCheckDigitsPosition |
|
iban_check_digits_length |
ibanCheckDigitsLength |
|
bank_identifier_position |
bankIdentifierPosition |
|
bank_identifier_length |
bankIdentifierLength |
|
branch_identifier_length |
branchIdentifierLength |
|
iban_national_id_length |
ibanNationalIdLength |
|
account_number_length |
accountNumberLength |
|
account_number_position |
accountNumberPosition |
|
iban_total_length |
ibanTotalLength |
La siguiente tabla proporciona información sobre el tipo de archivo soportado y el formato del archivo.
| File Type Supported | File Format Supported |
|---|---|
FULL/DELTA |
XML/TXT |
Example Mappings
Source Record from Industry file
<?xml version="1.0" encoding="UTF-8"?>
<dataexport product="ibanstructure_v2" filetype="full" filedate="20190513">
<ibanstructure_v2>
<modification_flag>A</modification_flag>
<record_key>IS0000000001</record_key>
<iban_country_code>AD</iban_country_code>
<iban_country_code_position>1</iban_country_code_position>
<iban_country_code_length>2</iban_country_code_length>
<iban_check_digits_position>3</iban_check_digits_position>
<iban_check_digits_length>2</iban_check_digits_length>
<bank_identifier_position>5</bank_identifier_position>
<bank_identifier_length>4</bank_identifier_length>
<branch_identifier_position>9</branch_identifier_position>
<branch_identifier_length>4</branch_identifier_length>
<iban_national_id_length>8</iban_national_id_length>
<account_number_position>13</account_number_position>
<account_number_length>12</account_number_length>
<iban_total_length>24</iban_total_length>
<sepa>Y</sepa><optional_commence_date>20190301</optional_commence_date>
<mandatory_commence_date>20191201</mandatory_commence_date>
<iso13616>Y</iso13616>
</ibanstructure_v2>
</dataexport>Destination Record IBAN Structure
{
"ibanCountryCode": "AD",
"ibanCountryCodePosition": 1,
"ibanCountryCodeLength": 2,
"ibanCheckDigitsPosition": 3,
"ibanCheckDigitsLength": 2,
"bankIdentifierPosition": 5,
"bankIdentifierLength": 4,
"branchIdentifierLength": 4,
"ibanNationalIdLength": 8,
"accountNumberPosition": 13,
"accountNumberLength": 12,
"ibanTotalLength": 24
}Setting Type
DPS v2 introdujo un nuevo atributo de Setting Type. Se utiliza para la generación de todos los endpoints de API para una configuración en particular. También se utiliza en la construcción index-config.<setting type>.
SETTING_TYPE = "ibanstructure"
Searchable Fields
Los campos buscables para Processing Entity son:
-
identifier
-
identifierType
-
identifierSubType
-
country
Indexes
DPS v2 proporciona una opción para configurar índices para cada setting. Los índices por defecto para IBAN Structure Settings son:
ipf.dps.mongodb.index-config.ibanstructure {
index-1 = ["status:ASC"]
index-2 = ["processingEntity:ASC"]
index-3 = ["values.payload.ibanCountryCode:ASC"]
}Esto puede sobrescribirse o actualizarse. Solo ten en cuenta que cuando el campo está bajo payload, necesitas proporcionar un índice como: index-x = ["values.payload.fieldX:ASC"].
Notifications
DPS v2 puede proporcionar una notificación después de que se realice cierta operación CRUD sobre una setting. Existe una opción para habilitar notificaciones a nivel de setting. Las notificaciones están deshabilitadas por defecto:
ipf.csm-reachability.should-send-notification.iban-structure-settings = false