Madrid, 25 de Diciembre de 2010

PROYECTO SEPA
FICHERO DE LOTES

TIPO DE DOCUMENTO

REFERENCIA:

DEFINICION

LOTES

VERSIN

AUTOR

OTROS

1.4

Jose Luis Hoyas Candela

Notificamos. Publicamos. Certificamos.

www.logalty.co
m

info@logalty.com

Hermosilla, 3
28001 Madrid

Documento Confidencial
Manual de Usuario CAF Madrid

Copyright Logalty 2005-2010

Todos los derechos reservados

Prioridad de produccin:
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

Versin n: 1.4

Notificamos. Publicamos. Certificamos.

www.logalty.co
m

Documento Confidencial

1 ndice
1

ndice ....................................................................................................................................... 3

Control de versin .................................................................................................................. 4

2.1

Historial Revisin............................................................................................................... 4

2.2

Cuadro RACI .................................................................................................................... 4

Introduccin ............................................................................................................................ 5
3.1

Propsito ........................................................................................................................... 5

3.2

mbito del Sistema ......................................................................................................... 5

Descripcin General .............................................................................................................. 5

4.1

Formato de fichero por lotes ......................................................................................... 5

4.1.1

Fichero TXT para generacin de PDF. .................................................................. 5

Validaciones sobre los campos ........................................................................................... 7

Otras validaciones.................................................................................................................. 9

Tcnica para construir un fichero de datos ....................................................................... 9

7.1

Desde un fichero EXCEL ................................................................................................. 9

7.1.1

Paso Inicial ................................................................................................................ 9

7.1.2

Exportacin.............................................................................................................10

7.1.3

Preparacin ............................................................................................................10

7.2

Desde una base de datos ACCESS ............................................................................12

7.2.1

Paso Inicial ..............................................................................................................12

7.2.2

Exportacin.............................................................................................................13

7.2.3

Preparacin ............................................................................................................13

Notificamos. Publicamos. Certificamos.

www.logalty.co
m

Documento Confidencial

2 Control de versin
2.1 Historial Revisin
Responsabilidad
(autor)

Descripcin

2-3-2011

Jose Luis Hoyas

Creacin

1.1

13-05-2011

Jose Luis Hoyas

Tamaos 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

Tcnicas para
construccin del fichero
desde Excel y Access

Version n.

Fecha

1.0

Autorizacin

2.2 Cuadro RACI

Cdigos utilizados en el cuadro RACI.
*

Autorizacin

Permitido cualquier cambio en

el documento

Responsable de la tarea

Responsable de la creacin del

documento

Responsable de resultados

Responsable de resultados de
precisin de este documento

Apoyo

Ofrece servicios de apoyo en la

produccin
de
este
documento

Consultado

Ofrece informacin

Informado

Debe
ser
informado
cualquier cambio

de

Nombre

Posicin

Jos Luis Hoyas Candela

Direccin Servicios Gestionados X

Jos Luis Martnez Tllez

Direccin Tcnica

Notificamos. Publicamos. Certificamos.

www.logalty.co
m

Documento Confidencial

3 Introduccin
3.1 Propsito
El propsito de este documento es definir el fichero de carga de datos para la
generacin automtica de e-Mandatos en el Portal SEPA.

3.2 mbito del Sistema

Dentro del Portal SEPA, existir la posibilidad de crear automticamente los e-Mandatos
a travs de una carga masiva, mediante un fichero de texto.

4 Descripcin General
4.1 Formato de fichero por lotes
Dentro de las opciones de generacin de e-Mandatos existe la posibilidad de cargar
ficheros con lotes de envos. A continuacin se detallan las especificaciones y
requerimientos de estos ficheros.
4.1.1

FICHERO TXT PARA GENERACIN DE PDF.

La especificacin del fichero Datos_Envios.txt es la siguiente:

La primera lnea del fichero indicar la codificacin de los caracteres, segn el
formato:
CHARSET=XXXXXXXXXX.
Los charsets soportados en cualquier versin 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. 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 carcter separador entre campos deber ser parametrizable y podr

cambiar. Por ahora, se ha decidido que sea el carcter ; (Punto y coma) .
Este carcter no podr formar parte de ningn campo del fichero como
contenido.
Todos los campos son obligatorios, los campos indicados como Informado
deben ser informados, la informacin del resto de campos es opcional.
La lista de campos ser la siguiente:

Campo

Descripcin

Informado
SEPA

NO SEPA

DATOS SLO PARA LA NOTIFICACION ELECTRNICA

EMAIL

e-mail recepcin

SI

SI

TLF.MOVIL

Mvil 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. identificacin legal

SI

SI

REFERENCIA

Referencia
nica
Domiciliacin

No

No

DIRECCION

Direccin del Deudor

SI

SI

POBLACIN

Poblacin del Deudor

SI

SI

PROVINCIA

Provincia del Deudor

SI

SI

COD_POSTAL

Cdigo postal/ciudad del Deudor

SI

SI

PAIS

Pas de residencia
(Codigo ISO 3166)

SI

SI

Notificamos. Publicamos. Certificamos.

www.logalty.co
m

Generacin

del

Orden

del

E-

de

Deudor

Documento Confidencial

Campo

Descripcin

Informado
SEPA

NO SEPA

CUENTA

Nmero de cuenta [IBAN] del Deudor

SI

No

BANCO DEUDOR

Cdigo BIC (SWIFT) del Banco Deudor

SI

No

Cdigo Comercial

Cdigo Comercial del Acreedor.

SI

No

TIPO_PAGO

Tipo de pago

SI

SI

ID_DEUDOR

Cdigo de identificacin del Deudor

No

No

REF_DEUDOR

Nombre de la Parte de referencia del

Deudor.

No

No

ID_REF_DEUDOR

Cdigo de identificacin de la Parte

de referencia del Deudor

No

No

REF_ACREEDOR

Nombre de la Parte de referencia del

Acreedor

No

No

ID_REF_ACREEDOR

Cdigo de identificacin de la Parte

de referencia del Acreedor

No

No

ID_CONTRATO

Identificador
subyacente

No

No

DESC_CONTRATO

Descripcin del contrato

No

No

NOMBRE_BANCO_DEUDOR Nombre del Banco del Deudor

No

No

CCC_DEUDOR

Cdigo 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

Validacin
Codigo ISO de Pais e Idioma (es-ES).

NOMBRE

200

No se realizar ninguna validacin

APELLIDOS

200

No se realizar ninguna validacin

Notificamos. Publicamos. Certificamos.

www.logalty.co
m

Documento Confidencial

Campo
DNI/NIF

Longitud
9

Validacin
Campo formado por 8 dgitos y una letra 7
dgitos y 2 letras, en formato CIF / NIF / NIE. No
se verifica su validez, slo se verifica el
formato.

EMAIL

100

Se validar el formato de direccin email.

TLF. MOVIL

12

Nmero de telfono MOVIL en

internacional. Ejemplo: +34666777888.

DIRECCIN

140

No se realizar ninguna validacin

POBLACIN

50

No se realizar ninguna validacin

PROVINCIA

50

No se realizar ninguna validacin

COD. POSTAL

25

No se realizar ninguna validacin

PAIS

cdigo ISO 3166 de Pas

REFERENCIA

100

Referencia de la Orden de Domiciliacin 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 validacin

BANCO DEUDOR

11

No se realizar ninguna validacin

Cdigo Comercial

No se realizar ninguna validacin

TIPO_PAGO

Valores posibles:

ID_DEUDOR

36

PUNTUAL

PERIODICO
No se realizar ninguna validacin

REF_DEUDOR

35

No se realizar ninguna validacin

ID_REF_DEUDOR

35

No se realizar ninguna validacin

REF_ACREEDOR

35

No se realizar ninguna validacin

ID_REF_ACREEDOR

35

No se realizar ninguna validacin

ID_CONTRATO

35

No se realizar ninguna validacin

Notificamos. Publicamos. Certificamos.

www.logalty.co
m

Documento Confidencial

forma

Campo
DESC_CONTRATO

Longitud
35

Validacin
No se realizar ninguna validacin

NOMBRE_BANCO_DEUDOR 35

No se realizar ninguna validacin

CCC_DEUDOR

23

No se realizar ninguna validacin (El dato

deber venir formateado)

TIPO_ORDEN

Deber tener los valores:

ESEPA -> Orden de Domiciliacin SEPA CORE
BSEPA -> Orden de Domiciliacin SEPA B2B
NSEPA --> Orden de Domiciliacin No SEPA

6 Otras validaciones
El proceso considerar que un item de informacin es ERRONEO, y por tanto no pasar
a formar parte de los envos de una Operacin 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 Envo que hay que realizar.
2. Existen datos incorrectos que no permiten la generacin del e-Mandato.

7 Tcnica 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. Sera
interesante que, a efectos de verificar que todos los datos estn situados en la
columna correcta, incluyamos una lnea 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

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

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

EXPORTACIN

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

PREPARACIN

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 recomendacin, podemos utilizar un editor de texto gratuito llamado
NOTEPAD++. Se puede bajar de la pgina web siguiente y su instalacin 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 botn derecho y seleccionar Editar con Notepad++.
Debemos
encontrarnos algo como esto:

Si nos encontrsemos que el separador de lneas no es el punto y coma,

deberemos cambiarlo:

Notificamos. Publicamos. Certificamos.

www.logalty.co
m

Documento Confidencial

12

Insertar en la primera lnea el texto: CHARSET=UTF-8

Seleccionar Todo el contenido del fichero (Editar Seleccionar Todo)

Convertir el fichero a UTF-8 (Codificacin 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

Cdigo Comercial

CCC_DEUDOR

DNI/NIF

TIPO_PAGO

TIPO_ORDEN

REFERENCIA

ID_DEUDOR

DIRECCION

REF_DEUDOR

POBLACIN

ID_REF_DEUDOR

PROVINCIA

REF_ACREEDOR

Notificamos. Publicamos. Certificamos.

www.logalty.co
m

Documento Confidencial

7.2.2

EXPORTACIN

Esta pantalla de exportacin es similar en distintas versiones de Access, la idea es

seleccionar la opcin de exportar a fichero de texto.
Una vez en esta pantalla, se debe prestar atencin a todos los elementos que estn en
rojo, de modo que todos estos parmetros queden de la forma indicada:

7.2.3

Guardar el fichero con el nombre Datos_Envios.txt..

PREPARACIN

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 recomendacin, podemos utilizar un editor de texto gratuito llamado

NOTEPAD++. Se puede bajar de la pgina web siguiente y su instalacin es muy
simple:
http://notepad-plus-plus.org/

info@logalty.com
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 botn derecho y seleccionar Editar con Notepad++.
Debemos
encontrarnos algo como esto:

Si nos encontrsemos que el separador de lneas 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 lnea el texto: CHARSET=UTF-8

Guardar el fichero

Notificamos. Publicamos. Certificamos.

www.logalty.co
m

Documento Confidencial
ARS_SEPA_FICHERO 13/09/11

15