Configuración del Agente

Un Agente es una entidad con la que la Entidad de Procesamiento mantiene una relación de liquidación en una o más Monedas de Transferencia.

Al liquidar y saldar un pago entre la Entidad de Procesamiento y el Agente, se debe utilizar al menos una cuenta de liquidación que permita a las dos entidades saldar la obligación. Si una entidad no necesita una cuenta de liquidación y puede utilizar las cuentas del libro mayor de la Entidad de Procesamiento para debitar / acreditar el customers directamente, esta entidad no es un Agente, esta es una Parte Intra Entidad, una parte que forma parte de la Entidad de Procesamiento misma.

El Agente puede ser una entidad que forma parte de un grupo bancario más amplio al que pertenece la Entidad Procesadora. En este caso, el Agente es un Agente Intra Grupo.

El tipo de Agente se basa en el tipo de relación de liquidación que mantiene con la Entidad Procesadora. Estas pueden ser:

AgenteDeCuentaDirecta - El Agente mantiene una relación de liquidación de cuentas directa con la Entidad Procesadora. Esto suele ser otro Banco / Institución Financiera que no es una Cámara de Compensación.
Agente de Compensación - El Agente es una Cámara de Compensación y facilita la compensación y liquidación de pagos entre diferentes instituciones financieras.

Según la naturaleza de la relación de liquidación, el Agente puede desempeñar diferentes roles, los cuales son independientes de los tipos de Agente. Los roles del agente pueden ser:

Intermediario - Un tipo de Agente DirectAccount (una Institución Financiera, no una cámara de compensación) que facilita la compensación y liquidación de los pagos entre la Entidad de Procesamiento y otras Instituciones Financieras con las que no mantiene relaciones de liquidación directas.
Agente de Servicio - Un tipo de Agente DirectAccount (una Institución Financiera, no una cámara de compensación) que utiliza la Entidad de Procesamiento para liquidar y saldar pagos con otras Instituciones Financieras. Un Agente Servido está utilizando la Entidad de Procesamiento como intermediario.

En resumen, la relación de liquidación entre la Entidad de Procesamiento y el Agente se define utilizando tres atributos clave en la Configuración del Agente.

Tipo de Agente
Rol del Agente
Intra Grupo Flag

Cuando un agente puede facilitar la compensación y liquidación de pagos entre la Entidad de Procesamiento y otras Instituciones Financieras, esas instituciones deben ser añadidas como participantes para el Agente utilizando la estructura de datos de la Industria llamada CSM Participantes. Los detalles de participación deben ser especificados en la Configuración del Agente para que se habilite una verificación de participación con fines de Alcance para la contraparte.

La Configuración del Agente es la configuración dinámica de tipo Processing Data que contiene los detalles del Agente (nombre, identificadores de la industria por los que se conoce al Agente, detalles de la dirección y los detalles de la participación).

Propiedades de Configuración Dinámica

Nombre	Descripción
ProcessingEntity	El espacio de nombres de la entidad de procesamiento desde el punto de vista de implementación/despliegue de IPF.
AgentUniqueId	Un identificador único asignado por la Entidad de Procesamiento al Agente.
AgentName	Nombre del agente
IdentificadoresDeAgente	Identificadores de la industria para el agente. Se debe especificar al menos un tipo de identificador.
+ Identificador	El valor del identificador para el agente
+ TipoDeIdentificador	Tipo de identificador, los siguientes valores predeterminados son compatibles: BIC LEI NCC
+ TipoDeSubidentificador	Condicionalmente obligatorio cuando el tipo de identificador es: BIC o NCC La lista de enumeración es específica para el tipo de identificador. BIC: accountIssuingBIC, schemeMembershipBIC NCC: Los enumerados de subtipo están alineados a ISO20022 códigos especificados.
TipoDeAgente	Tipo de Agente (Consulte las definiciones de tipo de agente arriba)
RolesDeAgente
+ AgenteDeServicio	El flag indica si el agente puede ser un agente atendido. El valor verdadero indica que la Entidad de Procesamiento está atendiendo al agente y el agente puede utilizar la relación de liquidación con la Entidad de Procesamiento para liquidar y saldar los pagos con otros agentes.
+ AgenteIntermediario	El flag indica si el agente es un agente intermediario para la entidad de procesamiento. El valor verdadero significaría que el agente está prestando servicio a la entidad de procesamiento y que la entidad de procesamiento puede utilizar la relación de liquidación con el agente para compensar y liquidar los pagos con otros agentes.
IntraGrupo	El flag identifica si el agente forma parte del mismo grupo bancario que la entidad de procesamiento. Un valor Falso significará que el agente es una entidad externa.
Detalles De Participación
+ ParticipantCSMAgentId	El CSM ID de agente en el CSM Registros de Participantes.
+ TipoDeIdentificadorDeParticipante	El valor del tipo de identificador que se utilizará para las verificaciones de conectividad del agente. La lista de enumeraciones es extensible para las implementaciones del cliente. Los valores posibles predeterminados son: BIC LEI NCC
+ SubtipoDeIdentificadorDeParticipante	Condicionalmente obligatorio cuando el tipo de identificador es: BIC o NCC. La lista de enumeración es específica para el tipo de identificador. BIC: accountIssuingBIC, schemeMembershipBIC NCC: Los enumerados de subtipo están alineados a ISO20022 códigos especificados.
+ Fuente De Búsqueda De Entidad De Parte	La fuente de los datos en el directorio de entidades de partes que debe ser utilizada para buscar identificadores de entidades de partes. La lista de enumeraciones es extensible para las implementaciones del cliente. Valores posibles por defecto: Directorio_Bancario_Plus SIX_Bank_Master SWIFTRef_IDENTIFIERS-TODOS
Dirección Agente
+Tipo De Dirección	ISO20022 tipos de dirección definidos. Valores soportados: ADDR, PBOX, HOME, BIZZ, MLTO, DLVY
+ Departamento	Nombre del departamento
+ Subdepartamento	Nombre del Subdepartamento.
+ NombreDeLaCalle	Nombre de la calle
+ Número De Edificio	Número de edificio
+ NombreEdificio	Nombre del Edificio
+ Piso	Suelo
+ Buzón	Buzón
+ Sala	Sala
+ Código Postal	Código postal
+ NombreDelPueblo	Esto puede ser un Nombre de Pueblo o el nombre de la Ciudad.
+ Nombre De Ubicación Del Pueblo	Nombre de la ubicación del pueblo
+ NombreDelDistrito	Nombre del Distrito
+ Subdivisión Del País	subdivisión del país
+ País	Código de país Alpha 2 de la ISO 3166
+ Líneas De Dirección	Lista de líneas de dirección
AgentEmail	Correo electrónico del Agente
Número De Teléfono Del Agente	Número de teléfono del agente. Soporte para caracteres especiales. Regex: +[0-9]{1, 3}-[0-9()+\-]{1, 30}

Nombre

Descripción

ProcessingEntity

El espacio de nombres de la entidad de procesamiento desde el punto de vista de implementación/despliegue de IPF.

AgentUniqueId

Un identificador único asignado por la Entidad de Procesamiento al Agente.

AgentName

Nombre del agente

IdentificadoresDeAgente

Identificadores de la industria para el agente. Se debe especificar al menos un tipo de identificador.

+ Identificador

El valor del identificador para el agente

+ TipoDeIdentificador

Tipo de identificador, los siguientes valores predeterminados son compatibles:

BIC

LEI

NCC

+ TipoDeSubidentificador

Condicionalmente obligatorio cuando el tipo de identificador es: BIC o NCC

La lista de enumeración es específica para el tipo de identificador.

BIC: accountIssuingBIC, schemeMembershipBIC

NCC: Los enumerados de subtipo están alineados a ISO20022 códigos especificados.

TipoDeAgente

Tipo de Agente (Consulte las definiciones de tipo de agente arriba)

RolesDeAgente

+ AgenteDeServicio

El flag indica si el agente puede ser un agente atendido. El valor verdadero indica que la Entidad de Procesamiento está atendiendo al agente y el agente puede utilizar la relación de liquidación con la Entidad de Procesamiento para liquidar y saldar los pagos con otros agentes.

+ AgenteIntermediario

El flag indica si el agente es un agente intermediario para la entidad de procesamiento. El valor verdadero significaría que el agente está prestando servicio a la entidad de procesamiento y que la entidad de procesamiento puede utilizar la relación de liquidación con el agente para compensar y liquidar los pagos con otros agentes.

IntraGrupo

El flag identifica si el agente forma parte del mismo grupo bancario que la entidad de procesamiento. Un valor Falso significará que el agente es una entidad externa.

Detalles De Participación

+ ParticipantCSMAgentId

El CSM ID de agente en el CSM Registros de Participantes.

+ TipoDeIdentificadorDeParticipante

El valor del tipo de identificador que se utilizará para las verificaciones de conectividad del agente. La lista de enumeraciones es extensible para las implementaciones del cliente.

Los valores posibles predeterminados son:

BIC

LEI

NCC

+ SubtipoDeIdentificadorDeParticipante

Condicionalmente obligatorio cuando el tipo de identificador es: BIC o NCC.

La lista de enumeración es específica para el tipo de identificador.

BIC: accountIssuingBIC, schemeMembershipBIC

NCC: Los enumerados de subtipo están alineados a ISO20022 códigos especificados.

+ Fuente De Búsqueda De Entidad De Parte

La fuente de los datos en el directorio de entidades de partes que debe ser utilizada para buscar identificadores de entidades de partes. La lista de enumeraciones es extensible para las implementaciones del cliente.

Valores posibles por defecto:

Directorio_Bancario_Plus

SIX_Bank_Master

SWIFTRef_IDENTIFIERS-TODOS

Dirección Agente

+Tipo De Dirección

ISO20022 tipos de dirección definidos.

Valores soportados: ADDR, PBOX, HOME, BIZZ, MLTO, DLVY

+ Departamento

Nombre del departamento

+ Subdepartamento

Nombre del Subdepartamento.

+ NombreDeLaCalle

Nombre de la calle

+ Número De Edificio

Número de edificio

+ NombreEdificio

Nombre del Edificio

+ Piso

Suelo

+ Buzón

Buzón

+ Sala

Sala

+ Código Postal

Código postal

+ NombreDelPueblo

Esto puede ser un Nombre de Pueblo o el nombre de la Ciudad.

+ Nombre De Ubicación Del Pueblo

Nombre de la ubicación del pueblo

+ NombreDelDistrito

Nombre del Distrito

+ Subdivisión Del País

subdivisión del país

+ País

Código de país Alpha 2 de la ISO 3166

+ Líneas De Dirección

Lista de líneas de dirección

AgentEmail

Correo electrónico del Agente

Número De Teléfono Del Agente

Número de teléfono del agente. Soporte para caracteres especiales.

Regex: +[0-9]{1, 3}-[0-9()+\-]{1, 30}

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 = "agentsettings"`

Campos buscables

Los campos buscables para la Configuración del Agente son:

agentUniqueId
agentIdentifier (agentIdentifiers.identifier)
tipoDeIdentificadorDeAgente (identificadoresDeAgente.tipoDeIdentificador)
agentIdentifierSubType (agentIdentifiers.identifierSubType)
agentCountry (agentAddress.country)
agentParticipantCsmAgentId (participationDetails.participantCsmAgentId)

Índices

DPS v2 proporciona una opción para configurar índices para cada ajuste. Los índices predeterminados para la Configuración del Agente son:

ipf.dps.mongodb.index-config.agentsettings {
    index-1 = ["status:ASC"]
    index-2 = ["processingEntity:ASC"]
    index-3 = ["values.payload.agentUniqueId:ASC"]
    index-4 = ["values.payload.agentIdentifiers.identifier:ASC"]
    index-5 = ["values.payload.agentIdentifiers.identifierType:ASC"]
    index-6 = ["values.payload.agentIdentifiers.identifierSubType:ASC"]
    index-7 = ["values.payload.agentAddress.country:ASC"]
    index-8 = ["payload.agentUniqueId:ASC"]
    index-9 = ["payload.agentIdentifiers.identifier:ASC"]
    index-10 = ["payload.agentIdentifiers.identifierType:ASC"]
    index-11 = ["payload.agentIdentifiers.identifierSubType:ASC"]
    index-12 = ["payload.agentAddress.country:ASC"]
    index-13 = ["lastUpdatedAt:ASC"]
}

Esto puede ser anulado o actualizado. Solo 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.agent-settings-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.agent-settings-settings = true

Por favor, consulte xref:csm-reachability:getting-started/dynamic-configuration-set-up/dynamic-configurations-set-up-guide.adoc[] para los pasos a seguir para configurar las configuraciones dinámicas.