Madrid, 25 de Diciembre de 2010 PROYECTO SEPA FICHERO DE LOTES TIPO DE DOCUMENTO REFERENCIA: DEFINICION LOTES VERSIÓN AUTOR OTROS 1.4 Jose Luis Hoyas Candela - Notificamos. Publicamos. Certificamos. www.logalty.co m [email protected] Hermosilla, 3 28001 Madrid Documento Confidencial Manual de Usuario CAF Madrid Copyright © Logalty 2005-2010 Todos los derechos reservados 2 Prioridad de producción: Fecha objetivo: Aprobado por: Nombre de usuario, departamento Fecha Preparado por: Nombre de usuario, departamento Fecha Nombre de archivo: ARS_SEPA_FICHERO_v1_4.doc Versión nº: 1.4 Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial 3 1 Índice 1 Índice ....................................................................................................................................... 3 2 Control de versión .................................................................................................................. 4 2.1 Historial Revisión............................................................................................................... 4 2.2 Cuadro RACI .................................................................................................................... 4 3 Introducción ............................................................................................................................ 5 3.1 Propósito ........................................................................................................................... 5 3.2 Ámbito del Sistema ......................................................................................................... 5 4 Descripción General .............................................................................................................. 5 4.1 Formato de fichero por lotes ......................................................................................... 5 4.1.1 Fichero TXT para generación de PDF. .................................................................. 5 5 Validaciones sobre los campos ........................................................................................... 7 6 Otras validaciones.................................................................................................................. 9 7 Técnica para construir un fichero de datos ....................................................................... 9 7.1 Desde un fichero EXCEL ................................................................................................. 9 7.1.1 Paso Inicial ................................................................................................................ 9 7.1.2 Exportación.............................................................................................................10 7.1.3 Preparación ............................................................................................................10 7.2 Desde una base de datos ACCESS ............................................................................12 7.2.1 Paso Inicial ..............................................................................................................12 7.2.2 Exportación.............................................................................................................13 7.2.3 Preparación ............................................................................................................13 Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial 4 2 Control de versión 2.1 Historial Revisión Responsabilidad (autor) Descripción 2-3-2011 Jose Luis Hoyas Creación 1.1 13-05-2011 Jose Luis Hoyas Tamaños de datos 1.2 13-09-2011 Jose Luis Hoyas Nuevos Datos para NO SEPA 1.3 22-09-2011 Jose Luis Hoyas SEPA B2B. Cambios en validaciones 1.3.1 29-09-2011 Jose Luis Hoyas Banco Deudor no obligatorio 1.4 20-10-2011 José Luis Hoyas Técnicas para construcción del fichero desde Excel y Access Version n.º Fecha 1.0 Autorización 2.2 Cuadro RACI Códigos utilizados en el cuadro RACI. * Autorización Permitido cualquier cambio en el documento R Responsable de la tarea Responsable de la creación del documento A Responsable de resultados Responsable de resultados de precisión de este documento S Apoyo Ofrece servicios de apoyo en la producción de este documento C Consultado Ofrece información I Informado Debe ser informado cualquier cambio de Nombre Posición * R A S C I José Luis Hoyas Candela Dirección Servicios Gestionados X X X X X X José Luis Martínez Téllez Dirección Técnica X X X X Notificamos. Publicamos. Certificamos. www.logalty.co m X Documento Confidencial 5 3 Introducción 3.1 Propósito El propósito de este documento es definir el fichero de carga de datos para la generación automática de e-Mandatos en el Portal SEPA. 3.2 Ámbito del Sistema Dentro del Portal SEPA, existirá la posibilidad de crear automáticamente los e-Mandatos a través de una carga masiva, mediante un fichero de texto. 4 Descripción General 4.1 Formato de fichero por lotes Dentro de las opciones de generación de e-Mandatos existe la posibilidad de cargar ficheros con lotes de envíos. A continuación se detallan las especificaciones y requerimientos de estos ficheros. 4.1.1 FICHERO TXT PARA GENERACIÓN DE PDF. La especificación del fichero “Datos_Envios.txt” es la siguiente: La primera línea del fichero indicará la codificación de los caracteres, según el formato: CHARSET=XXXXXXXXXX. Los charsets soportados en cualquier versión de Java y que todas las implementaciones Java soportan son: 1. US-ASCII 2. ISO-8859-1 3. UTF-8 4. UTF-16BE 5. UTF-16LE Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial 6 6. UTF-16 Sobre el resto de charset de distintas implementaciones de JVM, no se garantiza su soporte entre versiones y se advierte que el comportamiento puede variar entre ellas. El carácter separador entre campos deberá ser parametrizable y podrá cambiar. Por ahora, se ha decidido que sea el carácter “;” (Punto y coma) . Este carácter no podrá formar parte de ningún campo del fichero como contenido. Todos los campos son obligatorios, los campos indicados como Informado deben ser informados, la información del resto de campos es opcional. La lista de campos será la siguiente: Campo Descripción Informado SEPA NO SEPA DATOS SÓLO PARA LA NOTIFICACION ELECTRÓNICA EMAIL e-mail recepción SI SI TLF.MOVIL Móvil para avisos SMS SI SI Si SI DATOS PARA EL E-MANDATO LANGUAGE Lenguaje de MANDATO NOMBRE/RAZON SOCIAL Nombre del Deudor Si SI APELLIDOS Apellidos del Deudor No No DNI/NIF Num. identificación legal SI SI REFERENCIA Referencia Única Domiciliación No No DIRECCION Dirección del Deudor SI SI POBLACIÓN Población del Deudor SI SI PROVINCIA Provincia del Deudor SI SI COD_POSTAL Código postal/ciudad del Deudor SI SI PAIS País de residencia (Codigo ISO 3166) SI SI Notificamos. Publicamos. Certificamos. www.logalty.co m Generación del Orden del E- de Deudor Documento Confidencial 7 Campo Descripción Informado SEPA NO SEPA CUENTA Número de cuenta [IBAN] del Deudor SI No BANCO DEUDOR Código BIC (SWIFT) del Banco Deudor SI No Código Comercial Código Comercial del Acreedor. SI No TIPO_PAGO Tipo de pago SI SI ID_DEUDOR Código de identificación del Deudor No No REF_DEUDOR Nombre de la Parte de referencia del Deudor. No No ID_REF_DEUDOR Código de identificación de la Parte de referencia del Deudor No No REF_ACREEDOR Nombre de la Parte de referencia del Acreedor No No ID_REF_ACREEDOR Código de identificación de la Parte de referencia del Acreedor No No ID_CONTRATO Identificador subyacente No No DESC_CONTRATO Descripción del contrato No No NOMBRE_BANCO_DEUDOR Nombre del Banco del Deudor No No CCC_DEUDOR Código Cuenta del Deudor No SI TIPO_ORDEN TIPO DE ORDEN A EMITIR SI SI del contrato 5 Validaciones sobre los campos Las validaciones a realizar sobre cada uno de ellos son las siguientes: Campo LANGUAGE Longitud 15 Validación Codigo ISO de Pais e Idioma (es-ES). NOMBRE 200 No se realizará ninguna validación APELLIDOS 200 No se realizará ninguna validación Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial 8 Campo DNI/NIF Longitud 9 Validación Campo formado por 8 dígitos y una letra ó 7 dígitos y 2 letras, en formato CIF / NIF / NIE. No se verifica su validez, sólo se verifica el formato. EMAIL 100 Se validará el formato de dirección email. TLF. MOVIL 12 Número de teléfono MOVIL en internacional. Ejemplo: +34666777888. DIRECCIÓN 140 No se realizará ninguna validación POBLACIÓN 50 No se realizará ninguna validación PROVINCIA 50 No se realizará ninguna validación COD. POSTAL 25 No se realizará ninguna validación PAIS 2 código ISO 3166 de País REFERENCIA 100 Referencia de la Orden de Domiciliación para el Acreedor. Deberá ser única para el Acreedor y en él recae la responsabilidad de esta regla. Si no se informa, se utilizará la Referencia Única Universal del Portal. CUENTA 34 No se realizará ninguna validación BANCO DEUDOR 11 No se realizará ninguna validación Código Comercial 3 No se realizará ninguna validación TIPO_PAGO 9 Valores posibles: ID_DEUDOR 36 PUNTUAL PERIODICO No se realizará ninguna validación REF_DEUDOR 35 No se realizará ninguna validación ID_REF_DEUDOR 35 No se realizará ninguna validación REF_ACREEDOR 35 No se realizará ninguna validación ID_REF_ACREEDOR 35 No se realizará ninguna validación ID_CONTRATO 35 No se realizará ninguna validación Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial forma 9 Campo DESC_CONTRATO Longitud 35 Validación No se realizará ninguna validación NOMBRE_BANCO_DEUDOR 35 No se realizará ninguna validación CCC_DEUDOR 23 No se realizará ninguna validación (El dato deberá venir formateado) TIPO_ORDEN 5 Deberá tener los valores: ESEPA -> Orden de Domiciliación SEPA CORE BSEPA -> Orden de Domiciliación SEPA B2B NSEPA --> Orden de Domiciliación No SEPA 6 Otras validaciones El proceso considerará que un item de información es ERRONEO, y por tanto no pasará a formar parte de los envíos de una Operación si se da alguno de los siguientes casos: 1. Como resultado del tratamiento del un item correspondiente a un Destinatario (archivo Datos_Envios.txt) no existen todos los datos establecidos como obligatorios para el Tipo de Envío que hay que realizar. 2. Existen datos incorrectos que no permiten la generación del e-Mandato. 7 Técnica para construir un fichero de datos 7.1 Desde un fichero EXCEL 7.1.1 PASO INICIAL Partiremos de la base de que tenemos todos los datos en un fichero Excel. Sería interesante que, a efectos de verificar que todos los datos están situados en la columna correcta, incluyamos una línea de cabecera de datos del tipo: Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial 10 E M A I L T L F . M O V I L L A N G U A G E N O M B RE /R A Z O N S O CI A L A P E L LI D O S D N I / N I F R E F E R E N C I A D I R E C C I O N P O B L A C I Ó N P R O V I N C I A C O D _ P O S T A L P A I S C U E N T A B A N C O C ó d i g o D C E o U m D e O r R c i a l TI P O _ P A G O I D _ D E U D O R R E F _ D E U D O R ID _ R EF _ D E U D O R R EF _ A C R EE D O R ID _R EF _A C RE ED O R I D _ C O N T R A T O D ES C _ C O NT R AT O NO MB RE_ BA NC O_ DE UD OR C C C _ D E U D O R TI P O _ O R D E N Esta cabecera debe ser eliminada una vez depurado el fichero, antes de exportar los datos. 7.1.2 EXPORTACIÓN Una vez verificado que el fichero es correcto, guardar el fichero en formato CSV, con el nombre Datos_Envios.csv Renombrar el fichero con el nombre Datos_Envios.txt (No nos dejará si no salimos de Excel). 7.1.3 PREPARACIÓN Con objeto de preparar el fichero para ser entendido por el sistema, hay que editarlo con un editor de textos especializado. No es suficiente utilizar el NOTEPAD o el WORDPAD, sino que tenemos que utilizar un editor que gestione CHARSETS (la forma en que se codifican los caracteres). Como recomendación, podemos utilizar un editor de texto gratuito llamado NOTEPAD++. Se puede bajar de la página web siguiente y su instalación es muy simple: http://notepad-plus-plus.org/ Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial 11 Una vez instalado, para editar el fichero Datos_Envios.txt basta con situarse sobre él, pulsar botón derecho y seleccionar “Editar con Notepad++”. Debemos encontrarnos algo como esto: Si nos encontrásemos que el separador de líneas no es el punto y coma, deberemos cambiarlo: Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial 12 Insertar en la primera línea el texto: CHARSET=UTF-8 Seleccionar Todo el contenido del fichero (Editar – Seleccionar Todo) Convertir el fichero a UTF-8 (Codificación – Convertir a UTF-8 sin BOM). Guardar el fichero 7.2 Desde una base de datos ACCESS 7.2.1 PASO INICIAL Partiremos de la base de que tenemos todos los datos en una tabla Access que incluye los siguientes campos: EMAIL COD_POSTAL ID_REF_ACREEDOR TLF.MOVIL PAIS ID_CONTRATO LANGUAGE CUENTA DESC_CONTRATO NOMBRE/RAZON SOCIAL BANCO DEUDOR NOMBRE_BANCO_DEUDOR APELLIDOS Código Comercial CCC_DEUDOR DNI/NIF TIPO_PAGO TIPO_ORDEN REFERENCIA ID_DEUDOR DIRECCION REF_DEUDOR POBLACIÓN ID_REF_DEUDOR PROVINCIA REF_ACREEDOR Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial 7.2.2 EXPORTACIÓN Esta pantalla de exportación es similar en distintas versiones de Access, la idea es seleccionar la opción de exportar a fichero de texto. Una vez en esta pantalla, se debe prestar atención a todos los elementos que están en rojo, de modo que todos estos parámetros queden de la forma indicada: 7.2.3 Guardar el fichero con el nombre Datos_Envios.txt.. PREPARACIÓN Con objeto de preparar el fichero para ser entendido por el sistema, hay que editarlo con un editor de textos especializado. No es suficiente utilizar el NOTEPAD o el WORDPAD, sino que tenemos que utilizar un editor que gestione CHARSETS. Como recomendación, podemos utilizar un editor de texto gratuito llamado NOTEPAD++. Se puede bajar de la página web siguiente y su instalación es muy simple: http://notepad-plus-plus.org/ [email protected] Tel. +34 915 145 800 Hermosilla, 3 28001 Madrid Documento Confidencial ARS_SEPA_FICHERO 13/05/11 Copyright © Logalty 2005-2010 Todos los derechos reservados ¡Error! Utilice la ficha Inicio para aplicar Title al texto que desea que aparezca aquí. ¡Error! Utilice la ficha Inicio para aplicar Heading 1 al texto que desea que aparezca aquí. Una vez instalado, para editar el fichero Datos_Envios.txt basta con situarse sobre él, pulsar botón derecho y seleccionar “Editar con Notepad++”. Debemos encontrarnos algo como esto: Si nos encontrásemos que el separador de líneas no es el punto y coma, deberemos cambiarlo: Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial ARS_SEPA_FICHERO 13/09/11 14 ¡Error! Utilice la ficha Inicio para aplicar Title al texto que desea que aparezca aquí. ¡Error! Utilice la ficha Inicio para aplicar Heading 1 al texto que desea que aparezca aquí. Insertar en la primera línea el texto: CHARSET=UTF-8 Guardar el fichero Notificamos. Publicamos. Certificamos. www.logalty.co m Documento Confidencial ARS_SEPA_FICHERO 13/09/11 15