3. /iban/deconstruir
Propósito
Descomposición de IBAN API permite que un IBAN sea descompuesto para proporcionar detalles de la entidad que ha emitido el IBAN. Los detalles proporcionados en la respuesta incluyen el 'BIC de Membresía del Esquema' asociado con el IBAN, el código de compensación nacional, el país donde se encuentra la entidad emisora, así como el ID Nacional del IBAN y el Identificador del Banco tal como están registrados en los archivos de la industria.
Configuración
La deconstrucción del IBAN se puede realizar utilizando configuraciones dinámicas pobladas tanto con el portafolio SWIFTRef legado como con el portafolio SWIFTRef evolucionado. Las implementaciones de los clientes que deseen cambiar del portafolio legado al portafolio evolucionado pueden hacerlo utilizando la configuración.ipf.csm-reachability.swift-ref-version. Consulte la configuración en application.conf
| Valor de Configuración | Portafolio | Configuraciones Dinámicas Utilizadas | Archivos de la Industria Utilizados |
|---|---|---|---|
legacyPortfolio |
Portafolio legado de SWIFTRef |
IBAN Plus, Estructura del IBAN, Lista de Exclusión |
IBAN Plus, Estructura del IBAN, Lista de Exclusión |
evolvedPortfolio |
Portafolio evolucionado de SWIFTRef |
Directorio de Entidades de Parte (Fuente - Identificadores Todos), Estructura del IBAN |
Identificadores SWIFTRef Todos, FORMATOS-SWIFTReg-TODOS/FORMATOS-SWIFTReg-PAÍS |
| El valor predeterminado de la configuración se establece en legacyPortfolio por razones de compatibilidad hacia atrás para los clientes que ya utilizan la deconstrucción de IBAN mediante el portafolio legado. |
Configuraciones Dinámicas Utilizadas
IBAN Deconstruct utiliza las configuraciones dinámicas de datos de la industria para deconstruir los IBAN. Las configuraciones dinámicas deben ser completadas mediante la ingestión de archivos relevantes de la industria proporcionados.
Según el valor de configuración utilizado, IBAN Deconstruct utiliza las siguientes configuraciones dinámicas.
| Datos de la Industria | Utilizado con el portafolio SWIFTRef | Propósito | Referencias Adicionales |
|---|---|---|---|
Directorio de Estructura de IBAN |
legacyPortfolio, evolvedPortfolio |
La configuración dinámica proporciona la estructura de los IBAN en diferentes países, incluyendo la posición y la longitud de los identificadores relevantes que son embedded sobre los IBAN emitidos en esos países. |
|
Directorio IBANPlus |
legacyPortfolio |
La configuración dinámica proporciona entradas de IBAN Plus para facilitar la deconstrucción del IBAN. |
|
Lista de Exclusión de IBAN |
legacyPortfolio |
La configuración dinámica proporciona la lista de exclusión para verificar si el IBAN proporcionado se encuentra en la lista de exclusión suministrada por la fuente de la industria. |
|
Directorio de Entidades de Parte |
evolvedPortfolio |
Proporciona identificadores IBAN asociados con las entidades para ayudar con la deconstrucción del IBAN. |
Identificadores Todos a la Entidad del Directorio de Partes mapping |
Uso
-
Las implementaciones del cliente pueden llamar al endpoint /iban-deconstruct para descomponer un IBAN y obtener los detalles de la entidad que ha emitido el IBAN.
-
La implementación de Deconstruct de IBAN también se utiliza internamente por diferentes CSM Reachability service s para descomponer el IBAN y utilizar los detalles de la entidad para realizar verificaciones de accesibilidad o búsquedas de entidades de partes. A continuación CSM Reachability los endpoints utilizan la descomposición interna de IBAN (Consulte CSM Reachability Operaciones)
-
Valide la Alcanzabilidad Intraentidad
-
Valide CSM Reachability
-
Seleccione CSM Agente
-
Entidades de Parte
-
Determine Entidad de Procesamiento
Solicitud y Respuesta
La deconstrucción de IBAN sigue la estructura de solicitud y respuesta que se detalla a continuación. Esta sección proporciona información sobre las propiedades de la solicitud y la respuesta, para un detalle API especificaciones, por favor consulte CSM Reachability Service API
API Versión 2
Respuesta
| Propiedad de Respuesta | Descripción |
|---|---|
entidad País |
Indica el país en el que se encuentra la entidad que posee el IBAN.
En |
ibanCountry |
El país que ha emitido el IBAN. |
identificadorBancario |
El bankIdentifier tal como se define en la fuente de la industria. |
ibanNationalId |
IBAN Identificación Nacional asociada con el IBAN |
identificadoresDeEntidad (*) |
1. Una lista de identificadores derivados del IBAN utilizando configuraciones dinámicas de IBANPlus y Estructura de IBAN. Los tipos de identificadores devueltos son de tipo BIC y NCC. 2. Referir Identificadores de Parte Explicados para más detalles sobre los tipos de identificadores soportados en CSM Reachability Service. |
+identificador |
El valor del identificador para la entidad asociada con el IBAN. |
+TipoDeIdentificador |
El valor de tipo asociado con el identificador de entidad. |
+identifierSubType |
Subtipo del tipo de identificador devuelto. |
Notas
-
La deconstrucción del IBAN se basa en los datos de la industria proporcionados por SWIFTRef.
-
In
legacyPortfoliomodo: La Estructura IBAN, IBAN Plus y la Lista de Exclusión son requeridas. -
En
evolvedPortfolioEl modo: La Estructura del IBAN y el Directorio de Entidades de Parte son requeridos, con el IBAN Plus utilizado únicamente como respaldo.
-
-
Si las entidades asociadas con el IBAN no están presentes en las configuraciones dinámicas, la derivación del IBAN BIC puede no ser posible, aunque se puede derivar el NCC. (Al utilizar legacyPortfolio, si las entradas no están presentes en IBAN Plus, la deconstrucción del IBAN solo es posible para los IBAN suizos).
-
Algunos países no emiten NCC, ya que los números de cuenta son asignados por los bancos centrales. En estos casos, no se devolverán los NCC.
-
subtipo de NCC mapping(ISO20022 códigos alineados):
| Código de País IBAN | NCC SUb Tipo (ISO20022 Alineado) |
|---|---|
AT |
ATBLZ |
CH |
CHBCC |
DE |
DEBLZ |
GB |
GBDSC |
IE |
IENCC |
MZ |
MZBMO |