ServiciosWeb Organismos y Sedes (1631 KB · PDF)

Plataforma Notific@
Servicio compartido de Gestión de Notificaciones
Integración de Servicios Web en
Organismos y Sedes Electrónicas
ATENCIÓN: Para la comprensión de este documento, debe consultarse el Glosario de
Términos y Especificaciones Notific@" que dispone de todos los términos y
abreviaturas utilizados, así como su definición y en algunos casos, las especificaciones
técnico-funcionales asociadas a los mismos.
Manual
Notific@
Versión
2.14
Fecha de revisión 18/07/2016
Realizado por
DGR
1
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Tabla de contenido
1. REGISTRO DE CAMBIOS ...................................................................................................................... 4
2. OBJETIVO. .......................................................................................................................................... 5
2.1. INFORMACIÓN GENERAL DE APLICACIÓN A LA INTEGRACIÓN CON NOTIFIC@ MEDIANTE SERVICIO WEB. ................... 6
3. CONDICIONES ESPECIALES EN EL PROCEDIMIENTO DE INTEGRACIÓN CON NOTIFIC@ A TRAVÉS DE
LOS SERVICIOS WEB ............................................................................................................................... 6
4. REQUISITOS DE LOS ENVÍOS ............................................................................................................... 7
5. SERVICIOS WEB PARA ORGANISMOS. ................................................................................................ 8
5.1. DESCRIPCIÓN DE ENTORNOS PARA ORGANISMOS. ......................................................................................... 9
5.2. SERVICIO WEB DE NOTIFIC@, COMO PARTE SERVIDORA, PARA ORGANISMOS. ................................................ 9
5.3. MÉTODO ALTAENVIO(). ......................................................................................................................... 10
5.4. MÉTODO INFOENVIO(). ........................................................................................................................ 19
5.5. MÉTODO CONSULTAESTADO(). ................................................................................................................ 27
5.6. MÉTODO CONSULTADATADOENVIO()........................................................................................................ 28
5.7. MÉTODO CONSULTACERTIFICACIONENVIO(). ............................................................................................. 30
5.8. MÉTODO CONSULTAORGANISMOSACTIVOS(). ............................................................................................ 32
5.9. MÉTODO CONSULTACIES(). .................................................................................................................... 33
6. SERVICIO ADVISER EN ORGANISMOS PARA NOTIFIC@. .................................................................... 35
6.1. MÉTODO DATADOORGANISMO(). ............................................................................................................ 36
6.2. MÉTODO CERTIFICACIONORGANISMO(). ................................................................................................... 37
7. SERVICIOS WEB PARA SEDES ELECTRÓNICAS. ................................................................................... 39
7.1. DESCRIPCIÓN DE ENTORNOS PARA SEDES ELECTRÓNICAS. ............................................................................. 39
7.2. SERVICIO WEB DE NOTIFIC@, COMO PARTE SERVIDORA, PARA SEDES ELECTRÓNICAS.......................................... 39
7.2.1. Método getEnvios(). ................................................................................................................ 41
7.2.2. Método getEnviosAgrupados(). .............................................................................................. 43
7.2.3. Método infoEnvio().................................................................................................................. 44
7.2.4. Método certificacionSede(). .................................................................................................... 52
7.2.5. Método getCertificacion(). ...................................................................................................... 53
ANEXO I – SW PARA ORGANISMOS - PRUEBAS DE INTEGRACIÓN. ....................................................... 54
PRUEBAS DE EMISIÓN – CORRECTAS. ..................................................................................................... 54
PRUEBAS DE EMISIÓN – ERRÓNEAS. ...................................................................................................... 55
PRUEBA DE CONSULTA DE DATADO – CORRECTAS .................................................................................. 62
PRUEBAS DE CONSULTA DE DATADO – ERRÓNEAS .................................................................................. 62
PRUEBAS DE CONSULTA DE CERTIFICACIÓN - CORRECTAS ..................................................................... 63
PRUEBAS DE CONSULTA DE CERTIFICACIÓN - ERRÓNEAS ...................................................................... 63
ANEXO II – SW PARA ORGANISMOS – CÓDIGOS DE RESPUESTA. .......................................................... 64
ANEXO III – SW PARA ORGANISMOS - EJEMPLOS PARTE SERVIDORA ................................................... 65
ANEXO IV – SERVICIO ADVISER – CÓDIGOS DE RESPUESTA. ................................................................. 71
2
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
ANEXO V – SW PARA ORGANISMOS – EJEMPLOS DEL ADVISER. ........................................................... 72
ANEXO VI - SW PARA SEDES ELECTRÓNICAS - EJEMPLOS PARTE SERVIDORA. ...................................... 74
3
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
1. Registro de cambios
Fecha
Versión
Descripción
09/06/2016 2.10
Aclaración obligatoriedad código SIA para
notificaciones
22/06/2016 2.11
Se indica el carácter opcional del campo apellidos
28/06/2016 2.12
Indicación de que las peticiones a Notifica deben
especificar el Content-Length en su cabecera.
Indicación de las direcciones IP del servicio Notific@
11/07/2016 2.13
Cambio en la descripción del campo teléfono.
Añadidos contactos Red SARA
Añadida condición de eliminación de Chunking.
Obligatoriedad publicación DNS para Adviser
14/07/2016 2.14
Cambio en la descripción del campo caducidad
Consideraciones sobre el Adviser y TLS 1.0
4
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
2. Objetivo.
Este documento describe los Servicios Web que Notific@ pone a disposición de los
Consumidores del Servicio Compartido con la finalidad de que de manera automatizada
se consiga que:

Los Organismos emisores puedan realizar el envío de sus notificaciones y
comunicaciones.

Las Sedes Electrónicas, entre las que se incluye el Punto de Acceso General
(PAG) con
Carpeta Ciudadana (CC), puedan realizar consultas y
certificaciones del estado de los envíos.
El documento, además de proporcionar alguna información general, tiene su
principal contenido dirigido a la especificación de los distintos Servicios Web y por
consiguiente está organizado en tres secciones cuya aplicación se refleja en el
gráfico:

Servicios Web para Organismos.

Servicio Adviser en Organismos

Servicios Web para Sedes Electrónicas.
5
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Finalmente, se dispone de una sección de Anexos que incluye información
complementaria y detallada como: definición de pruebas de integración, resumen de
códigos de respuesta, ejemplos de consultas, etc…
2.1. Información general de aplicación a la integración con
notific@ mediante Servicio Web.
La integración mediante los Servicios Web, es solo una de las maneras en que los
Organismos emisores pueden establecer su comunicación con Notific@.
Para la integración a través de los Servicios Web, la parte más importante que deben
realizar los Organismos es la adecuación de sus Sistemas de Información para que
sean capaces de comunicarse con los Servicios Web Notific@.
De forma alternativa y/o adicional, los Organismos tienen a su disposición una
aplicación Web que permite, la integración con Notific@ sin hacer uso de los Servicios
Web, así como otra serie de funcionalidades complementarias al uso de los mismos.
Para un mayor conocimiento de esta aplicación consultar el “Manual de usuario”
sobre esta aplicación que forma parte de la documentación técnica publicada en el CTT.
3. Condiciones especiales en el procedimiento de
integración con Notific@ a través de los Servicios Web
Para conocer el procedimiento general de integración con Notific@, se deberá consultar
el documento “Guía de Integración con Notific@ para el responsable técnico”. No
obstante, los puntos más relevantes en relación con la implementación de lso Servicios
Web Notific@ son:
a. El Intercambio de claves y certificados para:

El intercambio de la API Key que debe ser incluida en la cabecera del
Servicio SOAP de las peticiones correspondientes al alta de un envío.

Intercambio de la parte pública de los certificados (CAs) que permitan la
comunicación entre sistemas Implementación por parte del Organismo o
Sede de los módulos (en modo cliente) necesarios para invocar los Servicios
Web de Notific@.
b. Todas las peticiones que se realizan a Notifica deben especificar el ContentLength en su cabecera.
c. No se admite el envío de peticiones por fragmentos (chunks), sino que se debe
mandar todo en un único bloque que incluya el tamaño. El chunking debe estar
deshabilitado.
6
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
d. Las comunicaciones con Notific@ (excepto para el servicio Adviser) deben
realizarse utilizando el protocolo TLS 1.0. No está soportado el uso de SSLv3 o
versiones inferiores.
e. Si los Organismos Emisores van a implementar el Servicio Adviser deberá
emplearse el puerto 443. Para el entorno de PRE se permite utilizar el puerto 80.
f. Elaboración de pruebas en entorno de Preproducción de los servicios web
implementados, siendo necesario cumplir con el protocolo de pruebas definido
en el Anexo I – SW para Organismos - Pruebas de Integración.
Notific@ pone a disposición recursos para la integración en Preproducción los
cuales pueden ser consultados en los apartados Descripción de entornos para
Organismos y Descripción de entornos para Sedes Electrónicas, de acuerdo a
si es un Organismo o una Sede Electrónica respectivamente.
g. Elaboración de pruebas de los servicios web implementados en el entorno de
Producción, al ser un entorno de Producción no se puede cumplir con el mismo
protocolo de pruebas definido en el Anexo I – SW para Organismos - Pruebas
de Integración, en este caso, se realizarán 2 o 3 pruebas puntuales para
comprobar que todo esté en orden.
4. Requisitos de los envíos
Para establecer la integración con Notific@, los Envíos deben incorporar una cierta
información y cumplir unas determinadas condiciones
y requisitos técnicosfuncionales. Para conocer en detalle estas condiciones deberá consultarse el Glosario de
términos y especificaciones Notific@. No obstante, se incorporan aquí algunos
aspectos generales, a modo de ejemplo
Requisitos funcionales de los envíos:
Los envíos deberán contener cierta información que debe ser proporcionada por el
Responsable Funcional y aportada a Notific@, bien en el propio cuerpo del envío, o por
otros medios que, en su caso, se establezcan al efecto.
Para consultar los detalles de esta información se deberá consultar la “Guía para la
integración con Notific@ para los Responsables Funcionales” que se encuentra
publicada en el CTT.
Algunos requisitos funcionales, que se mencionan a modo de ejemplo, son que el
Organismo Pagador haya suscrito los necesarios contratos con el/los CIEs que desee
utilizar y con el correspondiente operador postal y disponga de las referencias de dichos
contratos y las fechas de finalización de los mismos.
7
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Requisitos técnicos de los envíos:
Los envíos deberán cumplir ciertos requisitos técnicos básicos, bien asociados a su
propia condición, o bien asociados a la vía de puesta a disposición que el Organismo
Emisor elija.
Para conocer el detalle de esta especificación consultar el Glosario de Términos y
Especificaciones y en su caso, la “Guía para la integración con Notific@ para los
Responsables Técnicos” que se encuentra publicada en el CTT.
Algunos requisitos a modo de ejemplo son que:



El envío lleve un único fichero, por lo que si fuera necesario deberá fusionarse
los diferentes contenidos que se deseen enviar, en un documento único.
El formato del fichero sea PDF, siendo recomendable que cumpla con el
estándar PDF/A.
No superar los 10 MB de tamaño.
5. Servicios Web para Organismos.
Notific@ cuenta con varios Servicios Web, algunos de ellos en el rol de servidor y otros
en el rol cliente.

Servicio web para Organismos (rol servidor): es el encargado de recibir por parte
de los Organismos la información relacionada a las funciones que se desean
utilizar y en donde se emite una respuesta,

Servicio web para Organismos (rol de cliente): es el encargado de llamar a los
servicios implementados por los Organismos para que se les pueda enviar
información de interés, como por ejemplo, el acuse de recibo.
Como ya se ha mencionado anteriormente, Notific@ cuenta con un aplicativo web con
el que se pueden realizar la integración, sin embargo, si se desea contar con un uso
automatizado de Notific@ debe realizar la integración con el Servicio Web, lo que
comprende:

El desarrollo de la parte cliente, obligatoria y necesaria para poder invocar los
servicios web de Notific@ y/o la creación del Servicio Adviser, necesaria
solamente en el caso de desear recibir información de los servicios de Notific@
como Datados y Certificados.

El uso de los métodos citados a continuación en los siguientes apartados.

La evaluación de los resultados junto con las respuestas esperadas.
8
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
5.1. Descripción de entornos para Organismos.
Con el objetivo de cumplir con el Procedimiento de Integración con el
Servicio Web, Notific@ pone a disposición los siguientes recursos para la
integración en el entorno de Pruebas/Preproducción:
o URL del Punto Final del Servicio Web (EndPoint):
 https://se-notificaws.redsara.es/ws/soap/NotificaWS
 Se corresponde con la IP 10.252.139.202
o URL de acceso a la Aplicación Web:
 https://se-notifica.redsara.es
 Se corresponde con la IP 10.252.139.168
De igual forma, y con el objetivo de cumplir con las pruebas previstas en el
Procedimiento de Integración con el Servicio Web, Notific@ pone a
disposición los siguientes recursos para la integración en el entorno de
Producción:
o
URL del Punto Final del Servicio Web (EndPoint):
 https://notificaws.redsara.es/ws/soap/NotificaWs
 Se corresponde con la IP 10.253.252.188
o URL de acceso a la Aplicación Web:
 https://notifica.redsara.es
 Se corresponde con la IP 10.253.252.171
Nota
Antes de abrir incidencias por problemas de comunicaciones deben comprobar que su
conexión con la Red SARA es correcta. Para ello deben contactar con el equipo de
soporte de la Red SARA para su organismo:
 Para la AGE
o https://www.redsara.es/infoSARA/elements/contacto/Ministerios/index.ht
ml
 Para otros organismos (CCAA, EELL…)
o https://www.redsara.es/infoSARA/elements/contacto/Comunidades/index.
html
5.2. Servicio web de Notific@, como parte servidora, para
Organismos.
9
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Notific@ tiene implementado un servicio web, como parte servidora, que ofrece la
creación, consulta y monitorización de la entrega de una notificación, y que incluye los
siguientes métodos:
Método
altaEnvio()
Descripción
Método que permite el alta de un envío.
infoEnvio()
Método para consultar la información detallada de un
envío específico.
consultaEstado()
Método que permite la consulta del Estado de un
envío.
consultaDatadoEnvio()
Método que permite la consulta del Datado de un
envío.
consultaCertificacionEnvio() Método que permite la consulta de la certificación de
un envío.
consultaOrganismosActivos() Método que permite la consulta de los Organismos
Activos.
A continuación se puede consultar el detalle de cada uno de los parámetros de entrada,
así como el de las respuestas generadas.
Nota
La especificación técnica de los Servicios Web, se puede consultar en la siguiente
url:
https://se-notifica.redsara.es/docs/NotificaWS/wsdl-report.html
5.3. Método altaEnvio().
El método altaEnvio() es un módulo del servicio web de Notific@, como parte
servidora, que permite el envío de los datos necesarios para el alta de un envío:
comunicación o notificación.
Parámetros:
El método altaEnvio() debe invocarse con los siguientes parámetros:
Campo
organismo_emisor::codigo_dir3
Tipo
string
Descripción
Obligatorio.
Código
correspondiente al DIR3.
10
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
organismo_emisor::nombre
string
organismo_pagador_correos:: codigo_dir3
string
organismo_pagador_correos::
numero_contrato_correos
string
organismo_pagador_correos::
codigo_cliente_facturacion_correos
string
organismo_pagador_correos::
fecha_vigencia
DateTim
e
Opcional. Nombre de la
Entidad Emisora.
Campo
aún
válido
pero
depreciado. Sólo aplica al envío
postal. Campo Opcional. Código
DIR3 del organismo que
realizará el pago del servicio de
entrega
postal.
No
se
recomienda su uso, y utilizar e
orden de preferencia según se ha
establecido en la Aplicación
Web, modificable a través del
campo cie de domicilio.
Campo
aún
válido
pero
depreciado. Sólo aplica al envío
postal.
Campo
Opcional.
Número de contrato del
organismo pagador con el
operador
postal.
No
se
recomienda su uso, y utilizar e
orden de preferencia según se ha
establecido en la Aplicación
Web, modificable a través del
campo cie de domicilio.
Campo
aún
válido
pero
depreciado. Sólo aplica al envío
postal.
Campo
Opcional.
Código cliente del organismo
pagador para la facturación con
el operador postal. No se
recomienda su uso, y utilizar e
orden de preferencia según se ha
establecido en la Aplicación
Web, modificable a través del
campo cie de domicilio.
Campo
aún
válido
pero
depreciado. Sólo aplica al envío
postal. Campo Opcional. Fecha
fin del contrato con el
operador postal. Si está
caducado no se puede tramitar el
11
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
organismo_pagador_cie:: codigo_dir3
organismo_pagador_cie:: fecha_vigencia
string
DateTim
e
documento::contenido
string
documento::hash_sha1
string
documento::normalizado
string
alta del servicio en Notific@.
No se recomienda su uso, y
utilizar e orden de preferencia
según se ha establecido en la
Aplicación Web, modificable a
través del campo cie de
domicilio.
Campo
aún
válido
pero
depreciado. Sólo aplica al envío
postal.
Campo
Opcional.
Código DIR3 del organismo
que realizará el pago de costes
de impresión y ensobrado. No se
recomienda su uso, y utilizar e
orden de preferencia según se ha
establecido en la Aplicación
Web, modificable a través del
campo cie de domicilio.
Campo
aún
válido
pero
depreciado. Sólo aplica al envío
postal. Campo Opcional. Fecha
del fin del contrato con el
Centro
de
Impresión
y
Ensobrado. Si está caducado no
se puede tramitar el alta del
servicio en Notific@. No se
recomienda su uso, y utilizar e
orden de preferencia según se ha
establecido en la Aplicación
Web, modificable a través del
campo cie de domicilio.
Obligatorio. Contenido del
documento de la notificación
codificado en base64.
Obligatorio.
Codificación
base64 del sha1 del contenido
binario del documento.
Obligatorio. En caso de que el
documento reserve en la primera
página el espacio en blanco
necesario para introducir la
12
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
documento::generar_csv
string
tipo_envio
string
fecha_envio_programado
Concepto
DateTim
e
string
destinatarios::item:: referencia_emisor
string
destinatarios::item::titular:: telefono
string
ventanilla del sobre (NCC,
titular, destinatario, domicilio)
se debe rellenar con SI. En caso
contrario debe rellenarse con
NO y el CIE adjuntará una
página adicional con la ventana
para
el
ensobrado,
incrementando el coste del
servicio por la página impresa y
por el peso adicional del
servicio postal.
Obligatorio. En caso de que
desee que Notific@ genere un
CSV y que el documento esté
firmado digitalmente se debe
introducir SI, caso contrario
debe introducir NO. El CSV se
introducirá en el pie del
documento con la información
de los firmantes para la consulta
por parte del receptor de la
notificación.
Obligatorio. Tipo de envío a dar
de alta. Los valores válidos para
el
elemento
pueden
ser
notificación o comunicación.
Opcional. Fecha para realizar
un envío programado.
Obligatorio. Concepto del envío
que se realiza.
Obligatorio y único dentro de
cada organismo. Referencia
interna del Emisor del envío.
No pueden existir dos envíos
con la misma referencia para un
mismo organismo.
Número de teléfono. Se prevé
que se realizarán avisos vía
SMS
del
envío
de
la
notificación/comunicación y de
su disponibilidad en Carpeta
13
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
destinatarios:: ítem::titular:: email
string
destinatarios:: ítem::titular:: nif
string
destinatarios:: ítem::titular:: nombre
string
destinatarios:: ítem::titular:: apellidos
string
destinatarios:: ítem::destinatario:: telefono
string
destinatarios:: ítem::destinatario:: email
string
destinatarios:: ítem::destinatario:: nif
string
destinatarios:: ítem::destinatario::nombre
string
destinatarios:: ítem::destinatario::apellidos
string
Ciudadana.
Email para realizar el aviso vía
correo electrónico del envío de
la
notificación/comunicación
cuando se realiza un envío
exclusivo a Carpeta Ciudadana.
Obligatorio para envíos a Sedes
Electrónicas
y
Carpeta
Ciudadana.
Debe
ser
el
NIF/CIF/NIE del titular del
envío.
Obligatorio. Debe rellenarse con
el nombre o la razón social del
titular del envío
Opcional. Debe rellenarse con
los apellidos del titular del
envío. Puede no usarse y poner
los apellidos en el mismo campo
del nombre.
Número de teléfono. Se prevé
que se realizarán avisos vía
SMS
del
envío
de
la
notificación/comunicación y de
su disponibilidad en Carpeta
Ciudadana.
Email para realizar el aviso vía
correo electrónico del envío de
la
notificación/comunicación
cuando se realiza un envío
exclusivo a Carpeta Ciudadana.
Obligatorio para envíos a Sedes
Electrónicas
y
Carpeta
Ciudadana.
Debe
ser
el
NIF/CIF/NIE del destinatario
del envío.
Obligatorio. Debe rellenarse con
el nombre o la razón social del
destinatario del envío
Obligatorio si es un envío a una
persona física. Debe rellenarse
con
los
apellidos
del
14
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
destinatarios::tipo_domicilio
destinatarios::domicilio
destinatario del envío.
string
Opcional. Obligatorio para
envíos postales. Tipo de
domicilio del destinatario, puede
ser fiscal o concreto. En caso de
que
sea
concreto
deben
rellenarse los campos de
domicilio.
Compues Obligatorio
para
envíos
to
postales. Tipo de domicilio
concreto, puede ser nacional,
extranjero, sin_normalizar o
apartado_correos. Si no se
dispone de Código Postal, como
sucede en algunos países, se
colocará el valor 00000.
Dependiendo del tipo de
domicilio cambian los campos
obligatorios
dentro
de
domicilio.

Nacional:
tipo_domicilio_concreto,tipo_
via, nombre_via, numero_casa
o punto_kilometrico (solo uno
de
los
dos),
poblacion,
municipio::codigo_ine,
codigo_postal,
provincia::codigo_provincia,
pais::codigo_iso3166.

Extranjero: nombre_via,
pais::codigo_iso3166,
codigo_postal, población.

Apartado de Correos:
apartado_correos,
provincia::codigo_provincia,
municipio::codigo_ine,
codigo_postal, población.

Sin
Normalizar:
codigo_postal,
pais::codigo_iso3166, linea_1,
15
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
linea_2.
destinatarios::domicilio::cie
integer
destinatarios::servicio
string
destinatarios::direccion_electronica
::obligado
destinatarios::direccion_electronica
::nif
destinatarios::direccion_electronica
::codigo_procedimiento
Opcional. En caso que se quiera
alterar el CIE al que irá dirigido,
de modo que el envío que se
está dando de alta no siga el
orden de preferencia que se
estableció en la Aplicación Web,
se puede emplear el campo CIE
de domicilio estableciendo el
identificador que devuelve el
método consultaCies.
Obligatorio. Tipo de servicio de
envío a realizar, puede ser
urgente o normal. Válido para
la DEH y para el CIE, otorgando
prioridad en la cola de envíos.
En el caso del envío postal no
afecta la entrega, es decir, la
entrega se realiza en los plazos
normales.
booleano Obligatorio para envíos a la
DEH. Indica si la notificación
por DEH es con obligatoriedad
del titular que la recibe o no.
Los valores aceptados son true
o false. En caso de que sea
obligado y el titular no disponga
de Buzón DEH se le creará uno
automáticamente. En caso de no
ser obligado se debe realizar la
consulta del censo de suscritos.
string
Obligatorio para envíos a la
DEH. NIF del titular del buzón
DEH que va a recibir la
notificación.
string
Obligatorio para envíos a la
DEH
NO
OBLIGADOS.
Código de procedimiento en la
DEH al que el NIF debe estar
16
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
destinatarios::opciones_emision
::retardo_postal_deh
int
destinatarios::opciones_emision
::caducidad
string
procedimiento::codigo_sia
string
procedimiento::descripcion_sia
string
suscrito.
Indica el número de días
naturales
que
estará
disponible una notificación en
la Sede Electrónica y/o
Carpeta Ciudadana para que
pueda ser notificada por
comparecencia antes de ponerse
a disposición del ciudadano por
otras vías. Una vez pasen esos
días, el envío pasará a ser
realizado a través de la DEH o
el CIE.
En el caso de que el valor sea 0,
pasa directamente a la DEH o
al CIE para la posterior entrega
postal, permaneciendo en todo
caso disponible en la Sede
Electrónica
y/o
Carpeta
Ciudadana.
Opcional (Ver nota más abajo).
Caducidad en la comparecencia
del destinatario. El formato
correcto de la fecha es YYYYMM-DD.
Opcional, pero obligatorio para
las notificaciones. Para las
comunicaciones
no
aplica.
Código de procedimiento SIA
(Sistema
de
Información
Administrativa).
Opcional. Descripción del SIA
(Sistema
de
Información
Administrativa).
ATENCION
Si desea que el envío esté disponible únicamente en la Carpeta Ciudadana y, en su
caso, sede electrónica, para evitar que el destinatario sea notificado a través de la DEH
o por la Vía Postal, los valores de los campos:
17
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
destinatarios::tipo_domicilio, destinatarios::domicilio y
destinatarios::dirección_electrónica deben ser nulos
y el campo destinatarios::opciones_emision::caducidad obligatorio.
Con respecto a la caducidad, en caso que se esté integrando una sede electrónica del
organismo, y que se desee que ésta gestione la caducidad de las notificaciones en lugar
de Notific@, se deberá establecer un periodo de caducidad superior al manejado por la
sede, de modo que se produzca la caducidad primero en la sede y se informe
inmediatamente a Notific@ del cambio de estado del envío.
18
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre altaEnvioResponse con los campos:
Variable
Tipo
Descripción
identificadores::item::
identificador
string
identificadores::item::
referencia_emisor
string
identificadores::item::
nif_titular
codigo_csv
string
ID que se proporciona al dar el
alta y que se deberá usar
posteriormente para referenciar
dicho envío.
Referencia interna del Emisor
del envío. No pueden existir dos
envíos con la misma referencia
para un mismo organismo.
NIF/CIF/NIE del titular del envío.
codigo_respuesta
string
descripcion_respuesta
string
string
Opcional. Código de Seguridad y
Verificación generado en el alta
del envío.
Código de tres dígitos asociado al
resultado.
Descripción de la operación.
Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo II – SW para Organismos – Códigos de respuesta.
En el Anexo III – SW para Organismos - Ejemplos parte servidora podrá consultar
un ejemplo de este método.
5.4. Método infoEnvio().
El método infoEnvio() es un módulo del servicio web de Notific@, como parte
servidora, que permite la consulta y el detalle de un envío.
Parámetros:
El método infoEnvio() debe invocarse con los siguientes parámetros:
Variable
envio_destinatario
Tipo
string
Descripción
Obligatorio. Identificador del
envío devuelto en la respuesta de
altaEnvio().
19
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre infoEnvioResponse con los campos:
Campo
organismo_emisor::codigo_dir3
Tipo
string
organismo_emisor::nombre
string
organismo_pagador_correos:: codigo_dir3
string
organismo_pagador_correos::
numero_contrato_correos
string
organismo_pagador_correos::
codigo_cliente_facturacion_correos
string
organismo_pagador_correos::
fecha_vigencia
organismo_pagador_cie:: codigo_dir3
DateTim
e
string
Descripción
Obligatorio.
Código
correspondiente al DIR3.
Opcional. Nombre de la
Entidad Emisora.
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Código DIR3 del
organismo que realizará el
pago del servicio de entrega
postal.
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio()
Número
de
contrato
del
organismo
pagador con el operador
postal.
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Código cliente
del organismo pagador para la
facturación con el operador
postal.
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Fecha fin del
contrato con el operador
postal.
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Código DIR3
del organismo que realizará el
pago de costes de impresión y
20
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
organismo_pagador_cie:: fecha_vigencia
DateTim
e
documento::contenido
string
documento::hash_sha1
string
documento::normalizado
string
documento::generar_csv
string
ensobrado
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Fecha del fin del
contrato con el Centro de
Impresión y Ensobrado.
Obligatorio. Contenido del
documento de la notificación
codificado en base64.
Obligatorio.
Codificación
base64
del
sha1
del
contenido
binario
del
documento.
Obligatorio. En caso de que
el documento reserve en la
primera página el espacio en
blanco
necesario
para
introducir la ventanilla del
sobre
(NCC,
titular,
destinatario, domicilio) se
debe rellenar con SI. En caso
contrario debe rellenarse con
NO y el CIE adjuntará una
página adicional con la
ventana para el ensobrado,
incrementando el coste del
servicio por la página impresa
y por el peso adicional del
servicio postal.
Obligatorio. En caso de que
desee que Notific@ genere
un CSV y que el documento
esté firmado digitalmente se
debe introducir SI, caso
contrario debe introducir NO.
El CSV se introducirá en el
pie del documento con la
información de los firmantes
para la consulta por parte del
receptor de la notificación.
21
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
tipo_envio
fecha_envio_programado
string
DateTim
e
concepto
string
destinatarios::item::referencia_emisor
string
destinatarios::item::titular::telefono
string
destinatarios:: ítem::titular::email
string
destinatarios:: ítem::titular::nif
string
destinatarios:: ítem::titular::nombre
string
destinatarios:: ítem::titular::apellidos
string
Obligatorio. Tipo de envío a
dar de alta. Los valores
válidos para el elemento
pueden ser notificación o
comunicación.
Opcional.
Fecha
para
realizar
un
envío
programado.
Obligatorio. Concepto del
envío que se realiza.
Obligatorio y único dentro de
cada organismo. Referencia
interna del Emisor del
envío. No pueden existir dos
envíos
con
la
misma
referencia para un mismo
organismo.
Número de teléfono. Se
prevé que se realizarán avisos
vía SMS del envío de la
notificación/comunicación y
de su disponibilidad en
Carpeta Ciudadana.
Email para realizar el aviso
vía correo electrónico del
envío
de
la
notificación/comunicación
cuando se realiza un envío
exclusivo
a
Carpeta
Ciudadana.
Obligatorio para envíos a
Sedes Electrónicas y Carpeta
Ciudadana. Debe ser el
NIF/CIF/NIE del titular del
envío.
Obligatorio. Debe rellenarse
con el nombre o la razón
social del titular del envío
Obligatorio si es un envío a
una persona física. Debe
rellenarse con los Apellidos
22
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
destinatarios:: ítem::destinatario:: telefono
destinatarios:: ítem::destinatario::email
destinatarios:: ítem::destinatario::nif
destinatarios:: ítem::destinatario::nombre
destinatarios:: ítem::destinatario::apellidos
destinatarios::tipo_domicilio
destinatarios::domicilio
del titular del envío.
string
Número de teléfono. Se
prevé que se realizarán avisos
vía SMS del envío de la
notificación/comunicación y
de su disponibilidad en
Carpeta Ciudadana.
string
Email para realizar el aviso
vía correo electrónico del
envío
de
la
notificación/comunicación
cuando se realiza un envío
exclusivo
a
Carpeta
Ciudadana.
string
Obligatorio para envíos a
Sedes Electrónicas y Carpeta
Ciudadana. Debe ser el
NIF/CIF/NIE del titular del
envío.
string
Obligatorio. Debe rellenarse
con el nombre o la razón
social del titular del envío
string
Obligatorio si es un envío a
una persona física. Debe
rellenarse con los apellidos
del titular del envío.
string
Opcional aunque obligatorio
para envíos postales. Tipo de
domicilio del destinatario,
puede ser fiscal o concreto.
En caso de que sea concreto
deben rellenarse los campos
de domicilio.
Compues Obligatorio
para
envíos
to
postales. Tipo de domicilio
concreto, puede ser nacional,
extranjero, sin_normalizar
o apartado_correos. Si no
se dispone de Código Postal,
como sucede en algunos
países, se colocará el valor
23
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
0000.
destinatarios::servicio
destinatarios::direccion_electronica
::obligado
Dependiendo
del
tipo
cambian
los
campos
obligatorios
dentro
de
domicilio.

Nacional:
tipo_domicilio_concreto,tip
o_via,
nombre_via,
numero_casa
o
punto_kilometrico (solo uno
de los dos), poblacion,
municipio::codigo_ine,
codigo_postal,
provincia::codigo_provincia
, pais::codigo_iso3166.

Extranjero:
nombre_via,
pais::codigo_iso3166,
codigo_postal, población.

Apartado de Correos:
apartado_correos,
provincia::codigo_provincia
,
municipio::codigo_ine,
codigo_postal, población.

Sin
Normalizar:
codigo_postal,
pais::codigo_iso3166,
linea_1, linea_2.
string
Obligatorio. Tipo de servicio
de envío a realizar, puede ser
urgente o normal.
booleano Obligatorio para envíos a la
DEH. Indica si la notificación
por
DEH
es
con
obligatoriedad del titular que
la recibe o no. Los valores
aceptados son true o false.
En caso de que sea obligado y
el titular no disponga de
Buzón DEH se le creará uno
24
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
destinatarios::direccion_electronica
::nif
string
destinatarios::direccion_electronica
::codigo_procedimiento
string
destinatarios::opciones_emision
::retardo_postal_deh
int
destinatarios::opciones_emision
::caducidad
string
procedimiento::codigo_sia
string
procedimiento::descripcion_sia
string
certificada
booleano
automáticamente. En caso de
no ser obligado se debe
realizar la consulta del censo
de suscritos.
Obligatorio para envíos a la
DEH. NIF del titular del
buzón DEH que va a recibir
la notificación.
Obligatorio para envíos a la
DEH NO OBLIGADOS.
Código de procedimiento en
la DEH al que el NIF debe
estar suscrito.
Indica el número de días
naturales
que
estará
disponible una notificación
en la Sede Electrónica y/o
Carpeta Ciudadana para
que pueda ser notificada por
comparecencia
antes
de
ponerse a disposición del
ciudadano por otras vías, de
acuerdo a la configuración
que se estableció al dar de
alta el envío.
Opcional. Caducidad en
formato YYYY-MM-DD
Opcional.
Código
de
procedimiento SIA (Sistema
de
Información
Administrativa).
Opcional. Descripción del
SIA
(Sistema
de
Información
Administrativa).
Obligatorio. Indica si la
notificación ha llegado a su
estado final. Los valores
aceptados son true o false.
Nótese
que
para
las
25
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
codigo_respuesta
string
descripción_respuesta
string.
notificaciones un valor de
true
indica
que
hay
certificación pero ésta puede
ser positiva o negativa. Para
las comunicaciones este valor
siempre es false.
Obligatorio. Código de tres
dígitos asociado al resultado.
Obligatorio. Descripción de
la operación.
Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo II – SW para Organismos – Códigos de respuesta.
26
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
5.5. Método consultaEstado().
El método consultaEstado() es un módulo del servicio web de Notific@, como parte
servidora, que permite consultar el Estado de un envío.
Parámetros:
El método consultaEstado() debe invocarse con los siguientes parámetros:
Campo
identificador_envio
Tipo
string
Descripción
Obligatorio. Identificador del envío
devuelto en
altaEnvio()
la
respuesta
de
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre consultaEstadoResponse con los campos:
Variable
Tipo
Descripción
estado::
identificador_envio
string
Obligatorio. Identificador del envío
estado:: estado
string
Obligatorio. Estado del envío.
identificador_envio::
nif_titular
estado::ncc_id_externo
string
codigo_respuesta
string
descripcion_respuesta
string
Opcional. El NIF/CIF/NIE del
titular del envío.
Opcional. NCC. Número de
seguimiento de correos.
Obligatorio. Código de tres dígitos
asociado al resultado.
Obligatorio. Descripción de la
operación.
devuelto en
altaEnvio()
string
la
respuesta
de
Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo II – SW para Organismos – Códigos de respuesta.
En el Anexo III – SW para Organismos - Ejemplos parte servidora podrá consultar
un ejemplo de este método.
27
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
5.6. Método consultaDatadoEnvio().
El método consultaDatadoEnvio() es un módulo del servicio web de Notific@, como
parte servidora, que permite consultar el Datado de un envío.
Parámetros:
El método consultaDatadoEnvio() debe invocarse con los siguientes parámetros:
Campo
identificador_envio
Tipo
string
Descripción
Obligatorio. Identificador del envío
devuelto en
altaEnvio()
la
respuesta
de
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre consultaDatadoEnvioResponse con los
campos:
Variable
Tipo
Descripción
identificador_envio::
identificador
string
Obligatorio. Identificador del envío
identificador_envio::
referencia_emisor
string
identificador_envio::
nif_titular
datado::item::estado
string
datado::item::descripción
string
datado::item::fecha
string
estado_actual
string
descripción_estado_actua
l
string
devuelto en
altaEnvio()
string
la
respuesta
de
Obligatorio. Referencia interna
del Emisor del envío. No pueden
existir dos envíos con la misma
referencia para un mismo
organismo.
Opcional. El NIF/CIF/NIE del
titular del envío.
Opcional. Estado del Datado. Es
un array o lista con todo el
historial de estados.
Opcional.
Descripción
del
estado.
Opcional. Fecha del datado.
Estado Actual o último estado
del array o lista con todo el
historial de estados.
Obligatorio. Descripción del
estado actual.
28
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
fecha_actualizacion
DateTime
ncc_id_externo
codigo_respuesta
string
string
descripcion_respuesta
string
Obligatorio.
Fecha
de
actualización.
Opcional. NCC.
Obligatorio. Código de tres
dígitos asociado al resultado.
Obligatorio. Descripción de la
operación.
Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo II – SW para Organismos – Códigos de respuesta.
En el Anexo III – SW para Organismos - Ejemplos parte servidora podrá
consultar un ejemplo de este método.
29
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
5.7. Método consultaCertificacionEnvio().
El método consultaCertificacionEnvio() es un módulo del servicio web de Notific@,
como parte servidora, que permite consultar la Certificación de un envío.
Parámetros:
El método consultaCertificacionEnvio() debe invocarse con los siguientes parámetros:
Campo
identificador_envio
Tipo
string
Descripción
Obligatorio. Identificador del envío
devuelto en
altaEnvio()
la
respuesta
de
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre consultaCertificacionEnvioResponse con
los campos:
Variable
Tipo
Descripción
certificación::identificador_envio:: identificador
string
certificación::identificador_envio::
referencia_emisor
string
certificación::identificador_envio:: nif_titular
string
certificación::pdf_certificado
string
certificación::xml_certificado
string
Obligatorio. ID que
se proporciona al dar
de alta un envío.
Obligatorio.
Referencia interna
del Emisor del envío.
No pueden existir dos
envíos con la misma
referencia para un
mismo organismo.
Opcional.
El
NIF/CIF/NIE
del
titular del envío.
Opcional. Contenido
del Certificado en
PDF y en base 64.
Es excluyente con el
siguiente campo, si
está en PDF no se
devuelve en XML.
Opcional. Contenido
del Certificado en
30
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
certificación::certificación
certificación::fecha_actualizacion
string
DateTime
certificación::ncc_id_externo
codigo_respuesta
string
string
descripcion_respuesta
string
XML. Es excluyente
con
el
anterior
campo, si está en
XML no se devuelve
en PDF.
Obligatorio. Tipo de
acuse
o
sobre.
Nótese que para
envíos postales el
acuse
es
una
notificación positiva
y el sobre es una
notificación negativa
(por
ejemplo,
rehusada). Para otros
medios se usa el
acuse
independientemente
del resultado.
Obligatorio. Fecha en
la que llega el acuse.
Opcional. NCC.
Obligatorio. Código
de
tres
dígitos
asociado
al
resultado.
Obligatorio.
Descripción de la
operación.
Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo II – SW para Organismos – Códigos de respuesta.
En el Anexo III – SW para Organismos - Ejemplos parte servidora podrá
consultar un ejemplo de este método.
31
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
5.8. Método consultaOrganismosActivos().
El método consultaOrganismosActivos() es un módulo del servicio web de Notific@,
como parte servidora, que permite consultar a los Organismos activos.
Parámetros:
El método consultaOrganismosActivos() no recibe parámetros.
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre consultaOrganismosActivosResponse
con los campos:
Variable
Tipo
Descripción
organismos::item::
codigo_dir3
organismos::item:: nombre
string
Obligatorio. Código DIR3 del
Organismo.
Obligatorio.
Nombre
del
Organismo.
codigo_respuesta
string
descripcion_respuesta
string
string
Obligatorio. Código de tres
dígitos asociado al resultado.
Obligatorio. Descripción de la
operación.
Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo II – SW para Organismos – Códigos de respuesta.
32
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
5.9. Método consultaCies().
El método consultaCies() es un módulo del servicio web de Notific@, como parte
servidora, que permite consultar a los CIEs disponibles para un organismo emisor.
Parámetros:
El método consultaCies() recibe los siguientes parámetros.
Variable
Tipo
Descripción
organismo_emisor
string
Obligatorio. Código DIR3 del
Organismo.
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre consultaCiesResponse con los campos:
Variable
Tipo
Descripción
cies::id
integer
cies::centro_impresion
string
Obligatorio. Identificador del
CIE.
Obligatorio. Nombre del CIE
cies::fecha_vigencia
Date
Obligatorio. Fecha de vigencia
(hasta) del contrato
cies::
codigo_unidad_relacionada
cies::
nombre_unidad_relacionada
cies::orden
string
integer
codigo_respuesta
string
descripcion_respuesta
string
Obligatorio. Código DIR3 del
Organismo.
Obligatorio.
Nombre
del
Organismo.
Obligatorio.
Orden
de
preferencia del CIE. En caso
que varios CIEs tengan el
mismo orden, Notific@ hará la
seleccionará el CIE entre ellos
en función de criterios como la
capacidad del CIE o el reparto
de cargas de trabajo.
Obligatorio. Código de tres
dígitos asociado al resultado.
Obligatorio. Descripción de la
operación.
33
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
string
34
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
6. Servicio Adviser en Organismos para Notific@.
Notific@ tiene implementado un servicio web, denominado “Adviser”, con el rol de
parte cliente, que permite el envío de los Datados y Certificaciones de una notificación
hacia el Organismo Emisor.
La implementación de este servicio es opcional y solo se requiere si se desea obtener
una comunicación automática del estado de los envíos cuando se produzca una
modificación en dicho estado.
Como alternativa, el Organismo Emisor que no desee implementar estos desarrollos,
puede hacer uso de los métodos
de consulta, bajo demanda,
“consultaCertificacionEnvio” y “consultaDatadoEnvio” incluidos en los Servicios
web para Organismos.
La funcionalidad Adviser contiene los métodos es decir, la programación de los
métodos que se describen a continuación.
Método
datadoOrganismo()
certificacionOrganismo()
Descripción
Método que debe ser implementado para la recepción
del Datado de un envío.
Método que debe ser implementado para la recepción de
la Certificación de un envío.
A continuación se puede consultar el detalle de cada uno de los parámetros a recibir, así
como de las respuestas a generar.
Nota
La especificación técnica de los Servicios Web, se puede consultar en la siguiente
url:
https://se-notifica.redsara.es/docs/AdviserWS/wsdl-report.html
35
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Nota
Las direcciones IP de salida que utiliza Notific@ para comunicarse con el Adviser
de los Organismos Emisores son las siguientes:
 Entorno de PRE
o 10.252.240.2 y 10.252.240.4
 Entorno de PRO
o 10.253.6.2, 10.253.6.4, 10.253.6.64 y 10.253.6.65
En el entorno de producción es obligatorio que la dirección DNS de las máquinas
que contienen el Adviser esté PUBLICADA EN LA REDSARA. En el entorno de
pruebas de integración es recomendable que también sea así
6.1. Método datadoOrganismo().
El método datadoOrganismo() es un módulo del servicio web de Notific@, como
parte cliente, que permite la recepción del Datado de un envío.
Parámetros a recibir:
El método datadoOrganismo() debe implementarse para recibir los siguientes
parámetros:
Variable
Tipo
Descripción
organismo_emisor
tipoOrganismoEmisor Tipo compuesto que contendrá
tanto el código DIR3 del
organismo como su nombre.
codigo_dir3
string
Código DIR3 del organismo
emisor.
nombre
string
Nombre del organismo emisor.
Identificador del envío devuelto en
identificador_destinatario
string
la respuesta de altaEnvio()
resultado
fecha
receptor
nif
nombre
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
string
dateTime
tipo_persona
string
string
Estado de la entrega del
comunicado
que
se
corresponderá con uno de los
estados de Notific@.
Fecha en la que se produjo el
intento de entrega.
Datos del receptor del envío.
NIF del receptor del envío.
Nombre del receptor del envío.
36
Datos a devolver:
Se debe devolver una respuesta SOAP de nombre datadoOrganismoResponse con los
campos:
Variable
Tipo
Descripción
codigo_respuesta
string
texto_respuesta
string
Código de tres dígitos asociado al
resultado.
Descripción de la operación.
Los valores a devolver en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo IV – Servicio Adviser – Códigos de respuesta.
En el Anexo V – SW para Organismos – Ejemplos del Adviser podrá consultar un
ejemplo de este método.
6.2. Método certificacionOrganismo().
El método certificacionOrganismo() es un módulo del servicio web de Notific@,
como parte cliente, que permite la recepción de la Certificación de un envío.
Parámetros a recibir:
El método certificacionOrganismo() debe implementarse para recibir los siguientes
parámetros:
Variable
Tipo
Descripción
organismo_emisor
string
Sólo el código
Organismo.
DIR3
del
identificador_destinatario
string
Identificador del envío devuelto en
la respuesta de altaEnvio()
acuse_o_sobre
string
certificacion
string
hash_sha1
string
Indica si es un acuse de recibo o
un sobre escaneado.
Contiene el base64 del PDF con
el contenido.
Codificación base64 del sha1 del
contenido binario del documento
Datos a devolver:
37
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Se debe devolver una respuesta SOAP de nombre datadoOrganismoResponse con los
siguientes campos:
Variable
Tipo
Descripción
codigo_respuesta
string
texto_respuesta
string
Código de tres dígitos asociado al
resultado.
Descripción de la operación.
Los valores a devolver en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo IV – Servicio Adviser – Códigos de respuesta.
En el Anexo V – SW para Organismos – Ejemplos del Adviser podrá consultar un
ejemplo de este método.
38
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
7. Servicios Web para Sedes Electrónicas.
Notific@ cuenta con varios Servicios Web, en el rol de parte servidora, encargados de
recibir por parte de las Sedes Electrónicas la información relacionada a las funciones
que se desean utilizar y en donde se emite una respuesta.
El procedimiento general para la integración con el Servicio Web comprende:

El desarrollo de la parte cliente, obligatoria y necesaria para poder usar los
servicios web de Notific@ en el rol de parte servidora.

El uso de los métodos citados a continuación en los siguientes apartados.

La evaluación de los resultados junto con las respuestas esperadas.
7.1. Descripción de entornos para Sedes Electrónicas.
Con el objetivo de cumplir con lo previsto para la integración con el Servicio
Web, Notific@ pone a disposición los siguientes recursos para la integración en
el entorno de Pruebas/Preproducción:
o URL del Punto Final del Servicio Web (EndPoint):
https://se-notificaws.redsara.es/ws/soap/SedeWs
De igual forma, y con el objetivo de cumplir con lo previsto para la Integración
con el Servicio Web, Notific@ pone a disposición los siguientes recursos para la
integración en el entorno de Producción:
o URL del Punto Final del Servicio Web (EndPoint):
https://notificaws.redsara.es/ws/soap/SedeWs
7.2. Servicio web de Notific@, como parte servidora, para Sedes
Electrónicas.
Notific@ tiene implementado un servicio web, con el rol de parte servidora, que está
relacionado con la consulta y monitorización de la entrega de una notificación, y que
incluye los siguientes métodos:
Método
getEnvios()
Descripción
Método que devuelve todos los identificadores de los
envíos dependiendo de las opciones introducidas.
39
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
getEnviosAgrupados()
infoEnvio()
certificacionSede()
getCertificacion()
Método que devuelve la cantidad de envíos asociados a
un criterio señalado.
Método para consultar la información detallada de un
envío específico.
Método para el envío de la certificación de la
notificación desde la Sede hacia la aplicación Notific@.
Método que devuelve la certificación del envío
solicitado.
A continuación se puede consultar el detalle de cada una de las variables de entrada, así
como el de las respuestas generadas.
Nota
La especificación técnica de los Servicios Web, se puede consultar en la siguiente
url:
https://se-notifica.redsara.es/docs/SedeWS/wsdl-report.html
40
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
7.2.1. Método getEnvios().
El método getEnvios() es un módulo del servicio web de Notific@, como parte
servidora, que permite obtener los envíos de un destinatario.
Parámetros:
El método getEnvios() debe invocarse con los siguientes parámetros:
Variable
Tipo
Descripción
nif
string
estado
string
organismo_remisor
string
codigo_sia
string
Obligatorio. Indica el NIF/CIF de
titular del que se quieren obtener
las notificaciones que tiene el
sistema.
Opcional. Filtro por estado en el
que se encuentra la notificación:
Notificada,
Rehusada
o
Pendiente.
Opcional. Filtro por el organismo
que ha remitido la notificación,
debe introducirse el código DIR3
del organismo. Si no se consigna
se devolverán todos los envíos del
NIF/CIF indicado que estén
asociados
al
API_KEY
independientemente
del
Organismo Emisor.
Opcional. Filtro por el código del
procedimiento al que hace
referencia la notificación.
Opcional. Filtro por la fecha
desde la que se quieren recuperar
las
notificaciones,
debe
introducirse en formato AAAAMM-DD y en caso de no
rellenarse se tomarán desde el
1990-01-01.
Opcional.Filtro por la fecha hasta
la que se quieren recuperar las
notificaciones, debe introducirse
en formato AAAA-MM-DD y en
fecha_desde
DateTime
fecha_hasta
DateTime
41
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
caso de no rellenarse se tomará el
día actual.
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre getEnviosResponse con los siguientes
campos:
Variable
Tipo
Descripción
envio_destinatario
Identificador del envío devuelto en
la respuesta de altaEnvio()
estado
Estado del envío: Notificada,
Rehusada o Pendiente.
Concepto del envío.
Código DIR3 del organismo que
ha remitido el envío.
Fecha en la que ha sido dada de
alta en Notific@ el envío.
concepto
organismo_emisor
fecha_notificacion
En el Anexo VI – SW para Sedes Electrónicas – Ejemplos parte servidora podrá
consultar un ejemplo de este método.
42
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
7.2.2. Método getEnviosAgrupados().
El método getEnviosAgrupados() es un módulo del servicio web de Notific@, como
parte servidora, que permite obtener los envíos de un destinatario.
Parámetros:
El método getEnviosAgrupados() debe invocarse con los siguientes parámetros:
Variable
Tipo
Descripción
nif
string
estado
string
organismo_remisor
string
codigo_sia
string
Obligatorio. Indica el NIF de
titular del que se quieren obtener
las notificaciones que tiene el
sistema.
Opcional. Filtro por estado en el
que se encuentra la notificación:
Notificada,
Rehusada
o
Pendiente. Si no se consigna se
devolverán los tres valores. Si se
consigna, sólo se devolverá el
indicado.
Opcional. Filtro por el organismo
que ha remitido la notificación,
debe introducirse el código DIR3
del organismo.
Opcional. Filtro por el código del
procedimiento al que hace
referencia la notificación.
Opcional. Filtro por la fecha
desde la que se quieren recuperar
las
notificaciones,
debe
introducirse en formato AAAAMM-DD y en caso de no
rellenarse se tomarán desde el
1990-01-01.
Opcional. Filtro por la fecha
hasta la que se quieren recuperar
las
notificaciones,
debe
introducirse en formato AAAAMM-DD y en caso de no
rellenarse se tomará el día actual.
fecha_desde
DateTime
fecha_hasta
DateTime
43
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Datos de respuesta:
Como respuesta se recibirá el número de envíos pendientes, notificados y totales
agrupados por Organismo Emisor, por Procedimiento y por Estado.
En el Anexo VI – SW para Sedes Electrónicas – Ejemplos parte servidora podrá
consultar un ejemplo de este método.
7.2.3. Método infoEnvio().
El método infoEnvio() es un módulo del servicio web de Notific@, como parte
servidora, que permite obtener la información de un envío.
Parámetros a enviar:
El método infoEnvio() debe invocarse con los siguientes parámetros:
Variable
envio_destinatario
Tipo
Descripción
string
Obligatorio. Identificador del envío
devuelto en
altaEnvio()
la
respuesta
de
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre getEnviosResponse con los siguientes
campos:
Campo
organismo_emisor::codigo_dir3
Tipo
string
organismo_emisor::nombre
string
organismo_pagador_correos:: codigo_dir3
string
Descripción
Obligatorio.
Código
correspondiente al DIR3.
Opcional. Nombre de la
Entidad Emisora.
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Código DIR3
del organismo que realizará
el pago del servicio de
entrega postal.
44
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
organismo_pagador_correos::
numero_contrato_correos
string
organismo_pagador_correos::
codigo_cliente_facturacion_correos
string
organismo_pagador_correos::
fecha_vigencia
organismo_pagador_cie:: codigo_dir3
organismo_pagador_cie:: fecha_vigencia
DateTime
string
DateTime
documento::contenido
string
documento::hash_sha1
string
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Número de
contrato del organismo
pagador con el operador
postal.
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Código cliente
del organismo pagador para
la facturación con el
operador postal.
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Fecha fin del
contrato con el operador
postal.
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Código DIR3
del organismo que realizará
el pago de costes de
impresión y ensobrado
Sólo se muestra para envíos
postales cuando el dato fue
consignado en el Método
altaEnvio(). Fecha del fin
del contrato con el Centro
de Impresión y Ensobrado.
Obligatorio. Contenido del
documento
de
la
notificación codificado en
base64.
Obligatorio. Codificación
base64 del sha1 del
contenido
binario
del
documento.
45
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
documento::normalizado
string
documento::generar_csv
string
tipo_envio
string
fecha_envio_programado
DateTime
concepto
string
destinatarios::item:: referencia_emisor
string
Obligatorio. En caso de que
el documento reserve en la
primera página el espacio en
blanco
necesario
para
introducir la ventanilla del
sobre
(NCC,
titular,
destinatario, domicilio) se
debe rellenar con SI. En
caso
contrario
debe
rellenarse con NO y el CIE
adjuntará
una
página
adicional con la ventana
para
el
ensobrado,
incrementando el coste del
servicio por la página
impresa y por el peso
adicional del servicio postal.
Obligatorio. En caso de que
desee que Notific@ genere
un CSV y que el documento
esté firmado digitalmente se
debe introducir SI, caso
contrario debe introducir
NO. El CSV se introducirá
en el pie del documento con
la información de los
firmantes para la consulta
por parte del receptor de la
notificación.
Obligatorio. Tipo de envío a
dar de alta. Los valores
válidos para el elemento
pueden ser notificación o
comunicación.
Opcional. Si se consigna,
Notific@ no tratará el envío
hasta la fecha indicada.
Obligatorio. Concepto del
envío que se realiza.
Obligatorio y único dentro
de
cada
organismo.
46
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
destinatarios::item::titular:: telefono
string
destinatarios:: ítem::titular:: email
string
destinatarios:: ítem::titular::nif
string
destinatarios:: ítem::titular::nombre
string
destinatarios:: ítem::titular::apellidos
string
destinatarios:: ítem::destinatario:: telefono
string
destinatarios:: ítem::destinatario::email
string
Referencia interna del
Emisor del envío. No
pueden existir dos envíos
con la misma referencia
para un mismo organismo.
Número de teléfono. Se
prevé que se realizarán
avisos vía SMS del envío de
la
notificación/comunicación y
de su disponibilidad en
Carpeta Ciudadana.
Email para realizar el aviso
vía correo electrónico del
envío
de
la
notificación/comunicación
cuando se realiza un envío
exclusivo
a
Carpeta
Ciudadana.
Obligatorio para envíos a
Sedes
Electrónicas
y
Carpeta Ciudadana. Debe
ser el NIF/CIF/NIE del
titular del envío.
Obligatorio. Debe rellenarse
con el nombre o la razón
social del titular del envío
Obligatorio si es un envío a
una persona física. Debe
rellenarse con los apellidos
del titular del envío.
Número de teléfono. Se
prevé que se realizarán
avisos vía SMS del envío de
la
notificación/comunicación y
de su disponibilidad en
Carpeta Ciudadana.
Email para realizar el aviso
vía correo electrónico del
envío
de
la
47
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
destinatarios:: ítem::destinatario::nif
string
destinatarios:: ítem::destinatario::nombre
string
destinatarios:: ítem::destinatario::apellidos
string
destinatarios::tipo_domicilio
string
destinatarios::domicilio
Compuest
o
notificación/comunicación
cuando se realiza un envío
exclusivo
a
Carpeta
Ciudadana.
Obligatorio para envíos a
Sedes
Electrónicas
y
Carpeta Ciudadana. Debe
ser el NIF/CIF/NIE del
titular del envío.
Obligatorio. Debe rellenarse
con el nombre o la razón
social del titular del envío
Obligatorio si es un envío a
una persona física. Debe
rellenarse con los apellidos
del titular del envío.
Opcional aunque obligatorio
para envíos postales. Tipo
de
domicilio
del
destinatario, puede ser fiscal
o concreto. En caso de que
sea
concreto
deben
rellenarse los campos de
domicilio.
Obligatorio para envíos
postales. Tipo de domicilio
concreto,
puede
ser
nacional,
extranjero,
sin_normalizar
o
apartado_correos. Si no se
dispone de Código Postal,
como sucede en algunos
países, se colocará el valor
0000.
Dependiendo
del
tipo
cambian
los
campos
obligatorios
dentro
de
domicilio.

Nacional:
tipo_domicilio_concreto,ti
48
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
po_via,
nombre_via,
numero_casa
o
punto_kilometrico
(solo
uno de los dos), poblacion,
municipio::codigo_ine,
codigo_postal,
provincia::codigo_provinc
ia, pais::codigo_iso3166.

Extranjero:
nombre_via,
pais::codigo_iso3166,
codigo_postal, población.

Apartado
de
Correos: apartado_correos,
provincia::codigo_provinc
ia, municipio::codigo_ine,
codigo_postal, población.

Sin
Normalizar:
codigo_postal,
pais::codigo_iso3166,
linea_1, linea_2.
destinatarios::servicio
string
destinatarios::direccion_electronica
::obligado
booleano
destinatarios::direccion_electronica
string
Obligatorio.
Tipo
de
servicio de envío a realizar,
puede ser urgente o
normal.
Obligatorio para envíos a la
DEH.
Indica
si
la
notificación por DEH es
con
obligatoriedad
del
titular que la recibe o no.
Los valores aceptados son
true o false. En caso de que
sea obligado y el titular no
disponga de Buzón DEH se
le
creará
uno
automáticamente. En caso
de no ser obligado se debe
realizar la consulta del
censo de suscritos.
Obligatorio para envíos a la
49
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
::nif
destinatarios::direccion_electronica
::codigo_procedimiento
string
destinatarios::opciones_emision
::retardo_postal_deh
int
destinatarios::opciones_emision
::caducidad
string
procedimiento::codigo_sia
string
procedimiento::descripcion_sia
string
certificada
booleano
codigo_respuesta
string
descripción_respuesta
string.
DEH. NIF del titular del
buzón DEH que va a recibir
la notificación.
Obligatorio para envíos a la
DEH NO OBLIGADOS.
Código de procedimiento
en la DEH al que el NIF
debe estar suscrito.
Indica el número de días
naturales
que
estará
disponible una notificación
en la Sede Electrónica para
que pueda ser notificado por
comparecencia. Una vez
pasen esos días el envío
pasará a ser notificado a
través de la DEH o el CIE.
En el caso de que el valor
sea 0 el envío no se presenta
en Sede Electrónica y pasa
directamente a la DEH o a
la entrega postal.
Opcional. Caducidad del
envío en formato YYYYMM-DD
Opcional.
Código
de
procedimiento
SIA
(Sistema de Información
Administrativa).
Opcional. Descripción del
SIA
(Sistema
de
Información
Administrativa).
Obligatorio. Indica si el
envío es certificado o no.
Obligatorio. Código de tres
dígitos
asociado
al
resultado.
Obligatorio. Descripción de
50
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
la operación.
Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo II – SW para Organismos – Códigos de respuesta.
En el Anexo VI – SW para Sedes Electrónicas – Ejemplos parte servidora podrá
consultar un ejemplo de este método.
51
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
7.2.4. Método certificacionSede().
El método certificacionSede() es un módulo del servicio web de Notific@, como parte
servidora, que permite el envío de una certificación correspondiente a una notificación
comparecida en Sede Electrónica.
Parámetros:
El método certificacionSede() debe invocarse con los siguientes parámetros:
Variable
Tipo
Descripción
organismo_remisor
string
estado
string
documento
string
hash_documento
string
envio_destinatario
string
Obligatorio. Organismo que ha
remitido la notificación, debe
introducirse el código DIR3 del
organismo.
Obligatorio. Estado en el que se
encuentra
la
notificación:
Notificada o Rehusada.
Obligatorio. PDF en base64 con la
certificación de la notificación.
Obligatorio. Base64 del hash del
binario del documento con la
certificación.
Obligatorio. Identificador del envío
devuelto en
altaEnvio()
csv
string
la
respuesta
de
Opcional. Código de Seguridad
de Verificación.
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre certificacionSedeResponse con los
siguientes campos:
Variable
Tipo
Descripción
envio_destinatario_id
string
Identificador del envío devuelto en
la respuesta de altaEnvio()
codigo_respuesta
string
texto_respuesta
string
Código de tres dígitos asociado al
resultado.
Descripción de la operación.
52
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo II – SW para Organismos – Códigos de respuesta.
En el Anexo VI – SW para Sedes Electrónicas – Ejemplos parte servidora podrá
consultar un ejemplo de este método.
7.2.5. Método getCertificacion().
El método getCertificacion() es un módulo del servicio web de Notific@, como parte
servidora, que permite obtener la certificación de un envío.
Parámetros:
El método getCertificacion() debe invocarse con los siguientes parámetros:
Variable
envio_destinatario
Tipo
Descripción
string
Obligatorio. Identificador del envío
devuelto en
altaEnvio()
la
respuesta
de
Datos de respuesta:
Se devuelve una respuesta SOAP de nombre getCertificacionResponse con los
siguientes campos:
Variable
Tipo
Descripción
contenido
string
hash
string
Contenido de la certificación en
base 64.
Hash del documento.
acuse_o_sobre
fecha
codigo_respuesta
string
string
string
texto_respuesta
string
Indica si es un acuse o un sobre.
Fecha en la que se certificó.
Código de tres dígitos asociado
al resultado.
Descripción de la operación.
Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se
pueden consultar en el Anexo II – SW para Organismos – Códigos de respuesta.
53
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Anexo I – SW para Organismos - Pruebas de Integración.
PRUEBAS DE EMISIÓN – CORRECTAS.
Número 01
Tipo de prueba PETICIÓN CORRECTA DE 1 DESTINATARIO, TIPO
CENTRO DE IMPRESIÓN, DOMICILIO CONCRETO Y
NACIONAL.
Descripción Para cada destinatario se comprobará que devuelve un
identificador, la referencia del emisor y el NIF del titular.
Código devuelto 000.
Descripción OK.
respuesta
Número 02
Tipo de prueba PETICIÓN CORRECTA DE 2 DESTINATARIOS DE TIPO
CENTRO DE IMPRESIÓN, DOMICILIO CONCRETO Y
NACIONAL.
Descripción Para cada destinatario se comprobará que devuelve un
identificador, la referencia del emisor y el NIF del titular.
Código devuelto 000.
Descripción OK.
respuesta
Número 03
Tipo de prueba PETICIÓN CORRECTA DE TIPO CENTRO DE IMPRESIÓN,
DOMICILIO CONCRETO E INTERNACIONAL.
Descripción Para cada destinatario se comprobará que devuelve un
identificador, la referencia del emisor y el NIF del titular.
Código devuelto 000.
Descripción OK.
respuesta
54
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
PRUEBAS DE EMISIÓN – ERRÓNEAS.
Número 04
Tipo de prueba ORGANISMO EMISOR DESCONOCIDO.
Descripción Se enviará una petición con un organismo emisor cuyo código
DIR3 no se encuentre en BBDD.
Resultado “Organismo emisor no dado de alta”.
devuelto
Código de error 4011.
Número 05
Tipo de prueba PETICIÓN CON EL VALOR DE PDF NORMALIZADO
VACÍO.
Descripción Petición en la que el valor del campo normalizado está sin
rellenar.
Resultado “El campo normalizado está vacío”.
devuelto
Código de error 4151.
Número 06
Tipo de prueba PETICIÓN CON UN VALOR DE PDF NORMALIZADO
INCORRECTO.
Descripción Petición en la que el valor del campo normalizado no es ni si ni
no.
Resultado “El valor de normalizado no es válido, debe ser 'si' o 'no'”.
devuelto
Código de error 4152.
Número 07
Tipo de prueba PETICIÓN CON NIF DEL TITULAR INCORRECTO.
Descripción Petición en la que el NIF que se proporciona del titular es
incorrecto.
Resultado “El documento de identificación no es válido”.
devuelto
Código de error 4200
55
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Número
Tipo de prueba
Descripción
Resultado
devuelto
Código de error
08
PETICIÓN CON NOMBRE DEL TITULAR VACÍO.
Petición en la que el campo nombre del titular está vacío.
“Indique el nombre”.
Número
Tipo de prueba
Descripción
Resultado
devuelto
Código de error
09
PETICIÓN SIN DOCUMENTO.
Se enviará una petición sin documento.
“Documento no puede estar vacío”.
4241
4311.
Número 10
Tipo de prueba PETICIÓN EN LA QUE EL HASH ENVIADO NO COINCIDE
CON EL HASH DEL DOCUMENTO.
Descripción Se enviará una petición en la que el Hash calculado del PDF no
coincida con el que se recibe del WS. El algoritmo que se usa es
SHA1 y posteriormente codificado en Base64.
Resultado “No se corresponde el sha1 del documento con el contenido”.
devuelto
Código de error 4320.
Número 11
Tipo de prueba PETICIÓN CON UN VALOR PRIORIDAD DE SERVICIO
INCORRECTO.
Descripción Petición en la que el valor de servicio no es ni normal ni
urgente.
Resultado “El campo Servicio solo puede contener los valores 'urgente' o
devuelto 'normal'”.
Código de error 4402.
56
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Número 12
Tipo de prueba PETICIÓN CON EL VALOR DE PRIORIDAD DE SERVICIO
VACÍO.
Descripción Petición en la que el valor del campo servicio está vacío.
Resultado “Debe rellenar el campo 'servicio'”.
devuelto
Código de error 4403.
Número
Tipo de prueba
Descripción
Resultado
devuelto
Código de error
13
PETICIÓN CON CONCEPTO VACÍO.
Se enviará una petición con el campo concepto vacío.
“Indique el concepto”.
Número
Tipo de prueba
Descripción
Resultado
devuelto
Código de error
14
PETICIÓN CON TIPO DE ENVÍO VACÍO.
Petición en la que el tipo de envío está vacío.
“Tipo de envío vacío”.
4500.
4510.
Número 15
Tipo de prueba PETICIÓN CON TIPO DE ENVÍO INCORRECTO.
Descripción Petición en la que el tipo de envío no es ni notificación ni
comunicación.
Resultado “Tipo de envío no permitido”.
devuelto
Código de error 4511.
57
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Número 16
Tipo de prueba PETICIÓN CON CÓDIGO SIA ERRÓNEO.
Descripción Petición en la que el Código SIA enviado no es correcto o no se
corresponde con el emisor.
Resultado “Código SIA incorrecto”.
devuelto
Código de error 4531.
Número
Tipo de prueba
Descripción
Resultado
devuelto
Código de error
17
PETICIÓN CON TIPO DE DOMICILIO INCORRECTO.
Petición en la que el tipo_domicilio no es concreto ni fiscal.
“Tipo domicilio incorrecto”.
4600.
Número 18
Tipo de prueba PETICIÓN DE TIPO DOMICILIO CONCRETO CON
NÚMERO DE CASA Y PUNTO KILOMÉTRICO RELLENOS.
Descripción Petición en la que el tipo_domicilio es concreto pero se
introducen valores en ambos campos: punto_kilometrico y
numero_casa.
Resultado “Dirección no válida, no pueden estar rellenos al mismo tiempo
devuelto Número de casa y Punto kilométrico”.
Código de error 4601.
Número
Tipo de prueba
Descripción
Resultado
devuelto
Código de error
19
PETICIÓN CON TIPO DE DOMICILIO VACÍO.
Petición en la que no se rellena el campo tipo_domicilio.
“Tipo de domicilio vacío”.
4602.
58
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Número 20
Tipo de prueba PETICIÓN DE TIPO DOMICILIO CONCRETO CON
NOMBRE DE VÍA VACÍO.
Descripción Petición en la que el tipo_domicilio debe ser concreto, sin
Apartado de Correos y en la que el Nombre de Vía está vacío.
Resultado “El Nombre de vía no puede estar vacío”.
devuelto
Código de error 4610.
Número 21
Tipo de prueba PETICIÓN DE TIPO DOMICILIO CONCRETO CON TIPO DE
VÍA VACÍO.
Descripción Petición en la que el campo tipo_via del Domicilio está sin
rellenar.
Resultado “El Tipo de Vía no puede estar vacío”.
devuelto
Código de error 4620.
Número 22
Tipo de prueba PETICIÓN DE TIPO DOMICILIO CONCRETO CON
NÚMERO DE CASA Y PUNTO KILOMÉTRICO VACÍO.
Descripción Petición en la que el tipo_domicilio es concreto pero no se
introduce ningún valor en el campo punto_kilometrico ni en el
campo numero_casa….
Resultado “Dirección no válida, falta Número de casa o Punto kilométrico”.
devuelto
Código de error 4630.
Número 23
INCORRECTA
DE
TIPO
DOMICILIO
Tipo de prueba PETICIÓN
CONCRETO Y APARTADO DE CORREOS.
Descripción Petición en la que el tipo_domicilio debe ser concreto, con
Apartado de Correos relleno pero faltando el Código Postal.
Resultado “Código Postal no puede estar vacío”.
devuelto
Código de error 4650.
Número 24
59
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
INCORRECTA
DE
TIPO
DOMICILIO
Tipo de prueba PETICIÓN
CONCRETO FALTANDO EL APARTADO DE CORREOS.
Descripción Petición en la que el tipo_domicilio debe ser concreto, pero el
campo apartado_correos se encuentre vacío.
Resultado "Apartado de correos no puede estar vacío".
devuelto
Código de error 4660.
Número 25
Tipo de prueba PETICIÓN DEL TIPO DOMICILIO CONCRETO CON
CÓDIGO DE MUNICIPIO VACÍO.
Descripción Petición en la que el código de municipio (código INE)
proporcionado está vacío.
Resultado “Código de municipio vacío”.
devuelto
Código de error 4670.
Número 26
Tipo de prueba PETICIÓN DEL TIPO DOMICILIO CONCRETO CON
CÓDIGO DE MUNICIPIO INCORRECTO.
Descripción Petición en la que el código de municipio (código INE)
proporcionado es incorrecto.
Resultado “Código de municipio (COD_MUNICIPIO) erróneo”.
devuelto
Código de error 4671.
Número 27
Tipo de prueba PETICIÓN DEL TIPO DOMICILIO CONCRETO CON
CÓDIGO DE PROVINCIA VACÍO.
Descripción Petición en la que el código de provincia proporcionado está
vacío.
Resultado “Código de provincia vacío”.
devuelto
Código de error 4680.
60
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Número 28
Tipo de prueba PETICIÓN DEL TIPO DOMICILIO CONCRETO CON
CÓDIGO DE PROVINCIA INEXISTENTE.
Descripción Petición en la que el código de provincia proporcionado es
incorrecto.
Resultado “Código de provincia no válido”.
devuelto
Código de error 4681.
Número 29
Tipo de prueba PETICIÓN DEL TIPO DOMICILIO CONCRETO CON
CÓDIGO DE PAÍS VACÍO.
Descripción Petición en la que el código de país (ISO 3166) proporcionado
está vacío.
Resultado “Código de país vacío”.
devuelto
Código de error 4690.
Número 30
Tipo de prueba PETICIÓN DEL TIPO DOMICILIO CONCRETO CON
CÓDIGO DE PAÍS INEXISTENTE.
Descripción Petición en la que el código de país (ISO 3166) proporcionado es
incorrecto.
Resultado “Código de país no válido”.
devuelto
Código de error 4691.
61
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
PRUEBA DE CONSULTA DE DATADO – CORRECTAS
Número 01
Tipo de prueba PRUEBA CORRECTA.
Descripción Se realizará una petición SOAP con un identificador de envío
correcto.
Comprobación Se comprobará la respuesta con la información del Datado.
PRUEBAS DE CONSULTA DE DATADO – ERRÓNEAS
Número 01
Tipo de prueba IDENTIFICADOR VACÍO.
Descripción Se realizará una petición SOAP con un identificador de envío
vacío.
Comprobación Se comprobará que el servicio web responde con el mensaje
“Identificador de envío vacío”.
Número 02
Tipo de prueba IDENTIFICADOR DE ENVÍO ERRÓNEO.
Descripción Se realizará una petición SOAP con un identificador de envío
erróneo.
Comprobación Se comprobará que el servicio web responde con el mensaje
“Identificador de envío erróneo”.
Número 03
Tipo de prueba NINGUNA INFORMACIÓN DE DATADO.
Descripción Se realizará una petición SOAP con un identificador de envío
correcto pero que no contiene ninguna información de Datado.
Comprobación Se comprobará que el servicio web responde con el mensaje
“Identificador de envío sin información de datado”.
62
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
PRUEBAS DE CONSULTA DE CERTIFICACIÓN - CORRECTAS
Número 01
Tipo de prueba PRUEBA CORRECTA.
Descripción Se realizará una petición SOAP con un identificador de envío
correcto.
Comprobación Se comprobará la respuesta con la información de la
certificación.
PRUEBAS DE CONSULTA DE CERTIFICACIÓN - ERRÓNEAS
Número 01
Tipo de prueba IDENTIFICADOR DE ENVÍO VACÍO.
Descripción Se realizará una petición SOAP con un identificador de envío
vacío.
Comprobación Se comprobará que el servicio web responde con el mensaje
“Identificador de envío vacío”.
Número 02
Tipo de prueba IDENTIFICADOR DE ENVÍO ERRÓNEO.
Descripción Se realizará una petición SOAP con un identificador de envío
erróneo.
Comprobación Se comprobará que el servicio web responde con el mensaje
“Identificador de envío erróneo”.
Número 03
Tipo de prueba NINGUNA INFORMACIÓN DE CERTIFICACIÓN.
Descripción Se realizará una petición SOAP con un identificador de envío
correcto pero que no contiene ninguna información de
Certificación.
Comprobación Se comprobará que el servicio web responde con el mensaje
“Identificador de envío sin información de certificación”.
63
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Anexo II – SW para Organismos – Códigos de respuesta.
A continuación se presenta la tabla de códigos de respuesta obtenidos en las llamadas de
los servicios web, junto con el tipo de resultado y su descripción.
Código de
respuesta
Resultado
Descripción de respuesta
000
4011
4151
4152
4200
4241
4311
4320
4402
Éxito
Error
Error
Error
Error
Error
Error
Error
Error
4403
4500
4510
4511
4531
4600
4601
Error
Error
Error
Error
Error
Error
Error
4602
4610
4620
4630
4650
4660
4670
4671
4680
4681
4690
4691
Error
Error
Error
Error
Error
Error
Error
Error
Error
Error
Error
Error
Ok.
Organismo emisor no dado de alta.
El campo normalizado está vacío.
El valor de normalizado no es válido, debe ser SI o NO.
El documento de identificación no es válido.
Indique el nombre.
Documento no puede estar vacío.
No se corresponde el sha1 del documento con el contenido.
El campo Servicio solo puede contener los valores Urgente o
Normal.
Debe rellenar el campo Servicio.
Indique el concepto.
Tipo de envío vacío.
Tipo de envío no permitido.
Código SIA incorrecto.
Tipo domicilio incorrecto.
Dirección no válida, no pueden estar rellenos al mismo tiempo
Número de casa y Punto kilométrico.
Tipo de domicilio vacío.
El Nombre de vía no puede estar vacío.
El Tipo de Vía no puede estar vacío.
Dirección no válida, falta Número de casa o Punto kilométrico.
Código Postal no puede estar vacío.
Apartado de correos no puede estar vacío.
Código de municipio vacío.
Código de municipio (COD_MUNICIPIO) erróneo.
Código de provincia vacío.
Código de provincia no válido.
Código de país vacío.
Código de país no válido.
64
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Anexo III – SW para Organismos - Ejemplos parte
servidora
A continuación se presentan ejemplos relacionados con el llamado a los métodos del servicio
web para Organismos.
Método
altaEnvio()
Petición
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://administracionelectronica.gob.es/notifica/ws/notific
a/1.0/">
<soapenv:Header>
<api_key>XXXXXXXX</api_key>
</soapenv:Header>
<soapenv:Body>
<ns:altaEnvio>
<envio_type>
<organismo_emisor>
<codigo_dir3>E00000101</codigo_dir3>
<nombre>TRIBUNAL ECONOMICO ADMINISTRATIVO
CENTRAL</nombre>
</organismo_emisor>
<organismo_pagador_correos>
<codigo_dir3>E00000101</codigo_dir3>
<numero_contrato_correos>1111</numero_contrato_correos>
<codigo_cliente_facturacion_correos>2222</codigo_cliente_facturacion_c
orreos>
<fecha_vigencia>2015-12-31</fecha_vigencia>
</organismo_pagador_correos>
<organismo_pagador_cie>
<codigo_dir3>E04877504</codigo_dir3>
<fecha_vigencia>2015-12-31</fecha_vigencia>
</organismo_pagador_cie>
<documento>
<contenido>JVBERi0xLjQl....</contenido>
<hash_sha1>VdlJoGvVH2Srz2McEZ2CfhP4hKM=</hash_sha1>
<normalizado>no</normalizado>
<generar_csv>no</generar_csv>
</documento>
<tipo_envio>notificacion</tipo_envio>
<concepto>prueba</concepto>
<destinatarios>
<item>
<referencia_emisor>REF01010101</referencia_emisor>
<titular>
<telefono>910001122</telefono>
<email>[email protected]</email>
<nif>12345678Z</nif>
<nombre>Usuario</nombre>
<apellidos>ANF</apellidos>
</titular>
<destinatario>
65
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
<telefono>910001122</telefono>
<email>[email protected]</email>
<nif>12345678Z</nif>
<nombre>Usuario</nombre>
<apellidos>ANF</apellidos>
</destinatario>
<tipo_domicilio>concreto</tipo_domicilio>
<domicilio>
<tipo_domicilio_concreto>nacional</tipo_domicilio_concreto>
<tipo_via>Calle</tipo_via>
<nombre_via>Falsa</nombre_via>
<numero_casa>123</numero_casa>
<punto_kilometrico></punto_kilometrico>
<apartado_correos></apartado_correos>
<calificador_numero></calificador_numero>
<bloque></bloque>
<portal></portal>
<escalera></escalera>
<planta></planta>
<puerta></puerta>
<complemento></complemento>
<poblacion></poblacion>
<municipio>
<codigo_ine>280796</codigo_ine>
<nombre></nombre>
</municipio>
<codigo_postal>01020</codigo_postal>
<provincia>
<codigo_provincia>28</codigo_provincia>
<nombre>Madrid</nombre>
</provincia>
<pais>
<codigo_iso3166>ES</codigo_iso3166>
<nombre></nombre>
</pais>
</domicilio>
<servicio>normal</servicio>
<direccion_electronica>
<obligado>false</obligado>
<nif>12345678Z</nif>
</direccion_electronica>
<opciones_emision>
<codigo_procedimiento>prueba</código_procedimiento>
<retardo_postal_deh>3</retardo_postal_deh>
</opciones_emision>
</item>
</destinatarios>
<procedimiento>
<codigo_sia>101310</codigo_sia>
<descripcion_sia>Procedimiento de
ejemplo</descripcion_sia>
</procedimiento>
</envio_type>
</ns:altaEnvio>
</soapenv:Body>
</soapenv:Envelope>Respuesta
66
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/">
<SOAP-ENV:Body>
<ns1:altaEnvioResponse>
<return>
<identificadores>
<item>
<identificador>53bd4081814f8</identificador>
<referencia_emisor>REF01010101</referencia_emisor>
<nif_titular>12345678Z</nif_titular>
</item>
</identificadores>
<codigo_csv>2841e1a35fb9da19cfde57c26435a42001758c8ee2a95a7672e2e169b6
47c15d_53bd4081818e2_2014_07_09_15_15_1404911745</codigo_csv>
<codigo_respuesta>000</codigo_respuesta>
<descripcion_respuesta>OK</descripcion_respuesta>
</return>
</ns1:altaEnvioResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
67
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Método
consultaCertificacionEnvio()
Petición
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://administracionelectronica.gob.es/notifica/ws/notific
a/1.0/">
<soapenv:Body>
<ns:consultaCertificacionEnvio>
<identificador_envio>5390462af331e</identificador_envio>
</ns:consultaCertificacionEnvio>
</soapenv:Body>
</soapenv:Envelope>
Respuesta
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<ns1:consultaCertificacionEnvioResponse>
<return>
<certificacion>
<identificador_envio>
<identificador>5390462af331e</identificador>
<referencia_emisor>79</referencia_emisor>
<nif_titular>65380222P</nif_titular>
</identificador_envio>
<pdf_certificado>JVBERi0xLjQK....</pdf_certificado>
<xml_certificado xsi:nil="true"/>
<certificacion>acuse</certificacion>
<fecha_actualizacion>2014-0605T17:45:17+02:00</fecha_actualizacion>
<ncc_id_externo>1490374300003</ncc_id_externo>
</certificacion>
<codigo_respuesta>000</codigo_respuesta>
<descripcion_respuesta>OK</descripcion_respuesta>
</return>
</ns1:consultaCertificacionEnvioResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
68
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Método
consultaDatadoEnvio()
Petición
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://administracionelectronica.gob.es/notifica/ws/notific
a/1.0/">
<soapenv:Body>
<ns:consultaDatadoEnvio>
<identificador_envio>5390462af3707</identificador_envio>
</ns:consultaDatadoEnvio>
</soapenv:Body>
</soapenv:Envelope>
Respuesta
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/">
<SOAP-ENV:Body>
<ns1:consultaDatadoEnvioResponse>
<return>
<datado>
<identificador_envio>
<identificador>5390462af3707</identificador>
<referencia_emisor>80</referencia_emisor>
<nif_titular>50879347N</nif_titular>
</identificador_envio>
<datado>
<item>
<estado>ausente</estado>
<descripcion>Ausente</descripcion>
<fecha>2014-06-03T16:00:00+02:00</fecha>
</item>
</datado>
<estado_actual>ausente</estado_actual>
<descripcion_estado_actual>Ausente</descripcion_estado_actual>
<fecha_actualizacion>2014-0603T16:00:00+02:00</fecha_actualizacion>
<ncc_id_externo>1490374300002</ncc_id_externo>
</datado>
<codigo_respuesta>000</codigo_respuesta>
<descripcion_respuesta>OK</descripcion_respuesta>
</return>
</ns1:consultaDatadoEnvioResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
69
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Método
consultaEstado()
Petición
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://administracionelectronica.gob.es/notifica/ws/notific
a/1.0/">
<soapenv:Header/>
<soapenv:Body>
<ns:consultaEstado>
<identificador_envio>5390462af3707</identificador_envio>
</ns:consultaEstado>
</soapenv:Body>
</soapenv:Envelope>
Respuesta
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/">
<SOAP-ENV:Body>
<ns1:consultaEstadoResponse>
<return>
<estado>
<identificador_envio>5390462af3707</identificador_envio>
<estado>Ausente</estado>
<ncc_id_externo>1490374300002</ncc_id_externo>
</estado>
<codigo_respuesta>000</codigo_respuesta>
<descripcion_respuesta>OK</descripcion_respuesta>
</return>
</ns1:consultaEstadoResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
70
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Anexo IV – Servicio Adviser – Códigos de respuesta.
A continuación se presenta la tabla de códigos de respuesta obtenidos en las llamadas de
los servicios web, junto con el tipo de resultado y su descripción.

Método datadoOrganismo()
Código de respuesta
Resultado
000
001
002
003
004
005
999
Éxito
Error

Error
Error
Error
Error
Error
Descripción de respuesta
Ok
Organismo desconocido.
Identificador no encontrado.
Resultado desconocido.
Fecha incorrecta.
NIF incorrecto.
Petición SOAP incorrecta.
Método certificacionOrganismo()
Código de respuesta
Resultado
000
001
002
003
004
999
Éxito
Error
Error
Error
Error
Error
Descripción de respuesta
Ok
Organismo desconocido.
Identificador no encontrado.
Documento no reconocido.
Hash incorrecto.
Petición SOAP incorrecta.
71
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Anexo V – SW para Organismos – Ejemplos del Adviser.
A continuación se presentan ejemplos relacionados con el Adviser que debe ser implementado
por los Organismos en caso de querer recibir los Datados y Certificados.
Método
datadoOrganismo()
Petición:
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/">
<SOAP-ENV:Body>
<ns1:datadoOrganismo>
<datadoOrganismo>
<organismo_emisor>
<codigo_dir3>E00000101</codigo_dir3>
<nombre>DESTINOS</nombre>
</organismo_emisor>
<identificador_destinatario>54fe9ff2dbb32</identificador_destinatario>
<resultado>Object</resultado>
<fecha>2015-03-12T09:00:00</fecha>
<receptor>
<nif>00000000A</nif>
<nombre>Enrique García</nombre>
</receptor>
</datadoOrganismo>
</ns1:datadoOrganismo>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Respuesta:
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/">
<SOAP-ENV:Body>
<ns1:datadoOrganismoResponse>
<codigo_respuesta>000</codigo_respuesta>
<texto_respuesta>OK</texto_respuesta>
</ns1:datadoOrganismoResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
72
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Método
certificacionOrganismo()
Petición:
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://administracionelectronica.gob.es/notifica/ws/notific
a/1.0/">
<soapenv:Header/>
<soapenv:Body>
<ns:certificacionOrganismo>
<certificacionOrganismo>
<organismo_emisor>E00127203</organismo_emisor>
<identificador_destinatario>54fe9ff2dbb32</identificador_destinatario>
<acuse_o_sobre>acuse</acuse_o_sobre>
<certificacion>JVBERi0xLjQKJcfs...</certificacion>
<hash_sha1>Sa323sJKSA...</hash_sha1>
</certificacionOrganismo>
</ns:certificacionOrganismo>
</soapenv:Body>
</soapenv:Envelope>
Respuesta:
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/">
<SOAP-ENV:Body>
<ns1:certificacionOrganismoResponse>
<return>
<codigo_respuesta>000</codigo_respuesta>
<texto_respuesta>OK</texto_respuesta>
</return>
</ns1:certificacionOrganismoResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
73
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Anexo VI - SW para Sedes Electrónicas - Ejemplos parte
servidora.
Método
certificacionSede()
Petición
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://administracionelectronica.gob.es/notifica/ws/notific
a/1.0/">
<soapenv:Header/>
<soapenv:Body>
<ns:certificacionSede>
<certificacion_sede>
<organismo_emisor>E00000101</organismo_emisor>
<hash_documento>mArYS9OiWD5SC2OpSZfA1wRNZ3I=</hash_documento>
<documento>JVBERi0xLjQKJ.</documento>
<envio_destinatario>544</envio_destinatario>
<estado>rehusada</estado>
<csv>NOT12345678</csv>
</certificacion_sede>
</ns:certificacionSede>
</soapenv:Body>
</soapenv:Envelope>
Respuesta
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/">
<SOAP-ENV:Body>
<ns1:certificacionSedeResponse>
<return>
<envio_destinatario_id>544</envio_destinatario_id>
<codigo_respuesta>000</codigo_respuesta>
<descripcion_respuesta>OK</descripcion_respuesta>
</return>
</ns1:certificacionSedeResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
74
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Método
getEnvios()
Petición
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://administracionelectronica.gob.es/notifica/ws/notific
a/1.0/">
<soapenv:Header/>
<soapenv:Body>
<ns:getEnvios>
<get_envios>
<!--You may enter the following 6 items in any order-->
<nif>12345678Z</nif>
<estado>pendiente</estado>
<organismo_emisor>E00000101</organismo_emisor>
<codigo_sia></codigo_sia>
<fecha_desde>2015-01-01</fecha_desde>
<fecha_hasta></fecha_hasta>
</get_envios>
</ns:getEnvios>
</soapenv:Body>
</soapenv:Envelope>
Respuesta
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/">
<SOAP-ENV:Body>
<ns1:getEnviosResponse>
<return>
<resultadoGetEnvios>
<item>
<envio_destinatario>3405</envio_destinatario>
<estado>Pendiente</estado>
<concepto>Prueba NIE</concepto>
<organismo_emisor>E00000101</organismo_emisor>
<fecha_notificacion>2015-0122T16:38:57+01:00</fecha_notificacion>
</item>
<item>
<envio_destinatario>3404</envio_destinatario>
<estado>Pendiente</estado>
<concepto>Prueba NIE</concepto>
<organismo_emisor>E00000101</organismo_emisor>
<fecha_notificacion>2015-0122T16:37:48+01:00</fecha_notificacion>
</item>
<item>
<envio_destinatario>3403</envio_destinatario>
<estado>Pendiente</estado>
75
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
<concepto>sdsfsd</concepto>
<organismo_emisor>E00000101</organismo_emisor>
<fecha_notificacion>2015-0115T09:13:28+01:00</fecha_notificacion>
</item>
</resultadoGetEnvios>
<codigo_respuesta>000</codigo_respuesta>
<descripcion_respuesta>OK</descripcion_respuesta>
</return>
</ns1:getEnviosResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
76
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Método
getEnviosAgrupados()
Petición
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://administracionelectronica.gob.es/notifica/ws/notific
a/1.0/">
<soapenv:Header/>
<soapenv:Body>
<ns:getEnviosAgrupados>
<get_envios>
<!--You may enter the following 6 items in any order-->
<nif>12345678Z</nif>
<estado></estado>
<organismo_emisor></organismo_emisor>
<codigo_sia></codigo_sia>
<fecha_desde></fecha_desde>
<fecha_hasta></fecha_hasta>
</get_envios>
</ns:getEnviosAgrupados>
</soapenv:Body>
</soapenv:Envelope>
Respuesta
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/">
<SOAP-ENV:Body>
<ns1:getEnviosAgrupadosResponse>
<return>
<porOrganismoEmisor>
<item>
<organismoEmisor>E00000101</organismoEmisor>
<nombreOrganismoEmisor>DESTINOS</nombreOrganismoEmisor>
<estado_notificado>1</estado_notificado>
<estado_pendiente>178</estado_pendiente>
<totales>179</totales>
</item>
<item>
<organismoEmisor>E00120903</organismoEmisor>
<nombreOrganismoEmisor>COMISIONADO PARA EL MERCADO
DE TABACOS</nombreOrganismoEmisor>
<estado_notificado>1</estado_notificado>
<estado_pendiente>4</estado_pendiente>
<totales>5</totales>
</item>
<item>
<organismoEmisor>E00119003</organismoEmisor>
77
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
<nombreOrganismoEmisor>D.G. DE SEGUROS Y FONDOS DE
PENSIONES</nombreOrganismoEmisor>
<estado_notificado>0</estado_notificado>
<estado_pendiente>1</estado_pendiente>
<totales>1</totales>
</item>
<item>
<organismoEmisor>E00127203</organismoEmisor>
<nombreOrganismoEmisor>TRIBUNAL ECONOMICO
ADMINISTRATIVO CENTRAL</nombreOrganismoEmisor>
<estado_notificado>0</estado_notificado>
<estado_pendiente>1</estado_pendiente>
<totales>1</totales>
</item>
<item>
<organismoEmisor>E04877504</organismoEmisor>
<nombreOrganismoEmisor>DIVISION DE SISTEMAS DE
INFORMACION Y COMUNICACIONES</nombreOrganismoEmisor>
<estado_notificado>0</estado_notificado>
<estado_pendiente>1</estado_pendiente>
<totales>1</totales>
</item>
</porOrganismoEmisor>
<porCodigoSia>
<item>
<codigoSia>101310</codigoSia>
<descripcionSia>SUCESION EN DIGNIDADES
NOBILIARIAS.</descripcionSia>
<estado_notificado>1</estado_notificado>
<estado_pendiente>144</estado_pendiente>
<totales>145</totales>
</item>
</porCodigoSia>
<porEstado>
<estado_notificado>2</estado_notificado>
<estado_pendiente>185</estado_pendiente>
<totales>187</totales>
</porEstado>
<codigo_respuesta>000</codigo_respuesta>
<descripcion_respuesta>OK</descripcion_respuesta>
</return>
</ns1:getEnviosAgrupadosResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
78
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
Método
infoEnvio()
Petición
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://administracionelectronica.gob.es/notifica/ws/notific
a/1.0/">
<soapenv:Header/>
<soapenv:Body>
<ns:infoEnvio>
<info_envio>
<envio_destinatario>167</envio_destinatario>
</info_envio>
</ns:infoEnvio>
</soapenv:Body>
</soapenv:Envelope>
Respuesta
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://administracionelectronica.gob.es/notifica/ws/notifi
ca/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<ns1:infoEnvioResponse>
<return>
<infoEnvio>
<organismo_emisor>
<codigo_dir3>E00000101</codigo_dir3>
<nombre>DESTINOS</nombre>
</organismo_emisor>
<organismo_pagador xsi:nil="true"/>
<documento>
<contenido/>
<hash_sha1>2jmj7l5rSw0yVb/vlWAYkK/YBwk=</hash_sha1>
<normalizado>no</normalizado>
</documento>
<tipo_envio>NOTIFICACION</tipo_envio>
<concepto>prueba</concepto>
<destinatarios>
<item>
<referencia_emisor>REF01010101</referencia_emisor>
<titular>
<telefono>910001122</telefono>
<email>[email protected]</email>
<nif>12345678Z</nif>
<nombre>Usuario</nombre>
<apellidos>ANF</apellidos>
</titular>
<destinatario>
<telefono>910001122</telefono>
<email>[email protected]</email>
<nif>12345678Z</nif>
79
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx
<nombre>Usuario</nombre>
<apellidos>ANF</apellidos>
</destinatario>
<tipo_domicilio>concreto</tipo_domicilio>
<domicilio>
<tipo_domicilio_concreto xsi:nil="true"/>
<tipo_via>Calle</tipo_via>
<nombre_via>Falsa</nombre_via>
<numero_casa>123</numero_casa>
<punto_kilometrico/>
<apartado_correos xsi:nil="true"/>
<calificador_numero/>
<bloque/>
<portal/>
<escalera/>
<planta/>
<puerta/>
<complemento/>
<poblacion/>
<municipio>
<codigo_ine>280796</codigo_ine>
<nombre xsi:nil="true"/>
</municipio>
<codigo_postal>01020</codigo_postal>
<provincia>
<codigo_provincia>28</codigo_provincia>
<nombre xsi:nil="true"/>
</provincia>
<pais>
<codigo_iso3166>ES</codigo_iso3166>
<nombre xsi:nil="true"/>
</pais>
<linea_1 xsi:nil="true"/>
<linea_2 xsi:nil="true"/>
</domicilio>
<servicio>normal</servicio>
<direccion_electronica>
<obligado>false</obligado>
<nif>12345678Z</nif>
</direccion_electronica>
<opciones_emision xsi:nil="true"/>
</item>
</destinatarios>
<procedimiento>
<codigo_sia>101310</codigo_sia>
<descripcion_sia>SUCESION EN DIGNIDADES
NOBILIARIAS.</descripcion_sia>
</procedimiento>
</infoEnvio>
<certificada>false</certificada>
<codigo_respuesta>000</codigo_respuesta>
<descripcion_respuesta>OK</descripcion_respuesta>
</return>
</ns1:infoEnvioResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
80
Plataforma Notific@
ServiciosWeb Organismos y Sedes v2.14.docx