Party Entity Directory
Party Entity Directory es una configuración dinámica que puede usarse para buscar Party Entities y recuperar los detalles de la entidad, como identificadores y datos de dirección.
Los datos devueltos por la búsqueda de party entity pueden ser usados por las implementaciones cliente para el enriquecimiento de pagos. El directorio también se utiliza durante la comprobación de reachability para buscar identificadores usados por CSM Agents para la participación cuando la solicitud de entrada no proporciona el tipo de identificador requerido.
Party Entity Directory soporta la ingesta desde datos de referencia de la industria para habilitar búsquedas de entidades.
IPF soporta la siguiente ingesta de archivos de industria en Party Entity Directory: En el futuro podrán soportarse más fuentes de datos en Party Entity Directory si surge la necesidad a través de requisitos de cliente.
Si es necesario, las implementaciones cliente también pueden definir e implementar ingestas personalizadas en Party Entity Directory.
| Sr. No. | Industry Data File | Industry Source | File Format | File Type (Full / Delta) |
|---|---|---|---|---|
1 |
Bank Directory Plus |
SWIFTRef |
XML |
Full, Delta |
2 |
SIX Bank Master 3.0 |
SIX |
XML |
Full |
Party Entity Directory Data Structure
De forma similar a CSM Participants, Party Entity Directory es una configuración dinámica genérica que se carga desde diferentes fuentes de la industria de manera genérica, independientemente del formato de los archivos fuente.
A continuación se muestran las propiedades soportadas en Party Entity Directory.
| Party Entity Directory property | Description |
|---|---|
entityUniqueId |
Un ID único por el que se conocerá a la entidad. El ID será único a través de la fuente de datos. |
entityDataSource |
Especifica la fuente de los datos, que puede ser una fuente de datos de referencia, como 'Bank_Directory_Plus' o 'Bank_Master'. |
entityType |
Tipo de Party Entity. Los valores posibles son 'Bank' o 'Branch'. Esto es solo informativo y no se usa durante el procesamiento. |
entityName |
Nombre de la Party entity. |
entityAddress |
Dirección de la Party entity. Los campos de dirección en los registros de Party Entity Directory siguen una estructura de dirección compatible con ISO20022. |
entityEmail |
Email de la Party Entity. Soporta caracteres especiales. |
entityPhoneNumber |
Número de teléfono de la Party Entity. Soporta caracteres especiales |
entityIdentifiers |
Lista de identificadores asociados con la entidad. Los tipos de identificador soportados son BIC, NCC (National Clearing Code) y LEI. |
isHeadOffice |
Indica si la entidad es una entidad sede central en el grupo. |
Consulta la siguiente página para saber más sobre los identificadores de pago usados en IPF CSM Reachability Service.
Puntos importantes a tener en cuenta sobre Party Entity Directory:
-
Todos los BICs proporcionados por las fuentes de datos de la industria se cargan como ACCOUNT_ISSUING_BIC en Party Entity Directory.
-
Los National Ids proporcionados por las fuentes de la industria se cargan como NCCs y las definiciones de subtipo se cargan según la fuente de datos de la industria. Cuando está disponible, también se carga la información de subtipo alineada con 'External Clearing Codes' alineados con ISO20022.
-
Party Entity Directory no está diseñado para comprobar la pertenencia a esquemas o la participación en CSM Agents. Para este propósito, se utiliza la configuración dinámica CSM Participant.
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 = "partyentity"
Searchable Fields
Los campos buscables para Party Entity Directory son:
-
identifier
-
identifierType
-
identifierSubType
-
country
-
entityDataSource
Indexes
DPS v2 proporciona una opción para configurar índices para cada setting. Los índices por defecto para Party Entity Directory 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.identifierType:ASC"]
index-4 = ["values.payload.entityIdentifiers.identifierSubType:ASC"]
index-5 = ["values.payload.entityAddress.country:ASC"]
index-5 = ["values.payload.entityDataSource: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.party-entity-settings = falseHistory
Existe una opción para deshabilitar el histórico a nivel de setting. El histórico está habilitado por defecto:
ipf.csm-reachability.should-save-history.party-entity-settings = true