SEPA Tabla de Conversión
Descripción general
Mientras que ISO 20022 XML los estándares de mensajes permiten el conjunto completo de caracteres UNICODE UTF-8, el Consejo Europeo de Pagos (EPC) recomienda restringir el uso al Conjunto de Caracteres Latinos Básicos a menos que se acuerde lo contrario. Cualquier carácter fuera de este conjunto permitido puede ser convertido de acuerdo con el SEPA Tabla de conversión que está disponible here
El Reemplazo de caracteres la biblioteca proporciona el mecanismo para realizar conversiones de caracteres, y el SEPA La biblioteca de la Tabla de Conversión proporciona los predefinidos SEPA conversión mappings. Esto facilita la configuración del reemplazador de caracteres para realizar conversiones de acuerdo con SEPA especificaciones.
Conjunto de Caracteres Permitidos
El EPC recomienda los siguientes caracteres:
letras minúsculas:
a b c d e f g h i j k l m n o p q r s t u v w x y z
Mayúsculas:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Dígitos:
0 1 2 3 4 5 6 7 8 9
Caracteres especiales:
/ -?: ( )., ' +
Space
Conversión recomendada
La biblioteca de reemplazo de caracteres sigue las recomendaciones de EPC:
-
Se aceptan caracteres que pertenecen al conjunto básico de latín y no necesitan ser convertidos.
-
Caracteres fuera del conjunto básico de latín permitido pero definidos en el SEPA La tabla de conversión se convierte utilizando el recomendado mappings.
-
Cualquier carácter ISO no listado en el SEPA Tabla de Conversión — los caracteres que están fuera del conjunto básico de caracteres latinos o aquellos sin un reemplazo significativo serán convertidos a un punto (.)
| El SEPA La tabla de conversión puede estar sujeta a cambios. Por ejemplo, pueden ocurrir actualizaciones si el EPC amplía el conjunto básico de caracteres latinos o si un país que utiliza caracteres de idioma local no soportados se une. SEPA. |
Recomendaciones para la Presentación de Pagos
-
Los clientes deben esforzarse por enviar pagos con caracteres válidos. El SEPA La biblioteca de conversión ayuda a lograr esto aplicando conversiones de caracteres compatibles con EPC.
Usando SEPA Conversión en Personalizado Scheme Pack s
Los clientes que implementan sus propios paquetes de esquema pueden habilitar SEPA conversión de caracteres añadiendo el SEPA Tabla de conversión de dependencia y configuración del reemplazador de caracteres según sea necesario.
Maven Dependencia
Al utilizar el CSM La gestión de versiones de BOM, usted no necesita especificar una versión — el BOM proporcionará automáticamente una versión compatible.
<dependency>
<groupId>com.iconsolutions.ipf.payments.csm</groupId>
<artifactId>sepa-csm-character-replacement</artifactId>
</dependency>Configuración
La siguiente es la configuración para habilitar SEPA conversión de caracteres en custom paquetes de esquema. Esta configuración carga el SEPA Tabla de Conversión CSV y aplica las anulaciones necesarias para restringir la expansión de caracteres. Estas anulaciones garantizan que los valores convertidos no excedan los límites de longitud del campo, evitando así errores de validación de datos o truncamiento.
Estas anulaciones aseguran que cualquier carácter que normalmente se expandiría en múltiples caracteres sea reemplazado por un solo punto..)
character-replacements {
lookup-table-replacer {
enabled = true
csv-source = "classpath:sepa-conversion-csvs/SEPA_Conversion_All_Conversions.csv"
fallback-replacement = "."
overrides += {character-codepoint = "\\u0398", replacement = "."}
overrides += {character-codepoint = "\\u03A7", replacement = "."}
overrides += {character-codepoint = "\\u03A8", replacement = "."}
overrides += {character-codepoint = "\\u03B8", replacement = "."}
overrides += {character-codepoint = "\\u03C7", replacement = "."}
overrides += {character-codepoint = "\\u03C8", replacement = "."}
overrides += {character-codepoint = "\\u0416", replacement = "."}
overrides += {character-codepoint = "\\u0426", replacement = "."}
overrides += {character-codepoint = "\\u0427", replacement = "."}
overrides += {character-codepoint = "\\u0428", replacement = "."}
overrides += {character-codepoint = "\\u0429", replacement = "."}
overrides += {character-codepoint = "\\u0436", replacement = "."}
overrides += {character-codepoint = "\\u0446", replacement = "."}
overrides += {character-codepoint = "\\u0447", replacement = "."}
overrides += {character-codepoint = "\\u0448", replacement = "."}
overrides += {character-codepoint = "\\u0449", replacement = "."}
overrides += {character-codepoint = "\\u042E", replacement = "."}
overrides += {character-codepoint = "\\u042F", replacement = "."}
overrides += {character-codepoint = "\\u044E", replacement = "."}
overrides += {character-codepoint = "\\u044F", replacement = "."}
}
}
Referir Ejemplo de Configuración de Downstream para obtener orientación sobre la fusión de sobreescrituras adicionales con la configuración base.