Documentation for a newer release is available. View Latest

Agent Settlement Settings

Agent Settlement Settings son las configuraciones para un Agent que son específicas de las Transfer Currencies y de la liquidación entre la Processing Entity y el Agent para esas transfer currencies.

Agent Settlement Settings son necesarias para un Agent si dicho Agent va a ser seleccionado como parte de las comprobaciones de reachability para un pago en una transfer currency.

Agent Settlement Settings permiten mantener configuraciones como Transfer Currencies, cuentas de liquidación, límites a nivel de agent o para participantes específicos del Agent.

Dynamic Configuration Properties

Name Description

ProcessingEntity

Para clientes que deseen configurar diferentes Settings para distintas entidades dentro de su organización (p. ej., diferentes sucursales). Este valor define a qué Processing Entity aplica este registro.

AgentUniqueId

Un identificador único asignado por la Processing Entity al Agent. El AgentUniqueId se define en los Agent settings.

TransferCurrencies

Lista de transfer currencies ISO4217 para las que el registro de Setting es aplicable.

TransferDirection

Inbound - El registro de liquidación soporta transferencias de divisa hacia la Processing Entity desde el agent (Inbound Payments)

Outbound - El registro de liquidación soporta transferencias de divisa desde la Processing Entity hacia el agent (Outbound Payments)

Bidirectional - El registro de liquidación soporta transferencias de divisa tanto hacia como desde la processing entity con el agent (pagos Inbound y Outbound)

SettlementAccount

Solo puede registrarse una settlement account por cada divisa.

+ AccountId

Número de cuenta de la settlement account

+ AccountIdType

Tipo de Account ID usado. Valores posibles:

IBAN

OTHR

+ AccountCurrency

Código de divisa ISO 4217

+ AccountType

Valores posibles:

NOSTRO

VOSTRO

SETTLEMENTMIRROR

+ AccountServicingAgent

El agent que presta servicio a la settlement account. La cuenta puede estar en los libros de la Processing entity o en los del agent que está en el alcance del registro de setting. Deben añadirse los identificadores apropiados a las cuentas. Al menos debe proporcionarse un tipo de identificador.

++ AgentName

Nombre del agent

++ AgentIdentifiers

Los identificadores de la industria por los que se conoce al agent.

+ Identifier

El valor del identificador para el Agent

+ IdentifierType

Tipo de identificador; se soportan los siguientes valores por defecto:

BIC

LEI

NCC

+ IdentifierSubType

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

La lista de enums es específica del tipo de identificador.

BIC: accountIssuingBIC, schemeMembershipBIC

NCC: Los subtipos están alineados con los códigos especificados por ISO20022.

++ AgentCountry

El código de país del identificador del Account Servicing Agent. Condicionalmente obligatorio cuando el tipo de identificador es LEI.

AgentLimits

Límites aplicables para el agent para las transfer currencies dadas. Los límites de importe se aplicarán en la divisa de la settlement account tanto para transacciones inbound como outbound. Solo debe permitirse un límite de cada tipo (se permiten múltiples ocurrencias para especificar otros tipos de límite que aún no se soportan).

+ LimitType

Tipo del límite de importe. Valores posibles:

INDIVIDUAL_MAX_AMOUNT_VALUE

+ LimitValue

Valor para el tipo de límite correspondiente. Los valores de límite siempre se aplicarán contra la divisa base del Agent.

+ LimitDirection

Dirección en la que debe aplicarse el límite cuando la processing entity liquida con el agent; las direcciones de límite son desde el punto de vista de la processing entity. Valores posibles: INBOUND, OUTBOUND.

CustomParticipantLimits

Límites aplicables para Participants y establecidos por la Processing entity para el Agent dado y para un conjunto de participantes. Esto también puede establecerse por la processing entity para reducir el riesgo de exposición a uno o más participantes debido a preocupaciones de riesgo de liquidez.

Los límites de importe se aplicarán en la divisa de la settlement account solo para transacciones outbound. La lista puede tener a un participante apareciendo solo una vez y no puede duplicarse.

+ LimitType

Tipo del límite de importe. Valores posibles:

INDIVIDUAL_MAX_AMOUNT_VALUE

+ LimitValue

Valor para el tipo de límite correspondiente. Los valores de límite siempre se aplicarán contra la divisa base del Agent.

+ LimitDirection

Dirección en la que debe aplicarse el límite al liquidar con el agent, para el participant especificado. Las direcciones de límite son desde el punto de vista de la processing entity. Valores posibles: INBOUND, OUTBOUND.

+ ParticipantIdentifier

El participant al que aplica este límite. El identificador del participant debe establecerse usando la definición de tipo definida en los Agent settings. Esto es un paso operativo y no se implementarán validaciones. Si el valor no se establece usando el tipo de identificador correcto, entonces el límite no se aplicará.

CountryLimits

Límite aplicable cuando la contraparte del pago tiene sede en el país del límite especificado.

Los límites se aplicarán en la divisa de la settlement account en el registro de Agent Settlement Settings. Los límites pueden configurarse por país, por lo que si el mismo valor de límite aplica a varios países, será necesario registrar múltiples registros de límite.

+ LimitType

Tipo del límite de importe. Valores posibles:

INDIVIDUAL_MAX_AMOUNT_VALUE

+ LimitValue

Valor para el tipo de límite correspondiente. Los valores de límite siempre se aplicarán contra la divisa base del Agent.

+ LimitDirection

Dirección en la que debe aplicarse el límite al liquidar con el agent, para el país especificado. Las direcciones de límite son desde el punto de vista de la processing entity. Valores posibles: INBOUND, OUTBOUND.

+ Country

Código de país ISO 3166

HigherParticipantLimitAllowed

Este flag indica si el agent permite establecer y usar límites superiores a nivel de participant durante el procesamiento. Valores: True - El agent permite un límite a nivel de participant superior; si se encuentra un valor mayor para el participant (mediante una fuente de industria o mediante un límite bilateral de participant), entonces deben usarse esos valores al realizar comprobaciones de límites False - El agent no permite un límite superior a nivel de participant; si se encuentra un valor mayor para el participant (mediante una fuente de industria o mediante un límite bilateral de participant), entonces deben usarse los valores de límites a nivel de agent al realizar comprobaciones de límites

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 = "agentsettlementsettings"

Searchable Fields

Campos buscables para Agent Settlement Settings:

  • agentUniqueId

  • transferCurrencies

  • transferDirections

  • settlementAccountType (settlementAccount.accountType)

Indexes

DPS v2 proporciona una opción para configurar índices para cada setting. Los índices por defecto para Agent Settlement Settings son:

ipf.dps.mongodb.index-config.agentsettlementsettings{
    index-1 = ["status:ASC"]
    index-2 = ["processingEntity:ASC"]
    index-3 = ["values.payload.agentUniqueId:ASC"]
    index-4 = ["values.payload.transferCurrencies:ASC"]
    index-5 = ["values.payload.transferDirection:ASC"]
    index-6 = ["values.payload.settlementAccount.accountType: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.agent-settlement-settings-settings = false

History

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.agent-settlement-settings-settings = true

Consulta Dynamic Configuration Management Guidelines para los pasos a seguir al configurar las configuraciones dinámicas.