4. /entidades-de-partido

Propósito

Entidades de las Partes API puede ser utilizado por las implementaciones de los clientes para consultar los datos de referencia de la industria con el fin de recuperar detalles adicionales de las partes involucradas en el pago. Los detalles devueltos incluyen otros identificadores por los cuales la parte es conocida, así como detalles de nombre y dirección.

Los detalles recuperados a través de /party-entities API puede ser utilizado por las implementaciones de los clientes para fines de enriquecimiento de pagos.

Configuraciones Dinámicas

La /entidades-de-partido API utiliza las siguientes configuraciones dinámicas para la recuperación de entidades de partes.

Configuración Dinámica Opcionalidad Propósito Referencia

Directorio de Entidades de Parte

Obligatorio

El Directorio de Entidades de Parte contiene los registros cargados a través de datos de referencia de la industria y es la fuente de consultas para /party-entities. API.

Directorio de Entidades de Parte

Cuando las implementaciones de los clientes desean consultar registros de entidades de partes utilizando IBANs, se necesitarán datos de referencia adicionales de la industria. Consulte 3. /iban/deconstruir para más detalles.

Datos de Referencia de la Industria

El directorio de entidades de partes puede ser cargado a través de las cargas de datos de la industria para habilitar la búsqueda de registros de entidades de partes. IPF CSM Reachability service admite la ingestión de los siguientes archivos de datos de referencia de la industria en el Directorio de Entidades de Parte.

  1. Directorio Bancario SWIFTRef Plus

  2. SIX Bank Master

  3. Identificadores SWIFTRef Todos

Para más información sobre mapping de cada archivo de datos de referencia de la industria al directorio de entidades de partes, por favor consulte Directorio de Entidades de Parte.

Uso

  1. /entidades-de-partido API puede ser utilizado por las implementaciones del cliente para recuperar detalles adicionales sobre las partes involucradas en el pago para la identificación / enriquecimiento de direcciones de los pagos.

  2. La búsqueda de entidades de partido también es utilizada por otras implementaciones de servicio en CSM Reachability service para realizar búsquedas de identificadores para comprobaciones de alcanzabilidad cuando las solicitudes de alcanzabilidad no tienen los identificadores requeridos como los utilizados por el CSM Agentes para registrar membresías en CSM Configuración dinámica de participantes.

  3. Debajo CSM Reachability Los endpoints utilizan entidades de partes para la búsqueda interna (Consulte CSM Reachability Operaciones)

  4. Valide la Alcanzabilidad Intraentidad

  5. Valide CSM Reachability

  6. Seleccione CSM Agente

Solicitud y Respuesta

/party-entities sigue la estructura de solicitud y respuesta 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

NOTA

  1. Cuando un identificador proporcionado al punto final coincide con múltiples registros de entidades de partes (debido a que es un identificador compartido entre muchas sucursales), se devuelve el registro de la oficina central en la respuesta. Si en este caso no se encuentra un registro de la oficina central, entonces se devuelven todos los registros que coinciden con el identificador dado. En la mayoría de los casos, la búsqueda de entidades de partes debe devolver un único registro cuando se encuentra.

  2. Cuando la entidad de la parte busca la fuente de SWIFTRef_Identifiers_All se utiliza para la búsqueda, luego se agregan todos los identificadores asociados con la parte y se devuelven en la respuesta, junto con los campos no identificadores del registro coincidente. Esto se debe a que SWIFT proporciona entradas a nivel de identificador sobre Identifiers All El archivo y los registros de la entidad de la parte se cargan por identificador.

API Versión 2

Solicitud

Solicitar propiedad Descripción

identificadorDeEntidad

El identificador que debe utilizarse para buscar el registro de la Entidad en el Directorio de Entidades de Parte.

tipoDeIdentificadorDeEntidad

El tipo de identificador que se está utilizando para buscar una entidad. Consulte Identificadores de Parte Explicados

subtipoDeIdentificadorDeEntidad

1. El subtipo del tipo de identificador que se está utilizando para la búsqueda.

2. Para los identificadores de tipo BIC, tanto los valores ACCOUNT_ISSUING_BIC como SCHEME_MEMBERSHIP_BIC conducirán a la recuperación del identificador de registro con el valor BIC coincidente.

3. Aunque el directorio de entidades de la parte contiene los valores de subtipo NCC según lo definido por la respectiva fuente de datos de la industria (por ejemplo, Bank Directory Plus), el /party-entities API admite los valores de subtipo NCC según lo definido en ISO20022 Códigos del Sistema de Compensación Externa para consultas.

entityCountry

Código de país ISO3166-2 del registro de entidad que se está consultando. entityCountry es obligatorio al consultar registros de tipo LEI.

entityDataSource

La fuente de datos de la industria que debe utilizarse para la búsqueda del registro en el Directorio de Entidades de Parte.

Respuesta

Propiedad de Respuesta Descripción

entityUniqueId

El ID único asignado a la entidad según el mapping desde la fuente de datos respectiva en el Directorio de Entidades de Parte.

entityDataSource

Industria /Custom fuente de datos que se ha utilizado para la consulta del registro de la entidad parte.

tipoDeEntidad

El tipo de la entidad donde está disponible en el Directorio de Entidades de Parte.

entityName

Nombre de la entidad según la industria /custom fuente de datos.

entityAddress

Dirección de la entidad según lo mapeado desde la industria /custom fuente de datos. Los campos de dirección están alineados a ISO20022 formato de campo de dirección especificado.

identificadoresDeEntidad (*)

1. Una lista de identificadores derivados del Directorio de Entidades de Parte. Se pueden registrar múltiples identificadores del mismo tipo contra un registro (en caso de fusiones) y se pueden devolver múltiples identificadores de diferentes tipos si están registrados en el Directorio de Entidades de Parte.

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.

+TipoDeIdentificador

El valor de tipo asociado con el identificador de entidad.

+identifierSubType

Subtipo del tipo de identificador devuelto.

entityEmail

Correo electrónico de la entidad según lo registrado en el Directorio de Entidades de Parte.

número De Teléfono De La Entidad

El número de teléfono de la entidad tal como está registrado en el Directorio de Entidades de Parte.