Anda di halaman 1dari 111

Especificacin de la Interfaz con Organismos

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 DEL SERVICIO DE PAGO TELEMTICO DE


RED.ES
13
2.1.

Procesos on-line

13

2.1.1.

Primera parte: El Inicio del Proceso

16

2.1.2.

Segunda Parte: Conexin con el Servicio de Pago


Telemtico
18

2.1.3.

Tercera Parte: Ejecucin del Pago

19

2.1.4.

Cuarta Parte: Confirmacin de la Transaccin

20

2.1.5.

Quinta
Parte:
Administrativo

21

2.1.6.

2.2.

3.

Finalizar

el

Procedimiento

Presentacin on-line por Lotes

Proceso de
Organismos

Mantenimiento

por

22

parte

de

los
23

DESCRIPCIN DE LA INTERFAZ

25

3.1.

Caractersticas

25

3.2.

Anlisis de los Casos de Pago

26

3.2.1.

Nomenclatura

28

3.2.2.

Acceso al SPT con Certificado de Persona Fsica

29

Pg. 2 de 111

3.2.3.

4.

Acceso al SPT con Certificado de Persona Jurdica

33

ESPECIFICACIN FUNCIONAL

37

4.1.

Especificaciones del Pago Telemtico

37

4.1.1.

Modalidades Tecnolgicas

37

4.1.2.

Caractersticas Generales

39

4.2.

Especificaciones de la Consulta de Solicitudes de Pago


Telemtico
42
4.2.1.

4.3.

4.4.

4.5.

Modalidades Tecnolgicas

Formato de las
Organismo al SPT

solicitudes

43

enviadas

desde

el
46

4.3.1.

Formato de Solicitud de Pago, segn Cuaderno 65

46

4.3.2.

Formato de Solicitud de Pago, segn Cuaderno 60


(Modalidades 1 y 2)
48

4.3.3.

Formato de Solicitud de Pago, Cuaderno 60


(Modalidad 3)
50

4.3.4.

Formato de Solicitud de Pago, segn Cuaderno 57

52

Formato de las respuestas enviadas desde el SPT al


Organismo
54
4.4.1.

Formato de la respuesta, segn Cuaderno 65

4.4.2.

Formato de la respuesta, segn Cuaderno 60


(Modalidades 1 y 2)
56

4.4.3.

Formato de la respuesta, segn Cuaderno 60


(Modalidad 3)
57

4.4.4.

Formato de la respuesta, segn Cuaderno 57

58

4.4.5.

Excepciones reconocidas al interfaz

59

Listas de Valores
4.5.1.

Codificacin
Colaboradoras

54

59
de

Entidades

Financieras
59

4.5.2.

Codificacin de Organismos Acreedores

59

4.5.3.

Identificacin de Pasarelas de Pago

60

4.5.4.

Tipos de Peticiones

60

Pg. 3 de 111

4.6.
4.7.

4.8.

5.

Identificacin de los Medios de Pago

60

4.5.6.

Codificacin Territorial

60

4.5.7.

Codificacin de Domiciliaciones

61

4.5.8.

Codificacin de Tributos y Conceptos de Pago

61

4.5.9.

Cdigo de procedimiento de Recaudacin (CPR)

61

Transformaciones y Validaciones

64

4.6.1.

64

Validaciones

Transacciones

64

4.7.1.

Situacin de las Transacciones en el SPT

64

4.7.2.

Operativa de las Transacciones por el SPT

66

Condiciones de Error y Gestin de Excepciones

68

4.8.1.

Gestin de Errores

68

4.8.2.

Gestin de Excepciones

68

4.8.3.

Mensajes de Error de Validacin de SPT

69

4.8.4.

Mensajes de
Colaboradora

Error

de

la

Entidad

Financiera
72

OTRAS CONSIDERACIONES

77

5.1.

Especificaciones no Funcionales (Tcnicas)

77

5.2.

Seguridad

78

5.3.

Requerimientos tcnicos del equipo usuario de SPT.

78

5.3.1.

Hardware

78

5.3.2.

Software

78

5.4.
6.

4.5.5.

Comunicaciones

80

ANEXO I: EJEMPLOS DE LAS LISTAS DE VALORES

81

6.1.

Codificacin de Entidades Financieras Colaboradoras

81

6.2.

Codificacin de Organismos Acreedores

81

6.3.

Identificacin de Pasarelas de Pago

81

Pg. 4 de 111

7.

8.

6.4.

Tipos de Peticiones

81

6.5.

Identificacin de los Medios de Pago

81

6.6.

Codificacin Territorial

82

6.7.

Codificacin de Domiciliaciones

82

6.8.

Codificacin de Tributos y Conceptos de Pago

82

6.9.

Cdigo de Procedimiento de Recaudacin (CPR)

82

6.10.

Codificacin de Idiomas

84

6.11.

Codificacin de tipo de Cliente de Firma

84

6.12.

Codificacin de tipo de Firma

84

ANEXO II: VALIDACIONES

86

7.1.

Relacin de Validaciones

86

7.2.

Clculo de los dgitos de control del nmero de


referencia (Cuaderno 57)
86

7.3.

Clculo de los dgitos de control del nmero de


referencia (Cuaderno 60 mod. 1 y 2)
87

7.4.

Clculo de los dgitos de control del nmero de


justificante (Cuaderno 60 mod. 3)
88

7.5.

Clculo de los dgitos de control del nmero de


justificante (Cuaderno 65)
89

ANEXO III: DICCIONARIO DE CAMPOS

Pg. 5 de 111

93

Captulo 2 ndice de Figuras


Figura 1: Esquema General de la Interfaz ............................................................ 8
Figura 2: Esquema de Firma Electrnica ............................................................ 10
Figura 3: Esquema General del Proceso on-line .................................................. 14
Figura 4: Proceso on-line - Primer paso: Inicio ................................................... 16
Figura 5: Proceso on-line - Segundo paso: Conexin SPT .................................... 18
Figura 6: Proceso on-line - Tercer paso: Ejecucin del Pago ................................. 19
Figura 7: Proceso on-line - Cuarto paso: Confirmacin de la Transaccin............... 20
Figura 8: Proceso on-line - Quinto Paso: Finalizar el Procedimiento Administrativo . 21
Figura 9: Esquema Proceso on-line por Lotes ..................................................... 22
Figura 10: Esquema de Mantenimiento por parte de Organismos .......................... 23
Figura 11: Operativa en las Transacciones ......................................................... 67

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:

Los formatos utilizados para el envo de la informacin desde un Organismo


Acreedor al SPT.

Los formatos utilizados para la devolucin de la informacin desde el SPT al


Organismo Acreedor, que incluyen el resultado de la transaccin.
Estos dos modelos de formatos se han desarrollado teniendo en cuenta las
especificaciones del Cuaderno 57 (Cobros por ventanilla y autoservicio), del
Cuaderno 60 (Recaudacin de tributos y otros ingresos municipales) y del
Cuaderno 65 (Recaudacin de tributos, tasas, impuestos y otros ingresos
autonmicos) de la serie de normas y procedimientos bancarios,
correspondientes a los diferentes tipos de OOAA que harn uso del SPT.

Todos los elementos adicionales necesarios que estn relacionados con la


interfaz, y entre los que se incluyen: requerimientos, especificaciones
tcnicas, consideraciones (pruebas, rendimientos, seguridad), etc.

Estos formatos se emplearn tanto en la modalidad Web, como en la modalidad Web


Services. En este ltimo caso, la especificacin del Web Services se proporcionar
como complemento, para poder invocarlo.

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:

Figura 1: Esquema General de la 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

Autorizar o legalizar algo. Acreditar, dar fe de la verdad de un


hecho o documento con autoridad legal. En el contexto del
Servicio de Pago Telemtico, es el proceso electrnico que
permite confirmar, mediante un mecanismo de seguridad
(como usuario / contrasea o certificado electrnico), que
alguien es quien dice ser.

Autoridad de

Organizacin que emite certificados digitales y se encarga de


su gestin y mantenimiento. Tambin se puede conocer como
PSC (Prestador de Servicios de Certificacin).
Un ejemplo de Autoridad de Certificacin es el proyecto CERES
de la Fbrica Nacional de Moneda y Timbre (FNMT).

Certificacin

Certificado
Electrnico

Firma

Documento que establece que a un ciudadano (nombre y NIF)


le corresponde una clave pblica determinada.
Una Autoridad de Certificacin, con su firma, garantiza que
esta asociacin clave pblica-identidad de ciudadano es vlida.
La firma electrnica es el conjunto de datos, en forma
electrnica, anejos a otros datos electrnicos o asociados
Pg. 9 de 111

Electrnica

funcionalmente con ellos, utilizados como medio para


identificar formalmente al autor o a los autores del documento
que la recoge. (RD-L 14/1999 Art. 2).

Figura 2: Esquema de Firma Electrnica

Se trata de una cadena de caracteres, generada mediante un


algoritmo matemtico, que se obtiene utilizando como
variables la clave privada y la huella digital del texto a firmar
de forma que permite asegurar la identidad del firmante y la
integridad del mensaje.
La firma digital permite al receptor de un mensaje verificar la
autenticidad del origen de la informacin as como verificar
que dicha informacin no ha sido modificada desde su
generacin. De este modo, la firma digital ofrece el soporte
Pg. 10 de 111

para la autenticacin e integridad de los datos as como para


el no repudio en origen, ya que el creador de un mensaje
firmado digitalmente no puede argumentar que no lo es.
Una firma digital est destinada al mismo propsito que una
manuscrita. Sin embargo, una firma manuscrita es sencilla de
falsificar mientras que la digital es imposible mientras no se
descubra la clave privada del firmante.
La firma digital se basa en la propiedad de que un mensaje
cifrado utilizando la clave privada de un usuario slo puede
ser descifrado utilizando la clave pblica asociada. De tal
manera, se tiene la seguridad de que el mensaje que ha
podido descifrarse utilizando la clave pblica slo pudo cifrarse
utilizando la privada. La firma digital, por tanto, es un cifrado
del mensaje que se est firmando pero utilizando la clave
privada en lugar de la pblica.
MAC

Siglas correspondientes a Message Authentication Code, en


el contexto del SPT.
Se trata de un cdigo generado a partir de los datos de
ingreso (mensaje) y una clave simtrica que comparten
emisor y receptor, y sirve para garantizar la integridad y
autenticidad del mensaje. En el escenario de Pago Telemtico,
el MAC se utiliza para dar fe de la autenticidad de la orden de
pago frente a la Entidad Financiera Colaboradora encargada
de ejecutarla.

NRC

Siglas
correspondientes
a
Nmero
Completo, en el contexto del SPT.

de

Referencia

Se trata de un cdigo que comprende el nmero de


justificante y el cdigo MAC. En el escenario de Pago
Telemtico, el NRC se emite por la Entidad Financiera
Colaboradora que ha ejecutado una orden de pago
previamente recibida, y sirve como justificante del pago. El
NRC puede ser verificado por aquellos que comparten la clave
secreta utilizada para generarlo.

Pg. 11 de 111

Nmero de
Justificante

En el contexto del SPT, el concepto de Nmero de Justificante


puede ser utilizado desde el punto de vista tanto del
Organismo Acreedor como de la Entidad Financiera
Colaboradora como del propio administrado:

Para el Organismo Acreedor, el primero es el Nmero de


Justificante que le proporciona al administrado inicialmente
para poder pagar y mantener la referencia del
procedimiento administrativo. Adems, tambin es un
Nmero de Justificante el NJC, proporcionndoselo al
administrado como confirmacin de la presentacin de la
declaracin en una autoliquidacin (implcitamente debe
incluir el NRC).

Para la Entidad Financiera Colaboradora, el NRC (ver en la


terminologa de este mismo documento), tambin es un
Nmero correspondiente al Justificante de Ingreso.

Por ltimo, para el Administrado, cada uno de los Nmeros


de Justificante anteriores le sirve como respaldo de las
operaciones realizadas; los dos ltimos tienen validez
como pago (NRC) y como declaracin (NJC).

Representante

Se utiliza el trmino Representante asociado al Servicio de


Pago Telemtico para designar a los profesionales que pueden
realizar Solicitudes de Pago no siendo los Sujetos Pasivos de
los correspondientes trmites.

Web Service

Se identifica mediante este trmino a los mecanismos


normalizados para la integracin de aplicaciones Web,
utilizando estndares abiertos (XML, SOAP, WSDL, UDDI)
sobre Internet.

Pg. 12 de 111

2. PROCESOS DEL SERVICIO DE PAGO TELEMTICO


DE RED.ES
Dentro del Servicio de Pago Telemtico de Red.es se han identificado 2 procesos
especficos:
1. Proceso on-line: este proceso corresponde con los pasos necesarios para llevar a
cabo un pago telemtico en modo interactivo utilizando el Servicio de Pago
Telemtico de Red.es. Se distinguen dos casos, para la presentacin individual y
presentacin por lotes (enfocado a representantes).
2. Proceso de Mantenimiento por parte de los Organismos. Se incluyen en este
proceso, de forma genrica, los pasos que debe realizar cada Organismo para llevar
a cabo la administracin de los componentes ubicados en el sistema del Servicio de
Pago Telemtico (por ejemplo, relacin de Entidades Financieras Colaboradoras con
el Organismo).
A continuacin se detallan cada uno de estos procesos.

2.1.

Procesos on-line

El esquema general del proceso on-line se ilustra en la siguiente figura, donde se


muestran las diferentes partes implicadas y las tareas generales que realizan.

Pg. 13 de 111

Figura 3: Esquema General del Proceso on-line

De acuerdo con este esquema, se distinguen cinco grupos de operaciones, en funcin


del momento en que se produce la interaccin entre cada uno de los implicados:
1. El inicio del proceso, consistente en la interaccin del administrado con el Portal
de un Organismo Acreedor, para determinar la informacin necesaria para realizar el
pago (liquidacin o determinacin de la deuda).
2. El siguiente paso es la conexin transparente con el Servicio de Pago Telemtico
prestado por Red.es. La transicin se produce de forma transparente gracias a la
redireccin del formulario con los datos del pago.
3. A continuacin, se realiza la emisin de la orden de pago hacia la Entidad
Financiera Colaboradora para la ejecucin del pago.
4. El Organismo Acreedor recibir la informacin sobre el estado de la transaccin,
incluyendo el NRC, en el caso de que se haya resuelto satisfactoriamente. El Servicio
de Pago Telemtico proporcionar un mecanismo de consulta on-line, para validar el
NRC.

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.

Primera parte: El Inicio del Proceso

La secuencia de pasos en el inicio del proceso on-line es la siguiente:

Figura 4: Proceso on-line - Primer paso: Inicio

El administrado accede a la pgina Web o portal que establezca el Organismo


Acreedor, para realizar el pago correspondiente a una deuda que dicho Organismo
tiene previamente determinada por los procedimientos administrativos existentes.
En este punto del proceso, se podr exigir o no la identificacin del usuario segn
el criterio establecido para dicho portal.
El Portal establecido por el Organismo Acreedor, proporcionar los elementos
necesarios para que el administrado pueda seleccionar el concepto a pagar e
identificar (si as lo tiene establecido) y establecer el importe de la deuda
correspondiente.
Por ltimo, est informacin quedar cumplimentada en un formulario que
permitir poner en marcha el mecanismo de Pago Telemtico y proporcionar al
Pg. 16 de 111

prestador del servicio (Red.es) toda la informacin necesaria para realizar el pago
telemtico.

Pg. 17 de 111

2.1.2.

Segunda Parte: Conexin con el Servicio de Pago Telemtico

El proceso contina de forma transparente para el administrado:

Figura 5: Proceso on-line - Segundo paso: Conexin SPT

El portal establecido por el Organismo Acreedor, a travs de los componentes de


integracin con el Servicio de Pago Telemtico, enviar la informacin de pago
relevante a Red.es (como por ejemplo la Entidad y el nmero de cuenta), utilizando
un protocolo estndar. Esto se produce de manera transparente al usuario, que no
percibe la redireccin, pues el aspecto de la pgina de pago (Red.es) ser
personalizable para cada Organismo Acreedor.
La pgina de pago solicitar al usuario que firme la orden de pago utilizando Firma
Electrnica avanzada con alguno de los certificados soportados. Esta es la base del
servicio de pago, pues proporciona la cobertura legal del sistema, logrando que el
usuario exprese su voluntad de pago y dando respaldo a la ejecucin de la orden de
pago en la Entidad Financiera Colaboradora. De esta forma, Red.es podr autentificar
la identidad de la persona que est solicitando la ejecucin del pago por va
telemtica.
Pg. 18 de 111

2.1.3.

Tercera Parte: Ejecucin del Pago

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.

Figura 6: Proceso on-line - Tercer paso: Ejecucin del Pago

Una vez validada la informacin de pago y verificada fehacientemente la firma


digital avanzada del administrado, el servicio enviar la orden de pago a la Entidad
Financiera Colaboradora, asegurando la operacin utilizando la tecnologa convenida
con dicha Entidad Financiera Colaboradora y segn protocolo estndar de
intercambio.
A la recepcin de la orden, la Entidad Financiera Colaboradora verificar y validar
la orden de pago, haciendo las comprobaciones pertinentes, y si todas ellas resultan
positivas,efectuar el ingreso en la cuenta restringida correspondiente y actualizar
sus sistemas para poder generar posteriormente el detalle de los pagos en el
periodo.
Una vez efectuado el pago, la Entidad Financiera Colaboradora devolver la
confirmacin del pago o justificante de pago (NRC), o bien un cdigo de error
informativo sobre la situacin del pago.

Pg. 19 de 111

2.1.4.

Cuarta Parte: Confirmacin de la Transaccin

La cuarta parte del proceso, confirma la Transaccin con la Entidad Financiera


Colaboradora al Organismo.

Figura 7: Proceso on-line - Cuarto paso: Confirmacin de la Transaccin

El estado actual de la transaccin es enviado al administrado por parte del


Organismo, incluyendo el NRC, si procede, para que pueda almacenar e imprimirlo.
El administrado podr continuar, en los casos en que se haya finalizado
correctamente la transaccin de pago, con los siguientes pasos administrativos que
tenga determinados el Organismo Acreedor.

Pg. 20 de 111

2.1.5.

Quinta Parte: Finalizar el Procedimiento Administrativo

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

Figura 8: Proceso on-line - Quinto Paso: Finalizar el Procedimiento Administrativo

El administrado presenta al Organismo Acreedor la declaracin de la


autoliquidacin, anexando el correspondiente NRC.
El Organismo Acreedor confirmar la validez de todos los datos recibidos,
enviando, en el caso correspondiente, un justificante electrnico (NJC), con validez
para el administrado.

Pg. 21 de 111

2.1.6.

Presentacin on-line por Lotes

En el esquema general del proceso on-line visto hasta ahora, se contempla la


posibilidad de presentacin por lotes de las rdenes de pago, tal y como viene
ilustrado en la siguiente figura:

Figura 9: Esquema Proceso on-line por Lotes

Este esquema comprende, en forma resumida, los siguientes pasos:


1. El Representante preparar, mediante una aplicacin de presentacin por Lotes, la
remesa de declaraciones que desea presentar. Al final del proceso, ordenar el pago
de los registros seleccionados.
2. El Servicio de Pago Telemtico, en comunicacin con las Entidades Financieras
Colaboradoras implicadas, enviar la informacin para proceder al pago. El resultado
ser la obtencin de los justificantes de ingreso (NRCs) correspondientes, o los
mensajes de error que hayan podido generarse como consecuencia de las
transacciones.
3. El Servicio de Pago Telemtico enviar los resultados de todas las transacciones,
para que el Representante pueda verificar y continuar con los resultados obtenidos.
4. Por ltimo, el Representante podr enviar conjuntamente la remesa de
declaraciones y justificantes de ingresos a los Organismos Acreedores
correspondientes.

Pg. 22 de 111

2.2.

Proceso de Mantenimiento por parte de los Organismos

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.

Figura 10: Esquema de Mantenimiento por parte de Organismos

Pg. 23 de 111

En este proceso se distinguen los siguientes cuatro pasos:


1. Desde el Organismo Acreedor, el usuario autorizado por Red.es acceder al
sistema del Servicio de Pago Telemtico, donde realizar las operaciones de
Mantenimiento que desee.
2. Red.es actualizar y almacenar en el Servicio de Pago Telemtico los cambios
introducidos, entrando en vigor segn se haya establecido.
3. A continuacin, Red.es enviar una notificacin al responsable del Organismo
indicado para confirmar que las operaciones han sido llevadas a cabo.
4. Por ltimo, todo el proceso queda reflejado en el Log y en la Auditora.

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.

Anlisis de los Casos de Pago

En este apartado se incluye el anlisis detallado del funcionamiento del SPT, en


funcin del interesado en realizar el pago de tasas o tributos, teniendo en cuenta si
el acceso (y la firma de la correspondiente orden de pago) al servicio se realiza por
medio de un certificado de persona fsica o de persona jurdica, y si el pago se realiza
por el propio sujeto pasivo o por medio de un tercero autorizado. Estos casos aplican
al Cuaderno 57, la modalidad 3 del Cuaderno 60 y al Cuaderno 65.
En la fase actual del proyecto del SPT, no se contemplan los casos de las firmas
mancomunadas.
Se contemplan los siguientes casos:

Acceso (y Firma) con Certificado de Persona Fsica. Dentro de este tipo de


acceso hay dos casos:
o

El acceso lo realiza el Sujeto Pasivo.

El acceso lo realiza un Tercero Autorizado.

Acceso (y Firma) con Certificado de Persona Jurdica. Dentro de este tipo de


acceso hay dos casos:
o

El acceso lo realiza el Sujeto Pasivo.

El acceso lo realiza un Tercero Autorizado.

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

A continuacin se incluye una relacin de los trminos utilizados y su


correspondencia con los campos utilizados para el intercambio de datos entre los
implicados en el Pago, Organismo Acreedor, Entidad Financiera y el propio SPT.

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 Representante 1: es el NIF de la Persona Fsica que aparece en el


certificado, en todos los casos posibles. Se corresponde con el campo
nif_rep1. En el caso de que el titular del Certificado sea una Persona Fsica,
se corresponde con el NIF del Certificado; en el caso de que el titular del
Certificado sea una Persona Jurdica, se corresponde con el NIF de la Persona
Fsica que aparece en el Certificado.

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.

CCC o PAN: es el Cdigo Cuenta Cliente (CCC) o Nmero de Tarjeta en


interfaz Web o PAN en interfaz de Webservices, que proporciona el nmero de
cuenta o de tarjeta en la que se realiza el cargo. Se corresponde con el campo
ccc o pan.

Acreditacin Pagos por Cuenta de Terceros: es el indicador utilizado para


conocer si el pagador (gestores, asesores,...) est acreditado frente al
Organismo Acreedor para realizar el pago por cuenta de terceros. Se
corresponde con el campo acr_pagos.

Pg. 28 de 111

3.2.2.

Acceso al SPT con Certificado de Persona Fsica

3.2.2.1.

El Sujeto Pasivo es el Titular del Certificado.

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 Titular certificado

NIF: 11111111A

En la cuenta / tarjeta de?

En el medio de pago del que es titular Juan Prez.

NIF Representante 1

NIF: 11111111A

En nombre de quin paga?

Juan Prez

NIF Sujeto Pasivo

NIF: 11111111A

Acreditacin Pagos por


Cuenta de Terceros

0 - No es Tercero Autorizado.

Pg. 29 de 111

3.2.2.2.

El Sujeto Pasivo es diferente del Titular del Certificado.

CERTIFICADO
PERSONA FSICA

NIF PERSONA FSICA

NIF Titular certificado

NIF Persona Fsica Tercero Autorizado

NIF Representante 1

NIF Persona Fsica - Tercero Autorizado

NIF Sujeto Pasivo

NIF Persona Fsica

CCC

El titular del certificado (Tercero


Autorizado) deber ser el titular o estar
autorizado en el medio de pago.

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:

El propio Organismo valida la relacin del Tercero Autorizado y facilita los


datos correspondientes a partir del formulario enviado.

Red.es valida la relacin del Tercero Autorizado pero, en este caso, se


considerar que es alguien autorizado para todos los tributos o tasas que de
ese Organismo se puedan pagar a travs del SPT. Hay que tener en cuenta
que para Red.es, cuando se da de alta un Tercero Autorizado, podr serlo de
cualquier sujeto pasivo, para los tributos o tasas del Organismo en cuestin.
nicamente se remitir la orden de pago a la Entidad Financiera en el caso de que se
haya acreditado que la persona fsica identificada en el campo NIF Representante
1 puede actuar como Tercero Autorizado.
Por tanto, estaramos en el supuesto siguiente: el titular del certificado paga un
tributo o una tasa en nombre del sujeto pasivo, que puede ser una persona fsica o
Pg. 30 de 111

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 Titular certificado

NIF: 22222222B

En la cuenta / tarjeta de?

En el medio de pago del que es titular o autorizado


Carlos Martnez

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.

Acceso al SPT con Certificado de Persona Jurdica


3.2.3.1.

El Sujeto Pasivo es el Titular del Certificado.

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 Titular certificado

(En este certificado, Luis Gmez NIF:


33333333C, es la persona fsica)
En el medio de pago del que es titular:

En la cuenta / tarjeta de?

Coca-Cola CIF: C-33333333.

NIF Representante 1

y en el que es autorizado:
Luis Gmez NIF: 33333333C.

En nombre de quin paga?

Coca-Cola

NIF Sujeto Pasivo

CIF: C-33333333

Acreditacin Pagos por


Cuenta de Terceros

0 - No es Tercero Autorizado.

Pg. 33 de 111

3.2.3.2.

El Sujeto Pasivo es diferente del Titular del Certificado.

CERTIFICADO
PERSONA JURDICA

CIF ENTIDAD JURDICA

NIF PERSONA FSICA

NIF Titular certificado

CIF Persona Jurdica

NIF Representante 1

NIF Persona Fsica

NIF Sujeto Pasivo

NIF Sujeto Pasivo

CCC

El NIF de Persona Fsica del certificado


deber ser el titular o estar autorizado en
el medio de pago.

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?

El propio Organismo valida la relacin de Tercero Autorizado y facilita los


datos correspondientes a partir del formulario enviado.

Red.es valida la relacin de Tercero Autorizado pero, en este caso, se


considerar que es un Tercero Autorizado vlido para todos los tributos,
impuestos o tasas que de ese Organismo se puedan pagar a travs del SPT.
Hay que tener en cuenta que para Red.es, cuando se da de alta un Tercero
Autorizado, podr serlo de cualquier sujeto pasivo, para los tributos,
impuestos o tasas del Organismo en cuestin.
Por tanto, estaramos en el supuesto siguiente: el titular del certificado paga un
tributo, un impuesto o una tasa en nombre del sujeto pasivo, que puede ser una
persona fsica o una persona jurdica. El pago se podr realizar en el medio de pago

Pg. 34 de 111

del propio Tercero Autorizado o en la del sujeto pasivo o un tercero en la que el


titular del certificado est autorizado.

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

NIF Titular certificado

(En este certificado, Jorge Torres NIF:


44444444D, es la persona fsica)

En la cuenta / tarjeta de?


NIF Representante 1
En nombre de quin paga?
NIF Sujeto Pasivo
Acreditacin Pagos por
Cuenta de Terceros

En el medio de pago del que es titular o est


autorizado Jorge Torres
NIF: 44444444D.
Juan Prez NIF: 11111111A si persona fsica.
o,
Coca-Cola CIF: C-33333333 si jurdica.
1 - Es Tercero Autorizado.

Pg. 36 de 111

4. ESPECIFICACIN FUNCIONAL
4.1.

Especificaciones del Pago Telemtico

La integracin de los sistemas informticos del Organismo con el SPT se podr


realizar mediante 2 Modalidades Tecnolgicas: Web o Web Services.
4.1.1.

Modalidades Tecnolgicas
4.1.1.1.

Modalidad Web

El Servicio de Pago Telemtico en su modalidad tecnolgica Web (en ocasiones


tambin se denominar como ASP), se encuentra bajo el paradigma del B2C
(Business to Customer). Los OOAA debern poner a disposicin de sus usuarios los
mecanismos de determinacin de deuda que consideren oportunos, como por
ejemplo Formularios. Una vez determinada la deuda, el Organismo Acreedor
realizar una redireccin del flujo de navegacin al SPT, enviando los datos del pago
con el formato especificado en el presente documento. En este punto, el SPT retoma
la navegacin interactuando directamente con el ciudadano, hasta finalizar el
adeudo.
Los OOAA redireccionarn la navegacin mediante la invocacin https a una URL del
SPT.

Para los casos de pagos de Ciudadanos y Representantes en su


nombre la url a utilizar es la siguiente:
https://spt.red.es/PAGO/

En el caso de pagos con resultado satisfactorio (ejecucin del pago en la Entidad


Financiera y generacin del NRC), el SPT, en su modalidad web, El SPT redirige la
navegacin con los datos resultantes del proceso de pago a la url especificada por el
Organismo Acreedor.
En el caso de pagos con resultado error recuperable, como por ejemplo saldo
insuficiente en la cuenta seleccionada, el SPT ofrecer al usuario las opciones de
Volver a intentar el pago (pudiendo modificar los datos bancarios) y Salir,

Pg. 37 de 111

devolviendo en este caso el SPT el flujo de navegacin con el resultado de la


transaccin a la url especificada por el Organismo Acreedor.
Los tipos de firma disponibles en modo web son:

RSA PKCS #7: Cryptographic Message Syntax Standard (1.5).

CMS: Cryptographic Message Syntax Standard.

CAdES: CMS Advanced Electronic Signatures.

4.1.1.2.

Modalidad Web Services

El Servicio de Pago Telemtico en su modalidad tecnolgica de Web Services, se


encuentra bajo el paradigma del B2B (Business to Business), es decir los sistemas
informticos de los OOAA se comunican directamente con el SPT y son siempre los
OOAA quienes mantienen el flujo de la navegacin con el Ciudadano.
Para realizar una integracin en esta modalidad los OOAA debern realizar o
contemplar las siguientes acciones:

Articular los mecanismos de determinacin de la Deuda con el usuario.

Dotar al Ciudadano de los mecanismos de Firma Electrnica reconocida por el


SPT, para que este firme la Solicitud de Pago que se enviara al SPT.

Realizar la Firma, reconocida, de la Solicitud de Pago a enviar al SPT, por el


Servidor que realiza la peticin (B2B).

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:

W3C SOAP v1.1 and v1.2 Candidate Recommendation


Pg. 38 de 111

W3C Web Service Description Language (WSDL) v1.1

Sun SOAP with Attachments API for Java (SAAJ) v1.2

Sun Java API for XML-Based RPC (JAX-RPC) v1.1

Mediante estos estndares se soporta totalmente los estndares de SOAP


1.1 y de forma parcial el SOAP 1.2.

En este mensaje SOAP se incluirn las firmas (Ciudadano


Organismo) bajo los estndares de Firma soportado por el SPT:
o

XML Signature Syntax and Processing (XMLDSig).

XML Advanced Electronic Signatures (XAdES).

OASIS Web Services Security (WSS).

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

Durante el procesamiento de las solicitudes de rdenes de pago recibidas, el SPT


verifica posibles duplicidades en las peticiones mediante la comprobacin de los
datos que identifican unvocamente cada orden de pago (segn el cuaderno):

Cuaderno 60 mod. 1 y 2: los campos son:

Campo reservado (org_datos).

Cdigo de Organismo Emisor (org).

Referencia.

Primera parte de la identificacin (ident_1).

Segunda parte de la identificacin (ident_2).


Pg. 39 de 111

Cuaderno 60 mod. 3 y Cuaderno 65: los campos son:

Campo reservado (org_datos).

Cdigo de Organismo Emisor (org).

Nmero de justificante (num_just).

Cuaderno 57: los campos son:

Campo reservado (org_datos).

Cdigo de Organismo Emisor (org).

Referencia.

Concepto.

Identificacin.

En el caso de que la orden de pago est registrada como previamente


realizada, el SPT devolver la informacin relativa al Pago efectuado
anteriormente. El SPT visualiza la informacin correspondiente a rdenes
de pago completadas con xito durante 120 das y mantiene los pagos
custodiados para no repudio durante 5 aos.

En el caso de que la orden de pago est registrada pero con un Error


Recuperable, el SPT, con el fin de evitar pagos repetidos, consulta a la EFC
donde se realiz el intento anterior el estado del mismo. En el caso de que
el pago no se completara, el SPT lanza una transaccin con los nuevos
datos recibidos. El SPT almacena la informacin correspondiente a rdenes
de pago no completadas durante 24 horas.
4.1.2.2.

Realizacin de un pago en Modo de Consulta

Un caso particular de orden de pago se corresponde con el pago en modo consulta.


En este caso, el campo de la orden de pago Tipo de peticin se debe completar con
el valor correspondiente a consulta. El SPT, al recibir una orden de pago de este tipo,
enva una consulta con los datos especificados en la orden de pago a la Entidad

Pg. 40 de 111

Financiera indicada. La respuesta a la consulta recibida de la Entidad Financiera, se


remite directamente al Organismo como respuesta a la peticin.

Pg. 41 de 111

4.2.

Especificaciones de la Consulta de Solicitudes de Pago


Telemtico

Como funcionalidad adicional al pago, el SPT ofrece a los Organismos la posibilidad


de realizar consultas. A partir de esta funcionalidad, el Organismo podr solicitar la
informacin sobre los pagos generados.
Los posibles estados en los que se encontrarn las rdenes de pago son los
siguientes:

Pendiente respuesta, estado transitorio en el que la peticin se esta


procesando y aun no ha pasado a un estado definitivo.
Pago efectuado, estado definitivo que indica que se ha realizado el pago de
forma satisfactoria. Las SOP en este estado permanecern en el sistema del
SPT durante un tiempo (120 das), transcurrido dicho periodo desaparecen del
sistema.
Error recuperable, estado en el que ha quedado una SOP al no poder
procesarla por una causa transitoria. Permite la accin de repetir el pago.
Suele darse en situaciones de saldo insuficiente o fallo de conectividad con
la entidad financiera. Las SOP en este estado permanecern en el sistema
del SPT durante un tiempo limitado (24 horas), transcurrido dicho periodo
desaparecen del sistema.
Error no recuperable, estado definitivo que se corresponde con una
imposibilidad permanente de procesar la peticin. Un caso de ejemplo es NRC
invlido. Las SOP en este estado permanecern en el sistema del SPT durante
un tiempo limitado (24 horas), transcurrido dicho periodo desaparecen del
sistema.

La realizacin de las Consultas de SOP se podr realizar mediante 2 Modalidades


Tecnolgicas: Web o Web Services.

Pg. 42 de 111

4.2.1.

Modalidades Tecnolgicas
4.2.1.1.

Modalidad Web

El acceso a esta modalidad se realiza mediante la invocacin a las URL


correspondientes (segn se trate de SOP de Ciudadanos o de Representantes), por
protocolo seguro https.
El mecanismo de integracin es similar al caso de un Pago en modalidad Web. El
Organismo remitir la navegacin del usuario al SPT, donde este se deber
autenticar con su certificado reconocido para acceder al listado de las rdenes de
pago efectuadas con ese certificado.
En el caso de rdenes de pago que hayan quedado en estado recuperables, el
ciudadano podr realizar reintentos, en las condiciones que se especifican en el
apartado 5.1.
4.2.1.2.

Modalidad Web Services

Para la consulta de Organismo en esta modalidad, se seguirn las mismas pautas


que en la integracin de un pago en modalidad Web Services. Teniendo en cuenta las
siguientes particularidades:

La definicin del Web Services es la misma que para el proceso de pago, pero el
mtodo es diferente y es el de BusquedaSOP.

Los parmetros que se pasan al mtodo de consulta, se corresponden con los


criterios de bsqueda y sern los siguientes:

"CPR" Este campo es el que indicara de que tipo de cuaderno y


modalidad se trata. Es obligatorio (si no se incluye el lote) por lo que la
respuesta se corresponder con uno de los tres tipos de cuadernos
(C60_1_2, C60_3, C65 y 57). Algunos de ellos son:
o

Cuaderno 60 modalidad 1: 9050299

Cuaderno 60 modalidad 2: 9052180

Cuaderno 60 modalidad 3: 9052378

Cuaderno 57: 9050794


Pg. 43 de 111

organismoEmisor Este campo nos indica la entidad emisora.

superorganismo En el caso de consultar pagos de un


superorganismo sera necesario incluir este campo.

codOrganismo Este campo nos indica el organismo. Es obligatorio


si no incluimos el superorganismo.

"justificante" o "referencia" (depende del cuaderno) y/o "NRC" y/o


"NIF Certificado y/o "NIF Contribuyente Al menos uno de estos
campos es obligatorio junto con el cpr si no incluimos un lote.

"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

"fechaDesde" y "fechaHasta" Rango de Fechas (yyyyMMdd), en las


cuales se realizo la SOP.
idLote Nmero del lote que queremos consultar. Obligatorio si
queremos consultar lote.

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.

Formato de las solicitudes enviadas desde el Organismo


al SPT

A continuacin se detallan los formatos a utilizar por el OA para enviar las solicitudes
de pago al SPT.
4.3.1.

Formato de Solicitud de Pago, segn Cuaderno 65

Las Solicitudes procedentes de Conceptos de Pago de Comunidades Autnomas, se


enviarn desde el Organismo Acreedor al SPT de acuerdo al siguiente formato de
registro:
N Pos Long Tipo Oblig
Descripcin
Datos COMUNES
Web WS
1
1
9 AN
S
S NIF del Certificado
2
10
8
N
S
S Fecha de la Solicitud de Pago
3
18
10
N
S
S Hora de la Solicitud de Pago
4
28
7
N
S
S CPR
5
35
2
N
S
S Identificador pasarela de pago
6
37
2
N
S
S Tipo de peticin
Datos para el CARGO
7
39
1
N
No
S Identificador del medio de pago
8
40
4
N
No
S Cdigo de la Entidad Financiera
Cdigo Cuenta Cliente o PAN (en WS
9
44
20
N
No
S son dos campos)
10
64
12
N
S
S Importe
11
76
9 AN
No
No NIF Representante 1
12
85
9 AN
No
No NIF Representante 2
Apellidos y nombre o razn social del
13
94
40 AN
S
S contribuyente
14 134
40 AN
No
No Apellidos y nombre representante 1
15 174
40 AN
No
No Apellidos y nombre representante 2
Datos Especficos
16 214
5
N
S
S Cdigo del Organismo Emisor
17 219
3
N
S
S Modelo
18 222
4
N
No
No Ejercicio
19 226
2 AN
No
No Perodo
20 228
9 AN
S
S NIF del Contribuyente
21 237
4 AN
S
S Anagrama fiscal del contribuyente
Pg. 46 de 111

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

El campo res contiene la direccin (URL) a la que se devolver el resultado de la


solicitud.
En el interfaz web, el pago tipo consulta (campo tipo=02) no est disponible.
Se han aadido 2 nuevos campos (opcionales) para el modo web que van a indicar
qu componente de firma queremos utilizar (cliente_firma), y qu tipo de firma
(tipo_firma).

Pg. 47 de 111

4.3.2.

Formato de Solicitud de Pago, segn Cuaderno 60 (Modalidades 1


y 2)

Las Solicitudes procedentes de Conceptos de Pago de Entidades Locales, para las


Modalidades 1 y 2, se enviarn desde el Organismo Acreedor al SPT de acuerdo al
siguiente formato de registro:
N
Pos Long Tipo Oblig
Datos COMUNES
Web WS

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

NIF del Certificado


Fecha de la Solicitud de Pago
Hora de la Solicitud de Pago
CPR
Identificador pasarela de pago
Tipo de peticin

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

S Identificador del medio de pago


S Cdigo de la Entidad Financiera
Cdigo Cuenta Cliente o PAN (en WS
S son dos campos)
S Importe
No NIF Representante 1
No NIF Representante 2
No Apellidos y nombre representante 1
No Apellidos y nombre representante 2

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

Datos para el CARGO

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

Cdigo del Organismo Emisor


Referencia
Primera parte de la Identificacin
Segunda parte de la Identificacin
Cdigo de Domiciliacin
CCC Domiciliacin
Campo reservado para Organismo
(reservado en WS)
Cdigo de superorganismo
Idioma
URL de retorno

456

Pg. 48 de 111

org_datos
superorganismo
idioma
res

El campo res contiene la direccin (URL) a la que se devolver el resultado de la


solicitud.
En el interfaz web, el pago tipo consulta (campo tipo=02) no est disponible.
Se han aadido 2 nuevos campos (opcionales) para el modo web que van a indicar
qu componente de firma queremos utilizar (cliente_firma) y qu tipo de firma
(tipo_firma).

Pg. 49 de 111

4.3.3.

Formato de Solicitud de Pago, Cuaderno 60 (Modalidad 3)

Las Solicitudes procedentes de Conceptos de Pago de Entidades Locales, para la


Modalidad 3, se enviarn desde el Organismo Acreedor al SPT de acuerdo al
siguiente formato de registro:
N
Pos Long Tipo Oblig
Datos COMUNES
Web WS

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 del Certificado


Fecha de la Solicitud de Pago
Hora de la Solicitud de Pago
CPR
Identificador pasarela de pago
Tipo de peticin

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

Identificador del medio de pago


Cdigo de la Entidad Financiera
Cdigo Cuenta Cliente o PAN (en WS
son dos campos)
Importe
NIF Representante 1
NIF Representante 2
Apellidos y nombre representante 1
Apellidos y nombre representante 2

S
No
S
S
S
No
No

Datos para el CARGO

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

Cdigo del Organismo Emisor


Nmero de Expediente
Nmero de Justificante
NIF del Contribuyente
Cdigo de Modelo
Fecha de Devengo
Datos Especficos
Campo reservado para Organismo
S (reservado en WS)
No Cdigo de superorganismo
Acreditacin Pagos por Cuenta de
S Terceros
S Idioma
No URL de retorno

480

Pg. 50 de 111

org
num_exp
num_just
nif_cont
cod_mod
devengo
info
org_datos
superorganismo
acr_pagos
idioma
res

* El campo NIF del Contribuyente no sera obligatorio si en la posicin 4 del nmero


de justificante se indica un 8.
El campo res contiene la direccin (URL) a la que se devolver el resultado de la
solicitud.
En el interfaz web, el pago tipo consulta (campo tipo=02) no est disponible.
Se han aadido 2 nuevos campos (opcionales) para el modo web que van a indicar
qu componente de firma queremos utilizar (cliente_firma) y qu tipo de firma
(tipo_firma).

Pg. 51 de 111

4.3.4.

Formato de Solicitud de Pago, segn Cuaderno 57

Las Solicitudes correspondientes a Cobros por ventanilla y autoservicio, se enviarn


desde el Servicio de Pago Telemtico a la Entidad Financiera Colaboradora de
acuerdo al siguiente formato de registro:
N
Pos Long Tipo Oblig
Datos COMUNES
Web

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 del Certificado


Fecha de la Solicitud de Pago
Hora de la Solicitud de Pago
CPR
Identificador pasarela de pago
Tipo de peticin

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

Identificador del medio de pago


medio
Cdigo de la Entidad Financiera
eeffcc
Cdigo Cuenta Cliente o PAN
ccc
Fecha de caducidad de la tarjeta
fec_cad
Importe
importe
NIF Representante 1
nif_rep1
NIF Representante 2
nif_rep2
Apellidos y nombre representante 1 nom_rep1
Apellidos y nombre representante 2 nom_rep2

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

Datos para el CARGO

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

Cdigo del Organismo Emisor


Concepto de pago
Nmero de referencia
Identificacin
NIF del Contribuyente
Cdigo de Domiciliacin
CCC Domiciliacin
Campo reservado para Organismo
Cdigo de superorganismo
Acreditacin Pagos por Cuenta de
No Terceros
S
Idioma
No URL de retorno

472
Pg. 52 de 111

org
con_pago
referencia
identificacion
nif_cont
cod_dom
ccc_dom
org_datos
superorganismo
acr_pagos
idioma
res

El campo 20 (nif_cont) y 25 (acr_pagos) se pueden rellenar a blancos para mantener


compatibilidad con otras versiones.
En el interfaz web, el pago tipo consulta (campo tipo=02) no est disponible.
Se han aadido 2 nuevos campos (opcionales) para el modo web que van a indicar
qu componente de firma queremos utilizar (cliente_firma) y qu tipo de firma
(tipo_firma).

Pg. 53 de 111

4.4.

Formato de las respuestas enviadas desde el SPT al


Organismo

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.

Formato de la respuesta, segn Cuaderno 65

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 del Certificado


Fecha de la Solicitud de Pago
Hora de la Solicitud de Pago
CPR
Identificador pasarela de pago
Tipo de peticin

nif_cert
fecha
hora
cpr
pasarela
tipo

N
N
N

No
No
S

Identificador del medio de pago


Cdigo de la Entidad Financiera
Importe

medio
eeffcc
importe

Cdigo del Organismo Emisor


Modelo
Ejercicio
Perodo
NIF del Contribuyente
Cdigo territorial
Fecha de Devengo
Nmero del justificante
Informacin especfica
Concepto de la autoliquidacin
Campo reservado para Organismo
(reservado en WS)
Cdigo de superorganismo
NRC
Cdigo Retorno
Fecha Operacin

org
modelo
ejercicio
periodo
nif_cont
cod_terr
devengo
num_just
info
concepto

Datos para el CARGO

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.

Formato de la respuesta, segn Cuaderno 60 (Modalidades 1 y 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 del Certificado


Fecha de la Solicitud de Pago
Hora de la Solicitud de Pago
CPR
Identificador pasarela de pago
Tipo de peticin

nif_cert
fecha
hora
cpr
pasarela
tipo

N
N
N

S
S
S

Identificador del medio de pago


Cdigo de la Entidad Financiera
Importe

medio
eeffcc
importe

Cdigo del Organismo Emisor


Referencia
Primera parte de la Identificacin
Segunda parte de la Identificacin
Campo reservado para Organismo
(reservado en WS)
Cdigo de superorganismo
NRC
Cdigo Retorno
Fecha Operacin

org
referencia
ident_1
ident_2

Datos para el CARGO

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.

Formato de la respuesta, segn Cuaderno 60 (Modalidad 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 del Certificado


Fecha de la Solicitud de Pago
Hora de la Solicitud de Pago
CPR
Identificador pasarela de pago
Tipo de peticin

nif_cert
fecha
hora
cpr
pasarela
tipo

No
No
S

Identificador del medio de pago


Cdigo de la Entidad Financiera
Importe

medio
eeffcc
importe

S
S
S
No

Cdigo del Organismo Emisor


Nmero de Justificante
Cdigo de Modelo
Fecha de Devengo
Campo reservado para Organismo
(reservado en WS)
Cdigo de superorganismo
NRC
Cdigo Retorno
Fecha Operacin

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.

Formato de la respuesta, segn Cuaderno 57

Las Solicitudes correspondientes a Cobros por ventanilla y autoservicio, se enviarn


desde la Entidad Financiera Colaboradora al Servicio de Pago Telemtico de acuerdo
al siguiente formato de registro:
N
Pos Long Tipo Oblig
Datos COMUNES
Web

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 del Certificado


Fecha de la Solicitud de Pago
Hora de la Solicitud de Pago
CPR
Identificador pasarela de pago
Tipo de peticin

nif_cert
fecha
hora
cpr
pasarela
tipo

N
N
N

No
No
S

S
S
S

Identificador del medio de pago


Cdigo de la Entidad Financiera
Importe

medio
eeffcc
importe

S
S
S
S
S

Datos para el CARGO

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

Cdigo del Organismo Emisor


Concepto de pago
Nmero de referencia
Identificacin
NIF del Contribuyente
Campo reservado para
S Organismo
No Cdigo de superorganismo
S NRC
S Fecha Operacin
S Cdigo Retorno

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.

Excepciones reconocidas al interfaz

En el presente apartado se detallan excepciones generales al interfaz de SPT con las


entidades financieras, y que por tanto, afecta a todos los organismos y su
integracin:

El campo nom_rep1 (nombre de representante) es obligatorio para el caso del


Banco Popular (0075).
No es posible utilizar tarjetas de crdito (cargo a dbito) en el caso de Caja Rural
de Granada (3023).

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.

Codificacin de Entidades Financieras Colaboradoras

El formato de la lista de valores utilizada para codificar las Entidades Financieras


Colaboradoras es el siguiente:

Cdigo
4 posiciones (numrico)

4.5.2.

Entidad Financiera Colaboradora


Nombre Entidad Financiera

Codificacin de Organismos Acreedores

El formato de la lista de valores utilizada para codificar los Organismos Acreedores se


corresponder con la especificacin de los Cuadernos 57, 60 y 65.
Pg. 59 de 111

4.5.3.

Identificacin de Pasarelas de Pago

El formato de la lista utilizada para codificar las Pasarelas de Pago es la siguiente:

Cdigo
2 pos. (numrico)

4.5.4.

Pasarela de Pago
Nombre de la Pasarela de Pago

Tipos de Peticiones

El formato de la lista de valores utilizada para codificar los Tipos de Peticiones es la


siguiente:

Cdigo
2 pos.(numrico)

4.5.5.

Tipo de Peticin
Nombre del Tipo de Peticin

Identificacin de los Medios de Pago

El formato de la lista de valores utilizada para codificar los Medios de Pago es la


siguiente:

Cdigo
2 pos.(numrico)

4.5.6.

Medio de Pago
Nombre del Medio de Pago

Codificacin Territorial

El formato de la lista de valores utilizada para codificar los Territorios es la siguiente:

Pg. 60 de 111

Cdigo
6 pos.(numrico)

4.5.7.

Denominacin del Territorio


Nombre del Territorio

Codificacin de Domiciliaciones

El formato de la lista de valores utilizada para codificar los Tipos de Domiciliacin es


la siguiente:

Cdigo
1 pos.(numrico)

4.5.8.

Tipo de Domiciliacin
Nombre del Tipo de Domiciliacin

Codificacin de Tributos y Conceptos de Pago

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

Cdigo de procedimiento de Recaudacin (CPR)

El formato de la lista de valores utilizada para codificar el Cdigo de Procedimiento


de recaudacin, que identifica el tipo de cuaderno:
Cdigo

Denominacin

7 pos. (numrico) Nombre del Procedimiento de Recaudacin

Pg. 61 de 111

4.5.10.

Cdigo IBAN

Debido a la entrada en vigor de la normativa SEPA es necesario incluir el cdigo


IBAN para cada una de las cuentas e informarlo a las diferentes entidades financieras
(EEFF) a travs de los cuadernos bancarios.
El cdigo IBAN es el identificador nico de la cuenta y es un campo que puede tener
hasta 34 caracteres dependiendo del pas de origen. En el caso de Espaa tiene 24
caracteres: 4 +20 del ccc.
Los primeros dos caracteres informan del pas donde est situada la cuenta, en el
caso de Espaa es ES, y los otros dos son dgitos de control.
Ejemplo: ES07
El IBAN es un cdigo que sigue una norma fija para su SPT puede transmitir hasta
dos cuentas bancarias:
1) Cuenta de Cargo: Cuenta bancaria de donde se van a obtener el importe
para realizar el pago.
2) Cuenta de domiciliacin: Si desea domiciliar el pago puede seleccionar
otro nmero de cuenta. Solo disponible para los cuadernos 57, 60_1, 60_2
Para los cuadernos 57, 60_1, 60_2 ser necesario enviar 8 caracteres en vez de 4,
en el caso de que se utilicen ambas para realizar un pago.
Se utiliza el Campo reservado para el Organismo (org_datos) para informar
de los correspondiente cdigos IBAN. El cdigo IBAN ir informado al final del campo
reservado para el organismo, en concreto entre las posiciones 47 y 54 inclusive. A
continuacin se explica con ms detalle:
o
o

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.

Unos ejemplos serian:


Pg. 62 de 111

1) Cargo en cuenta y domiciliado


1RED
ES70ES70
1,2,3,447,48,49,50,51,52,53,54

Se informa de los dos correspondientes IBAN.


2) Cargo en cuenta y sin domiciliar
1RED
ES70

1,2,3,447,48,49,50,51,52,53,54

Cuando el usuario utilice el modo de pago por cuenta bancaria, el IBAN de la


CCC siempre vendr informado, pero en el caso de que no se solicite la
domiciliacin del pago, los carcter reservados para el IBAN de la cuenta a
domiciliar est compuesto con espacios en blanco.

3) Pago con tarjeta y domiciliado


1RED

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.

Situacin de las Transacciones en el SPT

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

desconexin y le propone realizar el reintento de la


operacin.
Respuesta de la Entidad Financiera Colaboradora
con error Recuperable:
Cuando el mensaje devuelto por la EFC hace
EFC: Recibido Aviso
referencia a un error que puede ser corregido por
Recuperable
el administrado, y permitir a ste volver a
intentarlo.
Comunicacin al administrado para correccin y
reintento:
USU: Comunicado Error,
Cuando el SPT ha comunicado al administrado la
Esperando Reintento
forma en que puede resolver el error con la EFC y
reintentar la transaccin.
Respuesta de la Entidad Financiera Colaboradora
con error NO Recuperable:
Cuando el mensaje devuelto por la EFC hace
EFC: Recibido Error NO
referencia a un error que no puede ser corregido
Recuperable
por el administrado, teniendo que darse por
terminada la transaccin.
Comunicacin al administrado:
Cuando el SPT comunica al administrado que se ha USU: Comunicado Error NO
producido el error y no hay forma de resolver ni
Recuperable
reintentar la transaccin.
Recibido
NRC
de
la
Entidad
Financiera
Colaboradora:
EFC: Recibido NRC de la
Cuando el SPT recibe un NRC que confirma que se
EFC
ha ejecutado la orden de pago.
Envo del NRC al administrado con confirmacin:
Cuando el SPT comunica al administrado el NRC,
USU: Comunicado y
para que pueda continuar el proceso con el
Confirmado NRC
Organismo Acreedor, recibiendo confirmacin.
Envo del NRC al administrado SIN confirmacin:
Cuando el SPT comunica al administrado el NRC,
USU: Comunicado NRC, NO
para que pueda continuar el proceso con el
Confirmado
Organismo Acreedor, pero no ha recibido
confirmacin.

Pg. 65 de 111

4.7.2.

Operativa de las Transacciones por el SPT

La operativa se resume en la siguiente figura:

Pg. 66 de 111

Figura 11: Operativa en las Transacciones

Pg. 67 de 111

4.8.
4.8.1.

Condiciones de Error y Gestin de Excepciones


Gestin de Errores

Se considerarn como errores en la ejecucin de la interfaz, aquellas situaciones que


permitan al Organismo obtener una respuesta codificada del SPT, de acuerdo a la
tabla de valores adjunta.
Los errores a la hora de ejecutar la solicitud de una orden de pago, devueltos por la
EFC, sern tratados y trasladados al Organismo por el SPT, de forma que el
organismo o el administrado puedan conocer su situacin. En los casos en los que
sea posible, se proporcionarn los mecanismos de recuperacin previstos.

4.8.2.

Gestin de Excepciones

Se considerarn como excepciones en la ejecucin de la interfaz, aquellas situaciones


que no permitan al SPT obtener una respuesta codificada de la EFC. En los casos en
los que sea posible, se proporcionarn los mecanismos de recuperacin previstos.
Se contemplan las siguientes situaciones:

Se recibe una respuesta no interpretable; en este caso, se transforma


al cdigo de Respuesta 99.

No se consigue realizar una conexin con la EEFF; en este caso, se


realiza un reintento y, si persiste la misma situacin, se devuelve el
error EC. En este caso no se ha realizado el Pago.

Se realiza una conexin, pero no se recibe respuesta, y/o salta el Time


out por cualquier motivo. En este caso no se reintenta, se
devuelve el cdigo TO. Este es el caso en que el pago se ha
podido realizar, pero no es conocido por el SPT; se gestionara
en la consulta, por un evento de usuario en modo Web, o del
OA en modo Web Services.

Cualquier error no recuperable, el SPT lo interpreta y devuelve NR.

Pg. 68 de 111

4.8.3.

Mensajes de Error de Validacin de SPT

En la siguiente tabla se contemplan los mensajes de error de validacin que genera


SPT asociados a la solicitud de pago:
Cdigo
J0

Descripcin
Error en el campo nif de certificado es obligatorio y no ha sido informado.

J1

Error en el campo nif de certificado no contiene un valor vlido.

J2

Error en el campo fecha es obligatorio y no ha sido informado.

J3

Error en el campo fecha no contiene un valor vlido.

J4

Error en el campo hora es obligatorio y no ha sido informado.

J5

Error en el campo hora no contiene un valor vlido.

J6

Error en el campo CPR es obligatorio y no ha sido informado.

J7

Error en el campo CPR no contiene un valor vlido.

J8

Error en el campo pasarela es obligatorio y no ha sido informado.

J9

Error en el campo pasarela no contiene un valor vlido.

JA

Error en el campo tipo de peticin es obligatorio y no ha sido informado.

JB

Error en el campo tipo de peticin no contiene un valor vlido.

JC
JD

Error en el campo cdigo de la entidad financiera es obligatorio y no ha sido


informado.
Error en el campo cdigo de la entidad financiera no contiene un valor vlido.

JE

Error al validar la MAC de la Fecha y Hora es un dato incorrecto

JF

JJ

Error en el campo cdigo identificador medio de pago es obligatorio y no ha


sido informado.
Error en el campo cdigo identificador medio de pago no contiene un valor
vlido.
Error en el campo tipo medio de pago (Cdigo Cuenta Cliente o Nmero de
tarjeta) es obligatorio y no ha sido informado.
Error en el campo tipo medio de pago (Cdigo Cuenta Cliente o Nmero de
tarjeta) no contiene un valor vlido.
Error en el campo Fecha de caducidad es obligatorio y no ha sido informado.

JK

Error en el campo importe es obligatorio y no ha sido informado.

JG
JH
JI

JL

Error en el campo importe no contiene un valor vlido.

JM

Error en el campo nif del representante 1 no contiene un valor vlido.

JN

Error en el campo nif del representante 2 no contiene un valor vlido.

JO

Error en el campo nombre del representante 1 no contiene un valor vlido


(Supera los 40 caracteres).
Error en el campo nombre del representante 2 no contiene un valor vlido
(Supera los 40 caracteres).
Error en el campo nombre del contribuyente no contiene un valor vlido

JP
JQ

Pg. 69 de 111

(Supera los 40 caracteres).


JR

Error en el campo reservado es obligatorio y no ha sido informado.

JS

Error en el campo reservado no contiene un valor vlido.

JT

JV

Error en el campo cdigo de organismo en el campo reservado contiene un


valor no vlido.
Error en el campo cdigo del organismo emisor es obligatorio y no ha sido
informado.
Error en el campo superorganismo no contiene un valor vlido.

JW

Error en el campo organismo emisor no contiene un valor vlido.

JX

Error en el campo idioma es obligatorio y no ha sido informado.

JY

Error en el campo idioma no contiene un valor vlido.

JU

JZ

Error en el campo url es obligatorio y no ha sido informado.

K0

Error en el campo url no contiene un valor vlido.

K1

Error en el campo Referencia es obligatorio y no ha sido informado.

K2

Error en el campo Referencia no contiene un valor vlido.

K3

K7

Error en el campo (ident1) la primera parte de la identificacin es obligatorio y


no ha sido informado.
Error en el campo (ident1) la primera parte de la identificacin no contiene un
valor vlido.
Error en el campo (ident2) la segunda parte de la identificacin es obligatorio y
no ha sido informado.
Error en el campo (ident2) la segunda parte de la identificacin no contiene un
valor vlido.
Error en el campo Concepto no contiene un valor vlido.

K8

Error en el campo cdigo domiciliacin es obligatorio y no ha sido informado.

K4
K5
K6

K9

Error en el campo cdigo domiciliacin no contiene un valor vlido.

KA

Error en el campo ccc de domiciliacin es obligatorio y no ha sido informado.

KB

Error en el campo ccc de domiciliacin no contiene un valor vlido.

KC

Error en el campo justificante es obligatorio y no ha sido informado.

KD

Error en el campo justificante no contiene un valor vlido.

KE

Error en el campo nif contribuyente es obligatorio y no ha sido informado.

KF

Error en el campo nif contribuyente no contiene un valor vlido.

KG

Error en el campo cdigo de modelo es obligatorio y no ha sido informado.

KH

Error en el campo cdigo de modelo no contiene un valor vlido.

KI

Error en el campo acreditacin de pagos por cuenta de terceros es obligatorio y


no ha sido informado.
Error en el campo acreditacin de pagos por cuenta de terceros no contiene un
valor vlido.
Error en el campo la acreditacin de pagos por cuenta de terceros el
NIF_CERTIFICADO es distinto del NIF_CONTRIBUYENTE

KJ
KK

Pg. 70 de 111

KL

Error en el campo expediente no contiene un valor vlido.

KM

Error en el campo fecha de devengo no contiene un valor vlido.

KN

Error en el campo informacin especifica no contiene un valor vlido.

KO

Error en el campo anagrama fiscal es obligatorio y no ha sido informado.

KP

Error en el campo anagrama fiscal no contiene un valor vlido.

KQ

Error en el campo cdigo territorial no contiene un valor vlido.

KR

Error en el campo concepto autoliquidacin no contiene un valor vlido.

KS

Error en el campo identificacin no contiene un valor vlido.

KT

El cuaderno no tiene un cdigo de organismo vlido.

KU

El SOAP recibido es incorrecto.

KV

La peticin no viene firmada.

KW

No se pudo conectar con ASF.

KX

No viene un nif del certificado en el pago.

KY

Pago firmado por ms de dos firmantes. Error de validacin.

KZ

Nmero de serie no validado contra el superorganismo.

L0

Error al obtener del repositorio los datos del organismo.

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

Error detectado en la aplicacin de firma webservice.

L8

Firma No Vlida

L9

Certificado no vlido (Intervalo de validez incorrecto).

LA

Certificado no verificado (la firma de la CA sobre el mismo no es correcta).

LB
LC

Certificado revocado (el certificado ha sido revocado, posteriormente se


aadirn a este cdigo las razones de revocacin).
El estado de revocacin del certificado no se ha podido verificar.

LE

El uso del certificado en esta aplicacin y operacin no es vlido.

L4

LF

El algoritmo de firma no est definido.

LG

El algoritmo de firma no es valido

LH

El certificado no se encontr.

LI

El xml no tiene el formato XMLDSig correcto

LJ

No se encontr la cadena del certificado de la firma


Pg. 71 de 111

LK

Los datos del pago no han superado la validacin XSS

LL

El dgito de control del campo Justificante no es vlido.

LM

El dgito de control del campo Referencia no es vlido.

LQ

No se ha informado del IBAN asociado al CCC


No se ha informado del IBAN asociado a la CCC domiciliada
Error en el cdigo IBAN asociado al CCC

LR
LS
LT
LU
LV

4.8.4.

Error en el cdigo IBAN asociado al CCC domiciliada


Error no hay un CCC pero se informan de un cdigo IBAN
Error no hay un CCC Domiciliada pero se informan de un cdigo IBAN

Mensajes de Error de la Entidad Financiera Colaboradora

En la siguiente tabla se contemplan los mensajes de error asociados a la solicitud de


pago provenientes de la entidad financiera:
Cdigo

Descripcin

Operacin finalizada OK

Nmero de justificante o importe errneo o ausente

Modelo o tipo de operacin no soportado

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

El certificado firmante no est autorizado para pagar y presentar

Pg. 72 de 111

este modelo
7

El certificado firmante no est autorizado para realizar este pago por


convenio

La entidad emisora de esta tarjeta no admite este tipo de servicio

10

Concepto o modelo errneo

11

Falta concepto o modelo

12

Ejercicio fiscal errneo

13

Falta ejercicio fiscal

14

Perodo errneo

15

Falta perodo

16

Tipo de moneda errneo (distinto de P o E)

17

NIF/CIF incorrecto para este modelo

18

Falta tipo de moneda

19

Importe ingreso errneo

20

Falta importe de ingreso

21

NIF contribuyente errneo

22

Falta NIF del contribuyente

23

NIF del primer representante errneo

24

Falta NIF del representante

25

Sobra NIF del representante

26

Falta nombre del contribuyente

27

Falta nombre del representante

28

Sobra nombre del representante

29

Cdigo administracin errneo

30

Falta cdigo administracin

31

Anagrama errneo

32

Falta anagrama

33

Sobra anagrama

34

Importe total y parcial no cuadra

35

Falta importe total

36

Sobra importe total

37

Opcin fraccionamiento errnea

38

Falta opcin fraccionamiento

39

C.C.C. (Cdigo Cuenta Cliente) errneo

40

Falta C.C.C. (Cdigo Cuenta Cliente)

41

Importe redenominacin errneo

42

Falta importe redenominacin


Pg. 73 de 111

43

Tipo de operacin errneo

44

Falta tipo de operacin

45

Tipo de peticin errneo (distinto de 01 o 02)

46

Falta tipo de peticin

47

Tipo de autoliquidacin errneo (distinto de I o D)

48

Falta tipo de autoliquidacin

49

NIF del segundo representante errneo

50

Concepto o modelo no permitidos

51

Ejercicio fiscal no permitido

52

Perodo no permitido

53

Ingreso no fraccionable por estar fuera del perodo voluntario

54

Ingreso fuera de perodo

55

Movimiento distinto de 01 y 02

56

NIF certificado distinto a NIF tecleado

57

NIF primer certificado distinto a NIF tecleado

58
59

NIF segundo certificado distinto a NIF tecleado


El horario de servicio es desde las 2:00 h hasta las 23:00 h
diariamente

60

Fecha de presentacin fuera de plazo

61

Importe total de la deuda errneo

62

Autoridad certificadora errnea

63

Certificado caducado

64

Certificado revocado

65

Presentador no autorizado en nombre de terceras personas

66

Ha firmado 2 veces con el mismo representante

67

Perodo impositivo/ concluido errneo

68

Fecha de conclusin perodo impositivo errnea

69

Error de formato en los datos de la peticin

70

Peticin duplicada. Utilice la opcin de consulta

71

No existe cargo con los datos consultados

72

C.C.C. cancelado

73

C.C.C. bloqueado (judicialmente)

74

C.C.C. con saldo no disponible

75

C.C.C. con saldo insuficiente

76

C.C.C. cuenta no es de ahorro a la vista

77

C.C.C. inexistente

78

C.C.C. inoperante
Pg. 74 de 111

79

NIF del contribuyente no titular a la cuenta

80

NIF representante no apoderado de la cuenta

81

Contribuyente no persona jurdica (e informa representante)

82

Falta segundo NIF por ser cuenta conjunta

83

El segundo NIF no corresponde a titular de la cuenta

84

MAC errneo

85

87

No hay suficientes apoderados


Esta entidad no atiende la solicitud de cargo por esta va en este
rango horario (y se le aade opcionalmente explicacin de horario de
servicio que puede venir en la cadena de respuesta desde la posicin
211 hasta la 400)
Texto de la Entidad Colaboradora en la cadena de respuesta desde la
posicin 211 hasta la 400 con explicacin amplia sobre la incidencia
y telfono de atencin al cliente.

88

Contribuyente no identificado

89

Fecha de validez/caducidad de la tarjeta excedida, errnea o ausente

90

No est autorizado para realizar el pago por personas ajenas

91
92

Nmero de tarjeta no vlido, errneo o ausente


El titular del certificado con que se ha firmado no es titular de la
tarjeta

93

Se ha excedido el lmite de la operacin

94

Tipo de tarjeta no soportado

95

Slo se aceptan tarjetas emitidas por la propia entidad

99

Error tcnico

A4

NRC no existe

A6

NIF no existe

A7

NRC ya constituido. Intntelo por consulta

A8

NRC no preconstituido. Intntelo por consulta

A9

NRC ya existe

B6

NRC no disponible para devolucin

B8

NRC ya liberado

C1

Incoherencia de datos

C2

NRC de operacin ya existe

F2

NRC no disponible para devolucin, ya devuelto

H4

Imposible cobro, NRC ya cobrado

I3

Dgito de control errneo.

I4

Carcter de control errneo.

I6

Error en el modelo de operacin.

86

Pg. 75 de 111

I7

Error en el cdigo del Banco de Espaa.

I8

Error en el cdigo IBAN

Pg. 76 de 111

5. OTRAS CONSIDERACIONES
5.1.

Especificaciones no Funcionales (Tcnicas)

Existir un entorno de integracin, tanto en el SPT como en cada Organismo


Acreedor, que permita realizar todas las pruebas necesarias para garantizar el
funcionamiento de la interfaz. La direccin del entorno de integracin de SPT es:

Para los casos de pagos de Ciudadanos y Representantes en su nombre la url


a utilizar es la siguiente:
https://spt.demo.red.es/PAGO/

Adems del entorno de pruebas de integracin Red.es pone a disposicin de los


OOAA un Simulador de Entidades Financieras. Utilizando este simulador se puede
completar el plan de pruebas propuesto sin intervencin de la EFC. An as hay
entidades financieras que mantienen activo el entorno de integracin con las que se
pueden realizar pruebas. Existe una batera de pruebas funcionales (AE_SPT_Bateria
de Pruebas_v1.0.xls) a disposicin de los organismos, que les puede servir de ayuda
de cara al diseo del plan de pruebas.
Una vez completadas estas pruebas de integracin ser necesario que el Organismo
coordine con sus EEFFCC la realizacin de las pruebas necesarias para la puesta en
marcha del servicio. Esta fase es muy importante y sern necesarios los siguientes
pasos:

Envo a Red.es de la adhesin a SPT firmada por el Organismo.

Peticin de Alta en Produccin en SPT.

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.

Pruebas en Produccin con las Entidades Financieras Colaboradoras.

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.

Requerimientos tcnicos del equipo usuario de SPT.


Hardware

Especificaciones del equipamiento de usuario: el usuario utilizar como terminal de


acceso a las aplicaciones y servicios un ordenador conectado a Internet que pueda
cumplir los requerimientos de software.
5.3.2.

Software

Especificaciones del equipamiento de usuario: el usuario utilizar uno los


navegadores establecidos en el siguiente apartado, con soporte de HTML 3.2, XML
1.0, scripts de cliente (applets Java, Java scripts) y cookies.
Especificaciones tcnicas de los certificados de usuario: los certificados debern
cumplir, al menos, las siguientes especificaciones tcnicas:
La identificacin de los usuarios y las firmas se realizar mediante un
sistema de claves asimtricas y certificados digitales, que sern compatibles
con el estndar X.509 v3, e interoperables con las tecnologas de los
navegadores al uso.
Los certificados sern emitidos por los prestadores de servicios de
certificacin. Estos certificados debern cumplir los requisitos establecidos por
el Real Decreto-Ley 14/1999 sobre Firma Electrnica. La lista de prestadores
admitidos por SPT estn disponibles en pago.red.es.
5.3.2.1.

Sistemas operativos soportados

Se soportan completamente los siguientes


documentacin de componentes de firma):
Pg. 78 de 111

sistemas

operativos

(segn

Microsoft Windows XP y superior.

Linux Ubuntu.

Si el cliente de firma utilizado es Websigner (5.7.3.0) podemos adems utilizar:


o

Linux Suse 9.2.

Si el cliente de firma utilizado es @Firma 3.2 (descargado de spt.red.es) podremos


adems utilizar:
o

Windows 2000, Server 2003, Server2008.

Linux Guadalinex.

MacOS X 10.5.

Sun Solaris / OpenSolaris 10.

5.3.2.2.

Navegadores de Internet soportados

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

La utilizacin de otro Navegador o versin del mismo no garantiza su correcto


funcionamiento.
El navegador deber tener activada la opcin de cookies.

Pg. 79 de 111

Para Internet Explorer 9 se recomienda el uso de modo Vista Compatibilidad.

5.4.

Comunicaciones

El sistema de comunicaciones deber cumplir las siguientes condiciones de


seguridad:
Se adoptarn las medidas de seguridad adecuadas en los niveles fsico, lgico y
organizativo, segn lo establecido en el Real Decreto-Ley 14/1999, de 17 de
septiembre, sobre firma electrnica. Adems, se estar a lo dispuesto en el Real
Decreto 994/1999, de 11 de junio, por el que se aprueba el Reglamento de medidas
de seguridad de los ficheros automatizados que contengan datos de carcter
personal.
En el nivel lgico, la autenticacin para el acceso a los ttulos se realizar mediante
el certificado que acredita su posesin, registrndose en ficheros Log todos los
accesos. La comunicacin a travs de las redes, tanto entre los usuarios y los
prestadores de servicios de certificacin, como entre stos, se har siempre con
canales cifrados, utilizando el protocolo de encriptacin SSL 3.0, migrable en el
futuro a TLS.
La criptografa asimtrica se basar en algoritmos tipo RSA (o DSA para la firma
electrnica), con una longitud de clave de 512 a 2048 bits. Para el cifrado simtrico
se utilizar RC4, con clave de hasta 128 bits. El clculo del hash se realizar con
SHA-1 o MD5.
Se adoptarn las medidas de seguridad fsica correspondientes, tales como
ubicacin segura de los equipos, alimentacin ininterrumpida, control de accesos,
etc. Se efectuarn las copias de seguridad pertinentes, almacenndose estos ltimos
en secuencia cronolgica, con la finalidad de guardar registro de las posibles
incidencias.

Pg. 80 de 111

6. ANEXO I: EJEMPLOS DE LAS LISTAS DE VALORES


6.1.

Codificacin de Entidades Financieras Colaboradoras

La lista de valores utilizada para codificar las Entidades Financieras Colaboradoras es


la correspondiente al NRBE (Nmero de Registro del Banco de Espaa).

6.2.

Codificacin de Organismos Acreedores

Se utilizar las listas de valores de los Cuadernos 60 y 65 para codificar los


Organismos Acreedores de la Administracin Autonmica y Local

6.3.

Identificacin de Pasarelas de Pago

La lista de valores utilizada para codificar las Pasarelas de Pago es la siguiente:


Cdigo
01

6.4.

Pasarela de Pago
Servicio de Pago Telemtico de Red.es

Tipos de Peticiones

La lista de valores utilizada para codificar los Tipos de Peticiones es la siguiente:


Cdigo
01
02

6.5.

Tipo de Peticin
Alta
Consulta

Identificacin de los Medios de Pago

La lista de valores utilizada para codificar los Medios de Pago es la siguiente:


Cdigo
1
2

Medio de Pago
Cargo en Cuenta
Tarjeta cargo a dbito

Pg. 81 de 111

6.6.

Codificacin Territorial

Se utilizar las listas de valores de los Cuadernos 60 y 65 para codificar los


Organismos adheridos al SPT.

6.7.

Codificacin de Domiciliaciones

La lista de valores utilizada para codificar los Tipos de Domiciliacin es la siguiente:


Cdigo
1
2

6.8.

Tipo de Domiciliacin
Domiciliacin = SI
Domiciliacin = NO

Codificacin de Tributos y Conceptos de Pago

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.

Cdigo de Procedimiento de Recaudacin (CPR)

La lista de valores utilizada para codificar los Tipos de Cuaderno es la siguiente:


Cdigo

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

6.10. Codificacin de Idiomas


La lista de valores utilizada para codificar el Idioma que el SPT emplear en su
operativa son los siguientes:
Cdigo
0
1
2
3

Idioma
Castellano
Cataln
Gallego
Euskera

6.11. Codificacin de tipo de Cliente de Firma


La lista de valores utilizada para codificar el tipo de cliente de firma que el SPT
emplear en su operativa son los siguientes:
Cdigo
Descripcin
WEBSIGNER Cliente de firma Websigner
AFIRMA
Cliente de firma @Firma

Si no se especifica ninguno por defecto se instalar Websigner.

6.12. Codificacin de tipo de Firma


La lista de valores utilizada para codificar el tipo de firma que el SPT emplear en su
operativa (slo aplicable a tipo de Cliente Websigner) son los siguientes:
Cdigo
1
3

Descripcin
Tipo de firma PKCS#7
Tipo de firma CMS
Pg. 84 de 111

7
2
5

Tipo de firma CAdES


Tipo de firma XMLDSig
Tipo de firma XAdES

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

7. ANEXO II: VALIDACIONES


7.1.

Relacin de Validaciones

Para obtener un listado completo de las validaciones, referirse al listado de errores


de SPT del punto 4.8.3.

7.2.

Clculo de los dgitos de control del nmero de referencia


(Cuaderno 57)

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.

Clculo de los dgitos de control del nmero de referencia


(Cuaderno 60 mod. 1 y 2)

Para el clculo de los dgitos de control del nmero de referencia, segn se especifica
en el Cuaderno 60, se utilizar el siguiente algoritmo:

1. Se definen tres nmeros con la siguiente composicin:


a. Emisora (6p, incluido el dgito de control).
b. Referencia (10p, sin dgitos de control).
c. Identificacin (ident_1 + ident_2) + Importe (12 p).
2. Para el clculo se considerara el importe completo, como si de una cantidad
entera se tratase (155,80 euros, se tomar 15580; 176,00 euros, se tomar
17600).
3. Para el clculo de los dgitos de control, la identificacin cambia en el caso de
la modalidad 2, y pasamos el dgito discriminante del perodo (la ltima
posicin del campo ident_2) a la primera posicin.
Supongamos que se trata de los siguientes datos:

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

Y la referencia ser 500043164988

7.4.

Clculo de los dgitos de control


justificante (Cuaderno 60 mod. 3)

del

nmero

de

Para el clculo de los dgitos de control del nmero de justificante, segn se


especifica en el Cuaderno 60, se utilizar el siguiente algoritmo:
1. Se suma al nmero de justificante (sin el dgito de control) la clave de
emisora (con el dgito de control).
2. El resultado as obtenido se divide por 7, obteniendo el resto R, que ser el
digito de control.
3. Si el resto de la divisin fuese cero el dgito de control ser el siete.
Supongamos que se trata de los siguientes datos:
org: 20009-8
num_just(sin dgito): 099812345612
Para obtener el dgito se realizarn las siguientes operaciones:
099812345612 + 200098 = 99.812.545.710
99812545710 : 7 = 14.258.935.101 con un resto de 3
R = 3 siendo ste el dgito de control
Y por tanto el nmero de justificante ser: 0998123456123

Pg. 88 de 111

7.5.

Clculo de los dgitos de


justificante (Cuaderno 65)

control

del

nmero

de

Para el clculo de los dgitos de control del nmero de justificante, segn se


especifica en el Cuaderno 60, se utilizar el siguiente algoritmo:
1. Dividir las doce primeras cifras de la izquierda por 7, obteniendo el resto R.
2. S el resto de la divisin es cero, el dgito de control ser cero. En caso
contrario se obtendr el complemento a siete del resto (7-R) y el dgito as
obtenido es el dgito control.
num_just ( sin dgito ): 099900851234
Para obtener el dgito se realizarn las siguientes operaciones:
099900851234 : 7 = 14.271.550.176 con un resto de 2 ( R = 2 )
El complemento ser: 7 - 2 = 5 siendo este el dgito de control
El nmero con el dgito de control es por tanto: 0999008512345

7.6.

Validaciones para el cumplimiento de la normativa SEPA.

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

Si no se cumple la validacin el SPT informar de un error LU


3) Se valida que el IBAN de la cuenta aportada sea correcto.
Si no se cumple la validacin el SPT informar de un error LS
4) Si el organismo informa de un CCC domiciliada se comprobar que
venga incluido 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
5) 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
6) 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.6.2.

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

No se realizan validaciones relacionado con el CCC ya que en el paso uno del


pago se permite su edicin. Si el ciudadano intenta avanzar al paso dos del
pago con un IBAN incorrecto el sistema no se lo permitir.
Pg. 90 de 111

7.7.

Algoritmo para el clculo del IBAN

El algoritmo encarado de calcular los dgitos de control del IBAN se encuentra


especificado en el documento Folleto-37 el cual ha sido elaborado por la AEB
(Asociacin Espaola de Banca) en Noviembre del 2011. En este documento se
describen los paso necesarios a realizar para la obtencin a partir de un CCC del
nmero IBAN asociado.
El algoritmo es el siguiente:
Crear un cdigo previo de IBAN compuesto del cdigo de pas (segn ISO 3166), ES
en el caso espaol, seguido de 00 y el BBAN (el C.C.C. en Espaa)
Ejemplo: Un C.C.C. 0012 0345 03 0000067890 se convierte en
ES0000120345030000067890
Paso 1
Trasladar los cuatro primeros caracteres del IBAN a la derecha del Cdigo:
Resultado: 00120345030000067890ES00
Paso 2
Convertir las letras en nmeros con arreglo a la tabla de conversin recogida
en el apartado 2.3 descrito en el Folleto-37.
Resultado: 0
Paso 3
Calcular el mdulo 97 (resto de la divisin por 97 del IBAN creado) y
estableciendo la diferencia entre 98 y el resto. Si el resultado es un dgito,
anteponer un cero.
98 91 = 07
El IBAN creado sera: ES07 0012 0345 03 0000067890

Pg. 91 de 111

Pg. 92 de 111

8. ANEXO III: DICCIONARIO DE CAMPOS

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

En personas jurdicas nunca lo lleva (a ceros).


En personas fsicas, en liquidaciones nunca lo
lleva (a ceros), pero en autoliquidaciones puede
llevarlo o no. Si no se dispone de este dato, se
graba el nombre y apellidos del contribuyente.
Cdigo Cuenta Cliente (CCC) o Nmero de
Tarjeta
Definicin: Nmero de cuenta o de tarjeta en la que se
realiza el cargo.

Long

Pg. 93 de 111

Nombre

Descripcin

Long

Tipo

20

AN

Origen: En modo Web, podr ser proporcionada por el


Organismo o se rellenar al invocar el SPT. En Modo
Web Service, el Organismo proporcionar este dato.
Formato: Para el cargo en cuenta, las 20 posiciones
del Cdigo Cuenta Cliente.
Para tarjeta: PAN (16) + Fecha Caducidad (4) (en
modalidad Web).

ccc_dom

Cdigo Cuenta Cliente Domiciliacin (CCC


Domiciliacin)
Definicin: Nmero de cuenta para la domicializacin.
Origen: En modo Web, podr ser proporcionada por el
Organismo o se rellenar al invocar el SPT. En Modo
Web Service, el Organismo proporcionar este dato.
Formato: Para el cargo en cuenta, las 20 posiciones
del Cdigo Cuenta Cliente.
Este campo debe estar relleno si el campo cod_dom
tiene valor 1.

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

Origen: la Comunidad Autnoma del emisor.


Formato:
XX: Cdigo de la Consejera u Organismo Autnomo.
YY: Cdigo de provincia.
ZZ: Cdigo de la oficina de administracin u rgano
gestor.
Concepto de pago (sufijo en Cuaderno 57):

con_pago

Definicin: El identificador discriminante para que una


misma Emisora pueda efectuar recaudaciones
Pg. 95 de 111

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

Entidad Financiera Colaboradora


Definicin: Cdigo del Banco de Espaa asignado a la
Entidad Financiera Colaboradora que va a recibir y
ejecutar la Orden de Pago.
Origen: En Modo Web Service, el Organismo debe
proporcionar el cdigo de la EFC a la que se le
solicitar la Orden de Pago.
En Modo Web, si el Organismo no lo proporciona, el
SPT lo pedir al usuario que est efectuando la
operacin.
Formato: Cuatro dgitos, de acuerdo a la lista de
valores.

ejercicio

Ejercicio
Definicin: Ao al que corresponde el tributo.
Origen: el Organismo proporcionar este dato.
Formato: Ao con 4 dgitos

DD - Dos dgitos correspondientes al da del mes.

Fecha Caducidad (en modalidad Webservices y


en Cuaderno 57)
Definicin: fecha de caducidad de la tarjeta
fec_cad

fec_oper

Origen: el Organismo proporcionar este dato.


Formato: MMAA
MM - Dos dgitos correspondientes al mes.
AA Dos dgitos del ao.
Fecha Operacin
Definicin: fecha en la que la operacin ha sido
efectuada por la Entidad Financiera Colaboradora.
Origen: Valor devuelto por la EFC.
Formato: AAAAMMDD
AAAA - Cuatro dgitos del ao.
MM - Dos dgitos correspondientes al mes.
Pg. 97 de 111

Nombre

Descripcin

Long

Tipo

fecha

Fecha de la Solicitud de Pago


Definicin: Fecha en la que se realiza la solicitud de
pago.
Origen: Esta fecha la informa el Organismo Acreedor y
se debe corresponder con el da en que se realiza la
solicitud. En los casos de reintento el SPT actualiza
esta fecha al da en que realiza el reintento.
Formato: AAAAMMDD
AAAA - Cuatro dgitos del ao.
MM - Dos dgitos correspondientes al mes.
DD - Dos dgitos correspondientes al da del mes.

hora

Hora de la Solicitud de Pago


Definicin: Hora en la que se realiza la solicitud de
pago. Origen: Esta hora la informa el Organismo
Acreedor y se debe corresponder con la hora en que
se realiza la solicitud. En los casos de reintento el SPT
actualiza esta hora a la del momento en que realiza el
reintento.
Formato: HHMMSSZZZZ
HH - Dos dgitos correspondientes a la hora.
MM - Dos dgitos correspondientes a los minutos.
SS - Dos dgitos correspondientes a segundos.
ZZZZ - Cuatro dgitos correspondientes a diez
milsimas de segundo.

10

DD - Dos dgitos correspondientes al da del mes.

Pg. 98 de 111

Nombre

ident_1

ident_2

Descripcin

Long

Tipo

Primera parte de la Identificacin


Definicin: El identificador discriminante para que una
misma Emisora pueda efectuar recaudaciones
diferenciadas, esto es, para diferentes tributos.
Origen: Este dato es proporcionado por el Organismo.
Formato:
Para la modalidad 1, se rellena a ceros.
Para la modalidad 2, tres dgitos correspondientes al
cdigo del tributo, concepto o gravamen.
Para la modalidad 3, tres dgitos correspondientes al
cdigo del modelo.

Segunda parte de la Identificacin


Definicin: Identificador de ejercicios y periodos de
cobranza para el mismo tributo, de forma que
diferencia las diferentes remesas pasadas al cobro y la
fecha lmite de pago en entidades bancarias para las
mismas.
Origen: Este dato es proporcionado por el Organismo.
Formato:
Para la modalidad 1, el identificador propiamente
dicho. Tal y como se define en el cuaderno 60, se
compone de los siguientes valores: cdigo de tributo o
concepto (3), ejercicio (2), remesa (2).
Para la modalidad 2, siete dgitos compuestos por los
siguientes valores:
ejercicio (2),
ultimo digito ao (1),
fecha juliana (3),
dgito discriminante periodo (1), que admite los
siguientes valores:
1 - cuando en el tributo figure un nico perodo de
pago e importe.
5 - cuando en el tributo figuren dos perodos de
pago y, por tanto, dos importes (se consignar el
primer importe)
9 - cuando en el tributo figuren dos perodos e
Pg. 99 de 111

Nombre

Descripcin

Long

Tipo

12

20-25

AN

importes (se consignar el segundo)


Para la modalidad 3, se rellena a ceros.
Identificacin
Definicin: Es un dato para identificar la notificacin.
Origen: el Organismo indicar este dato.
Formato: 6 dgitos numricos, relleno con ceros a la
izquierda.
Puede figurar una fecha, una clave o cualquier otra
informacin que la Emisora crea conveniente. Si se
identificacion
desea que la Entidad de Crdito controle la fecha
lmite de pago a requerimiento de la Emisora, ser
necesario que en este campo figure la fecha con
formato DDMMAA.
Si con_pago (3 ltimas cifras de cod_emisor) < 500
ser libre.
Si con_pago >= 500 tendr formato DDMMAA (ltimo
da de pago)
Idioma
Definicin: Idioma con el que se le presentar la
idioma
informacin al usuario.
Origen: el Organismo indicar la preferencia.
Formato: 1 dgito correspondiente a la lista de valores.

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

Pg. 100 de 111

Nombre

Descripcin

Long

Tipo

determinado. De acuerdo a los cuadernos 60 con 20


posiciones y 65 con 25 posiciones (segn aplique).

medio

Identificador del medio de pago


Definicin: este campo especifica el medio de pago
que se va a utilizar.
Origen: En Modo Web, el SPT podr pedir este dato a
usuario. En Modo Web Services, el Organismo deber
proporcionar este dato.
Formato: los valores posibles son:
1 para Cargo en cuenta
2 para Pago con tarjeta cargo a dbito

modelo

Modelo
Definicin: Identificador de la plantilla o formulario en
la que se va a basar la autoliquidacin.

nif_cert

NIF del Certificado


Definicin: CIF (si es de Persona Jurdica) NIF (si es de
Persona Fsica) del Certificado que se utiliza para
solicitar la Orden de Pago.
Origen: En Modo Web, el SPT tomar este dato del
certificado del usuario. En Modo Web Services, el
Organismo deber proporcionar este dato.
Formato: formato del Nmero de Identificacin Fiscal,
relleno con ceros a la izquierda.

AN

nif_cont

NIF del Contribuyente


Definicin: NIF del sujeto Pasivo al que corresponde el
tributo/tasa.
Origen: El Organismo deber proporcionar este dato.
Formato: formato del Nmero de Identificacin Fiscal,
relleno con ceros a la izquierda.

AN

Pg. 101 de 111

Nombre

Descripcin

Long

Tipo

nif_rep1

NIF del Representante 1


Definicin: NIF del primer representante.
Origen: El Organismo deber proporcionar este dato.
Formato: formato del Nmero de Identificacin Fiscal,
relleno con ceros a la izquierda.

AN

nif_rep2

NIF del Representante 2


Definicin: NIF del segundo representante.
Origen: El Organismo deber proporcionar este dato.
Formato: formato del Nmero de Identificacin Fiscal,
relleno con ceros a la izquierda.

AN

nom_cont

Apellidos y Nombre o Razn Social del


Contribuyente
Definicin: Apellidos y Nombre (o Razn Social) del
sujeto Pasivo al que corresponde el tributo/tasa.
Origen: El Organismo deber proporcionar este dato.
Formato: hasta 40 caracteres alfanumrico.

40

AN

nom_rep1

Apellidos y Nombre del Representante 1


Definicin: Apellidos y Nombre del primer
representante.
Origen: El Organismo deber proporcionar este dato.
Formato: hasta 40 caracteres alfanumrico o espacios
si no corresponde.

40

AN

nom_rep2

Apellidos y Nombre del Representante 2


Definicin: Apellidos y Nombre del segundo
representante.
Origen: El Organismo deber proporcionar este dato.
Formato: hasta 40 caracteres alfanumrico o espacios
si no corresponde.

40

AN

Pg. 102 de 111

Nombre

Descripcin

Long

Tipo

22

AN

NRC (Nmero de Referencia Completo)


Definicin: Cdigo devuelto por la Entidad Financiera
Colaboradora cuando la operacin se ha completado
con xito.
Origen: La Entidad Financiera Colaboradora
proporciona este dato.
Formato: 22 posiciones alfanumricas (ver
documentacin).

nrc

Cuaderno 65: El NRC constar de 22 posiciones,


desglosadas en el Nmero de Justificante (13p + 1p)
se aade un cero a la izquierda de los 13 dgitos del
justificante, ms los caracteres de control (8p).
Cuaderno 60, modalidades 1 y 2: El NRC consta de
22 posiciones, desglosadas en el Nmero de
Referencia (12p + 2p) se aade dos ceros a la
izquierda de los 12 dgitos del nmero de referencia
ms los caracteres de control (8p)
Cuaderno 60, modalidad 3: El NRC constar de 22
posiciones, desglosadas en el Nmero de Justificante
(13p + 1p) se aade un cero a la izquierda de los 13
dgitos del justificante, ms los caracteres de control
(8p).
Cuaderno 57: El NRC consta de 22 posiciones,
desglosadas en el Nmero de Referencia (13p + 1p)
se aade un cero a la izquierda de los 13 dgitos del
nmero de referencia ms los caracteres de control
(8p)

Pg. 103 de 111

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.

Pg. 104 de 111

Long

Tipo

Nombre

Descripcin

Long

Tipo

12

AN

13

Campos para clculo de los caracteres de control


del NRC en el cuaderno 60, modalidad 3:
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 57:
Los campos utilizados sern:
- Nmero de Referencia: 14 posiciones (Un dgito a la
izquierda relleno a 0. + Trece 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.

num_exp

num_just

Total longitud campos: 48 posiciones.


Nmero de Expediente
Definicin: Nmero de procedimiento asociado a la
gestin del hecho imponible a liquidar. Slo se dar en
caso de que el interesado o pagador tenga abierto un
procedimiento conocido con la administracin.

Nmero de Justificante
Definicin: Campo identificador de un pago en
Pg. 105 de 111

Nombre

Descripcin

Long

Tipo

Cuaderno 60 mod. 3 y Cuaderno 65.


Formato:
Cuaderno 60, modalidad 3:
MMM Y ZZZZZZZZ D siendo:
M: cdigo de tributo o modelo
Y: indicador de datos a capturar
Z: nmero secuencial por concepto tributario y
modelo
D: dgito de control.
Valores que puede adoptar el indicador Y:
0 = No se capturan datos opcionales
1 = Se captura el expediente
2 = Fecha de devengo
3 = Expediente y fecha de devengo
4 = Dato especifico
5 = Expediente y dato especifico
6 = Fecha de devengo y dato especifico
7 = Fecha de devengo, dato especifico y expediente
8 = No se captura NIF / CIF (contribuyente) ni datos
opcionales

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

Cdigo del Organismo Emisor


Definicin: Identificador del Organismo que realiza la
emisin o gestin de la recaudacin de las
5, 6 u
autoliquidaciones / recibos. Las 2 primeras cifras se
8
asignan al Organismo, segn el BOE 07/02/1989. Este
cdigo debe ajustarse a los reconocidos por la
AEB/CECA, y en caso de necesitar uno nuevo habra
que contactar con AEB/CECA para obtenerlo.

Pg. 106 de 111

Nombre

Descripcin

Long

Tipo

Inicialmente slo debern pedirlo a AEB aquellos


organismos que no estn definidos en el apartado de
Anexos de la Norma CSB.
Origen: el Organismo proporcionar este dato.
Formato:
Las 2 primeras posiciones: Cdigo Comunidad
Autnoma
Las 2 siguientes: 00 si es Comunidad Autnoma
La ltima posicin es el dgito de control (mdulo 11).
En el cuaderno 57 estar formado por las posiciones
numricas del NIF/CIF de la Emisora.

org_datos

Campo reservado para Organismo


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
Segn
24 a la 44 (20 posiciones) el cdigo de Organismo que
Cuad. y
asigne el SPT. Las posiciones del 47 al 54 inclusive
ajuste
estn reservadas para informar de los cdigos IBAN
para
pertinentes (Ver punto 4.4.9)
MAC
Dependiendo del cuaderno la longitud del campo
difiere:
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.
Pg. 107 de 111

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

Nmero de Tarjeta (en modalidad Webservices


salvo el C57)
Definicin: Nmero de tarjeta en la que se realiza el
cargo.
Origen: En Modo Web Service, el Organismo
proporcionar este dato.

pasarela

Identificador pasarela de pago:


Definicin: Cdigo utilizado para identificar la pasarela
de pago.
Origen: en el SPT este valor es 01, en este momento.
El Organismo proporciona este dato.
Formato: dos caracteres numricos.
01 Servicio de Pago Telemtico de RED.ES

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:

Pg. 109 de 111

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

Campo reservado para Organismo (en modalidad


Webservices)
Definicin: El Organismo utilizar este campo de
acuerdo a sus necesidades.
Origen: el Organismo proporcionar este dato.
Formato: Ver campo org_datos

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

Pg. 111 de 111

Anda mungkin juga menyukai