Módulos Opcionales - Cambios y correcciones

Esta página cubre los cambios y correcciones de módulo opcionales proporcionados en la versión de IPF. 2025.3.0

Scheme Pack s

Cambios Obsoletos

La configuración del reemplazador de caracteres anterior está obsoleta, por favor consulte la documentación actualizada para definir la configuración (PAY-15636).
- La configuración obsoleta ya no será compatible a partir de la 2026.3.0 lanzamiento

Por favor, consulte Pasos de Migración para más detalles

Cambios Importantes

Método de reemplazo de caracteres para reemplazar partes del mensaje eliminadas (PAY-15636)
Se han corregido las verificaciones de integridad de pruebas BDD para TechnicalResponses y ValidateSchemeRuleResponses (PAY-15277)
Todas las referencias a ValidateSchemeRulesResponseSender en scheme pack s debe ser reemplazado con ValidateSchemeRulesResponseSender<ValidateSchemeRulesResponse> o ValidateSchemeRulesResponseSender<ValidateDirectDebitSchemeRulesResponse> (en caso de domiciliación bancaria) (PAY-15332)
Todas las referencias a ValidateSchemeRules en scheme pack s debe ser reemplazado con ValidateSchemeRules<CANONICAL, ValidationResponse> (PAY-15332)
Todas las referencias a ValidateDDSchemeRules<CANONICAL> en scheme pack s debe ser reemplazado con ValidateSchemeRules<CANONICAL, ValidationDDResponse> (PAY-15332)
Cualquier clase como <SchemeName>ValidateSchemeRules que implemente ValidateSchemeRules debe ser reemplazada por un concreto bean. Cada método sobrecargado en ValidateSchemeRules debe tener una implementación dedicada para su tipo CANONICAL correspondiente. Cada concreto bean debe implementar ValidateSchemeRules<CANONICAL, ValidationResponse> (PAY-15332)

Por favor, consulte Pasos de Migración para más detalles

Nuevo

ValidateSchemeRuleResponse ahora incluye automáticamente la clave "ValidatedIsoType" en su customBusinessData metadata. Esto identifica qué ISO 20022 message type fue validado. El CSMClientValidationResponseAdapter y CSMDDClientValidationResponseAdapter predeterminado handleSchemeRulesResponse() método ahora enruta automáticamente a nuevos métodos de manejo específicos de tipo ISO para que usted los implemente en función de los metadatos de respuesta. Si usted implementó anteriormente el handleSchemeRulesResponse() y si no desea migrar a la nueva ruta predeterminada, no se requiere ningún cambio. Puede mantener su implementación existente sin cambios (PAY-15060, PAY-15075)

Debe mantener su CSM client y CSM service versiones en sincronía para garantizar el nuevo predeterminado handleSchemeRulesResponse() El enrutamiento funciona correctamente. Si su cliente es actualizado pero el servicio está ejecutando una versión anterior, los metadatos estarán ausentes en las respuestas, lo que provocará que el método falle.

Un nuevo reemplazador de caracteres de tabla de búsqueda está disponible. Consulte Reemplazo de Caracteres para más detalles. (PAY-15636)

CSM Instant Scheme Pack s

Cambiado

En un duplicado pacs. 004 recibido csm-el servicio no envía un pacs. 002(PAY-15331)

SEPA CT CSM

Nuevo

Configuración para deshabilitar el scheduling de final de día (EOD) implícito pacs. 002. Ver trabajos eod para más detalles. (PAY-15290)

Fijo

Se eliminó la pluralización de las etiquetas problemáticas en las fallas de validación. Por ejemplo, "XT33 CdtTrfTxInf RmtInf Strds" ahora será "XT33 CdtTrfTxInf RmtInf Strd" (PAY-14756)
Al recibir un archivo CVF 'Rechazo Completo de Archivo' (denotado por el campo FileRjctRsn que no es 'A00' o 'A01'), un System Event de tipo FileRejected se elevará y el flujo de 'enviar' permanecerá en un estado pasivado de 'Esperando Respuestas del Esquema’s tate. (PAY-15290)
Los archivos ICF e IQF producidos se generan con un nombre de archivo conforme al esquema STEP2 (PAY-15716, PAY-15742).

Cambiado

Cambios Importantes

El siguiente system events han sido reubicados a sepa-common con su paquete actualizado (PAY-14419)
- BulkCommandFailed
- ReceiveFromSchemeExtensionPointFailed
- ErrorAlEnviarEsquemaDeRespuesta
- SendToSchemeExtensionPointFailed
- SendToSchemeExtensionPointSuccess

Por favor, consulte Pasos de Migración para más detalles

SEPA DD CSM

Nuevo

Añada la validación de esquema canónico para ValidateCollectAndSettleSchemeRulesRequest y CollectAndSettleRequest (PAY-15023)
Añada la regla de validación pacs003 para exigir el código de país de la dirección postal del deudor si el pago involucra un país no perteneciente al EEE (PAY-15098)
Agregue nuevas opciones de configuración para habilitar o deshabilitar la regla de validación pacs003 que exige el código de país de la dirección postal del deudor si el pago involucra un país fuera del EEE. Los valores predeterminados son:
- ipf.csm.sepa-dd.validation.pacs003.validación-dirección-de-deudor-no-eee-salida.habilitado = false
Añada la regla de validación pacs003 para verificar que la dirección postal del deudor debe ser estructurada, híbrida o no estructurada (PAY-11648)
Agregue nuevas opciones de configuración para habilitar o deshabilitar la regla de validación pacs003 para verificar que la dirección postal del deudor debe ser estructurada, híbrida o no estructurada. Los valores predeterminados son:
- ipf.csm.sepa-dd.validation.pacs003.dirección-de-deudor-validación-estructural-salida.habilitado = false
Agregue nuevas opciones de configuración para habilitar o deshabilitar la regla de validación pacs003 para verificar que la dirección postal del acreedor debe ser estructurada, híbrida o no estructurada. Los valores predeterminados son:
- ipf.csm.sepa-dd.validación.pacs003.dirección-del-acreedor-validación-estructural-salida.habilitado = false
Habilitado Debulker validación de esquema para archivos DVF y RSF. (PAY-14837)
Soporte añadido para camt056 (PAY-15649)
- Direct Debit API ahora soporta ExecuteDDCancellationRequest y ExecuteDDCancellationResponse para más detalles consulte API y Procesamiento de Solicitudes
- Direct Debit Validation API ahora soporta ValidateDDCancellationSchemeRulesRequest para más detalles consulte API y Validaciones
- La producción de archivos IDF ahora admite camt056.
- El procesamiento de respuestas DVF admite camt056.
Soporte añadido para pacs007 (PAY-15649)
- Direct Debit API ahora soporta ExecuteDDReversalRequest y ExecuteDDReversalResponse para más detalles consulte API y Procesamiento de Solicitudes
- Direct Debit Validation API ahora soporta ValidateDDReversalSchemeRulesRequest para más detalles consulte API y Validaciones
- La producción de archivos IDF ahora admite pacs007.
- El procesamiento de respuestas DVF admite pacs007.
- El procesamiento de respuestas de RSF admite pacs007.

Fijo

El procesamiento de componentes de un archivo DVF/RSF se reanudará ahora después de un fallo de la aplicación (PAY-14419).
No se puede procesar ValidateCollectAndSettleSchemeRulesRequest si hay un error de validación del esquema del esquema (PAY-15023).
Eliminar failed transacciones de bulking y eleve RegisterBulkCorrelationFailed system event si el guardado en el almacén de correlación falla (PAY-14833)
La validación ahora rechaza correctamente las solicitudes pacs003 que contienen más de 2 líneas de dirección postal para el deudor o el acreedor (PAY-15049).
Para las validaciones de flujo, continúe ejecutando las validaciones en las transacciones restantes incluso si la primera failed, para que podamos enviar transacciones exitosas a la bulker correctamente (PAY-14884)
Los archivos IDF producidos se generan con un nombre de archivo conforme al esquema STEP2 (PAY-15741).

Cambiado

Actualizado a los últimos esquemas XSD para la versión de octubre de 2025:
- Pacs003 (PAY-14682)
- Pacs002S2 (PAY-14683)

Cambios Importantes

El procesamiento de mensajes Pacs002 para RSF y DVF ahora se encuentra contenido en un subflujo (PAY-14419).
El technical.enabled El parámetro ahora sirve como un interruptor único para habilitar/deshabilitar las respuestas técnicas de débito directo (consulte los cambios de configuración a continuación).
- Cambio del valor predeterminado del tema de Kafka desde COLLECTANDSETTLE_TECHNICAL_RESPONSE to DIRECTDEBIT_TECHNICAL_RESPONSE
- Cambio del valor predeterminado de la cola JMS desde collectandsettle.technical.response to directdebit.technical.response
Las colas/temas de Domiciliación Bancaria ahora son por dirección y rol únicamente (es decir, DD acreedor-a-de-csm/DD csm-al acreedor), en oposición a por dirección, rol y message type(PAY-15358/PAY-15434/PAY-15360/PAY-15550)
- Los nombres de los temas y las claves de configuración para anularlos han cambiado. Consulte referencia de transporte para más detalles

La configuración a continuación muestra el cambio en la configuración para habilitar/deshabilitar los diversos conectores DD:

Antes:

csm {
  direct-debit {
    collect-and-settle {
      creditor.enabled = true
      technical.enabled = true
    }
  }
}

Después:

csm {
  direct-debit {
    creditor.enabled = true
    technical.enabled = true
  }
}

Por favor, consulte Pasos de Migración para más detalles

CONSEJOS CSM

Cambios Importantes

La sustitución de caracteres predeterminada se ha actualizado para utilizar el EPC217-08.SEPA Tabla de Conversión (PAY-15584)
- Advertencia: Los reemplazos de múltiples caracteres de la tabla serán reemplazados por .
- Por favor, consulte Pasos de Migración sobre cómo mantener el comportamiento heredado

SEPA Simulador VFG

Nuevo

Soporte añadido para Camt. 056 transacciones durante la generación del archivo DVF de Domiciliación Bancaria (PAY-15371)
Soporte añadido para Pacs. 007 transacciones durante la generación de archivos de Débito Directo DVF y RSF (PAY-15372)

Fijo

El simulador espera que los nombres de los archivos ICF, IQF e IDF coincidan con el formato conforme al esquema para poder producir los archivos de verificación correspondientes (PAY-15716, PAY-15741, PAY-15742).

SIC CSM Simulador

Cambiado

Utilizando expresiones que no son SpeL en additionalInfo mejorar los datos generados está obsoleto y será eliminado en una futura versión (PAY-14008)

CONSEJOS CSM Simulador

Cambiado

Al configurar additionalInfo, ahora puede utilizar SpEL para mejorar los datos generados (PAY-14008)
Utilizando expresiones que no son SpeL en additionalInfo mejorar los datos generados está obsoleto y será eliminado en una futura versión (PAY-14008)

Procesador de Métricas IPF

Nuevo

Estructura de configuración actualizada para soportar versiones.pds mappings en el Procesador de Métricas IPF.

Para soportar los datos de IPF versioning, la configuración del procesador de métricas se ha mejorado para manejar múltiples versiones de un PDS objeto a través de varias versiones, acomodando posibles cambios en el esquema.

NOTA: Mientras PDS versioning no está actualmente soportado en IPF, estos cambios están en preparación para su eventual integración. Se proporcionará documentación adicional una vez que versioning está completamente soportado.
Este cambio es compatible hacia atrás, permitiendo a los usuarios continuar utilizando la configuración existente sin requerir una migración inmediata al nuevo formato.

A continuación se presenta un ejemplo de configuración para algunas etiquetas de métricas:

ipf.business-metrics-processor.payment-metrics {
  labels {
    csm {
      pds-type = "Csm",
      path = "/value"
    }
    currency {
      pds-type = CurrencyPdsType
      path = "/amt/pmtAmt/ccy"
    }
    local-instrument {
      pds-type = InstrumentPdsType
      path = "/prcgInstrs/lclInstrm/prtry"
    }
  }
}

Para migrar a la nueva configuración, se requieren los siguientes cambios:

Reemplace el labels clave con versioned-labels
Cada clave dentro de versioned-labels(Ej.csm,currency,local-instrument etc.) ahora contiene un arreglo de objetos en lugar de un solo objeto.

A continuación se presenta la versión actualizada de la configuración de ejemplo:

ipf.business-metrics-processor.payment-metrics {
  versioned-labels {
    csm = [
      {
        pds-type = "Csm",
        path = "/value"
      }
    ]
    currency = [
      {
        pds-type = CurrencyPdsType
        path = "/amt/pmtAmt/ccy"
      }
    ]
    local-instrument = [
      {
        pds-type = InstrumentPdsType
        path = "/prcgInstrs/lclInstrm/prtry"
      }
    ]
  }
}

Consulta ODS utilizando Consulta

En algunos casos, el procesador de métricas consulta ODS(Operational Data Store) base de datos para recuperar cualquier dato faltante como events y PDS(Processing Data Estructuras) objetos. Esto se ha realizado utilizando una conexión directa a la ODS MongoDB colecciones. Ahora es posible configurar el procesador de métricas para utilizar ODS Inquiry para recuperar estos datos necesarios.

Esta funcionalidad es opcionalmente configurable. Si lo desea, añada lo siguiente a la configuración de su Procesador de Métricas IPF:

ods.inquiry.client {
  version = 3
  // Only the process object and pds object connectors are required
  process-objects.enabled = true
  pds-objects.enabled = true

  // Replace with your deployed ODS Inquiry host and port
  http.client {
    host = "ods-inquiry-host"
    port = 8080
  }
}

Recomendamos que usted pase a utilizar esto. ODS configuración del cliente para el procesador de métricas, ya que se convertirá en el predeterminado en el futuro; en ese momento,`ods.http.client.host` y `ods.http.client.port` se requerirá configuración para una instancia de IPF Metrics Processor.

Una instancia de ODS Inquiry es necesario dentro de su implementación para que estos nuevos conectores funcionen.

Verificación del Beneficiario (VoP)

Solicitante de VoP

Obsoleto Kafka Encabezados

Los siguientes encabezados están ahora obsoletos (PAY-15687) y serán eliminados en la versión IPF 2025.4.0:
- requestId
- processingEntity
Los encabezados de reemplazo equivalentes que se utilizarán en adelante son:
- ipf_processing_context_client_request_id
- ipf_processing_context_processing_entity

VoP Responder

Nuevo

Filtrado por país
- Se añadió funcionalidad para filtrar solicitudes de VoP en función del código de país BIC del agente solicitante y una fecha regulatoria opcional. Devuelve una respuesta NOAP (No Aplicable) si alguna de estas verificaciones no se cumple.
- El filtrado por país está desactivado por defecto, por lo que no se requieren pasos de migración para que el respondedor continúe funcionando.
- Por favor, consulte VoP Responder para más detalles

Obsoleto Kafka Encabezados

Los siguientes encabezados están ahora obsoletos (PAY-15687) y serán eliminados en la versión IPF 2025.4.0:
- requestId
- processingEntity
Los encabezados de reemplazo equivalentes que se utilizarán en adelante son:
- ipf_processing_context_client_request_id
- ipf_processing_context_processing_entity == Servicio de Notificación de Pagos === Cambios Importantes Como parte de la adaptación del servicio de notificaciones a una versión de datos independiente, algunas clases de dominio han cambiado, lo que puede requerir una migración para las implementaciones específicas del cliente del servicio de notificaciones. Consulte el notas de migración para obtener detalles adicionales.