Especificación Web Service ECOT Intermediado

Transcripción

1 Especificación Web Service ECOT Intermediado Fecha: Versión: 2.0 Departamento de Informática Tributaria C/ Sta. María Magdalena, Madrid Subdirección de Aplicaciones de Aduanas e II.EE. AGENCIA TRIBUT RIA A

2 Control Documental Versión Documento Fecha 1.0 Especificación inicial Modificaciones Datos genéricos SCSP Incorporación de Modalidades NOTA: en el apartado de FICHEROS se especifican algunos de los documentos asociados a este servicio (esquemas y WSDL) que figuran publicados junto con este documento en la dirección siguiente: Página 1

3 Tabla de contenidos DESCRIPCIÓN...3 CARACTERISTICAS...4 REQUISITOS...4 MENSAJE DE PETICIÓN...5 MENSAJE DE RESPUESTA...8 SOAP FAULT...11 FIRMA...13 ESTRUCTURA DE LOS MENSAJES...15 Solicitud: Mensaje de petición...15 Contestación: Mensaje de respuesta...15 INFORMACIÓN TRIBUTARIA FACILITADA...16 ERRORES FUNCIONALES Y OTRAS SITUACIONES...16 FICHEROS...17 CONTACTOS...18 Página 2

4 ESPECIFICACIONES DEL WEB SERVICE DE INFORMACIÓN PARA LA COMPROBACIÓN DE ESTAR AL CORRIENTE DE OBLIGACIONES TRIBUTARIAS DESCRIPCIÓN Este desarrollo facilita en modo síncrono a los organismos públicos autorizados la información de si un contribuyente está al corriente de pago con la AEAT para la concesión de subvenciones y ayudas utilizando el estándar del SCSP Intermediado. La finalidad de este servicio web es certificar si una persona o entidad se encuentra al corriente de sus obligaciones tributarias conforme a lo establecido en el artículo 74 del Reglamento General de las actuaciones y los procedimientos de gestión e inspección tributaria y de desarrollo de las normas comunes de los procedimientos de aplicación de los tributos, aprobado por el Real Decreto 1065/2007, de 27 de julio. Se indicará el carácter positivo o negativo de la certificación. En los certificados negativos se indicará el motivo o motivos del incumplimiento: 1) Falta de presentación de una autoliquidación o declaración a la que el contribuyente estuviera obligado a presentar en los últimos doce meses precedentes a los dos meses inmediatamente anteriores a la fecha de solicitud; 2) Mantenimiento de deudas o sanciones tributarias en período ejecutivo con la Agencia Tributaria sin que éstas se encuentren aplazadas, fraccionadas o suspendidas; 3) No tener pendientes de ingreso responsabilidades civiles derivadas de delito contra la Hacienda Pública declaradas por sentencia firme; 4) Estar dado de alta en el censo de empresarios, profesionales o retenedores, cuando se trate de personas o entidades obligados a estar en dicho censo y estar dado de alta en el Impuesto sobre Actividades Económicas, cuando se trate de sujetos pasivos no exentos del impuesto. Modalidades de Estar al Corriente de Obligaciones Tributarias a consignar en el campo <CodigoCertificado> : - AEAT101I : Contratación con el Sector Público - AEAT102I : Autorizaciones de Transporte por carretera - AEAT103I : Subvenciones y Ayudas - AEAT104I : Permiso residencia y trabajo (Extranjeros) Página 3

5 CARACTERISTICAS Entorno: Intranet Administrativa. Protocolo: HTTPS. Mensajes: Web Service con SOAP 1.1 modo Document. Se proveerán ficheros WSDL 1.0 para la generación de clientes. Medio de envío: por la Intranet Administrativa. Es necesaria autenticación de cliente al enviarse por la Intranet Administrativa. Los mensajes irán con protocolo seguro SSL. Certificados a utilizar: de persona jurídica o de sello emitidos por alguna autoridad de certificación homologada por la AEAT. Firma: en Web Service Security. Se cifrará el tag de DatosEspecificos en la respuesta con XMLEncryption (se utilizará el método aes128cbc). La firma se realizará tras el cifrado. Nodo de firma: todo el BODY del SOAP. Encoding: preferentemente UTF-8 y, si no, ISO REQUISITOS -Intercambio de datos públicos de los certificados implicados en la firma. -Dirección IP del organismo peticionario con la que se va a acceder por Intranet Administrativa ya que en AEAT se debe de autorizar específicamente. -Conexión del organismo peticionario a la red SARA. -El organimo peticionario deberá enviar los datos públicos del certificado con el que van a hacer el handshake y, si va a ser distinto, también con el que van a firmar. -Las autorizaciones de acceso al servicio se gestionarán a través del SEPRI (comunicación.sepri@aeat.es) mediante el formulario Formsweb.doc. - Consultar en la dirección: Página 4

6 MENSAJE DE PETICIÓN Emisor: Organismo peticionario. Receptor: AEAT. DIAGRAMA El esquema de la solicitud consiste en: Página 5

7 DESCRIPCIÓN DE LOS CAMPOS. Características de los tags del mensaje: Atributos Carácter R: requerido, O: opcional Descripción Long. Tipo Car. Comentarios ATRIBUTOS IDPETICION 26 AN R Identificador de Petición. Clave única, irrepetible, para identificar la petición. Puede confeccionarse, por ejemplo, con 4 letras del organismo seguido de un secuencial NUMELEMENTOS 4 N R Debe ser 1 por petición TIMESTAMP 29 AN R Instante de la petición ESTADO O CODIGOESTADO 4 AN O Código de estado CODIGOESTADOSECUNDARIO 16 AN O Código de estado secundario LITERALERROR 255 AN O Descripción del error TIEMPOESTIMADORESPUESTA 4 N O Tiempo estimado de respuesta CODIGOCERTIFICADO 64 AN R Código del certificado. Se pondrá AEAT10xI SOLICITUDES SOLICITUDTRANSMISION DATOSGENERICOS EMISOR NIFEMISOR 10 AN R Nif del emisor Q H NOMBREEMISOR 50 AN R Nombre del emisor AEAT SOLICITANTE IDENTIFICADORSOLICITANTE 10 AN R Nif del Organismo que solicita la información NOMBRESOLICITANTE 50 AN R Nombre del Organismo que solicita la información UNIDADTRAMITADORA 250 AN O Unidad tramitadora PROCEDIMIENTO CODPROCEDIMIENTO 20 AN O Código de procedimiento NOMBREPROCEDIMIENTO 100 AN O Nombre del procedimiento FINALIDAD 250 AN R Texto libre que indica el motivo de la petición del certificado a la AEAT CONSENTIMIENTO 3 AN R Indica si el solicitante tiene el permiso del titular para recabar esta información, los valores posibles son Si y Ley. Página 6

8 FUNCIONARIO O NOMBRECOMPLETOFUNCIONARIO 122 AN O Nombre completo del funcionario que realiza la petición NIFFUNCIONARIO 10 AN O Nif del funcionario que realiza la petición IDEXPEDIENTE 25 AN O Identificación del expediente TITULAR TIPODOCUMENTACION 17 AN R Tipo de documentación del contribuyente del que se va a solicitar la información Los tipos posibles son: CIF, NIF, DNI, Pasaporte y NIE DOCUMENTACION 14 AN R Documentación del contribuyente del que se va a solicitar la información NOMBRECOMPLETO 122 AN R Nombre completo del contribuyente del que se va a solicitar la información NOMBRE 40 AN O Nombre del contribuyente del que se va a solicitar la información APELLIDO1 40 AN O Primer apellido del contribuyente del que se va a solicitar la información APELLIDO2 40 AN O Segundo apellido del contribuyente del que se va a solicitar la información TRANSMISION CODIGOCERTIFICADO 64 AN R Identificador del servicio web al que se va a acceder AEATIAE IDSOLICITUD 40 AN R Identificador de Solicitud. IDTRANSMISION 29 AN O Timestamp de la petición FECHAGENERACION 29 AN O Fecha en la que se realiza la petición Página 7

9 MENSAJE DE RESPUESTA Emisor: AEAT. Receptor: Organismo peticionario. DIAGRAMA Página 8

10 DESCRIPCIÓN DE LOS CAMPOS. Características de los tags del mensaje: Atributos Carácter R: requerido, O: opcional Descripción Long. Tipo Car. Comentarios ATRIBUTOS IDPETICION 26 AN R Identificador de Petición. Clave única, irrepetible, para identificar la petición. Puede confeccionarse, por ejemplo, con 4 letras del organismo seguido de un secuencial NUMELEMENTOS 4 N R Debe ser 1 por petición TIMESTAMP 29 AN R Instante de la petición ESTADO O CODIGOESTADO 4 AN O Código de estado. 0001: pendiente 0002: en proceso 0003: petición procesada y correcta 0004: petición errónea CODIGOESTADOSECUNDARIO 16 AN O Código de estado secundario. Error de la aplicación LITERALERROR 255 AN O Descripción del error de la aplicación TIEMPOESTIMADORESPUESTA 4 N O Tiempo estimado de respuesta CODIGOCERTIFICADO 64 AN R Código del certificado. Se pondrá AEAT10xI TRANSMISIONES O TRANSMISIONDATOS DATOSGENERICOS EMISOR NIFEMISOR 10 AN R NIF del emisor Q H NOMBREEMISOR 50 AN R Nombre del emisor AEAT SOLICITANTE IDENTIFICADORSOLICITANTE 10 AN R NIF del Organismo que solicita la información NOMBRESOLICITANTE 50 AN R Nombre del Organismo que solicita la información UNIDADTRAMITADORA 250 AN O Unidad tramitadora PROCEDIMIENTO CODPROCEDIMIENTO 20 AN O Código de procedimiento NOMBREPROCEDIMIENTO 100 AN O Nombre del procedimiento FINALIDAD 250 AN R Texto libre que indica el motivo de la petición del certificado a la AEAT Página 9

11 CONSENTIMIENTO 3 AN R Indica si el solicitante tiene el permiso del titular para recabar esta información, los valores posibles son Si y Ley. FUNCIONARIO O NOMBRECOMPLETOFUNCIONARIO 122 AN O Nombre completo del funcionario que realiza la petición NIFFUNCIONARIO 10 AN O NIF del funcionario que realiza la petición IDEXPEDIENTE 25 AN O Identificación del expediente TITULAR TIPODOCUMENTACION 17 AN R Tipo de documentación del contribuyente del que se solicita la información Los tipos posibles son: CIF, NIF, DNI, Pasaporte y NIE DOCUMENTACION 14 AN R Documentación del contribuyente del que se solicita la información NOMBRECOMPLETO 122 AN R Nombre completo del contribuyente del que se solicita la información NOMBRE 40 AN O Nombre del contribuyente del que se solicita la información APELLIDO1 40 AN O Primer apellido del contribuyente del que se solicita la información APELLIDO2 40 AN O Segundo apellido del contribuyente del que se solicita la información TRANSMISION CODIGOCERTIFICADO 64 AN R Identificador del servicio web al que se accede IDSOLICITUD 40 AN R Identificador de Solicitud. IDTRANSMISION 29 AN O Timestamp de la petición FECHAGENERACION 29 AN O Fecha en la que se realiza la petición DATOSESPECIFICOS Datos propios informados por el servicio CODRESPUESTA 4 AN R Código de respuesta: 0: Positivo. Está al corriente en Obligac.Tributarias 1-2-3: Negativo. No está al corriente : errores funcionales y otras situaciones DESCRESPUESTA 250 AN O REFERENCIA 11 AN O Referencia de certificación FECHAPROCESO 10 AN O Fecha de proceso Página 10

12 SOAP FAULT DIAGRAMA El esquema del mensaje SOAP ante cualquier error genérico (de sistema, base de datos...) será: Página 11

13 DESCRIPCIÓN DE LOS CAMPOS. Características de los tags del mensaje de error: Atributos Carácter R: requerido, O: opcional Descripción Long. Tipo Car. Comentarios Idpeticion 45 an R Identificación de petición que debe ser único por transmisión. Es la clave que identificará en ambos extremos TimeStamp 20 an R Timestamp de petición en formato DateTime AAAA-MM-DDTHH:MM:SSZ Mensaje 20 an R Identificación del mensaje. Los valores posibles son EFICHERO-Envío de fichero RFICHERO-Recepción de fichero Estado O Estado de la transmisión. Describe el error Estado Carácter R: requerido, O: opcional Descripción Long. Tipo Car. Comentarios CodigoEstadoPrincipal 5 an O Código de estado principal que permite a la aplicación cliente la toma de decisión (reenvío...). Si se ha recibido correctamente se devolverá LiteralErrorPrincipal 150 an O Descipción del campo CodigoEstadoPrincipal si ha habido error. CodigoEstadoSecundario 5 an O Código de estado secundario. Devuelve un código de error más específico que ayuda a resolver la incidencia LiteralErrorSecundario 150 an O Descipción del campo CodigoEstadoSecundario si ha habido error. TiempoEstimadoRespuesta 4 n O Tiempo estimado en devolver respuesta en caso que el error posible se solucione Página 12

14 FIRMA DIAGRAMA El esquema genérico con la firma WS Security en la petición sería: El esquema con la firma WS Security en la respuesta sería: Página 13

15 Página 14

16 ESTRUCTURA DE LOS MENSAJES Solicitud: Mensaje de petición Contendrá una capa SOAP y en el BODY estarán los datos de la transmisión, éstos se firman con WS Security. CAPA SOAP HEADER SOAP Firma WS Security (nodo Body) BODY SOAP Peticion Contestación: Mensaje de respuesta Contendrá una capa SOAP y en el BODY estarán los datos de la transmisión más los datos específicos de este mensaje. Se firman con WS Security los atributos de transmisión y los datos específicos. Los Datos Específicos además se envían cifrados con XML Encryption. CAPA SOAP HEADER SOAP Firma WS Security (nodo Body) BODY SOAP Respuesta (el nodo DatosEspecificos estará cifrado con XML Encryption). Página 15

17 INFORMACIÓN TRIBUTARIA FACILITADA La aplicación contempla los mismos criterios que se aplican en el resto de vías a la hora de establecer la situación en la que se encuentra un contribuyente a la fecha en que se solicita. Se comprueban así las cuatro fuentes principales ya mencionadas anteriormente que corresponden a: obligaciones tributarias propiamente dichas, deudas o sanciones tributarias, existencia de delito contra la hacienda pública y obligación censal de empresarios, profesionales o retenedores. Estas cuatro fuentes son las que delimitan el sentido del certificado obtenido: Código Respuest a Descripción de la situación tributaria POSITIVO. El contribuyente se encuentra al corriente en sus obligaciones tributarias. NEGATIVO. El contribuyente no se encuentra al corriente en sus obligaciones tributarias, se ha detectado que no figura presentación de declaración o de autoliquidación a la que figura obligado. NEGATIVO. El contribuyente no se encuentra al corriente en sus obligaciones tributarias, se ha detectado la existencia de una deuda o sanción de carácter tributario. NEGATIVO. El contribuyente no se encuentra al corriente en sus obligaciones tributarias debido a cualquier otra causa o combinación de ellas ERRORES FUNCIONALES Y OTRAS SITUACIONES Conjunto de casos en los que no se puede facilitar un certificado positivo ni negativo del contribuyente por los motivos siguientes: Error Descripción Solución 1001 Solicitante no autorizado Contactar AEAT - CAT 1002 Titular no identificado Revisar datos identificativos del contribuyente 1003 Código de certificado desconocido Incluir AEAT10xI como codigo certificado 1004 Problemas técnicos Contactar AEAT - CAT 1005 Entrada inconsistente Contactar AEAT - CAT 1006 No procede por ilocalizado Remitir al interesado a su Admon.Tributaria 1007 Solicitante no identificado Revisar datos identificativos del solicitante 1008 Titular de baja 1009 Titular con C.I. revocado 1010 Denegado por sentencia o sanción Remitir al interesado a su Admon.Tributaria Página 16

18 FICHEROS FICHERO TIPO DESCRIPCIÓN schema_copy_ XSPRUW30_peticion.xsd Esquema Datos específicos del Envío de fichero schema_copy_ XSPRUW30_respuesta.xsd Esquema Datos específicos del Recepción del fichero wsdl_ XSPRUW30.wsdl WSDL Petición/Respuesta de envío de fichero Página 17

19 CONTACTOS Para cualquier duda, incidencia o sugerencia por favor diríjase a: CAT Centro de Atención Telefónica de la AEAT Teléfono Correo electrónico: CATENTIDADES@CORREO.AEAT.ES Centro de Soporte Supresión de Certificados del Ministerio de la Presidencia Teléfono Opción 3 Otros Servicios Correo electrónico: soporte.sustituciondecertificados@mpr.es Página 18