Documentation for a newer release is available. View Latest

IBAN Plus Directory

SwiftRef IBAN Plus Directory, cargado mediante ingestors de archivos locales y que contiene los siguientes tipos de archivo: IBAN Plus, que contiene datos relacionados con IBAN para instituciones financieras en países SEPA y no SEPA que han adoptado IBAN. Soporta importaciones FULL y DIFF en XML y TXT.

Iban Plus Directory Structure

Iban Plus property Comment

modificationFlag

En el archivo FULL siempre es "A" y para el archivo DELTA puede ser "A", "M" o "D"

ibanBic

El BIC de la institución. Cargado desde el campo IBAN BIC del archivo IBANPLUS publicado por SWIFTRef (parte de IBANPlus Directory)

ibanIsoCountryCode

País donde se ubica el banco. Cargado desde el campo IBAN ISO COUNTRY CODE del archivo IBANPLUS

isoCountryCode

País donde se ubica el banco.

ibanNationalId

Usado junto con IBAN ISO COUNTRY CODE para buscar en esta tabla al deconstruir o validar un IBAN y recuperar el IBAN BIC y ROUTING BIC relacionados Cargado desde el campo IBAN NATIONAL ID del archivo IBANPLUS

institutionName

Nombre de la institución. Cargado desde el campo INSTITUTION NAME del archivo IBANPLUS

routingBic

Cargado desde el campo ROUTING BIC del archivo IBANPLUS Del documento SWIFT IBAN Plus FAQ - El ROUTING BIC NO está relacionado con pagos SEPA (ISO 20022 XML). El ROUTING BIC puede aplicarse a pagos IBAN no SEPA para encontrar: • el corresponsal conectado a SWIFT de un banco no conectado • la dirección central de procesamiento de pagos de un banco con muchos BICs de sucursal no conectados o con múltiples BICs debido a adquisiciones y fusiones

serviceContext

Cargado desde el campo SERVICE CONTEXT del archivo IBANPLUS

File Types Supported

File Name File Types Supported File Formats Supported File Naming Conventions

IBAN Plus

FULL

TXT, XML

IBANPLUS_V3_FULL_YYYYMMDD

IBAN Plus

DELTA

TXT, XML

IBANPLUS_V3_DELTA_YYYYMMDD

La ingesta desde AWS S3 identifica este archivo cuando el nombre del archivo comienza con "IBANPLUS". 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 Definition

Iban Plus Directory Mappings

Iban Structure V2 property Iban Structure property Comment

modification_flag

modificationFlag

iban_bic

ibanBic

iban_iso_country_code

ibanIsoCountryCode

iso_country_code

isoCountryCode

iban_national_id

ibanNationalId

institution_name

institutionName

routing_bic

routingBic

service_context

serviceContext

Example Mappings

Source Record from Industry file

MODIFICATION FLAG	RECORD KEY	INSTITUTION NAME	COUNTRY NAME	ISO COUNTRY CODE	IBAN ISO COUNTRY CODE	IBAN BIC	ROUTING BIC	IBAN NATIONAL ID	SERVICE CONTEXT	FIELD A	FIELD B
A	IB0000000001	MoraBanc	ANDORRA	AD	AD	BINAADADXXX	BINAADADXXX	00070014	SEPA

Destination Record IBANPLus

{
  "modificationFlag": "A",
  "ibanBic": "BINAADADXXX",
  "ibanIsoCountryCode": "AD",
  "isoCountryCode": "AD",
  "ibanNationalId": "00070014",
  "institutionName": "MoraBanc",
  "routingBic": "BINAADADXXX",
  "serviceContext": null
}

Setting Type

DPS v2 introduced new attribute of Setting Type. This is used for generation of all API endpoints for a particular setting. It is also used in index-config.<setting type> construct. SETTING_TYPE = "ibanplus"

Searchable Fields

Searchable fields for IBAN Plus Settings are:

  • ibanBic

  • institutionName

  • ibanIsoCountryCode

  • isoCountryCode

  • ibanNationalId

  • routingBic

  • serviceContext

Indexes

DPS v2 provides an option to configure indexes for each setting. Default indexes for IBAN Plus Settings are:

ipf.dps.mongodb.index-config.ibanplus {
    index-1 = ["status:ASC"]
    index-2 = ["processingEntity:ASC"]
    index-3 = ["values.payload.ibanIsoCountryCode:ASC"]
    index-4 = ["values.payload.isoCountryCode:ASC"]
    index-5 = ["values.payload.ibanNationalId:ASC"]
}

This can be overridden or updated. Just note that when the field is under payload, you need to provide an index like: index-x = ["values.payload.fieldX:ASC"].

Notifications

DPS v2 can provide notification after certain CRUD operation on a setting is performed. There is an option to enable notifications on setting level. Notifications are disabled by default:

ipf.csm-reachability.should-send-notification.iban-plus-settings = false

History

There is an option to disable history on setting level. History is enabled by default:

ipf.csm-reachability.should-save-history.iban-plus-settings = true