Módulos Opcionales - Cambios y Soluciones

Esta página cubre los cambios y correcciones de módulo opcionales proporcionados en la versión 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 versión 2026.3.0.

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 los paquetes de esquema deben ser reemplazados por ValidateSchemeRulesResponseSender<ValidateSchemeRulesResponse> o ValidateSchemeRulesResponseSender<ValidateDirectDebitSchemeRulesResponse> (en caso de domiciliación bancaria) (PAY-15332)

  • Todas las referencias a ValidateSchemeRules en los paquetes de esquema deben ser reemplazados por ValidateSchemeRules<CANONICAL, ValidationResponse> (PAY-15332)

  • Todas las referencias a ValidateDDSchemeRules<CANONICAL> en los paquetes de esquema debe ser reemplazado por ValidateSchemeRules<CANONICAL, ValidationDDResponse> (PAY-15332)

  • Cualquier clase como <SchemeName>ValidateSchemeRules que implementa ValidateSchemeRules debe ser reemplazado 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 metadatos. Esto identifica qué tipo de mensaje ISO 20022 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 implemente según 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 versiones de servicio 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 faltarán en las respuestas, causando 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 el servicio csm recibido no envía un pacs.002(PAY-15331)

SEPA CT CSM

Nuevo

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

Fijo

  • Se eliminó la pluralización de las etiquetas ofensivas 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 de Archivo Completo' (denotado por el FileRjctRsn campo que no sea 'A00' o 'A01') a System Event de tipo FileRejected se elevará y el flujo de 'enviar' permanecerá en un estado pasivado de 'Esperando Respuestas del Esquema'. (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

  • Los siguientes eventos del sistema han sido reubicados a sepa-common con su paquete actualizado (PAY-14419)

    • BulkCommandFailed

    • ReceiveFromSchemeExtensionPointFailed

    • SendingSchemeResponseFailed

    • SendToSchemeExtensionPointFailed

    • SendToSchemeExtensionPointSuccess

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

SEPA DD CSM

Nuevo

  • Añada 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.non-eea-debtor-address-validation-outbound.enabled = 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.debtor-address-structural-validation-outbound.enabled = 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.validation.pacs003.creditor-address-structural-validation-outbound.enabled = 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 admite 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).

  • Incapaz de procesar ValidateCollectAndSettleSchemeRulesRequest si hay un error de validación del esquema (PAY-15023)

  • Elimine las transacciones fallidas de bulking y aumentar RegisterBulkCorrelationFailed evento del sistema 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 falla, de modo que podamos enviar las transacciones exitosas al agrupador 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 de COLLECTANDSETTLE_TECHNICAL_RESPONSE to DIRECTDEBIT_TECHNICAL_RESPONSE

    • Cambio del valor predeterminado de la cola JMS de collectandsettle.technical.response to directdebit.technical.response

  • Las colas/temas de Domiciliación Bancaria ahora son por dirección y rol únicamente (es decir, de deudor a CSM/de CSM a deudor), en lugar de por dirección, rol y tipo de mensaje (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)

  • Se añadió soporte para transacciones Pacs. 007 durante la generación de archivos DVF y RSF de Débito Directo (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

  • Usando no SpeL expresiones 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 usar SpEL para mejorar los datos generados (PAY-14008)

  • Usando no SpeL expresiones 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 pds versionados.mappings en el Procesador de Métricas IPF.

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

NOTA

Mientras PDS La versionado 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 el versionado 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 eventos 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)

VoP Solicitante

Obsoleto Kafka Encabezados

  • Los siguientes encabezados están ahora obsoletos (PAY-15687) y serán eliminados en la versión 2025.4.0 de IPF:

    • requestId

    • processingEntity

  • Los encabezados de reemplazo equivalentes que se deben utilizar en adelante son:

    • ipf_processing_context_client_request_id

    • ipf_processing_context_processing_entity

VoP Responder

Nuevo

  • Filtrado por País

    • Funcionalidad añadida para filtrar VoP solicitudes basadas en el 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 2025.4.0 de IPF:

    • 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.