Pblicos
RED_SPT_Especificacin_Interfaz_Organismo
Pg. 1 de 111
Captulo 1 NDICE
1.
INTRODUCCIN
1.1.
Propsito de la Interfaz
1.2.
Supuestos
1.2.1.
Horario de Funcionamiento
1.2.2.
Duplicacin de Operaciones
1.3.
2.
Terminologa
Procesos on-line
13
2.1.1.
16
2.1.2.
2.1.3.
19
2.1.4.
20
2.1.5.
Quinta
Parte:
Administrativo
21
2.1.6.
2.2.
3.
Finalizar
el
Procedimiento
Proceso de
Organismos
Mantenimiento
por
22
parte
de
los
23
DESCRIPCIN DE LA INTERFAZ
25
3.1.
Caractersticas
25
3.2.
26
3.2.1.
Nomenclatura
28
3.2.2.
29
Pg. 2 de 111
3.2.3.
4.
33
ESPECIFICACIN FUNCIONAL
37
4.1.
37
4.1.1.
Modalidades Tecnolgicas
37
4.1.2.
Caractersticas Generales
39
4.2.
4.3.
4.4.
4.5.
Modalidades Tecnolgicas
Formato de las
Organismo al SPT
solicitudes
43
enviadas
desde
el
46
4.3.1.
46
4.3.2.
4.3.3.
4.3.4.
52
4.4.2.
4.4.3.
4.4.4.
58
4.4.5.
59
Listas de Valores
4.5.1.
Codificacin
Colaboradoras
54
59
de
Entidades
Financieras
59
4.5.2.
59
4.5.3.
60
4.5.4.
Tipos de Peticiones
60
Pg. 3 de 111
4.6.
4.7.
4.8.
5.
60
4.5.6.
Codificacin Territorial
60
4.5.7.
Codificacin de Domiciliaciones
61
4.5.8.
61
4.5.9.
61
Transformaciones y Validaciones
64
4.6.1.
64
Validaciones
Transacciones
64
4.7.1.
64
4.7.2.
66
68
4.8.1.
Gestin de Errores
68
4.8.2.
Gestin de Excepciones
68
4.8.3.
69
4.8.4.
Mensajes de
Colaboradora
Error
de
la
Entidad
Financiera
72
OTRAS CONSIDERACIONES
77
5.1.
77
5.2.
Seguridad
78
5.3.
78
5.3.1.
Hardware
78
5.3.2.
Software
78
5.4.
6.
4.5.5.
Comunicaciones
80
81
6.1.
81
6.2.
81
6.3.
81
Pg. 4 de 111
7.
8.
6.4.
Tipos de Peticiones
81
6.5.
81
6.6.
Codificacin Territorial
82
6.7.
Codificacin de Domiciliaciones
82
6.8.
82
6.9.
82
6.10.
Codificacin de Idiomas
84
6.11.
84
6.12.
84
86
7.1.
Relacin de Validaciones
86
7.2.
7.3.
7.4.
7.5.
Pg. 5 de 111
93
Pg. 6 de 111
1. INTRODUCCIN
El presente documento describe la interfaz que rige el intercambio de informacin
entre el Servicio de Pago Telemtico (en adelante, SPT) de Red.es y los Sistemas de
Informacin de los Organismos Pblicos adheridos al SPT, a las que se le denomina
en el presente documento Organismos Acreedores (en adelante, OOAA),
correspondientes a los pagos de tributos, precios pblicos, y otros ingresos de
Derecho Pblico. Mediante esta interfaz, se especifica el mecanismo de intercambio
de informacin necesario para tramitar las Solicitudes de Pago de los Administrados
o Terceros Autorizados, mediante los distintos medios de pago.
En este documento se incluyen las diferentes especificaciones necesarias para
construir los componentes necesarios tanto en el SPT como en los sistemas de los
OOAA, que en conjunto darn soporte a las transacciones de pago de los Organismos
Pblicos. Por tanto, este documento de trabajo concreta y unifica los siguientes
aspectos:
Pg. 7 de 111
1.1.
Propsito de la Interfaz
La interfaz forma parte de los Procesos on-line definidos dentro del SPT, siendo el
mecanismo que permite el intercambio de las Solicitudes de Pago realizadas por los
Administrados y Terceros Autorizados desde los OOAA de las administraciones
pblicas, as como la informacin con la relacin de Ingresos.
En el siguiente esquema se muestra en qu punto del Proceso de Pago interviene
esta interfaz:
1.2.
1.2.1.
Supuestos
Horario de Funcionamiento
Esta previsto que el SPT tenga disponibilidad 24x7. Para ello, la interfaz debe tener
la posibilidad de solicitar y recibir respuesta en cualquier momento.
Pg. 8 de 111
No obstante, dado que cada EFC puede tener establecida una ventana horaria
asociada con este tipo de pagos (e, incluso, acordada con cada OA de forma
individual), el OA se encargar de informar, en cada uno de los casos, de la
disponibilidad real.
1.2.2.
Duplicacin de Operaciones
Cada uno de los sistemas, tanto del SPT como de los OOAA, se encargar de
verificar, en cada una de las fases, que no se produce la duplicacin de las
operaciones, tratando de garantizar al pagador, en la medida de lo posible, que no se
produce dos veces el mismo pago.
1.3.
Terminologa
Autenticar
Autoridad de
Certificacin
Certificado
Electrnico
Firma
Electrnica
NRC
Siglas
correspondientes
a
Nmero
Completo, en el contexto del SPT.
de
Referencia
Pg. 11 de 111
Nmero de
Justificante
Representante
Web Service
Pg. 12 de 111
2.1.
Procesos on-line
Pg. 13 de 111
Pg. 14 de 111
5. Una vez confirmado el pago, se procede al envo del justificante del mismo. Este
justificante se presentar en un formato que permitir al administrado tanto el
almacenamiento digital en su ordenador como su impresin.
A continuacin se explican en mayor detalle cada uno de estos grupos de
operaciones.
Pg. 15 de 111
2.1.1.
prestador del servicio (Red.es) toda la informacin necesaria para realizar el pago
telemtico.
Pg. 17 de 111
2.1.2.
2.1.3.
La tercera parte del proceso on-line consiste en la ejecucin de la orden de pago por
parte de la Entidad Financiera Colaboradora, recibiendo el Servicio de Pago
Telemtico el justificante de pago correspondiente.
Pg. 19 de 111
2.1.4.
Pg. 20 de 111
2.1.5.
La ltima parte del proceso incluye todos los pasos necesarios que haya establecido
el Organismo Acreedor para finalizar el procedimiento administrativo. Desde el punto
de vista del pago telemtico, al menos incluir la presentacin de las
autoliquidaciones y la devolucin del Nmero de Justificante Completo (NJC).
Pg. 21 de 111
2.1.6.
Pg. 22 de 111
2.2.
El proceso de Mantenimiento por parte de los Organismos sirve para que stos
puedan llevar a cabo tareas especficas sobre la informacin del Servicio de Pago
Telemtico que puede ser alterada directamente por cada Organismo Acreedor (por
ejemplo, la lista de Entidades Financieras Colaboradoras con las que ha llegado a un
acuerdo y, a travs de las cuales, pueden ser seleccionadas por un administrado
para realizar sus rdenes de pago).
Para poder llevar a cabo este Mantenimiento, cada Organismo deber nombrar un
responsable.
Pg. 23 de 111
Pg. 24 de 111
3. DESCRIPCIN DE LA INTERFAZ
3.1.
Caractersticas
Durante un proceso cualquiera de pago telemtico que vaya a realizarse a travs del
SPT de Red.es, la solicitud de pago mediante cargo en cuenta (con opcin de
domiciliacin) o tarjeta es enviada, una vez completado el formulario
correspondiente, desde el portal del OA, por medio del administrado, al propio
servicio. El SPT proceder a la validacin y solicitar su Firma Electrnica, para
remitir la peticin a la EFC, quien se encargar de la ejecucin el pago, de acuerdo a
sus propios sistemas y teniendo en cuenta las validaciones que considere necesarias.
Como siguiente paso de la operacin, devolver un mensaje indicando el resultado
obtenido. Este resultado, junto con otras posibles situaciones anmalas que puedan
producirse, es devuelto al Organismo.
El resultado podr suponer que la transaccin se ha ejecutado con xito,
proporcionando un Nmero de Referencia Completo (NRC) que justifica que el pago
ha sido efectuado. Si la transaccin no se puede completar con xito, proporcionar
un mensaje de error, en el que estar codificado el motivo por el cual no ha podido
ejecutarse el pago.
A partir de este punto, el SPT proceder a continuar la operacin en funcin de las
alternativas contempladas en el apartado 4.7.2 de este documento y que, en alguno
de estos casos, podr suponer el reenvo de la informacin, una vez modificado el
contexto de la propia operacin (por cambios en los datos de la solicitud de pago, o
por situacin de los diferentes sistemas que participan).
Todos estos intercambios de informacin debern cumplir con las especificaciones
detalladas en el presente documento.
Pg. 25 de 111
3.2.
Pg. 26 de 111
A continuacin se detallan todos los casos, con ejemplos para cada uno de ellos.
Pg. 27 de 111
3.2.1.
Nomenclatura
NIF Titular certificado: es NIF del titular del Certificado de Persona Fsica o el
CIF del titular en el caso de Certificado de Persona Jurdica. Se corresponde
con el campo nif_cert.
NIF Sujeto Pasivo: es el NIF o CIF del contribuyente o Sujeto Pasivo al que
corresponde el tributo o la tasa que se est pagando. Se corresponde con el
campo nif_cont.
Pg. 28 de 111
3.2.2.
3.2.2.1.
En este caso, el SPT verifica que el NIF del Titular del certificado se corresponde con
el NIF del Sujeto Pasivo.
EJEMPLO: Persona fsica que paga su tributo, impuesto o tasa en su propia cuenta.
Quin paga?
Juan Prez
NIF: 11111111A
NIF Representante 1
NIF: 11111111A
Juan Prez
NIF: 11111111A
0 - No es Tercero Autorizado.
Pg. 29 de 111
3.2.2.2.
CERTIFICADO
PERSONA FSICA
NIF Representante 1
CCC
En este caso, el SPT verifica que el NIF del titular del certificado se corresponde con
el NIF del Tercero Autorizado, recibido en el SPT a travs de la interfaz con el
Organismo.
Quin valida esa relacin de Tercero Autorizado? Existen dos opciones:
una persona jurdica. El pago se debe realizar con un medio de pago en el que el
propio Tercero Autorizado sea titular o est autorizado.
Pg. 31 de 111
EJEMPLO: Tercero Autorizado que paga tributos, impuestos o tasas del sujeto
pasivo (persona fsica o persona jurdica) en su propia cuenta o en aquella en la que
est autorizado.
Quin paga?
Carlos Martnez
NIF: 22222222B
NIF Representante 1
En nombre de quin paga?
NIF Sujeto Pasivo
Acreditacin Pagos por
Cuenta de Terceros
NIF: 22222222B
Juan Prez NIF: 11111111A s persona fsica.
o,
Coca-Cola CIF: C-33333333 si jurdica.
1 - Es Tercero Autorizado.
Pg. 32 de 111
3.2.3.
Estamos en el supuesto de pago de los tributos, impuestos o tasas del titular del
certificado, en el medio de pago de la persona fsica que aparece en el certificado o
en el de un tercero, siempre que se tenga dicha persona fsica las autorizaciones
correspondientes.
EJEMPLO: Persona jurdica que paga sus tributos, impuestos o tasas en la cuenta
corriente en la que est autorizado.
Coca-Cola
Quin paga?
CIF: C-33333333
NIF Representante 1
y en el que es autorizado:
Luis Gmez NIF: 33333333C.
Coca-Cola
CIF: C-33333333
0 - No es Tercero Autorizado.
Pg. 33 de 111
3.2.3.2.
CERTIFICADO
PERSONA JURDICA
NIF Representante 1
CCC
Este caso es similar al 3.2, con la utilizacin del Certificado de Persona Jurdica, en
lugar de Persona Fsica.
En este caso, el SPT nicamente realiza la verificacin de los datos del certificado.
Quin valida la relacin de Tercero Autorizado?
Pg. 34 de 111
Pg. 35 de 111
EJEMPLO: Tercero Autorizado (Persona jurdica, titular del certificado) que paga un
tributo, un impuesto o tasa del sujeto pasivo (persona fsica o jurdica) en un medio
de pago en que la Persona Fsica del Tercero Autorizado es titular o est autorizado.
Gestora Snchez
Quin paga?
CIF: D-44444444
Pg. 36 de 111
4. ESPECIFICACIN FUNCIONAL
4.1.
Modalidades Tecnolgicas
4.1.1.1.
Modalidad Web
Pg. 37 de 111
4.1.1.2.
Invocar a las funcionalidades (mtodo) de Pago del Web Services del SPT. La
estructura del mensaje SOAP a enviar al SPT se basara en el WSDL publicado
en la URL:
https://spt.red.es/PAGO/services/ServicioOrganismoWS?wsdl
y en los siguientes estndares:
Por ultimo los OOAA recogern la respuesta del Web Services remitida por el
SPT a la finalizacin del proceso de pago.
4.1.2.
Caractersticas Generales
4.1.2.1.
Reintentos de Pago
Referencia.
Referencia.
Concepto.
Identificacin.
Pg. 40 de 111
Pg. 41 de 111
4.2.
Pg. 42 de 111
4.2.1.
Modalidades Tecnolgicas
4.2.1.1.
Modalidad Web
La definicin del Web Services es la misma que para el proceso de pago, pero el
mtodo es diferente y es el de BusquedaSOP.
"estado" este campo permitir seleccionar las SOP por estado, sus
posibles valores son:
1--> 'Error recuperable' --> TO(Time Out), EC (Error de
Conexin)
2--> 'Pago efectuado' -->00
3--> 'Error no recuperable'-->NR (No recuperable)
4--> 'Pendiente respuesta' --> Estado temporal
vaco --> todos los estados
El mensaje SOAP deber estar firmado por una CA (reconocida por el SPT) del
Organismos Acreedor. En el caso de consulta nicamente se admite la firma
del Organismo.
Pg. 44 de 111
Pg. 45 de 111
4.3.
A continuacin se detallan los formatos a utilizar por el OA para enviar las solicitudes
de pago al SPT.
4.3.1.
Nombre
nif_cert
fecha
hora
cpr
pasarela
tipo
medio
eeffcc
ccc
importe
nif_rep1
nif_rep2
nom_cont
nom_rep1
nom_rep2
org
modelo
ejercicio
periodo
nif_cont
anagrama
22
23
24
25
26
241
247
255
268
293
6
8
13
25
4
AN
N
N
AN
AN
No
No
S
No
No
No
No
S
No
No
27 297
28 356
59
20
AN
AN
S
No
S
No
1
1
159
N
N
AN
S
S
S
S
S
No
29
30
31
Total
376
377
378
536
Cdigo territorial
Fecha de Devengo
Nmero del justificante
Informacin especfica
Concepto de la autoliquidacin
Campo reservado para Organismo
(reservado en WS)
Cdigo de superorganismo
Acreditacin Pagos por Cuenta de
Terceros
Idioma
URL de retorno
cod_terr
devengo
num_just
info
concepto
org_datos
superorganismo
acr_pagos
idioma
res
Pg. 47 de 111
4.3.2.
1
2
3
4
5
6
1
10
18
28
35
37
9
8
10
7
2
2
AN
N
N
N
N
N
Descripcin
Nombre
S
S
S
S
S
S
S
S
S
S
S
S
nif_cert
fecha
hora
cpr
pasarela
tipo
N
N
No
No
medio
eeffcc
N
N
AN
AN
AN
AN
No
S
No
No
No
No
N
N
N
N
N
N
S
S
S
S
S
No
S
S
S
S
S
No
org
referencia
ident_1
ident_2
cod_dom
ccc_dom
AN
AN
N
AN
S
No
S
S
S
No
S
No
7
8
39
40
1
4
9 44
10 64
11 76
12 85
13 94
14 134
20
12
9
9
40
40
ccc
importe
nif_rep1
nif_rep2
nom_rep1
nom_rep2
Datos Especficos
15
16
17
18
19
20
174
180
192
195
202
203
6
12
3
7
1
20
21
22
23
24
223
277
297
298
54
20
1
159
Total
456
Pg. 48 de 111
org_datos
superorganismo
idioma
res
Pg. 49 de 111
4.3.3.
1
2
3
4
5
6
1
10
18
28
35
37
9
8
10
7
2
2
AN
N
N
N
N
N
Descripcin
Nombre
S
S
S
S
S
S
S
S
S
S
S
S
nif_cert
fecha
hora
cpr
pasarela
tipo
N
N
No
No
S
S
medio
eeffcc
N
N
AN
AN
AN
AN
No
S
No
No
No
No
S
S
No
No
No
No
S
No
S
S
S
No
No
7
8
39
40
1
4
9 44
10 64
11 76
12 85
13 94
14 134
20
12
9
9
40
40
ccc
importe
nif_rep1
nif_rep2
nom_rep1
nom_rep2
Datos Especficos
15
16
17
18
19
20
21
174
180
192
205
214
217
225
6
12
13
9
3
8
20
N
AN
N
AN
N
N
AN
S
No
S
S *
S
No
No
22 245
23 300
55
20
AN
AN
S
No
24 320
25 321
26 322
1
1
159
N
N
AN
S
S
S
Total
480
Pg. 50 de 111
org
num_exp
num_just
nif_cont
cod_mod
devengo
info
org_datos
superorganismo
acr_pagos
idioma
res
Pg. 51 de 111
4.3.4.
1
2
3
4
5
6
1
10
18
28
35
37
9
8
10
7
2
2
AN
N
N
N
N
N
Descripcin
Nombre
WS
S
S
S
S
S
S
S
S
S
S
S
S
nif_cert
fecha
hora
cpr
pasarela
tipo
N
N
N
N
N
AN
AN
AN
AN
No
No
No
No
S
No
No
No
No
S
S
S
No
S
No
No
No
No
N
N
N
N
AN
N
N
AN
AN
S
S
S
S
S
S
No
S
No
S
S
S
S
S
S
No
S
No
7 39
8 40
9 44
10 64
11 68
12 80
13 89
14 98
15 138
1
4
20
4
12
9
9
40
40
Datos Especficos
16
17
18
19
20
21
22
23
24
178
186
189
202
208
217
218
238
292
25 312
26 313
27 314
Total
8
3
13
6
9
1
20
54
20
1 N
1 N
159 AN
No
S
S
472
Pg. 52 de 111
org
con_pago
referencia
identificacion
nif_cont
cod_dom
ccc_dom
org_datos
superorganismo
acr_pagos
idioma
res
Pg. 53 de 111
4.4.
A continuacin se detallan los formatos a utilizar para las respuestas del SPT, una
vez procesadas las rdenes de pago con la EFC.
4.4.1.
N
Pos Long Tipo Oblig
Datos COMUNES
1
2
3
4
5
6
1
10
18
28
35
37
9
8
10
7
2
2
AN
N
N
N
N
N
Descripcin
Nombre
S
S
S
S
S
S
nif_cert
fecha
hora
cpr
pasarela
tipo
N
N
N
No
No
S
medio
eeffcc
importe
org
modelo
ejercicio
periodo
nif_cont
cod_terr
devengo
num_just
info
concepto
7
8
9
39
40
44
1
4
12
Datos Especficos
10 56
11 61
12 64
13 68
14 70
15 79
16 85
17 93
18 106
19 131
5
3
4
2
9
6
8
13
25
4
N
N
N
AN
AN
AN
N
N
AN
AN
S
S
No
No
S
No
No
S
No
No
20
21
22
23
24
59
20
22
2
8
AN
AN
AN
AN
N
S
No
S
S
S
135
194
214
236
238
Total 245
Pg. 54 de 111
org_datos
superorganismo
nrc
cod_ret
fec_oper
Los campos 1 a 20 se corresponden con los campos utilizados para el clculo del
MAC enviado por el SPT. Los campos 22, 23 y 24, son aadidos por la respuesta de
la Entidad Financiera Colaboradora.
Pg. 55 de 111
4.4.2.
N
Pos Long Tipo Oblig
Datos COMUNES
1
2
3
4
5
6
1
10
18
28
35
37
9
8
10
7
2
2
AN
N
N
N
N
N
Descripcin
Nombre
S
S
S
S
S
S
nif_cert
fecha
hora
cpr
pasarela
tipo
N
N
N
S
S
S
medio
eeffcc
importe
org
referencia
ident_1
ident_2
7
8
9
39
40
44
1
4
12
Datos Especficos
10
11
12
13
56
62
74
77
6
12
3
7
N
N
N
N
S
S
S
S
14
15
16
17
18
84
138
158
180
182
54
20
22
2
8
AN
AN
AN
AN
N
S
No
S
S
S
org_datos
superorganismo
nrc
cod_ret
fec_oper
Total 189
Los campos 1 a 14 se corresponden con los campos utilizados para el clculo del
MAC enviado por el SPT. Los campos 16, 17 y 18, son aadidos por la respuesta de
la Entidad Financiera Colaboradora.
Pg. 56 de 111
4.4.3.
N
Pos Long
Datos COMUNES
Tipo Oblig
1
1
9 AN
2
10
8
N
3
18
10 N
4
28
7 N
5
35
2 N
6
37
2 N
Datos para el CARGO
7
39
1 N
8
40
4 N
9
44
12 N
Datos Especficos
10
56
6 N
11
62
13 N
12
74
3 N
13
77
8 N
14
15
16
17
18
Total
85
140
160
182
184
191
55
20
22
2
8
AN
AN
AN
AN
N
Descripcin
Nombre
S
S
S
S
S
S
nif_cert
fecha
hora
cpr
pasarela
tipo
No
No
S
medio
eeffcc
importe
S
S
S
No
org
num_just
cod_mod
devengo
S
No
S
S
S
org_datos
superorganismo
nrc
cod_ret
fec_oper
Los campos 1 a 14 se corresponden con los campos utilizados para el clculo del
MAC enviado por el SPT. Los campos 16, 17 y 18, son aadidos por la respuesta de
la Entidad Financiera Colaboradora.
Pg. 57 de 111
4.4.4.
1
2
3
4
5
6
1
10
18
28
35
37
9
8
10
7
2
2
AN
N
N
N
N
N
Descripcin
Nombre
WS
S
S
S
S
S
S
S
S
S
S
S
S
nif_cert
fecha
hora
cpr
pasarela
tipo
N
N
N
No
No
S
S
S
S
medio
eeffcc
importe
S
S
S
S
S
7
8
9
39
40
44
1
4
12
Datos Especficos
10
11
12
13
14
56
64
67
80
86
8
3
13
6
9
N
N
N
N
AN
S
S
S
S
S
15
16
17
18
19
95
149
169
191
199
54
20
22
8
2
AN
AN
AN
N
AN
S
No
S
S
S
Total
org
con_pago
referencia
identificacion
nif_cont
org_datos
superorganismo
nrc
fec_oper
cod_ret
180
Los campos 1 a 15 se corresponden con los campos utilizados para el clculo del
MAC enviado por el SPT. Los campos 17 a 19, son aadidos por la respuesta de la
Entidad Financiera Colaboradora.
El campo 14 (nif_cont) se podr rellenar a blanco para mantener compatibilidad con
versiones anteriores.
Pg. 58 de 111
4.4.5.
4.5.
Listas de Valores
Las listas de valores recogidas en el presente documento servirn para rellenar los
campos asociados de los formatos anteriormente definidos. Para cada caso, se
especifica la denominacin de la lista, los campos donde debe aplicarse y la operativa
contemplada ante las posibles modificaciones que en ellas puedan producirse.
En el Anexo 1 de este documento pueden verse ejemplos ilustrativos de cada una de
las listas de valores.
4.5.1.
Cdigo
4 posiciones (numrico)
4.5.2.
4.5.3.
Cdigo
2 pos. (numrico)
4.5.4.
Pasarela de Pago
Nombre de la Pasarela de Pago
Tipos de Peticiones
Cdigo
2 pos.(numrico)
4.5.5.
Tipo de Peticin
Nombre del Tipo de Peticin
Cdigo
2 pos.(numrico)
4.5.6.
Medio de Pago
Nombre del Medio de Pago
Codificacin Territorial
Pg. 60 de 111
Cdigo
6 pos.(numrico)
4.5.7.
Codificacin de Domiciliaciones
Cdigo
1 pos.(numrico)
4.5.8.
Tipo de Domiciliacin
Nombre del Tipo de Domiciliacin
El formato de la lista de valores utilizada para codificar los Tributos y los Conceptos
de Pago correspondientes a los ingresos municipales y otros adeudos de las
entidades emisoras, es la siguiente:
Cdigo
3 pos. (numrico)
4.5.9.
Denominacin
Nombre del Concepto de Pago
Denominacin
Pg. 61 de 111
4.5.10.
Cdigo IBAN
IBAN del CCC: posicin 47, 48, 49, 50. Ser informado siempre que el
usuario seleccione el pago por cuenta.
IBAN de la cuenta domiciliada: posicin 51, 52, 53, 54. Ser incluido
siempre que el usuario informe de la domiciliacin de un pago aportando el
correspondiente CCC.
1,2,3,447,48,49,50,51,52,53,54
ES70
1,2,3,447,48,49,50,51,52,53,54
Si se realiza un pago con tarjeta pero se domicilia el pago solo deber estar
informado el IBAN de la cuenta domiciliada.
En el caso de que la EEFF detecte que el cdigo IBAN es errneo devolver el cdigo
I8.
Pg. 63 de 111
4.6.
4.6.1.
Transformaciones y Validaciones
Validaciones
Las validaciones especifican cualquier regla que se aplique a los campos utilizados
para el intercambio, tanto de los datos enviados por el SPT como de los recibidos del
Organismo Acreedor. Solamente se indicarn validaciones concretas de los campos,
pero no estn incluidas reglas de negocio. En los casos de campos asociados con
listas de valores, la validacin corresponder a la verificacin del valor en la lista.
El Anexo II recoge las validaciones realizadas sobre la informacin transmitida en los
campos de la interfaz.
4.7.
Transacciones
Cada Solicitud de Pago gestionada por el SPT se considera como una transaccin que
ser tratada de acuerdo a un conjunto de situaciones y operaciones asociadas.
4.7.1.
Nm
Descripcin
Situacin
1
Creacin del registro de la Transaccin:
SPT: Nueva Transaccin
Cuando el SPT crea el registro correspondiente.
Firmada
2
Preparacin y Envo a la Entidad Financiera
Colaboradora:
SPT: Transaccin Enviada a
Cuando el SPT valida la informacin de pago y
EFC
enva el registro de la solicitud y correspondiente a
una EFC.
3
Perdida Conexin con la Entidad Financiera
Colaboradora: Cuando el SPT ha enviado una EFC: Perdida Conexin con
solicitud a la EFC, pero no recibe respuesta
EFC
despus de un tiempo predefinido.
4
Comunicacin al administrado para confirmacin de
USU: Comunicada
reintento:
Desconexin, Esperando
Cuando el SPT comunica al administrado que,
Reintento
durante el proceso, se ha producido una
Pg. 64 de 111
10
11
Pg. 65 de 111
4.7.2.
Pg. 66 de 111
Pg. 67 de 111
4.8.
4.8.1.
4.8.2.
Gestin de Excepciones
Pg. 68 de 111
4.8.3.
Descripcin
Error en el campo nif de certificado es obligatorio y no ha sido informado.
J1
J2
J3
J4
J5
J6
J7
J8
J9
JA
JB
JC
JD
JE
JF
JJ
JK
JG
JH
JI
JL
JM
JN
JO
JP
JQ
Pg. 69 de 111
JS
JT
JV
JW
JX
JY
JU
JZ
K0
K1
K2
K3
K7
K8
K4
K5
K6
K9
KA
KB
KC
KD
KE
KF
KG
KH
KI
KJ
KK
Pg. 70 de 111
KL
KM
KN
KO
KP
KQ
KR
KS
KT
KU
KV
KW
KX
KY
KZ
L0
L1
El cdigo de Validacin del organismo indica que debera venir el pago firmado
por el ciudadano y el organismo, y slo est firmado una vez.
No coinciden el nmero de serie del certificado con el existente en la B.B.D.D.
L2
L3
L5
El cdigo de Validacin del organismo indica que debera venir el pago firmado
slo por el organismo, y hay dos firmantes.
No coincide el nmero de serie de ningn firmante con el que est configurado
para el organismo.
Certificado no autorizado para el pago.
L6
Verificacin NO correcta.
L7
L8
Firma No Vlida
L9
LA
LB
LC
LE
L4
LF
LG
LH
El certificado no se encontr.
LI
LJ
LK
LL
LM
LQ
LR
LS
LT
LU
LV
4.8.4.
Descripcin
Operacin finalizada OK
Solicitud anulada
El certificado firmante no est autorizado para realizar el pago por
personas ajenas
El representante del certificado firmante no est autorizado para
realizar el pago por personas ajenas
Pg. 72 de 111
este modelo
7
10
11
12
13
14
Perodo errneo
15
Falta perodo
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
Anagrama errneo
32
Falta anagrama
33
Sobra anagrama
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
Perodo no permitido
53
54
55
Movimiento distinto de 01 y 02
56
57
58
59
60
61
62
63
Certificado caducado
64
Certificado revocado
65
66
67
68
69
70
71
72
C.C.C. cancelado
73
74
75
76
77
C.C.C. inexistente
78
C.C.C. inoperante
Pg. 74 de 111
79
80
81
82
83
84
MAC errneo
85
87
88
Contribuyente no identificado
89
90
91
92
93
94
95
99
Error tcnico
A4
NRC no existe
A6
NIF no existe
A7
A8
A9
NRC ya existe
B6
B8
NRC ya liberado
C1
Incoherencia de datos
C2
F2
H4
I3
I4
I6
86
Pg. 75 de 111
I7
I8
Pg. 76 de 111
5. OTRAS CONSIDERACIONES
5.1.
Peticin de Alta en las Entidades Financieras con las que se desea colaborar.
Existe una lista de contactos en la web de pago.
Poseer cuentas
Colaboradoras.
activas
en
Produccin
con
Pg. 77 de 111
las
Entidades
Financieras
5.2.
Seguridad
Los servidores del SPT y de cada Organismo utilizarn un Certificado Electrnico para
poder establecer un canal seguro SSL que garantice la seguridad de las operaciones
que supongan intercambio de informacin a travs de la interfaz.
5.3.
5.3.1.
Software
sistemas
operativos
(segn
Linux Ubuntu.
Linux Guadalinex.
MacOS X 10.5.
5.3.2.2.
La aplicacin se ha desarrollado para que sea compatible con las siguientes versiones
de navegadores:
Navegador
Microsoft Internet
Explorer
Google Chrome
Apple Safari
Opera
Ver. Min.
Ver.
Recomen.
Websigner
@Firma
7.0
9.0
OK
OK
4.0
5.0
10.0
13.0
5.0
10.0
OK
KO
KO
OK
OK
OK
Pg. 79 de 111
5.4.
Comunicaciones
Pg. 80 de 111
6.2.
6.3.
6.4.
Pasarela de Pago
Servicio de Pago Telemtico de Red.es
Tipos de Peticiones
6.5.
Tipo de Peticin
Alta
Consulta
Medio de Pago
Cargo en Cuenta
Tarjeta cargo a dbito
Pg. 81 de 111
6.6.
Codificacin Territorial
6.7.
Codificacin de Domiciliaciones
6.8.
Tipo de Domiciliacin
Domiciliacin = SI
Domiciliacin = NO
Se utilizar las listas de valores de los Cuadernos 57, 60 y 65 para codificar los
Tributos y los Conceptos de Pago correspondientes a los ingresos municipales y
autonmicos u otros adeudos propios de las entidades emisoras.
6.9.
Tipo de Cuaderno
9050794
9050299
9052180
9052378
Andaluca
Aragn
Asturias
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Cuaderno
Cuaderno
Cuaderno
Cuaderno
9053466
9053565
9053664
9053763
9053862
9053961
Pg. 82 de 111
57
60 modalidad 1
60 modalidad 2
60 modalidad 3
Cuaderno 65
Cdigo
Baleares
Canarias
Cantabria
Castilla-La Mancha
Castilla y Len
Catalua
Extremadura
Galicia
Madrid
Murcia
Navarra
La Rioja
Valencia
Alava
Vizcaya
Guipzcoa
Ceuta
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Tasas
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Autoliquidaciones
Liquidaciones
Tipo de Cuaderno
9054060
9054159
9054258
9054357
9054456
9054555
9054654
9054753
9054852
9054951
9055050
9055149
9055248
9055347
9055446
9055545
9055644
9055743
9057623
9055842
9052675
9056040
9056139
9056238
9056337
9056436
9056535
9056633
9056732
9056831
9056930
9057029
9057128
9057227
9057326
Pg. 83 de 111
Cdigo
Melilla
Tipo de Cuaderno
Autoliquidaciones
Liquidaciones
9057425
9057524
Idioma
Castellano
Cataln
Gallego
Euskera
Descripcin
Tipo de firma PKCS#7
Tipo de firma CMS
Pg. 84 de 111
7
2
5
Los tipos de firma PKCS#7, CMS y CAdES son utilizados para pagos tipo web y los
tipos de firma XMLDSig y XAdES son para pagos tipo webservice.
Pg. 85 de 111
Relacin de Validaciones
7.2.
Para el clculo de los dgitos de control del nmero de referencia, segn se especifica
en el Cuaderno 57, se utilizar el siguiente algoritmo:
1. Sumar al Nmero de referencia (11 caracteres) el Nmero de la Emisora
(mximo 8 caracteres numricos), el concepto de pago (3 caracteres), la
identificacin (mximo 6 caracteres) y el importe alineados por la derecha.
Para el clculo de los dgitos de control del dato referencia, se considerar el
importe completo como si de una cantidad entera se tratase (Ejemplo: el
importe de 6543,21 euros se tomar como 654321).
2. Con el resultado de la suma calcular los dgitos de control. Para ello, se
dividir dicho resultado por 97, hasta obtener tres decimales. Los dos dgitos
de control seran la diferencia entre 100 y las dos primeras cifras decimales
del cociente. Si la divisin es exacta los dgitos son 00.
Supongamos que se trata de los siguientes datos:
org:
01234567
con_pago:
023
referencia: 12345678901
identificacion:
123456
importe:
654321
suma:
12347691268
La suma se divide por 97 = 127295786,268
Los dgitos de control seran: 100 26 = 74
Por lo que la referencia completa sera: 1234567890174
Pg. 86 de 111
7.3.
Para el clculo de los dgitos de control del nmero de referencia, segn se especifica
en el Cuaderno 60, se utilizar el siguiente algoritmo:
org:
084992
importe: 000000006058
referencia: 5000431649
ident_1:
170
ident_2:
1000821
Por tanto identificacin ser: 1170100082_ (el primer 1 es el movido de
ident_2)
emisora
84992
x 76
referencia
5000431649 x 9
identificacion 1170100082
importe
6058
identif+importe 1170106140 -1 =
1170106139
Pg. 87 de 111
x 55
=
=
6459392
45003884841
(a)
(b)
64355837645
(c )
[(a)+(b)+ ( c)] /
97
= 1127486411,11340
DC
99- 11 = 88
7.4.
del
nmero
de
Pg. 88 de 111
7.5.
control
del
nmero
de
7.6.
El SPT garantiza que los cdigos IBAN recibidos sean correctos o en su defecto se
permite modificarlos antes de realizar la solicitud de pago contra la entidad
financiera.
Las validaciones son:
7.6.1.
WebService
1) Si el organismo informa de un CCC, se comprobar que venga
informado su correspondiente IBAN en las posiciones 47,48,49 y
50, inclusive, del campo reservado para el organismo.
Si no se cumple la validacin el SPT informar de un error LQ
2) Si el organismo informa de un IBAN en las posiciones 47,48,49 y
50, inclusive, del campo reservado para el organismo,
se
comprobar que venga informado su correspondiente CCC.
Pg. 89 de 111
Web
1) Si el organismo informa de un CCC domiciliada se comprobar que
venga informado su correspondiente IBAN en las posiciones
51,52,53 y 54 inclusive, del campo reservado para el organismo
Si no se cumple la validacin el SPT informar de un error LR
2) Si el organismo informa de un IBAN en las posiciones 51,52,53 y
54, inclusive del campo reservado para el organismo
se
comprobar que venga informado su correspondiente CCC
domiciliada
Si no se cumple la validacin el SPT informar de un error LV
3) Se valida que el IBAN de la cuenta domiciliada sea correcto
Si no se cumple la validacin el SPT informar de un error LT
7.7.
Pg. 91 de 111
Pg. 92 de 111
Nombre
acr_pagos
anagrama
Descripcin
Acreditacin Pagos por Cuenta de Terceros
Definicin: Campo utilizado para indicar si el Tercero
Autorizado est acreditado frente al Organismo para
realizar el pago por cuenta de terceros. El SPT
transmitir el dato recibido desde el Organismo, para
la verificacin por parte de la Entidad Financiera
Colaboradora.
Origen: El Organismo tiene la opcin de utilizar un
servicio de Red.es para establecer el valor
correspondiente. En caso contrario, deber rellenar el
campo al invocar el SPT.
Formato: Es un carcter numrico con dos valores
posibles:
0 - No es Tercero Autorizado.
1 - Es Tercero Autorizado.
Anagrama fiscal del contribuyente
Definicin: Letras de etiqueta del contribuyente en
personas fsicas.
Origen: El mismo que el NIF del Certificado.
Formato: Cuatro caracteres o espacios en blanco
Tipo
AN
20
ccc
Long
Pg. 93 de 111
Nombre
Descripcin
Long
Tipo
20
AN
ccc_dom
Cliente de Firma
Definicin: este campo indica si se quiere incluir un
cliente de firma especfico en pago web SPT.
Origen: Este dato debe ser proporcionado por el
cliente_firma
Organismo.
Formato:
WEBSIGNER para cliente de firma Websigner
AFIRMA para cliente de firma @firma
cod_dom
Cdigo de Domiciliacin
Definicin: este campo indica si, adems del pago,
en la misma operacin, se quiere ordenar la
domiciliacin del correspondiente concepto.
Origen: Este dato debe ser proporcionado por el
Organismo.
Formato:
1 para SI
Pg. 94 de 111
Nombre
Descripcin
Long
Tipo
16
AN
2 para NO
cod_mac
MAC
Definicin: Cdigo de autenticacin del mensaje que
se enva a la Entidad Financiera Colaboradora.
Origen: El cdigo es creado por el SPT.
Formato: Alfanumrico.
cod_mod
Cdigo de Modelo
Definicin: Identificador de la plantilla o formulario en
la que se va a basar la autoliquidacin.
cod_ret
Cdigo de Retorno
Definicin: Cdigo de retorno con el resultado de la
operacin en la EFC.
Origen: la Entidad Financiera Colaboradora.
Formato: ver lista de valores.
AN
AN
Cdigo Territorial
Definicin: En este campo se incluir el cdigo del
territorio correspondiente.
cod_terr
con_pago
Nombre
Descripcin
Long
Tipo
AN
diferenciadas.
Origen: el Organismo indicar que tipo de concepto de
pago que desea.
Formato:
Tiene un valor entre 000 y 499, la Entidad de Crdito
no efectuar control alguno en base al contenido del
campo Identificacin; si el valor es igual o superior a
500, el campo Identificacin contendr una fecha
lmite de cobro y la Entidad de Crdito no admitir
cobros a partir de esa fecha
concepto
cpr
Concepto de la Autoliquidacin
Definicin: Concepto de pago de la autoliquidacin.
CPR (Cdigo de Procedimiento de Recaudacin)
Definicin: Este cdigo, que pas a formar parte de los
distintos procedimientos de recaudacin, deber ser
incorporado en el proceso de emisin de los
documentos de pago. Se establece un perodo para la
adaptacin al nuevo procedimiento, que finaliz el 110-2003, por lo que a partir de dicha fecha todos los
documentos debern contener el citado cdigo (CPR).
Los valores especficos de este campo varan
dinmicamente, segn las necesidades de cada
Organismo.
Se especifican en la lista de valores.
devengo
Fecha de Devengo
Definicin: Fecha de realizacin del hecho imponible o
fecha de inicio del perodo para impuestos peridicos.
Formato: AAAAMMDD
AAAA - Cuatro dgitos del ao.
MM - Dos dgitos correspondientes al mes.
Pg. 96 de 111
Nombre
Descripcin
Long
Tipo
eeffcc
ejercicio
Ejercicio
Definicin: Ao al que corresponde el tributo.
Origen: el Organismo proporcionar este dato.
Formato: Ao con 4 dgitos
fec_oper
Nombre
Descripcin
Long
Tipo
fecha
hora
10
Pg. 98 de 111
Nombre
ident_1
ident_2
Descripcin
Long
Tipo
Nombre
Descripcin
Long
Tipo
12
20-25
AN
importe
info
Importe
Definicin: El importe a pagar.
Origen: el Organismo debe proporcionar este dato.
Formato: se especifica en cntimos de euro
(por ejemplo, 125 se indicara como
000000012500).
Informacin especfica
Definicin: Campo que el organismo considera
obligatorio o necesario informar. Se incluira
informacin que el organismo haya definido
previamente en el modelo para un cdigo de tributo
Nombre
Descripcin
Long
Tipo
medio
modelo
Modelo
Definicin: Identificador de la plantilla o formulario en
la que se va a basar la autoliquidacin.
nif_cert
AN
nif_cont
AN
Nombre
Descripcin
Long
Tipo
nif_rep1
AN
nif_rep2
AN
nom_cont
40
AN
nom_rep1
40
AN
nom_rep2
40
AN
Nombre
Descripcin
Long
Tipo
22
AN
nrc
Nombre
Descripcin
Campos para clculo de los caracteres de control
del NRC en el cuaderno 65:
Los campos utilizados sern:
- Nmero de Justificante: 14 posiciones (Un dgito a la
izquierda relleno a 0. + Trece dgitos del campo
Justificante original.)
- NIF del Certificado: 9 posiciones.
- Importe: 13 posiciones (En cntimos de euro,
rellenando ceros a la izquierda).
- Fecha de la operacin: 8 posiciones.
- Cdigo del Banco de Espaa: 4 posiciones.
Total longitud campos: 48 posiciones.
Campos para clculo de los caracteres de control
del NRC en el cuaderno 60, modalidad 1 y 2:
Los campos utilizados sern:
- Nmero de referencia 14 posiciones (Dos dgitos a la
izquierda rellenos a 00 + Doce dgitos del campo
Referencia original)
- NIF del certificado: 9 posiciones.
- Importe: 13 posiciones (En cntimos de euro,
rellenando ceros a la izquierda).
- Fecha de la operacin: 8 posiciones.
- Cdigo del Banco de Espaa: 4 posiciones.
Total longitud campos: 48 posiciones.
Long
Tipo
Nombre
Descripcin
Long
Tipo
12
AN
13
num_exp
num_just
Nmero de Justificante
Definicin: Campo identificador de un pago en
Pg. 105 de 111
Nombre
Descripcin
Long
Tipo
Cuaderno 65:
MMM V NNNNNNNN D
siendo:
M: nmero del modelo del documento
V: versin o ltimo dgito del ao
N: nmero de orden
D: dgito de control
org
Nombre
Descripcin
Long
Tipo
org_datos
AN
Nombre
Descripcin
2.- 20 posiciones alfanumricas con el cdigo de
organismo.
Para el cuaderno 60 modalidad 3, 54 posiciones
alfanumricas
Para el cuaderno 57, 54 posiciones alfanumricas
Campo reservado para Organismo (en modalidad
Web)
Definicin: El Organismo utilizar este campo de
acuerdo a sus necesidades.
Origen: el Organismo proporcionar este dato.
Formato: la longitud de este campo ser mayor de 50
posiciones, variable en funcin del cuaderno y
modalidad, para ajustar el nmero de caracteres
utilizado para el clculo del MAC.
Para todos los cuadernos, la posicin 23 a 1, y de la
24 a la 44 (20 posiciones) el cdigo de Organismo que
asigne el SPT.
Para el cuaderno 65, 59 posiciones alfanumricas
Para el cuaderno 60 modalidad 1, 54 posiciones
alfanumricas
Para el cuaderno 60 modalidad 2, 54 posiciones
alfanumricas que se desglosan de la siguiente
manera:
1.- 23 posiciones alfanumricas a libre disposicin
del organismo.
2.- 20 posiciones alfanumricas con el cdigo de
organismo.
3.- 10 posiciones numricas. Se cumplimentarn
obligatoriamente cuando se solicite el pago de un
tributo durante el segundo periodo, informando del
campo Identificacin del primer periodo (se debe
cumplimentar cuando la 7a. posicin del campo
Ident_2 tenga el valor "9") El formato de dicha
identificacin ser la definida en el propio cuaderno
60.
Para el cuaderno 60 modalidad 3, 54 posiciones
Pg. 108 de 111
Long
Tipo
Nombre
Descripcin
Long
Tipo
16
alfanumricas
Para el cuaderno 57, 54 posiciones alfanumricas
pan
pasarela
periodo
Perodo
Definicin: Ciclo de pago dentro de un ejercicio.
Ejemplo: El tipo de ingreso basuras puede tener 4
ciclos de pago o perodos (en el caso de que sean
trimestrales).
AN
12-13
referencia
Referencia
Definicin: Campo identificador de un pago en
Cuaderno 60 mod. 1 y 2 y Cuaderno 57. Habr sido
generado previamente por el Organismo Emisor.
Origen: el Organismo proporciona este dato.
Formato:
Nombre
res
reservado
Descripcin
Cuaderno 57:
11 caracteres numricos + 2 dgitos de control (clculo
de dgitos de control en apartado validaciones)
URL de Retorno
Definicin: en este campo, el Organismo especificar
la URL a la que el SPT concatenar los parmetros de
respuesta del STP, cuando devuelva el resultado de la
operacin en Modo Web.
Origen: el Organismo proporciona este dato.
Formato: la URL constar de los elementos necesarios
para poder ser invocada por https.
Ejemplo: servidor.dominio/dir/pagina.jsp
para constituir la URL completa:
servidor.dominio/dir/pagina.jsp?par1=valor1&par2=va
lor2....
Long
Tipo
159
AN
20
AN
superorganismo
tipo
Cdigo de superorganismo:
Definicin: Superorganismo al que pertenece la
peticin al SPT.
Origen: el Organismo proporcionar este dato.
Tipo de peticin:
Definicin: Tipo de peticin que se est realizando al
SPT.
Origen: el Organismo indicar que tipo de peticin
desea.
Formato:
01 para Alta (crear una orden de pago)
Pg. 110 de 111
Nombre
Descripcin
Long
Tipo
02 para Consulta
tipo_firma
Tipo de firma:
Definicin: Tipo de firma que se est realizando en
SPT en cliente con Websigner.
Origen: el Organismo indicar que tipo de firma desea.
Formato:
1
Tipo de firma PKCS#7
3
Tipo de firma CMS
7
Tipo de firma CAdES
2
Tipo de firma XMLDSig
5
Tipo de firma XAdES