SERVICIO DE PLATINO. v2.0

Transcripción

1 Interoperabilidad de los servicios telemáticos de la Administración Pública de la CAC Página 1 de 75 SERVICIO NOTIFIC@ DE PLATINO v2.0 Documento : Ubicación en eroom: PLA-DOC-FIN-V 2.0. Servicio.pdf Preparado por Revisado por Aprobado por Oficina Técnica de Platino D. Gral. de Telecomunicaciones y Nuevas Tecnologías D. Gral. de Telecomunicaciones y Nuevas Tecnologías Fecha: 29/05/2018 Fecha: 29/05/2018 Fecha: 29/05/2018

2 Página 2 de 75 ÍNDICE 1 INTRODUCCIÓN REQUISITOS PREVIOS VERSIÓN DEL SERVICIO OPERACIONES DEL SERVICIO PARA ORGANISMOS altaremesaenvios() Entrada... 7 Notas Aclaratorias Salida infoenvio2() Entrada Salida getcies() Entrada Salida OPERACIONES DEL SERVICIO PARA SEDES getenvios() Entrada Salida getenvios2() Entrada Salida getenviosagrupados() Servicio

3 Página 3 de Entrada Salida getenviosagrupados2() Entrada Salida infoenvio() Entrada Salida infoenvio2() Entrada Salida certificacionsede() Entrada Salida getcertificacion() Entrada Salida comunicacionsede() Entrada Salida ADVISER Introducción Servicio

4 Página 4 de Política de reintentos datadoorganismo() Entrada Salida certificacionorganismo() Entrada Salida...69 CÓDIGOS DE RESPUESTA PARA ORGANISMOS Y SEDES CÓDIGOS DE RESPUESTA DEL ADVISER Estado de un envío...74 Servicio

5 Página 5 de 75 1 INTRODUCCIÓN El Servicio, dentro del marco de la Plataforma de Interoperabilidad del Gobierno de Canarias, consiste en un servicio horizontal que podrá ser utilizado por los backoffices y sedes para la remisión/recepción de Notificaciones y Comunicaciones vía Carpeta Ciudadana y la Dirección Electrónica Habilitada. Este documento describe los Servicios Web que el Servicio pone a disposición de los consumidores para el uso automatizado e integración de las aplicaciones con el servicio. El servicio Notific@ expone 3 endpoints para el consumo de los Organismos emisores, las Sedes y el Adviser. Servicio

6 Página 6 de 75 2 REQUISITOS PREVIOS Para poder hacer uso del servicio de Notific@ es necesario previamente cumplir los requisitos del alta en Platino para el consumo del servicio, para ello se deberá disponer de un identificador APIKEY y que el certificado de consumo de la aplicación esté dada de alta en la Base de Datos de Autorización de Platino con la plantilla Notifica, a continuación se detallan los pasos: 1) Se deberá abrir incidencia a Cibercentro para el alta del certificado de consumo de la aplicación en la Base de datos de Autorización de Platino, solicitando la aplicación de la plantilla de Notifica a dicho Consumidor. 2) La Oficina Técnica de Platino proveerá el APIKEY generado por parte del Ministerio al organismo emisor. 3 VERSIÓN DEL SERVICIO Este documento corresponde a la versión del servicio Para consultar la información más detallada de los cambios del servicio ver Servicio

7 Página 7 de 75 4 OPERACIONES DEL SERVICIO PARA ORGANISMOS La ruta del wsdl de organismos se expone en la siguiente ruta: V2/organismos?wsdl ofreciendo la creación, consulta y monitorización de la entrega de una notificación, y que incluye los siguientes métodos: Parámetros altaremesaenvios() infoenvio2() getcies() Descripción Método que permite el dar de alta una remesa, es decir, un conjunto de 1 o varios envíos que comparten las mismas características y que difieren únicamente en quiénes son los titulares y destinatarios. Método para consultar la información detallada de un envío específico. Método que permite obtener un listado de los CIEs disponibles para un Organismo Emisor. 4.1 altaremesaenvios() El método altaremesaenvios() es el método del servicio web de Notific@ para Organismos a través del cual se permite la incorporación a la plataforma Notific@ de un conjunto de 1 o N envíos para su gestión y puesta a disposición a través de las distintas vías de salida, conforme a las opciones que se indiquen. Todos los envíos de una misma remesa comparten los mismos datos (vías de salida, información de Organismos Emisores, documento a notificar, etc.) y únicamente difieren el Titular y/o los Destinatarios de cada envío Entrada Parámetros Tipo Descripción codigoorganismoemisor string Obligatorio. DIR3 del Organismo Emisor del envío. Servicio

8 Página 8 de 75 tipoenvio integer Obligatorio. Valores posibles: 1 Comunicación 2 Notificación concepto string Obligatorio. Concepto del envío. En caso que se envíe a través de un CIE sólo se imprimirán los primeros 50 caracteres. Los caracteres válidos para este campo son los siguientes:aàáäbcçdeèéëfghiìíïjklmnñoòóöpqrstuù úüvwxyzaàáäbcçdeèéëfghiìíïjklmnñoòóö PQRSTU ÙÚÜVWXYZ \u2013_'"/:().,?! ; descripción string Descripción detallada del envío. Máximo 1000 caracteres. fechaenvioprogramado Date Fecha en la que el envío se pondrá a disposición para su comparecencia. Formato YYYY-MM-DD procedimiento String Código SIA del procedimiento de la notificación. Obligatorio para las notificaciones, opcional para las comunicaciones. documento envios opcionesremesa ComplexType: Documento ComplexType: Envios ComplexType: Opciones Obligatorio. Información del documento que se envía. Obligatorio.Envíos contenidos en la Remesa. Opciones de la remesa. Opciones permitidas para el envío en modo clave:valor -retardo: número de días que el envío está a disposición de comparecencia en carpeta antes de entregarlo a otras vías (CIE o DEH) -caducidad: formato YYYY-MMDD, fecha de expiración del envío contenido base64binary Refencia al documento a través del estándar SOAP with Attachments. Se insertará el contenido del archivo en formato Base64. Es obligatorio si no está informado enlacedocumento. No pueden enviarse ambos elementos. hash string Obligatorio. Hash del documento. SHA256 del Servicio

9 Página 9 de 75 Documento adjunto o del enlazado, codificado previamente en base64. enlacedocumento string Enlace externo donde se encuentra el documento del envío. Es obligatorio si no está informado el elemento contenido. No pueden enviarse ambos elementos. Debe ser un enlace activo desde internet, accesible por el ciudadano. metadatos string Metadatos extra del propio documento. Parámetros extra del propio documento en formato XML, definidos por el Organismo Emisor o conforme a algún estándar. opcionesdocumento envio ComplexType: Opciones ComplexType: Envio Opciones válidas: -normalizado: si o no. Sólo aplica a los envíos postales, para los que es obligatorio. Ver definición de normalizado en el glosario de términos. -generarcsv: si o no. Cuando el documento aportado es un PDF con firma PADES, indicar si se desea que notific@ lo sustituya por otro en el que se inserte en el PDF un Código Seguro de Verificación. Obligatorio. Información del destino. Puede aparecer de 1 a 100. referenciaemisor string Referencia que establece el Organismo Emisor para el Envío. Debe ser único para ese Organismo Emisor. En esta nueva versión este campo es opcional. Si no viene relleno Notific@ generará un identificador único para el envío. titular destinatarios entregapostal ComplexType: Persona ComplexType: Destinatarios ComplexType: EntregaPostal Obligatorio.Titular de la notificación/comunicación Conjunto de destinatarios de la notificación/comunicación. Existirá en caso de que existan destinatarios distintos del titular. Datos para la entrega Postal. entregadeh Tipo Datos para la entrega a la DEH Servicio

10 Página 10 de 75 destinatario Complejo: EntregaDEH ComplexType: Persona Obligatorio. Destinatario de la notificación/comunicación. Puede aparecer de 0 a 100 veces. Si aparece 0 veces se asume que Titular = Destinatario. Cuando un envío va por salida postal únicamente se imprime en el sobre el nombre del primer destinatario, junto con la dirección postal. nif string NIF de la persona física/jurídica. Puede ser sustituido por el NIE, no por otros documentos como el pasaporte. La obligatoriedad del campo NIF depende de las siguientes reglas: Para los envíos que solo se publiquen en Carpeta Ciudadana: entre el titular y todos los posibles destinatarios debe haber al menos una persona con NIF. Para los envíos que se remitan a la DEH: El NIF del titular es obligatorio. Si además se establecen destinatarios y tienen NIF, también podrán acceder al contenido de la notificación. Para los envíos que se remitan al CIE: No es obligatorio el NIF. Sin embargo, debe tenerse en cuenta que si no se indica ningún NIF nadie podrá acceder a los envíos a través de Carpeta Ciudadana. Todo ello sin perjuicio de la entrada en vigor el 2 de octubre de 2018 del artículo 43.4 de la Ley 39/2015 que indica que Los interesados podrán acceder a las notificaciones desde el Punto de Acceso General electrónico de la Administración nombre string Nombre de la persona física. Obligatorio en caso de personas físicas. Cuando un envío se entrega al CIE, en el sobre se imprimen únicamente los primeros 125 caracteres resultantes de la concatenación de los campo nombre o razón social, según corresponda y apellidos apellidos string Apellidos de la persona física. Obligatorio en caso de personas físicas. Servicio

11 Página 11 de 75 razonsocial string Razón Social de la persona jurídica. Obligatorio en caso de personas jurídicas. Cuando un envío se entrega al CIE, en el sobre se imprimen únicamente los primeros 125 caracteres resultanes de la concatenación de los campo nombre o razón social, según corresponda y apellidos. string de la persona que recibe la notificación/comunicación. Desde Notifica se recomienda la introducción de este campo para todas las notificaciones electrónicas, de esta forma se podrá avisar de la existencia de la notificación por esta vía. Adicionalmente si como resultado del envío se crea un buzón de DEH (si es obligado a DEH y no está previamente creado el buzón), la dirección de correo electrónico quedará fijada como dirección de correo de la DEH asociada. telefono string Teléfono de la persona que recibe la notificación/comunicación. Actualmente no se le da uso para el envío de SMS informando de que existe una nueva notificación o comunicación. Estando en estudio su posible reimplantación en el futuro. codigodestino String DIR3 o DIRe de la entidad que recibe el envío. No es obligatorio en ningún caso, ni cuando el envío se dirige a personas físicas, ni a personas jurídicas del sector público (DIR3) o del sector privado (DIRe). Los códigos DIRe (relativos al sector privado) no están disponibles actualmente. organismopagadorpostal organismopagadorcie ComplexType: OrganismoPa gadorpostal ComplexType: OrganismoPa gadorcie Datos del organismo que asume los costes postales. Introducir en caso de que no haya información en la web de Notifica acerca del pagador postal. También puede introducirse para sobrescribir la información del pagador para el envío que se remite. Sólo aplica a envíos en que se vaya a usar el Operador Postal Correos conjuntamente con el CIE de la AEAT. Datos del organismo que asume los costes del CIE. Introducir en caso de que no haya información en la web de Notifica acerca del Servicio

12 Página 12 de 75 pagador del CIE. También puede introducirse para sobrescribir la información del pagador para el envío que se remite. Sólo aplica a envíos en que se vaya a usar el Operador Postal Correos conjuntamente con el CIE de la AEAT. tipodomicilio enum Obligatorio. Valor numérico que define el tipo de domicilio para la entrega postal. Valores posibles: 1: Nacional Normalizado 2: Extranjero Normalizado 3: Apartado de Correos Normalizado 4: Sin Normalizar tipovia string Tipo de vía para entregas postales. Obligatorio si tipodomicilio = Nacional Normalizado. nombrevia string Nombre de la vía para entregas postales. Obligatorio si tipodomicilio = Nacional Normalizado o Extranjero Normalizado. numerocasa string Número de la casa para entregas postales. Obligatorio si tipodomicilio = Nacional Normalizado a menos que se consigne puntokilometrico. puntokilometrico string Punto kilométrico para entregas postales. Obligatorio si tipodomicilio = Nacional Normalizado a menos que se consigne numerocasa. portal string Portal de la casa para entregas postales. puerta string Puerta de la casa para entregas postales escalera string Escalera de la casa para entregas postales planta string Planta de la casa para entregas postales bloque string Bloque de la casa para entregas postales complemento string Información extra acerca de la casa para la entrega postal Servicio

13 Página 13 de 75 calificadornumero string Tipo de numeración de la dirección. Campo libre para indicar información adicional sobre la numeración (por ejemplo bis, tri, etc.) codigopostal string Código Postal de la casa para entregas postales. Obligatorio para cualquier valor de tipodomicilio. Para envíos internacionales en países sin código postal se puede consignar apartadocorreos string Apartado de Correos para entregas postales. Obligatorio cuando tipodomicilio = Apartado de Correos Normalizado. municipio string Código INE del municipio donde se entrega el envío. Debe contener el dígito de control. Obligatorio para envíos de los tipos Nacional Normalizado y Apartado de Correos Normalizado provincia string Código de provincia donde se entrega el envío. Obligatorio para envíos de los tipos Nacional Normalizado, y Apartado de Correos Normalizado pais string Código ISO3166 de 2 caracteres del país donde se entrega el envío. Obligatorio cuando tipodomicilio = Extranjero Normalizado poblacion string Población donde se entrega el envío. Obligatorio para envíos de los tipos Nacional Normalizado, Extranjero Normalizado y Apartado de Correos Normalizado. Únicamente se imprimen los primeros 30 caracteres. linea1 string Linea 1 de la dirección de entrega del envío sin normalizar. Obligatorio cuando tipodomicilio = Sin Normalizar. El campo línea 1 y línea 2 son los únicos que se imprimen y, por tanto, deben contener la dirección completa incluyendo código postal y país, sin perjuicio de que el código postal y país se envíen adicionalmente en campo separado. linea2 string Línea 2 de la dirección de entrega del envío sin normalizar. Obligatorio cuando tipodomicilio = Sin Normalizar. El campo línea 1 y línea 2 son los únicos que se Servicio

14 Página 14 de 75 opcionescie ComplexType: Opciones imprimen y, por tanto, deben contener la dirección completa incluyendo código postal y país, sin perjuicio de que el código postal y país se envíen adicionalmente en campo separado. En formato clave:valor - cie: identificador del CIE en Notifica para seleccionarlo para el envío - formatosobre: cadena de caracteres para el formato del sobre (americano, C5 ) - formatohoja: cadena de caracteres para el formato de hoja (A4,A5 ) codigodir3postal string Obligatorio. Código DIR3 del pagador de los costes postales. numcontratopostal string Obligatorio. Número de contrato con el operador postal. codclientefacturacionpostal string Obligatorio. Código de cliente de facturación con el operador postal. fechavigenciapostal Date Obligatorio. Fecha de vigencia del contrato con el operador postal. codigodir3cie string Obligatorio. Código DIR3 del pagador de los costes de impresión y ensobrado fechavigenciacie Date Obligatorio. Fecha de vigencia del contrato con el CIE. obligado Boolean Obligatorio. Booleano para indicar si el envío es obligado o voluntario. Valores admitidos: true o false. Si no es obligado se comprueba si el Titular está suscrito voluntariamente al procedimiento, en cuyo caso se podrá notificar a través de la DEH. codigoprocedimiento string Código del procedimiento en la DEH para envíos a voluntarios. El código de procedimiento en la DEH se recomienda que coincida con el código en SIA. opcion ComplexType: Opcion Tipo simple con la estructura. Puede aparecer N veces. Un ejemplo sería <alt:opcion tipo="normalizado">no</alt:opcio n> Servicio

15 Página 15 de 75 Notas Aclaratorias Envío únicamente a Capeta/Sede electrónica Si desea que el envío esté disponible únicamente en la Carpeta Ciudadana y, en su caso, sede electrónica, se deben dejar los campos EntregaPostal y EntregaDEH sin consignar, y se deberá establecer fecha de caducidad a través del campo opcionesremesa. Envío DEH voluntario + Carpeta Ciudadana / Sede electrónica De la misma manera el campo caducidad también es obligatorio cuando un envío se configura como DEH no obligatoria + Carpeta Ciudadana, ya que en caso que el ciudadano no esté suscrito el envío acabará únicamente en Carpeta Ciudadana. Uso de la fecha de caducidad cuando se está integrando una sede electrónica 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, a través de los servicios web para sedes electrónicas. Debe tener en cuenta que lo anterior no aplica cuando los envíos se ponen a disposición también a través de la DEH (en cuyo caso es ésta quien controla los plazos) o a través de Operador Postal (en cuyo caso los envíos no caducan sino que su ciclo de vida lo marcan los intentos de entrega a través de dicho operador). Importancia de consignar el campo Estadísticamente se ha confirmado que la tasa de comparecencia de notificaciones por medios electrónicos es muy superior cuando se consigna el campo . Esto es especialmente importante cuando los destinatarios están obligados a recibir notificaciones electrónicas. Es deseable que el Organismo Emisor rellene el campo a partir de la información contenida en un registro de contactos. Servicio

16 Página 16 de 75 Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:alt=" vios"> <soapenv:header> <apikey>*************************</apikey> </soapenv:header> <soapenv:body> <alt:altaremesaenvios>  <alt:codigoorganismoemisor>a </alt:codigoorganismoemisor> <alt:tipoenvio>2</alt:tipoenvio> <alt:concepto>prueba DE NOTIFICACION CON NOTIFICA 2.1</alt:concepto>  <alt:descripcion>prueba </alt:descripcion>  <alt:procedimiento>200620</alt:procedimiento> <alt:documento>   <alt:contenido>jvberi0xljqkjcokw7zdtsofcjigmcbvymokpdwvtgvuz3roidmgmcbsl0zpbhrlci 9GbGF0ZURlY29kZT4+CnN0cmVhbQp4nDPQM1Qo5ypUMFAwALJMLU31jBQsTAz1LBSKUrnCtRTyIHJAWJT O5RTCZWoGlDI3NwEqDklR0HczVDA0UghJi7YxMLTTNbQxMDIwNjCxAzJMDczsYkO8uFxDuAK5AhUAeIcW EwplbmRzdHJlYW0KZW5kb2JqCgozIDAgb2JqCjEwMQplbmRvYmoKCjUgMCBvYmoKPDwvTGVuZ3RoIDYgM i83lxc8swway0msksth57paiyqhbfp3f4qcua5pskpuojq/8ziazx5vmqcevndgrayprfgzuucskvt4i0 NCQjZFRjIyOUE1RTBFQkNEMEIwREQ1Mjg5PiBdCi9Eb2NDaGVja3N1bSAvOUY0OTIzNTgwRUQyMTUzODN ERkE0QURGNUI5MjUxRjMKPj4Kc3RhcnR4cmVmCjY1NTgKJSVFT0YK</alt:contenido> <alt:hash>14fdb/rwm8qapn2b+xt95qrw/qotu3ctdur6gmlyore=</alt:hash>  <alt:enlacedocumento></alt:enlacedocumento> </alt:documento> <alt:envios> <alt:envio>  <alt:titular> Servicio

17 Página 17 de 75   <alt:nif> h</alt:nif>  <alt:nombre>said</alt:nombre>  <alt:apellidos>filali YACHOU</alt:apellidos>  <alt: > @ .com</alt: >  </alt:titular>  <alt:destinatarios> <alt:destinatario>   <alt:nif> h</alt:nif>  <alt:nombre>said</alt:nombre>  <alt:apellidos>filali YACHOU</alt:apellidos>  <alt: > @ .com</alt: > </alt:destinatario> </alt:destinatarios>   <alt:entregadeh>  <alt:obligado>true</alt:obligado>  <alt:codigoprocedimiento>200620</alt:codigoprocedimiento> </alt:entregadeh> </alt:envio> </alt:envios> </alt:altaremesaenvios> Servicio

18 Página 18 de 75 </soapenv:body> </soapenv:envelope> Salida Parámetros Tipo Descripción codigorespuesta string Obligatorio.Código para indicar el OK o el ERROR. 000 para envíos correctos, para errores consultar tabla en el anexo descripcionrespuesta string Obligatorio. Descripción del código de respuesta. codigoorganismoemisor string DIR3 del organismo que realiza el envío. No viene informado en caso de error. No viene informado en caso de error. fechacreacion DateTime Fecha de creación del envío. No viene informado en caso de error. resultadoenvios resultadoenvios ResultadoE nvios ResultadoE nvios Array de identificadores de envío junto con el NIF del Titular. No viene informado en caso de error. Obligatorio. Contendrá tantas entradas como envíos tenga la remesa * Los valores devueltos en los campos codigorespuesta y descripciónrespuesta se pueden consultar en el final del documento. Ejemplo de Salida <soap:envelope xmlns:soap=" <soap:body> <resultadoaltaremesaenvios xmlns=" " xmlns:ns2=" xmlns:ns3=" <codigorespuesta>000</codigorespuesta> Servicio

19 Página 19 de 75 <descripcionrespuesta>ok</descripcionrespuesta> <codigoorganismoemisor>a </codigoorganismoemisor> <fechacreacion> t15:53:17+03:00</fechacreacion> <resultadoenvios> <item> <identificador>5af994cdbef3f</identificador> <niftitular> h</niftitular> </item> </resultadoenvios> </resultadoaltaremesaenvios> </soap:body> </soap:envelope> 4.2 infoenvio2() El método infoenvio2() es un método del servicio web de para Organismos a través del cual se permite consultar información relativa a: Los parámetros de configuración del envío con los que éste se dio de alta. El estado actual del envío. Los datados asociados al envío. Las certificaciones, si las hubiera, asociadas al envío Entrada Parámetros Tipo Descripción identificador string Obligatorio. Identificador público del envío. Debe ser el mismo identificador que corresponde al envío y que se devolvió en el método altaremesaenvios(). Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:inf=" Servicio

20 Página 20 de 75 <soapenv:header> <apikey>************************</apikey> </soapenv:header> <soapenv:body> <inf:infoenviov2> <inf:identificador>5af934cdc745f3f</inf:identificador> </inf:infoenviov2> </soapenv:body> </soapenv:envelope> Salida Parámetros Tipo Descripción identificador string Obligatorio. Identificador público del envío. Identificador que corresponde al envío y que se devolvió en el método altaremesaenvios() estado string Obligatorio. Código de estado en el que se encuentra el envío concepto string Obligatorio. Concepto del envío descripcion string Descripción detallada del envío. codigoorganismoemisor codigoorganismoemisorraiz ComplexType: CodigoDIR ComplexType: CodigoDIR Obligatorio.Datos del Organismo Emisor del envío Datos del Organismo Raíz correspondiente al Organismo Emisor del envío. No viene informado en caso de que coincida con el codigoorganismoremisor. tipoenvio integer Obligatorio. Entero que indica si el envío es comunicación o notificación. Valores posibles: 1 Comunicación 2 Notificación fechacreacion datetime Obligatorio.Fecha de creación del envío. Servicio

21 Página 21 de 75 Formato YYYY-MM-DDTHH:ii:ss fechapuestadisposición Date Obligatorio. Fecha en la que el envío se puso a disposición para su comparecencia. Formato YYYY-MM-DD. Se corresponde con: La fecha de envío programado, si se hubiera especificado si ésta no hubiera llegado aún. La fecha de alta efectiva en Notific@ en el resto de casos. fechacaducidad Date Fecha en la que el envío expira. Formato YYYY- MM-DD retardo integer Número de días en los que el envío permanece disponible para comparecencia en CC antes de entregarlo por otras vías. procedimiento documento ComplexType: Procedimiento ComplexType: Documento Datos del procedimiento SIA. Obligatorio para notificaciones. Obligatorio. Info del documento de la notificación / comunicación referenciaemisor string Obligatorio. Identificador del envío que es único para ese Organismo Emisor. En caso que se informase al hacer el alta del envío, coincidirá con el número que se estableció. En caso contrario se informará el número que haya asignado Notific@. titular destinatarios entregapostal entregadeh ComplexType: Persona ComplexType: Destinatario ComplexType: EntregaPostal ComplexType: EntregaDEH Obligatorio.Titular de la notificación/comunicación Conjunto de destinatarios de la notificación/comunicación. Existirá en caso de que existan destinatarios distintos del titular Datos para la entrega Postal. Datos para la entrega a la DEH datados ComplexType: Obligatorio. Información de los datados Servicio

22 Página 22 de 75 certificacion opcionesenvio destinatario Datados ComplexType: Certificacion ComplexType: Opciones ComplexType: Persona Información de la certificación. Opciones del envío Obligatorio. Destinatario de la notificación/comunicación. Puede aparecer de 1 a 100 veces. nif string Obligatorio. NIF de la persona física / jurídica nombre string Nombre de la persona física. Obligatorio en caso de personas físicas. apellidos string Apellidos de la persona física. Obligatorio en caso de personas físicas razonsocial string Razón Social de la persona jurídica. Obligatorio en caso de personas jurídicas. string de la persona que recibe la notificación/comunicación. Desde Notifica se recomienda la introducción de este campo para todas las notificaciones electrónicas, de esta forma se podrá avisar de la existencia de la notificación por esta vía. telefono string Teléfono de la persona que recibe la notificación/comunicación. Actualmente no se le da uso para el envío de SMS informando de que existe una nueva notificación o comunicación. Estando en estudio su posible reimplantación en el futuro. codigodestino ComplexType: CodigoDIR DIR3 o DIRe de la entidad que recibe el envío. No es obligatorio en ningún caso, ni cuando el envío se dirige a personas físicas, ni a personas jurídicas del sector público (DIR3) o del sector privado (DIRe). Los códigos DIRe (relativos al sector privado) no están disponibles actualmente Servicio

23 Página 23 de 75 organismopagadorpostal organismopagadorcie ComplexType: OrganismoPag adorpostal ComplexType: OrganismoPag adorcie Datos del organismo que asume los costes postales. Introducir en caso de que no haya información en la web de Notifica acerca del pagador postal. También puede introducirse para sobrescribir la información del pagador para el envío que se remite. En infoenviov2 se rellena siempre para los envíos postales, independietemente del CIE y Operador Postal seleccionado. Datos del organismo que asume los costes del CIE. Introducir en caso de que no haya información en la web de Notifica acerca del pagador del CIE. También puede introducirse para sobrescribir la información del pagador para el envío que se remite. En infoenviov2 se rellena siempre para los envíos postales, independientemente del CIE y Operador Postal seleccionado. tipodomicilio Enum Obligatorio. Valor numérico que define el tipo de domicilio para la entrega postal. Valores posibles 1: Nacional Normalizado 2: Extranjero Normalizado 3: Apartado de Correos Normalizado 4: Sin Normalizar tipovia string Tipo de vía para entregas postales. Obligatorio si tipodomicilio = Nacional Normalizado nombrevia string Nombre de la vía para entregas postales. Obligatorio si tipodomicilio = Nacional Normalizado o Extranjero Normalizado numerocasa string Número de la casa para entregas postales. Obligatorio si tipodomicilio = Nacional Normalizado a menos que se consigne puntokilometrico puntokilometrico string Punto kilométrico para entregas postales. Obligatorio si tipodomicilio = Nacional Normalizado a menos que se consigne numerocasa Servicio

24 Página 24 de 75 portal string Portal de la casa para entregas postales puerta string Puerta de la casa para entregas postales. escalera string Escalera de la casa para entregas postales. planta string Planta de la casa para entregas postales. bloque string Bloque de la casa para entregas postales. complemento string Información extra acerca de la casa para la entrega postal. calificadornumero string Tipo de numeración de la dirección. Campo libre para indicar información adicional sobre la numeración (por ejemplo bis, tri, etc.) codigopostal string Obligatorio.Código Postal de la casa para entregas postales. Obligatorio para cualquier valor de tipodomicilio. Para envíos internacionales en países sin código postal se puede consignar apartadocorreos string Apartado de Correos para entregas postales. Obligatorio cuando tipodomicilio = Apartado de Correos Normalizado. municipio string Código INE del municipio donde se entrega el envío. Debe contener el dígito de control. Obligatorio para envíos de los tipos Nacional Normalizado y Apartado de Correos Normalizado provincia string Código de provincia donde se entrega el envío. Obligatorio para envíos de los tipos Nacional Normalizado, y Apartado de Correos Normalizado pais string Código ISO3166 de 2 caracteres del país donde se entrega el envío. Obligatorio cuando tipodomicilio =Extranjero Normalizado poblacion string Población donde se entrega el envío. Obligatorio para envíos de los tipos Nacional Normalizado, Extranjero Normalizado y Apartado de Correos Normalizado. Únicamente se Servicio

25 Página 25 de 75 imprimen los primeros 30 caracteres. linea1 string Linea 1 de la dirección de entrega del envío sin normalizar. Obligatorio cuando tipodomicilio = Sin Normalizar El campo línea 1 y línea 2 son los únicos que se imprimen y, por tanto, deben contener la dirección completa incluyendo código postal y país, sin perjuicio de que el código postal y país se envíen adicionalmente en campo separado. linea2 string Línea 2 de la dirección de entrega del envío sin normalizar. Obligatorio cuando tipodomicilio = Sin Normalizar El campo línea 1 y línea 2 son los únicos que se imprimen y, por tanto, deben contener la dirección completa incluyendo código postal y país, sin perjuicio de que el código postal y país se envíen adicionalmente en campo separado. opcionescie codigodir3postal ComplexType: Opciones ComplexType: CodigoDIR Opciones de entrega postal. En formato clave:valor -cie: identificador del CIE en Notifica para seleccionarlo para el envío -formatosobre: cadena de caracteres para el formato del sobre (americano, C5 ) -formatohoja: cadena de caracteres para el formato de hoja (A4,A5 ) Obligatorio.Código DIR3 del pagador de los costes postales. numcontratopostal string Obligatorio.Número de contrato con el operador postal codclientefacturacionpostal string Obligatorio.Código de cliente de facturación con el operador postal. fechavigenciapostal Date Obligatorio. Fecha de vigencia del contrato con el operador postal. codigodir3cie ComplexType: codigodir Obligatorio. Código DIR3 del pagador de los costes de impresión y ensobrado Servicio

26 Página 26 de 75 fechavigenciacie Date Obligatorio. Fecha de vigencia del contrato con el CIE. obligado Boolean Obligatorio.Booleano para indicar si el envío es obligado o voluntario. Valores admitidos: true o false codigoprocedimiento string Código del procedimiento en la DEH para envíos a voluntarios. El código de procedimiento en la DEH se recomienda que coincida con el código en SIA. codigo string Obligatorio. Código DIR3 o DIRe de la entidad descripcioncodigodir string Descripción del código DIR. Notific@ lo enviará siempre que disponga de este dato. nifdir string NIF del Organismo Emisor. Únicamente se informará cuando el dato esté disponible en el repositorio de DIR3. codigosia string Obligatorio. Código SIA del procedimiento de la notificación DescripcionSIA string Obligatorio. Descripción del procedimiento contenido base64binary En la versión Base64 se insertará el contenido del archivo en formato Base64 Es obligatorio en caso de no existir enlacedocumento, no pueden enviarse ambos elementos. hash string Obligatorio. Hash del documento. SHA256 del Documento adjunto o del enlazado, codificado previamente en base64 enlacedocumento string Enlace externo donde se encuentra el documento del envío. Es obligatorio en caso de no existir el elemento contenido, no pueden coexistir ambos elementos en la misma petición. Debe ser un enlace activo desde internet. metadatos string Metadatos extra del propio documento. Parámetros extra del propio documento en formato XML. Servicio

27 Página 27 de 75 csv string CSV del documento mime string Tipo MIME del documento size integer Tamaño del documento en bytes. opcionesdocumento datado ComplexType: Opciones ComplexType: Datado Opciones que tiene el documento. Opciones válidas: -normalizado: si o no Obligatorio. Info de un datado de 1 a 100 repeticiones fecha DateTime Fecha del datado resultado string Obligatorio. Resultado del datado. Indicación del estado asociado al datad origen string Obligatorio. Origen del datado: - correos_cie(postal) - electronico(deh) - carpeta - - sede - ema - funcionario_habilitado nombrereceptor string Nombre de la persona que origina el datado. Para estados notificada, rehusada, leida. nifreceptor string NIF de la persona que origina el datado descripcionerror string Descripción detallada cuando el datado es error contenido base64binary Obligatorio. En la versión Base64 se insertará el contenido del archivo en formato Base64. hash string Obligatorio. Hash del documento. SHA256 del Documento adjunto o del enlazado, codificado previamente en base64 fechacertificacion Datetime Obligatorio. Fecha en la que se genera la certificación. origen string Obligatorio. Origen de la certificación. Origen de Servicio

28 Página 28 de 75 la certificación: - correos_cie (Postal) - electronico (DEH) - carpeta - sede - ema - funcionario_habilitado metadatos string Metadatos extra del propio documento. Parámetros extra del propio documento en formato XML. csv string CSV del documento mime string Obligatorio. Tipo MIME del documento size integer Obligatorio. Tamaño del documento en bytes. opcionescertificacion opcion ComplexType: Opciones ComplexType: Opcion Opciones que tiene el documento Tipo simple con la estructura. Puede aparecer N veces. Un ejemplo sería <alt:opcion tipo="normalizado">no</alt:opcio n> * Los valores devueltos en los campos codigorespuesta y descripciónrespuesta se pueden consultar en el final del documento. Ejemplo de Salida <soap:envelope xmlns:soap=" <soap:body> <ns2:resultadoinfoenviov2 xmlns=" " xmlns:ns2=" xmlns:ns3=" <ns2:identificador>5af994cdbef3f</ns2:identificador> <ns2:estado>enviado_deh</ns2:estado> <ns2:concepto>prueba DE NOTIFICACION CON NOTIFICA 2.1</ns2:concepto> Servicio

29 Página 29 de 75 <ns2:descripcion>prueba</ns2:descripcion> <ns2:codigoorganismoemisor> <ns2:codigo>a </ns2:codigo> <ns2:descripcioncodigodir>comunidad Autónoma de Canarias</ns2:descripcionCodigoDIR> </ns2:codigoorganismoemisor> <ns2:tipoenvio>notificacion</ns2:tipoenvio> <ns2:fechacreacion> t15:53:17</ns2:fechacreacion> <ns2:fechapuestadisposicion> T15:53:17</ns2:fechaPuestaDisposicion> <ns2:retardo>0</ns2:retardo> <ns2:procedimiento> <ns2:codigosia>200620</nsr2:codigosia> <ns2:descripcionsia>consulta Bibliotecas Públicas</ns2:descripcionSia> </ns2:procedimiento> <ns2:documento> <ns2:contenido>jvberi0xljqkjcokw7zdtsofcjigmcbvymokpdwvtgvuz3roidmgmcbsl0zpbhrlci 9GbGF0ZURlY29kZT4+CnN0cmVhbQp4nDPQM1Qo5ypUMFAwALJMLU31jBQsTAz1LBSKUrnCtRTyIHJAWJT O5RTCZWoGlDI3NwEqDklR0HczVDA0UghJi7YxMLTTNbQxMDIwNjCxAzJMDczsYkO8uFxDuAK5AhUAeIcW EwplbmRzdHJlYW0KZW5kb2JqCgozIDAgb2JqCjEwMQplbmRvYmoKCjUgMCBvYmoKPDwvTGVuZ3RoIDYgM Ft9fLiHmq/0AZ7INzDhGu6ccoa/MVQbEpxRuwx3HdTNGR3Kb4wdjgsheJhNnZYocbLdj4cYT4rY6GBUWl g+hhovxaiymdmdpx+m8xiibtqbgdqmdybauiwi2eutccbbhcqujrwrhjqjbgswhbozypb1ufdxa5r0hig AwNTI0NiAwMDAwMCBuIAowMDAwMDA1NDQxIDAwMDAwIG4gCjAwMDAwMDU3NTcgDAwMDAgbiAKMDAwMDAw NjM4OCAwMDAwMCBuIAp0cmFpbGVyCjw8L1NpemUgMTQvUm9vdCAxMiAwIFIKL0luZm8gMTMgMCBSCi9JR CBbIDw3RDc0NjkzQkI2RUYyMjlBNUUwRUJDRDBCMERENTI4OT4KPDdENzQ2OTNCQjZFRjIyOUE1RTBFQk NEMEIwREQ1Mjg5PiBdCi9Eb2NDaGVja3N1bSAvOUY0OTIzNTgwRUQyMTUzODNERkE0QURGNUI5MjUxRjM KPj4Kc3RhcnR4cmVmCjY1NTgKJSVFT0YK</ns2:contenido> <ns2:hash>zdc4n2mznmzmywq2owjjytgwytrkzdlizjk3yjdkztuwywq2zmqwmzkzntm3mdkzmgq0ndd hodbjmmyyytjimq==</ns2:hash> <ns2:mime>application/pdf</ns2:mime> <ns2:size>7041</ns2:size> <ns2:opcionesdocumento> <ns2:opcion tipo="normalizado">no</ns2:opcion> </ns2:opcionesdocumento> </ns2:documento> <ns2:referenciaemisor>5af994cdbef3f</ns2:referenciaemisor> <ns2:titular> Servicio

30 Página 30 de 75 <ns2:nif> h</ns2:nif> <ns2:nombre>said</ns2:nombre> <ns2:apellidos>filali YACHOU</ns2:apellidos> <ns2:telefono> </ns2:telefono> </ns2:titular> <ns2:destinatarios> <ns2:destinatario> <ns2:nif> h</ns2:nif> <ns2:nombre>said</ns2:nombre> <ns2:apellidos>filali YACHOU</ns2:apellidos> <ns2:telefono> </ns2:telefono> </ns2:destinatario> </ns2:destinatarios> <ns2:entregadeh> <ns2:obligado>true</ns2:obligado> <ns2:codigoprocedimiento>200620</ns2:codigoprocedimiento> </ns2:entregadeh> <ns2:datados> <ns2:datado> <ns2:fecha> t15:53:19</ns2:fecha> <ns2:resultado>pendiente_deh</ns2:resultado> <ns2:origen>electronico</ns2:origen> <ns2:nombrereceptor>said</ns2:nombrereceptor> <ns2:nifreceptor> h</ns2:nifreceptor> </ns2:datado> <ns2:datado> <ns2:fecha> t15:53:29</ns2:fecha> <ns2:resultado>enviado_deh</ns2:resultado> <ns2:origen>electronico</ns2:origen> <ns2:nombrereceptor>said</ns2:nombrereceptor> <ns2:nifreceptor> h</ns2:nifreceptor> </ns2:datado> </ns2:datados> </ns2:resultadoinfoenviov2> Servicio

31 Página 31 de 75 </soap:body> </soap:envelope> 4.3 getcies() El método getcies() es un método del servicio web de para Organismos a través del cual se permite obtener un listado de los CIEs disponibles para un Organismo Emisor, conforme a la configuración de Agentes Colaboradores que haya podido establecer éste a través de la Aplicación Web de Notific@ Entrada Parámetros Tipo Descripción organismoemisor string Obligatorio. DIR3 del Organismo Emisor para el que se hace la consulta. Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:get=" <soapenv:header> <apikey>************************</apikey> </soapenv:header> <soapenv:body> <get:getcies> <get:organismoemisor>a </get:organismoemisor> </get:getcies> </soapenv:body> </soapenv:envelope> Servicio

32 Página 32 de Salida Parámetros Tipo Descripción cies ComplexType: Cies Obligatorio. Array de Cies disponibles codigorespuesta string Obligatorio. Código para indicar el OK o el ERROR. 000 para envíos correctos, para errores consultar tabla en el anexo descripcionrespuesta string Obligatorio. Descripción del código de respuesta cie ComplexType:Cie Obligatorio. Centro de Impresión y Ensobrado Id integer Obligatorio. Identificador del CIE centroimpresion string Obligatorio. Nombre del CIE fechavigencia string Obligatorio. Fecha de vigencia (hasta) del contrato. Formato YYYY-MM-DDTHH:ii:ss codigounidad Relacionada string Obligatorio. Código DIR3 de la unidad relacionada con el CIE (Organismo Pagador). * Los valores devueltos en los campos codigorespuesta y descripciónrespuesta se pueden consultar en el final del documento. 5 OPERACIONES DEL SERVICIO PARA SEDES La ruta del wsdl de sedes se expone en la siguiente ruta: V2/sedes?wsdl permitiendo la consulta y monitorización de la entrega de una notificación, y que incluye los siguientes métodos: Parámetros getenvios() Descripción Método que devuelve todos los identificadores de los envíos dependiendo de las opciones introducidas. Servicio

33 Página 33 de 75 getenvios2() getenviosagrupados() getenviosagrupados2() infoenvio() infoenvio2() certificacionsede() getcertificacion() comunicacionsede() Método similar a getenvios() pero que además dispone de opciones para considerar quién es el titular, el destinatario o la existencia de apoderamientos. También permite filtrar entre notificaciones y comunicaciones. Método que devuelve la cantidad de envíos asociados a un criterio señalado. Método que devuelve la cantidad de envíos asociados a un criterio señalado de forma más detallada. Método para consultar la información detallada de un envío específico. Método para consultar la información detallada de un envío específico, con menos detallte que el método anterior. 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. Método para indicar que una comunicación ha sido leída en sede electrónica y por tanto, en su caso, no es necesario enviarla por papel o DEH. 5.1 getenvios() El método getenvios() permite que permite obtener los envíos de un destinatario Entrada Parámetros Tipo Descripción nif string Obligatorio. Indica el NIF/CIF de titular del que se quieren obtener las notificaciones que tiene el sistema. estado string Opcional. Filtro por estado en el que se encuentra la notificación: Notificada, Rehusada o Pendiente. Servicio

34 Página 34 de 75 organismos_emisor string 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. codigo_sia string Opcional. Filtro por el código del procedimiento al que hace referencia la notificación. fecha_desde datetime Opcional. Filtro por la fecha desde la que se quieren recuperar las notificaciones, debe introducirse en formato AAAA-MM-DD y en caso de no rellenarse se tomarán desde el fecha_hasta datetime Opcional. Filtro por la fecha hasta la que se quieren recuperar las notificaciones, debe introducirse en formato AAAA-MM-DD y en caso de no rellenarse se tomará el día actual Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:sed=" <soapenv:header> <api_key>xxxxxxxxxxxxxxxxxxxx</api_key> </soapenv:header> <soapenv:body> <sed:getenvios> <get_envios> <nif> h</nif> <organismo_remisor>a </organismo_remisor> <fecha_desde> t08:00:00</fecha_desde> <fecha_hasta> t08:00:00</fecha_hasta> </get_envios> </sed:getenvios> </soapenv:body> </soapenv:envelope> Servicio

35 Página 35 de Salida Parámetros Tipo Descripción envio_destinatario string Identificador del envío devuelto en la respuesta de altaenvio() estado string Estado del envío: Notificada, Rehusada o Pendiente. concepto string Concepto del envío. organismo_emisor string Código DIR3 del organismo que ha remitido el envío. fecha_notificacion datetime Fecha en la que ha sido dada de alta en Notific@ el envío (independientemente de que sea una notificación o comunicación). fecha_actualizacion datetime Fecha del último cambio vinculo string Indica si el envío ha sido recuperado porque el NIF/CIF indicado es el del titular o el del destinatario. tipo_envio string Notificación o comunicación canal_envio string A partir del último datado * Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se pueden consultar en el final del documento. Ejemplo de Salida <soap:envelope xmlns:soap=" <soap:body> <ns1:getenviosresponse xmlns:ns1=" <return> <resultadogetenvios> <item> Servicio

36 Página 36 de 75 <envio_destinatario>5a0559aa62a0a</envio_destinatario> <estado>pendiente</estado> <concepto>notificacion prueba de Notific de la CAC</concepto> <organismo_remisor>a </organismo_remisor> <fecha_notificacion> t08:47:54+01:00</fecha_notificacion> <fecha_actualizacion> t08:47:54+01:00 </fecha_actualizacion> <vinculo>titular</vinculo> <tipo_envio>notificacion</tipo_envio> <canal_envio xsi:nil="true" xmlns:xsi=" /> </item> </resultadogetenvios> <codigo_respuesta>000</codigo_respuesta> <descripcion_respuesta>ok</descripcion_respuesta> </return> </ns1:getenviosresponse> </soap:body> </soap:envelope> 5.2 getenvios2() El método getenvios2() permite obtener los envíos de un destinatario, y que además dispone de opciones para considerar quién es el titular, el destinatario o la existencia de apoderamientos. También permite filtrar entre notificaciones y comunicaciones Entrada Parámetros Tipo Descripción nif string Obligatorio. Indica el NIF/CIF de titular del que se quieren obtener las notificaciones que tiene el sistema. nif_representante Opcional. Indica el NIF/CIF del destinatario. Servicio

37 Página 37 de 75 estado string Opcional. Filtro por estado en el que se encuentra la notificación: Notificada, Rehusada o Pendiente. organismos_emisor string 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. codigo_sia string Opcional. Filtro por el código del procedimiento al que hace referencia la notificación. fecha_desde datetime Opcional. Filtro por la fecha desde la que se quieren recuperar las notificaciones, debe introducirse en formato AAAA-MM-DD y en caso de no rellenarse se tomarán desde el fecha_hasta datetime Opcional. Filtro por la fecha hasta la que se quieren recuperar las notificaciones, debe introducirse en formato AAAA-MM-DD y en caso de no rellenarse se tomará el día actual tipo_envio string Opcional. Debe valer 1 si se desea obtener únicamente las comunicaciones 2 para obtener únicamente las notificaciones rea boolean Opcional. Por defecto false. Indica que el Organismo Emisor ha comprobado que existen derechos de representación en el registro electrónico de apoderamientos que corresponda, y que el resultado de dicha consulta es positivo. A continuación se explica el funcionamiento de los parámetros nif, nif_representante y rea a través de la siguiente tabla: Nif Nif_representante Rea Comportamiento H Vacío N/A Devuelve todos los envíos para los que sea titular H Vacío H N/A Devuelve todos los envíos para los que sea Servicio

38 Página 38 de 75 destinatario H H T F Devuelve todos los envíos para los que sea titular H y destinatario T, es decir, que se cumplan ambas condiciones H T T Devuelve todos los envíos para los que sea titular H (se ignora el dato nif_representante). ATENCIÓN: Aunque tanto nif como nif_representante son parámetros opcionales, se debe consignar al menos uno de ellos. Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:sed=" <soapenv:header> <api_key>xxxxxxxxxxxxxxxxxxxx</api_key> </soapenv:header> <soapenv:body> <sed:getenvios2> <get_envios2> <nif> h</nif> <organismo_remisor>a </organismo_remisor> <fecha_desde> t08:00:00</fecha_desde> <fecha_hasta> t08:00:00</fecha_hasta> <rea>false</rea> </get_envios2> </sed:getenvios2> </soapenv:body> </soapenv:envelope> Salida Parámetros Tipo Descripción Servicio

39 Página 39 de 75 envio_destinatario string Identificador del envío devuelto en la respuesta de altaenvio() estado string Estado del envío: Notificada, Rehusada o Pendiente. concepto string Concepto del envío. organismo_emisor string Código DIR3 del organismo que ha remitido el envío. fecha_creacion datetime Fecha en la que ha sido dado de alta en Notific@ el envío. fecha_actualizacion datetime Fecha del último cambio vinculo string Indica si el envío ha sido recuperado porque el NIF/CIF indicado es el del titular o el del destinatario. tipo_envio string Notificación o comunicación canal_envio string A partir del último datado. * Los valores devueltos en los campos código_respuesta y descripción_respuesta se pueden consultar en el final del documento. ATENCION: El campo de respuesta haymasresultados indica que no se han recuperado todos los resultados existentes en la base de datos de Notific@, sino que únicamente se han recuperado los 1000 resultados con fecha de alta más reciente. Si los envíos que se quieren encontrar no están entre los recuperados se deberán usar opciones de filtrado. Ejemplo de Salida <soap:envelope xmlns:soap=" <soap:body> <ns1:getenvios2response xmlns:ns1=" Servicio

40 Página 40 de 75 <return> <resultadogetenvios2> <item> <envio_destinatario xsi:nil="true" xmlns:xsi=" <estado xsi:nil="true" xmlns:xsi=" <concepto xsi:nil="true" xmlns:xsi=" <organismo_remisor xsi:nil="true" xmlns:xsi=" <nombre_organismo_remisor xsi:nil="true" xmlns:xsi=" <fecha_creacion xsi:nil="true" xmlns:xsi=" <fecha_actualizacion xsi:nil="true" xmlns:xsi=" <vinculo xsi:nil="true" xmlns:xsi=" <tipo_envio xsi:nil="true" xmlns:xsi=" <canal_envio xsi:nil="true" xmlns:xsi=" </item> </resultadogetenvios2> <haymasresultados>false</haymasresultados> <codigo_respuesta>000</codigo_respuesta> <descripcion_respuesta>ok</descripcion_respuesta> </return> </ns1:getenvios2response> </soap:body> </soap:envelope> 5.3 getenviosagrupados() El método getenviosagrupados() permite obtener los envíos de un destinatario Entrada Parámetros Tipo Descripción nif Obligatorio. Indica el NIF de titular del que se quieren obtener las notificaciones que tiene el Servicio

41 Página 41 de 75 sistema. estado string 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. organismos_emisor string Opcional. Filtro por el organismo que ha remitido la notificación, debe introducirse el código DIR3 del organismo. codigo_sia string Opcional. Filtro por el código del procedimiento al que hace referencia la notificación. fecha_desde datetime Opcional. Filtro por la fecha desde la que se quieren recuperar las notificaciones, debe introducirse en formato AAAA-MM-DD y en caso de no rellenarse se tomarán desde el fecha_hasta datetime Opcional. Filtro por la fecha hasta la que se quieren recuperar las notificaciones, debe introducirse en formato AAAA-MM-DD y en caso de no rellenarse se tomará el día actual. Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:sed=" <soapenv:header> <api_key>xxxxxxxxxxxxxxxxxxxx</api_key> </soapenv:header> <soapenv:body> <sed:getenviosagrupados> <get_envios_agrupados> <nif> h</nif> <estado>pendiente</estado> <organismo_remisor>a </organismo_remisor> <codigos_sia> <item> Servicio

42 Página 42 de 75 <codigo_sia>200620</codigo_sia> </item> </codigos_sia> <tipo_envio>notificacion</tipo_envio> </get_envios_agrupados> </sed:getenviosagrupados> </soapenv:body> </soapenv:envelope> Salida Como respuesta se recibirá el número de envíos pendientes, notificados y totales agrupados por Organismo Emisor, por Procedimiento y por Estado. Ejemplo de Salida <soap:envelope xmlns:soap=" <soap:body> <ns1:getenviosagrupadosresponse xmlns:ns1=" <return> <pororganismoremisor> <item> <organismoremisor>a </organismoremisor> <nombreorganismoremisor>comunidad Autónoma de Canarias</nombreOrganismoRemisor> <estado_notificado>0</estado_notificado> <estado_pendiente>29</estado_pendiente> <totales>29</totales> </item> </pororganismoremisor> <porcodigosia> <item> <codigosia>200620</codigosia> <descripcionsia>consulta Bibliotecas Públicas</descripcionSia> <estado_notificado>28</estado_notificado> Servicio

43 Página 43 de 75 <estado_pendiente>29</estado_pendiente> <totales>57</totales> </item> </porcodigosia> <porestado> <estado_notificado>28</estado_notificado> <estado_pendiente>29</estado_pendiente> <totales>57</totales> </porestado> <codigo_respuesta>000</codigo_respuesta> <descripcion_respuesta>ok</descripcion_respuesta> </return> </ns1:getenviosagrupadosresponse> </soap:body> </soap:envelope> 5.4 getenviosagrupados2() El método getenviosagrupados2() permite obtener los envíos de un destinatario de forma más detallada Entrada Parámetros Tipo Descripción nif nif_representante Opcional. Indica el NIF de titular del que se quieren obtener las notificaciones que tiene el sistema. Opcional. Indica el NIF/CIF del destinatario. estado string 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. Servicio

44 Página 44 de 75 organismos_emisor string Opcional. Filtro por el organismo que ha remitido la notificación, debe introducirse el código DIR3 del organismo. codigo_sia string Opcional. Filtro por el código del procedimiento al que hace referencia la notificación. fecha_desde datetime Opcional. Filtro por la fecha desde la que se quieren recuperar las notificaciones, debe introducirse en formato AAAA-MM-DD y en caso de no rellenarse se tomarán desde el fecha_hasta datetime Opcional. Filtro por la fecha hasta la que se quieren recuperar las notificaciones, debe introducirse en formato AAAA-MM-DD y en caso de no rellenarse se tomará el día actual. rea boolean Opcional. Por defecto false. Indica que el Organismo Emisor ha comprobado que existen derechos de representación en el registro electrónico de apoderamientos que corresponda, y que el resultado de dicha consulta es positivo. Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:sed=" <soapenv:header> <api_key>xxxxxxxxxxxxxxxxxxxx</api_key> </soapenv:header> <soapenv:body> <sed:getenviosagrupados> <get_envios_agrupados> <nif> h</nif> <estado>pendiente</estado> <organismo_remisor>a </organismo_remisor> <codigos_sia> <item> <codigo_sia>200620</codigo_sia> </item> Servicio

45 Página 45 de 75 </codigos_sia> <tipo_envio>notificacion</tipo_envio> </get_envios_agrupados> </sed:getenviosagrupados> </soapenv:body> </soapenv:envelope> Salida Como respuesta se recibirá el número de envíos pendientes, notificados y totales agrupados por Organismo Emisor, por Procedimiento y por Estado. Ejemplo de Salida <soap:envelope xmlns:soap=" <soap:body> <ns1:getenviosagrupados2response xmlns:ns1=" <return> <pororganismoremisor> <item> <organismoremisor>a </organismoremisor> <nombreorganismoremisor>comunidad Autónoma de Canarias</nombreOrganismoRemisor> <notificaciones_realizadas>7</notificaciones_realizadas> <comunicaciones_realizadas>0</comunicaciones_realizadas> <notificaciones_pendientes>0</notificaciones_pendientes> <comunicaciones_pendientes>0</comunicaciones_pendientes> <total_organismo>7</total_organismo> </item> </pororganismoremisor> <porcodigosia> <item> <codigosia>200620</codigosia> <descripcionsia>consulta Bibliotecas Públicas</descripcionSia> <estado_notificado>6</estado_notificado> Servicio

46 Página 46 de 75 <estado_pendiente>0</estado_pendiente> <totales>6</totales> </item> <item> <codigosia>200623</codigosia> <descripcionsia>registro de comerciantes y actividades comerciales</descripcionsia> <estado_notificado>1</estado_notificado> <estado_pendiente>0</estado_pendiente> <totales>1</totales> </item> </porcodigosia> <porestado> <notificaciones_realizadas>7</notificaciones_realizadas> <notificaciones_pendientes>0</notificaciones_pendientes> <comunicaciones_realizadas>0</comunicaciones_realizadas> <comunicaciones_pendientes>0</comunicaciones_pendientes> <totales>7</totales> </porestado> <codigo_respuesta>000</codigo_respuesta> <descripcion_respuesta>ok</descripcion_respuesta> </return> </ns1:getenviosagrupados2response> </soap:body> </soap:envelope> 5.5 infoenvio() El método infoenvio() permite obtener la información de un envío Entrada Parámetros Tipo Descripción Servicio

47 Página 47 de 75 envio_destinatario string Obligatorio. Identificador del envío devuelto en la respuesta de altaenvio() Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:sed=" <soapenv:header> <api_key>xxxxxxxxxxxxxxxxxxxx</api_key> </soapenv:header> <soapenv:body> <sed:infoenvio> <info_envio> <envio_destinatario>5a0559aa62a0a</envio_destinatario> </info_envio> </sed:infoenvio> </soapenv:body> </soapenv:envelope> Salida Parámetros Tipo Descripción organismo_emisor::codigo_dir3 string Obligatorio. Código correspondiente al DIR3. organismo_emisor::nombre string Opcional. Nombre de la Entidad Emisora. organismo_pagador_correos:: codigo_dir3 organismo_pagador_correos:: numero_contrato_correos string string 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. organismo_pagador_correos:: string Sólo se muestra para envíos postales cuando el Servicio

48 Página 48 de 75 codigo_cliente_facturacion_correos dato fue consignado en el Método altaenvio(). Código cliente del organismo pagador para la facturación con el operador postal. organismo_pagador_correos:: fecha_vigencia organismo_pagador_cie:: codigo_dir3 organismo_pagador_cie:: fecha_vigencia datetime string datetime 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. documento::contenido string Obligatorio. Contenido del documento de la notificación codificado en base64. documento::hash_sha1 string Obligatorio. Codificación base64 del sha1 del contenido binario del documento. documento::normalizado 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. documento::generar_csv string 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. tipo_envio string Obligatorio. Tipo de envío a dar de alta. Los valores válidos para el elemento pueden ser notificación o comunicación. Servicio

49 Página 49 de 75 fecha_envio_programado datetime Opcional. Si se consigna, no tratará el envío hasta la fecha indicada. concepto string Obligatorio. Concepto del envío que se realiza. destinatarios::item:: referencia_emisor string 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. destinatarios::item::titular:: telefono 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. destinatarios:: ítem::titular:: string 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. destinatarios:: ítem::titular::nif string Obligatorio para envíos a Sedes Electrónicas y Carpeta Ciudadana. Debe ser el NIF/CIF/NIE del titular del envío. destinatarios:: ítem::titular::nombre string Obligatorio. Debe rellenarse con el nombre o la razón social del titular del envío destinatarios:: ítem::titular::apellidos destinatarios::ítem::destinatario:: telefono destinatarios:: ítem::destinatario:: string string string 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. 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. destinatarios:: ítem::destinatario::nif string Obligatorio para envíos a Sedes Electrónicas y Carpeta Ciudadana. Debe ser el NIF/CIF/NIE del titular del envío. Servicio

50 Página 50 de 75 destinatarios:: ítem::destinatario::nombre destinatarios:: ítem::destinatario::apellidos string string 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. destinatarios::tipo_domicilio 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. destinatarios::domicilio Compues to 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 Dependiendo del tipo 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, linea_2. destinatarios::servicio string Obligatorio. Tipo de servicio de envío a realizar, puede ser urgente o normal. destinatarios::direccion_electronica ::obligado booleano Obligatorio para envíos a la DEH. Indica si la notificación por DEH es con obligatoriedad del Servicio

51 Página 51 de 75 destinatarios::direccion_electronica ::nif string 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 DEH. NIF del titular del buzón DEH que va a recibir la notificación. destinatarios::direccion_electronica ::codigo_procedimiento string Obligatorio para envíos a la DEH NO OBLIGADOS. Código de procedimiento en la DEH al que el NIF debe estar suscrito. destinatarios::opciones_emision ::retardo_postal_deh destinatarios::opciones_emision ::caducidad int string 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, 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. Fecha en la cual, a primera hora del día, una notificación pasa a estado rehusado a última hora del día. El formato correcto de la fecha es YYYY-MM-DD. procedimiento::codigo_sia string Opcional. Código de procedimiento SIA (Sistema de Información Administrativa). procedimiento::descripcion_sia string Opcional. Descripción del SIA (Sistema de Información Administrativa). certificada booleano Obligatorio. Indica si el envío es certificado o no. codigo_respuesta string Obligatorio. Código de tres dígitos asociado al resultado. descripción_respuesta string Obligatorio. Descripción de la operación. Servicio

52 Página 52 de 75 * Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se pueden consultar en el final del documento. Ejemplo de Salida <soap:envelope xmlns:soap=" <soap:body> <ns1:infoenvioresponse xmlns:ns1=" <return> <infoenvio> <organismo_emisor> <codigo_dir3>a </codigo_dir3> <nombre>comunidad Autónoma de Canarias</nombre> </organismo_emisor> <organismo_pagador_correos xsi:nil="true" xmlns:xsi=" <organismo_pagador_cie xsi:nil="true" xmlns:xsi=" <documento> <contenido>jvberi0xljqkjcokw7zdtsofcjigmcbvymokpdwvtgvuz3r...</contenido> <hash_sha1>k5g/vxjltvdjvhaad4cncbu5kvy=</hash_sha1> <normalizado>no</normalizado> <generar_csv>no</generar_csv> </documento> <tipo_envio>notificacion</tipo_envio> <fecha_envio_programado xsi:nil="true" xmlns:xsi=" <concepto>notificacion prueba de Notific de la CAC</concepto> <destinatarios> <item> <referencia_emisor>5a0559aa372da</referencia_emisor> <titular> <telefono xsi:nil="true" xmlns:xsi=" < xsi:nil="true" xmlns:xsi=" Servicio

53 Página 53 de 75 <nif> h</nif> <nombre>nombre1</nombre> <apellidos>apellido1 APELLIDO2</apellidos> </titular> <destinatario> <telefono xsi:nil="true" xmlns:xsi=" < xsi:nil="true" xmlns:xsi=" <nif> h</nif> <nombre>nombre1</nombre> <apellidos>apellido1 APELLIDO2</apellidos> </destinatario> <tipo_domicilio xsi:nil="true" xmlns:xsi=" <domicilio xsi:nil="true" xmlns:xsi=" <servicio>normal</servicio> <direccion_electronica xsi:nil="true" xmlns:xsi=" <opciones_emision xsi:nil="true" xmlns:xsi=" </item> </destinatarios> <procedimiento> <codigo_sia>200620</codigo_sia> <descripcion_sia>consulta Bibliotecas Públicas</descripcion_sia> </procedimiento> </infoenvio> <certificada>false</certificada> <codigo_respuesta>000</codigo_respuesta> <descripcion_respuesta>ok</descripcion_respuesta> </return> </ns1:infoenvioresponse> </soap:body> </soap:envelope> Servicio

54 Página 54 de infoenvio2() El método infoenvio2() permite obtener la información de un envío con menos detalle que el método infoenvio() Entrada Parámetros Tipo Descripción envio_destinatario string Obligatorio. Identificador del envío devuelto en la respuesta de altaenvio() Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:sed=" <soapenv:header> <api_key>xxxxxxxxxxxxxxxxxxxx</api_key> </soapenv:header> <soapenv:body> <sed:infoenvio2> <info_envio2> <envio_destinatario>5a0559aa62a0a</envio_destinatario> </info_envio2> </sed:infoenvio2> </soapenv:body> </soapenv:envelope> Salida Parámetros Tipo Descripción organismo_emisor::codigo_dir3 string Obligatorio. Código correspondiente al DIR3. organismo_emisor::nombre string Opcional. Nombre de la Entidad Emisora. Servicio

55 Página 55 de 75 mime string Opcional. Tipo formato del fichero. tipo_envio string Obligatorio. Tipo de envío a dar de alta. Los valores válidos para el elemento pueden ser notificación o comunicación. concepto string Obligatorio. Concepto del envío que se realiza. destinatarios::item:: referencia_emisor string 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. destinatarios::item::titular:: telefono 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. destinatarios:: ítem::titular:: string 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. destinatarios:: ítem::titular::nif string Obligatorio para envíos a Sedes Electrónicas y Carpeta Ciudadana. Debe ser el NIF/CIF/NIE del titular del envío. destinatarios:: ítem::titular::nombre string Obligatorio. Debe rellenarse con el nombre o la razón social del titular del envío destinatarios:: ítem::titular::apellidos destinatarios::ítem::destinatario:: telefono destinatarios:: ítem::destinatario:: string string string 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. 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. destinatarios:: ítem::destinatario::nif string Obligatorio para envíos a Sedes Electrónicas y Servicio

56 Página 56 de 75 destinatarios:: ítem::destinatario::nombre destinatarios:: ítem::destinatario::apellidos string string 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. destinatarios::servicio string Obligatorio. Tipo de servicio de envío a realizar, puede ser urgente o normal. destinatarios::opciones_emision ::caducidad string Opcional. Fecha en la cual, a primera hora del día, una notificación pasa a estado rehusado a última hora del día. El formato correcto de la fecha es YYYY-MM-DD. procedimiento::codigo_sia string Opcional. Código de procedimiento SIA (Sistema de Información Administrativa). procedimiento::descripcion_sia string Opcional. Descripción del SIA (Sistema de Información Administrativa). certificada booleano Obligatorio. Indica si el envío es certificado o no. codigo_respuesta string Obligatorio. Código de tres dígitos asociado al resultado. descripción_respuesta string Obligatorio. Descripción de la operación. * Los valores devueltos en los campos codigo_respuesta y descripción_respuesta se pueden consultar en el final del documento. Ejemplo de Salida <soap:envelope xmlns:soap=" <soap:body> <ns1:infoenvio2response xmlns:ns1=" <return> <infoenvio> Servicio

57 Página 57 de 75 <organismo_emisor> <codigo_dir3>a </codigo_dir3> <nombre>comunidad Autónoma de Canarias</nombre> </organismo_emisor> <mime>application/pdf</mime> <tipo_envio>notificacion</tipo_envio> <concepto>notificacion prueba de Notific de la CAC</concepto> <destinatarios> <item> <referencia_emisor>5a0559aa372da</referencia_emisor> <titular> <telefono xsi:nil="true" xmlns:xsi=" < xsi:nil="true" xmlns:xsi=" <nif> h</nif> <nombre>nombre1</nombre> <apellidos>apellido1 APELLIDO2</apellidos> </titular> <destinatario> <telefono xsi:nil="true" xmlns:xsi=" < xsi:nil="true" xmlns:xsi=" <nif> h</nif> <nombre>nombre1</nombre> <apellidos>apellido1 APELLIDO2</apellidos> </destinatario> <servicio>normal</servicio> <opciones_emision xsi:nil="true" xmlns:xsi=" </item> </destinatarios> <procedimiento> <codigo_sia>200620</codigo_sia> <descripcion_sia>consulta Bibliotecas Públicas</descripcion_sia> </procedimiento> Servicio

58 Página 58 de 75 </infoenvio> <certificada>false</certificada> <codigo_respuesta>000</codigo_respuesta> <descripcion_respuesta>ok</descripcion_respuesta> </return> </ns1:infoenvio2response> </soap:body> </soap:envelope> 5.7 certificacionsede() El método certificacionsede() permite el envío de una certificación correspondiente a una notificación comparecida en Sede Electrónica Entrada Parámetros Tipo Descripción organismo_remisor string Obligatorio. Organismo que ha remitido la notificación, debe introducirse el código DIR3 del organismo. estado string Obligatorio. Estado en el que se encuentra la notificación: notificada o rehusada. documento string Obligatorio. PDF en base64 con la certificación de la notificación. hash_documento string Obligatorio. Base64 del hash del binario del documento con la certificación. envio_destinatario string Obligatorio. Identificador del envío devuelto en la respuesta de altaenvio() csv string Opcional. Código de Seguridad de Verificación. fecha datetime Obligatorio. Fecha asociada a la certificación Servicio

59 Página 59 de 75 Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:sed=" <soapenv:header> <api_key>xxxxxxxxxxxxxxxxxxxx</api_key> </soapenv:header> <soapenv:body> <sed:certificacionsede> <certificacion_sede> <organismo_remisor>a </organismo_remisor> <documento>jvberi0xljqkjcokw7zdtsofcjigmcbvymokpdwvtgvuz3roid...</documento> <hash_documento>k5g/vxjltvdjvhaad4cncbu5kvy=</hash_documento> <envio_destinatario>59fc75e276c62</envio_destinatario> <estado>notificada</estado> <fecha> t10:36:00</fecha> </certificacion_sede> </sed:certificacionsede> </soapenv:body> </soapenv:envelope> Salida Parámetros Tipo Descripción envio_destinatario_id string Identificador del envío devuelto en la respuesta de altaenvio() codigo_respuesta string Código de tres dígitos asociado al resultado. texto_respuesta string Descripción de la operación. Ejemplo de Salida <soap:envelope xmlns:soap=" Servicio

60 Página 60 de 75 <soap:body> <ns1:certificacionsederesponse xmlns:ns1=" <return> <envio_destinatario_id>59fc75e276c62</envio_destinatario_id> <codigo_respuesta>000</codigo_respuesta> <descripcion_respuesta>ok</descripcion_respuesta> </return> </ns1:certificacionsederesponse> </soap:body> </soap:envelope> 5.8 getcertificacion() El método getcertificacion() permite obtener la certificación de un envío Entrada Parámetros Tipo Descripción envio_destinatario string Obligatorio. Identificador del envío devuelto en la respuesta de altaenvio() Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:sed=" <soapenv:header> <api_key>xxxxxxxxxxxxxxxxxxxx</api_key> </soapenv:header> <soapenv:body> <sed:getcertificacion> <get_certificacion> <envio_destinatario>59f1c6c697a25</envio_destinatario> Servicio

61 Página 61 de 75 </get_certificacion> </sed:getcertificacion> </soapenv:body> </soapenv:envelope> Salida Parámetros Tipo Descripción contenido string Contenido de la certificación en base 64. hash string Hash del documento. acuse_o_sobre string Indica si es un acuse o un sobre fecha string Fecha en la que se certificó. codigo_respuesta string Código de tres dígitos asociado al resultado. texto_respuesta string Descripción de la operación. Ejemplo de Salida <soap:envelope xmlns:soap=" <soap:body> <ns1:getcertificacionresponse xmlns:ns1=" <return> <contenido>jvberi0xljukjeljz9mkmsawig9iago8pc9qcm9kdwnlcihpw...</contenido> <hash> f445c50e05bb5aa0c90a042d29fe5c07517e196106fb809736</hash> <acuse_o_sobre>acuse</acuse_o_sobre> <fecha> :03:04</fecha> <codigo_respuesta>000</codigo_respuesta> <descripcion_respuesta>ok</descripcion_respuesta> </return> </ns1:getcertificacionresponse> </soap:body> Servicio

62 Página 62 de 75 </soap:envelope> 5.9 comunicacionsede() El método comunicacionsede() permite que una sede electrónica informe de la lectura de una comunicación para que, en su caso, no se envíe por vía postal o por DEH Entrada Parámetros Tipo Descripción organismo_remisor string Obligatorio. Organismo que ha remitido la notificación, debe introducirse el código DIR3 del organismo. envio_destinatario string Obligatorio. Identificador del envío devuelto en la respuesta de altaenvio() fecha string Fecha de la lectura. Ejemplo de Entrada <soapenv:envelope xmlns:soapenv=" xmlns:sed=" <soapenv:header> <api_key>xxxxxxxxxxxxxxxxxxxx</api_key> </soapenv:header> <soapenv:body> <sed:comunicacionsede> <comunicacion_sede> <organismo_remisor>a </organismo_remisor> <identificador_destinatario>5a055981c2073</identificador_destinatario> <fecha> t08:00:00</fecha> </comunicacion_sede> </sed:comunicacionsede> Servicio

63 Página 63 de 75 </soapenv:body> </soapenv:envelope> Salida Parámetros Tipo Descripción envio_destinatario string Obligatorio. Identificador del envío devuelto en la respuesta de altaenvio() codigo_respuesta codigo_respuesta string Código de tres dígitos asociado al resultado. descripcion_respuesta string Descripción de la operación. Ejemplo de Salida <soap:envelope xmlns:soap=" <soap:body> <ns1:comunicacionsederesponse xmlns:ns1=" <return> <identificador_destinatario>5a055981c2073</identificador_destinatario> <codigo_respuesta>000</codigo_respuesta> <descripcion_respuesta>ok</descripcion_respuesta> </return> </ns1:comunicacionsederesponse> </soap:body> </soap:envelope> Servicio

64 Página 64 de 75 6 ADVISER. 6.1 Introducción. El servicio Adviser permite entregar al Organismo Emisor los Datados y Certificaciones de los envíos. En este Servicio Web tanto Notific@ como el propio servicio de Platino actuaran como como cliente y el Organismo Emisor que publique el servicio como servidor. Es por ello que el Organismo Emisor que desee implementar este servicio web debe descargar el WSDL de Platino en la siguiente URL: El Organismo Emisor debe implementar y publicar un endpoint de tipo SOAP, facilitando la URL a la Oficina Técnica de Platino junto con su código DIR3 para establecer la comunicación entre el servicio de Platino y el del Organismo Emisor. Una vez establecida la comunicación cada vez que Notific@ envíe un mensaje SOAP al servicio de Platino este a su vez propagara el mensaje hacia el endpoint del Organismo Emisor en función del Código DIR3, quedando el flujo de la Servicio