Directorio de Entidades de Parte

El Directorio de Entidades de Parte es una configuración dinámica que puede ser utilizada para buscar Entidades de Parte y recuperar los detalles de la entidad de parte, como identificadores y detalles de dirección.

Los datos devueltos de la búsqueda de entidades de partes pueden ser utilizados por las implementaciones del cliente para fines de enriquecimiento de pagos. El directorio también se utiliza durante la verificación de alcanzabilidad para buscar identificadores utilizados por CSM Agentes para la participación cuando la solicitud de entrada no proporciona el tipo de identificador requerido.

El Directorio de Entidades de Party admite la ingestión de datos de referencia de la industria para habilitar búsquedas de entidades.

IPF admite la ingestión de archivos de la industria a continuación en el Directorio de Entidades de Parte: En el futuro, se pueden soportar más fuentes de datos en el Directorio de Entidades de Parte si se identifica una necesidad a través de los requisitos del cliente.

Si es necesario, las implementaciones del cliente también pueden definir e implementar custom ingestión en el Directorio de Entidades de Parte.

Sr. No. Archivo de Datos de la Industria Fuente de la industria Formato de archivo Tipo de archivo (Completo / Delta)

1

Directorio Bancario Plus

SWIFTRef

XML

Completo, Delta

2

Identificadores Todos

SWIFTRef

XML, ZIP (XML)

Completo, Delta Diario, Delta Mensual

3

SIX Bank Master 3. 0

SEIS

XML

Completo

Estructura de Datos del Directorio de Entidades de Parte

Similar a CSM Los participantes, el Directorio de Entidades de Parte es una configuración dinámica genérica que se carga a través de diferentes fuentes de la industria de manera genérica, independientemente del formato de los archivos de la industria fuente.

A continuación se presentan las propiedades admitidas en el Directorio de Entidades de Parte.

Propiedad del Directorio de Entidades de Parte Descripción

entityUniqueId

Un ID único por el cual la entidad será conocida. El ID será único en toda la fuente de datos.

parentEntityId

Id de la entidad padre de la entidad representada por "EntityUniqueId". El atributo puede no estar cargado para todas las fuentes hasta que se solicite específicamente.

groupEntityId

Identificación de la entidad del nivel de grupo de la entidad representada por "EntityUniqueId". Esta información puede no estar cargada para todas las fuentes hasta que se solicite específicamente.

isHeadOffice

Indica si la entidad es una entidad de oficina central en el grupo.

entityDataSource

Especifica la fuente de los datos, que puede ser una determinada fuente de datos de referencia, como 'Bank_Directory_Plus', 'Bank_Master' o 'SWIFTRef_Identifiers_All'.

tipoDeEntidad

Tipo de la Parte Entidad. Los valores posibles son 'Banco' o 'Sucursal'. Esto es solo para fines informativos y no se utiliza durante el procesamiento.

entityName

Nombre de la entidad de la Parte.

entityAddress

Dirección de la entidad Parte. Los campos de dirección en los registros del Directorio de Entidades Parte siguen ISO20022 estructura de dirección conforme. Por favor, consulte el esquema para los atributos proporcionados bajo la dirección aquí.CSM Reachability Setting Management API

entityEmail

Correo electrónico de la Entidad Parte. Soporta caracteres especiales.

número De Teléfono De La Entidad

Número de teléfono de la Entidad Parte. Soporta caracteres especiales.

identificadoresDeEntidad

Una lista de identificadores asociados con la entidad. Los tipos de identificadores admitidos son BIC, NCC (Código Nacional de Compensación) y LEI.

identificadoresDeEnrutamiento

Estos son los identificadores que se pueden utilizar para el enrutamiento. SWIFT pagos a la entidad utilizando SWIFT servicios. La información estará disponible en el registro de la entidad del partido cuando sea proporcionada por las fuentes de datos de la industria.

+swiftFinPlusBic

Valor BIC que debe utilizarse al enrutar los pagos a la entidad en SWIFT Servicio FIN PLUS.

+swiftFinPlusDn

Nombre distinguido que se utilizará al enrutar los pagos a la entidad en SWIFT Servicio FIN PLUS utilizando un nombre distinguido.

ibanIdentifiers

Estos son identificadores asociados con la entidad cuando se utilizan IBANs para dirigir a la entidad / cuentas mantenidas con la entidad.

+ibanId

ID de IBAN según lo proporcionado por la fuente de la industria. Esta información no es proporcionada por todas las fuentes (Solo cargado para Identificadores SWIFTRef Todos).

+ibanBic

BIC utilizado por la entidad al emitir IBANs a la customers/ cuentas. Esta información no es proporcionada por todas las fuentes. (Solo cargada para Identificadores SWIFTRef Todos)

Consulte la página a continuación para conocer más sobre los identificadores de pago utilizados en IPF. CSM Reachability Service.Identificadores de Parte Explicados

NOTA

  1. Bank Directory Plus será desmantelado por SWIFT a partir de noviembre de 2026 como parte de la iniciativa de evolución del portafolio de SWIFTRef por SWIFT. Soporte de ingestión para Bank Directory Plus se proporcionará sobre IPF hasta este momento. Las implementaciones de los clientes deben suscribirse al portafolio evolucionado de SWIFTRef (Directorio de Pagos o Directorio de Identificadores) y comenzar a utilizar Identifiers All archivo para los datos de la entidad de la parte de la fuente SWIFTRef antes de esta fecha. Consulte Evolución del Portafolio SWIFTRef para más detalles.

  2. El directorio de entidades de partes registra los datos creados a través de la ingestión de Bank Directory Plus tiene todos los identificadores de la parte en el registro único, mientras que una entidad equivalente ingerida a través de Identifiers All tendrá múltiples registros de entidades de partes con el mismo Id único de entidad. Esto se debe a SWIFT proporcione registros a nivel de identificador en Identifiers All mientras Bank Directory Plus proporciona un registro de entidad único con todos los identificadores disponibles en él. A pesar de que la base de datos contiene los identificadores de la entidad de Identifiers All en diferentes registros, la búsqueda de la entidad de parte proporcionada por IPF agrega múltiples identificadores asociados con la misma entidad cuando se realiza una búsqueda utilizando Identifiers All como la fuente. Por lo tanto, una respuesta de búsqueda de entidad de parte se verá similar independientemente de si se realiza una búsqueda desde Bank Directory Plus or Identifiers All. Refiera Entidades de Parte para más detalles.

Puntos importantes a tener en cuenta sobre el Directorio de Entidades de Parte:

  1. Todos los BIC proporcionados por las fuentes de datos de la industria se cargan como ACCOUNT_ISSUING_BIC en el directorio de entidades de las partes.

  2. Los identificadores nacionales proporcionados por las fuentes de datos de la industria se cargan como NCC y las definiciones de subtipos se cargan de acuerdo con la fuente de datos de la industria. Donde esté disponible, la información del subtipo se alinea con ISO20022 el 'Código de Compensación Externo' también se carga.

  3. El Directorio de Entidades de Parte no está destinado a ser utilizado para verificar la membresía en esquemas o la participación en CSM Agentes. Para este propósito,CSM Se utiliza la configuración dinámica del participante.

Tipo de configuración

 DPS v2 introdujo un nuevo atributo de Tipo de Configuración. Este se utiliza para la generación de todos API puntos finales para una configuración particular. También se utiliza en la construcción index-config.<tipo de configuración>.
`SETTING_TYPE = "partyentity"`

Campos buscables

Los campos buscables para el Directorio de Entidades de Parte son:

  • identificador

  • identifierType

  • identifierSubType

  • país

  • entityDataSource

  • entityUniqueId

  • ibanId

Índices

DPS v2 proporciona una opción para configurar índices para cada ajuste. Los índices predeterminados para el Directorio de Entidades de Parte son:
ipf.dps.mongodb.index-config.partyentity {
    index-1 = ["status:ASC"]
    index-2 = ["source:ASC"]
    index-3 = ["values.payload.entityIdentifiers.identifier:ASC"]
    index-4 = ["values.payload.entityIdentifiers.identifierSubType:ASC"]
    index-5 = ["values.payload.entityDataSource:ASC"]
    index-6 = ["payload.entityIdentifiers.identifier:ASC"]
    index-7 = ["payload.entityIdentifiers.identifierSubType:ASC"]
    index-8 = ["payload.entityDataSource:ASC"]
    index-9 = ["values.payload.entityIdentifiers.identifierType:ASC"]
    index-10 = ["values.payload.entityAddress.country:ASC"]
    index-11 = ["payload.entityIdentifiers.identifierType:ASC"]
    index-12 = ["payload.entityAddress.country:ASC"]
    index-13 = ["processingEntity:ASC"]
    index-14 = ["values.payload.entityUniqueId:ASC"]
    index-15 = ["values.payload.ibanIdentifiers.ibanId:ASC"]
    index-16 = ["lastUpdatedAt:ASC"]
}

Esto puede ser anulado o actualizado. Simplemente tenga en cuenta que cuando el campo está bajo carga, debe proporcionar un índice como:`index-x = ["values.payload.fieldX:ASC"]`.

Campo processingEntity se añade a la búsqueda de configuración, por lo que para un mejor rendimiento se recomienda que se indexe para processingEntity se crea.

Notifications

DPS v2 puede proporcionar notificación después de que se realice cierta operación CRUD en una configuración. Hay una opción para habilitar notifications en el nivel de configuración. Notifications están deshabilitados por defecto:
ipf.csm-reachability.should-send-notification.party-entity-settings = false

Historia

Hay una opción para deshabilitar el historial a nivel de configuración. El historial está habilitado por defecto:

ipf.csm-reachability.should-save-history.party-entity-settings = true

Directorio de Entidades de Parte Mappings

Directorio de Entidades de Parte mapping admite las siguientes ingestas: