DEPOSITARIO FIEL Aplicativo Visualizador de Carpetas Digitalizadas Especificación de Intercambio de Información AFIP PSAD

Transcripción

1 DEPOSITARIO FIEL Aplicativo Visualizador de Carpetas Digitalizadas Especificación de Intercambio de Información AFIP PSAD Última Actualización 20/05/2010 Página 1 de 9

2 Historial de modificaciones Versión Fecha Descripción /01/2010 Versión inicial del Documento /02/2010 Incorporación de Diagrama faltante y aclaraciones producto de las consultas recibidas /05/2010 Incorporación de un nuevo servicio de Registro de PSAD y sus implicancias con la interfaz Visualizador /05/2010 Incorporación de proceso de Homologación de la Implementación /05/2010 Especificación de los Actores intervinientes y aclaración de términos dentro del documento. Página 2 de 9

3 1 Objetivo El presente documento define el esquema a utilizar para la visualización de las carpetas digitalizadas. El documento esta dirigido a personas de perfil técnico encargadas del desarrollo de la interfaz para el intercambio de información con la AFIP, ya sean PSAD o declarantes de más de 5000 declaraciones que haya optado por desarrollar WebService. 2 Esquema General El siguiente gráfico presenta el esquema definido para la arquitectura del aplicativo visualizador. El mismo contempla los siguientes actores: Usuario AFIP: Es un operador de la Administracion Federal de Ingresos Publicos utilizando un servicio interno. Aplicativo Visualizador: Servicio Interno desarrollado por AFIP que sera utilizado por el Usuario AFIP y enviara requerimientos al Servicio desarrollado por el Ente Digitalizador. Ente Digitalizador: Es la persona o empresa que, o bien se ha inscripto como PSAD o bien es un Declarante con mas de 5000 operaciones que decide consumir los WebServices desarrollados por AFIP. El Usuario AFIP ingresará al Aplicativo Visualizador autenticado de acuerdo a sus propias normas de seguridad informática. En este aplicativo el usuario podrá realizar búsquedas por distintos parámetros sobre la base de datos de carpetas digitalizadas. Una vez identificada la carpeta buscada, podrá solicitar las imágenes de los documentos de toda la carpeta, o bien solamente aquellos documentos de una cierta familia de documentos. Al realizar la solicitud de los documentos digitalizados, el Aplicativo Visualizador identificará al Ente Digitalizador que ha realizado la digitalización de la documentación y generará una solicitud al servicio Web publicado por esta entidad. Esta solicitud será implementada a través de Página 3 de 9

4 un ticket de solicitud (ver punto 3.1) firmado digitalmente y codificado en formato Base64 para asegurar el correcto intercambio entre plataformas. El servicio Web de la entidad deberá recibir el ticket de solicitud, verificar su integridad, interpretar la solicitud realizada y generar como resultado un documento PDF conteniendo las digitalizaciones solicitadas, una imagen por página, sin incorporar formatos, leyendas, inscripciones, logos, o cualquier agregado que no corresponda con los documentos digitalizados. Para iniciar la operación en producción de ésta solución, el Ente Digitalizador deberá primero homologar su implementación con la AFIP. El punto 6 Proceso de Homologación de la Implementación del presente documento describe los pasos a seguir por un Ente Digitalizador que ha decidido consumir los WebServices de Aviso de Digitalización y por consiguiente desarrollará y homologará también la interfaz de intercambio de información para el Aplicativo Visualizador AFIP. 3 Requerimientos técnicos 3.1 Ticket de Solicitud El ticket de solicitud se representa como un documento XML versionado con el siguiente formato: <?xml version='1.0'?> <req version="1.0"> <id unique_id="req#" src="dn del Emisor" dst="cuit del Receptor" gen_time="abs_time" exp_time="abs_time"/> <operation type="folder-req" response="online"> <folder id="id Legajo" cuit_desp="cuit Despachante"> <doctypes> <doctype id="id Familia Doc" />... <doctype id="id Familia Doc" /> </doctypes> </folder> </operation> </req> El ticket se encuentra versionado, para permitir y administrar metodológicamente las modificaciones que puedan llegar a resultar necesarias con la evolución de este mecanismo. La AFIP se compromete a publicar la documentación correspondiente a la nueva versión del ticket con una anticipación minima de 30 días a la fecha prevista de su implementación. Referencias <id unique_id= REQ# : Cada ticket generado será identificado con un numero entero de un máximo de 16 dígitos, único para el momento en que se genero (aleatorio). <id src= DN del Emisor : Contendrá la información del certificado digital (Distinguish Name) utilizado por el servicio emisor (AFIP). <id dst= CUIT del Receptor : C.U.I.T. de la entidad que ha declarado haber digitalizado el legajo. <id gen_time= abs_time : Instante de generación del ticket. Valor abs_time. Página 4 de 9

5 <id exp_time= abs_time : Tiempo de expiración del ticket. Valor abs_time. abs_time: Es un número entero en formato decimal que representa el tiempo según las especificaciones Posix. Representa la cantidad de segundos desde el 1 de enero de 1970, 0hs GMT. La función que normalmente devuelve este valor es time() o gettimeofday(). <operation type= folder-req : Cada ticket de solicitud indica que solicitud se está realizando. Actualmente, la única operación habilitada es la solicitud de legajo (folder-req). <operation response= online : El ticket incluye el tipo de respuesta esperada por el usuario a la solicitud realizada. Actualmente, el único tipo de respuesta habilitado es la respuesta en línea al solicitador (online). <folder id= ID Legajo : Este elemento indica cual es el legajo que se esta solicitando. El valor es un alfanumérico de 16 posiciones. <folder cuit_desp= CUIT Despachante : El elemento indica en un número entero de 11 posiciones la CUIT del Despachante asociado al Legajo solicitado. <doctype id= ID Familia Doc : Cada solicitud puede incluir 0, 1 o varias familias de documentos. Si la solicitud no incluye una familia de documentos, entonces la respuesta deberá incluir todas las familias de documentos incluidas en la carpeta. En caso de contener 1 o más familias identificadas, la respuesta deberá contener solo aquellos documentos digitalizados que correspondan a las familias solicitadas. (Detalle de Familias de Documentos en Información Especifica ) 3.2 Firma El servicio Web destino deberá verificar o controlar la firma utilizando el certificado digital correspondiente al DN del Emisor informado en el ticket de solicitud. AFIP publicará en el sitio el certificado digital utilizado para firmar las solicitudes, así como el certificado raíz de la Autoridad Certificante AFIP emisora de los certificados digitales utilizados para esta implementación. 3.3 Dirección del servicio destino El punto de acceso al servicio deberá ser de forma segura mediante la utilización de SSL (empleando el protocolo HTTPS) para lo cual deberá contar con un certificado digital que será emitido por AFIP para este propósito específico y a pedido del interesado. El documento Especificación Técnica de certificados emitidos por AFIP para Sitios Seguros de PSAD publicado en el Micrositio brinda mayor información al respecto. Esta URL de acceso deberá ser referenciada mediante su FQDN (fully qualified domain name) del servidor en el que reside el servicio y no mediante una dirección IP. Dicho FQDN deberá estar disponible en el Servidor de Nombres (DNS) correspondiente al dominio. A este punto de acceso, el aplicativo Visualizador enviará por POST dos variables denominadas: token y sign. La variable token es la codificación base64 de la representación como texto del ticket XML, mientras sign es la codificación base64 de la firma del documento anterior (previo a la codificación en base64). Ambas codificaciones en base64 deben dar como resultado un string sin nuevas líneas o caracteres de retorno. Página 5 de 9

6 La dirección URL del punto de acceso al servicio deberá ser informada utilizando la transacción Desistimiento / Inclusión Anexo II RG2721, donde al optar por el desarrollo del WebService, deberá informar tanto esta URL como puntos de contacto (teléfono y correo electrónico) para posibles intercambios técnicos con AFIP. Hasta tanto el Ente Digitalizador no haya informado esta dirección URL y la AFIP haya realizado el control de calidad de la implementación, no estará finalizado el proceso de acreditación y no estará habilitado para operar los WebServices desarrollados por AFIP. 3.4 Sincronización de clocks El clock del equipo que recibe el token deberá estar sincronizado a través del protocolo ntp. Dicha sincronización se podrá realizar con el servidor time.afip.gov.ar u otro servidor que preste dicho servicio. Para más información sobre el protocolo y/o para bajar el software necesario consultar: 4 Obligaciones del Ente Digitalizador Utilizar esta interfaz de intercambio de información, obliga a la entidad a realizar las siguientes acciones al recibir un ticket de solicitud: 1. Verificar la firma digital de la solicitud. Utilizando el correspondiente certificado digital publicado por AFIP, deberá validar la firma del ticket de solicitud emitiendo, en caso de no validación de la firma, el mensaje de error código PSAD.V Validar la generación del ticket. La generación del ticket no puede ser posterior a la fecha actual. En caso de no validación, emitirá el mensaje de error código PSAD.V Validar la expiración del ticket. La expiración del ticket no puede ser anterior a la fecha actual (ticket vencido). En caso de no validación, emitirá el mensaje de error código PSAD.V Generar la respuesta a la solicitud realizada, de acuerdo a los parámetros solicitados. 5. Generar un registro de auditoria relacionado con la solicitud recibida. El mismo deberá contener la fecha y hora de recepción de la solicitud, el identificador de la solicitud, el Identificador del Legajo solicitado, el contenido completo del ticket de solicitud y el resultado generado. En caso de respuesta exitosa código PSAD.V.000, caso contrario, el código de error emitido. Es obligación del Ente Digitalizador mantener operativo el servicio que responde a las solicitudes AFIP con un up-time superior al 98%, así como solicitar y renovar el certificado digital necesario para asegurar el canal seguro HTTPS. La AFIP realizara controles periódicos sobre los servicios publicados por los Entes Digitalizadores para verificar estas condiciones. Página 6 de 9

7 5 Códigos de Resultado de Operación Código Descripción Observaciones PSAD.V.000 Resultado OK PSAD.V.001 Firma Inválida No se pudo verificar la firma del ticket enviado. Verificar estar utilizando el certificado digital vigente publicado en PSAD.V.002 Ticket emitido con posterioridad a la fecha actual. El ticket ha sido generado con una fecha posterior a la fecha actual del sistema receptor. Verificar la sincronización del reloj del equipo. PSAD.V.003 Ticket vencido La fecha actual del sistema es posterior a la fecha de expiración del ticket. Esto puede deberse a que exista una dessincronización del reloj del equipo receptor, o bien que el ticket este siendo utilizado con posterioridad a su periodo de vigencia. 6 Proceso de Homologación de la Implementación Para poder iniciar la operación en un ambiente productivo como Ente Digitalizador de documentos (ya sea PSAD o Declarante con más de 5000 declaraciones) la entidad deberá cumplimentar una serie de pasos, a saber: 1. Descargar, leer y comprender el presente documento. Es de primordial importancia ponerse al tanto de las definiciones realizadas por AFIP. Las mismas surgen del consenso de la mayoría de los actores involucrados en el sistema. 2. Solicitar los Certificados Digitales necesarios para la implementación de los Servicios informáticos requeridos por el sistema. El documento Especificación Técnica de certificados emitidos por AFIP para Sitios Seguros de PSAD publicado en el Micrositio brinda mayor información al respecto. 3. Registrarse como Consumidor de WebService. Para esto deberá solicitar primero el servicio con Clave Fiscal denominado Desistimiento / Inclusión Anexo II RG2721. Mediante este servicio manifiesta su voluntar de ser incluido en los términos del Anexo II de la RG2721, por lo cual se compromete a desarrollar los servicios informáticos relacionados con el sistema. Al manifestar su voluntad de ser incluido, la transacción le permitirá registrar su información de contacto (Teléfono y Correo Electrónico) así como la dirección URL donde publicará la dirección de su servicio (ver punto 3.3). 4. Comunicarse con los contactos técnicos AFIP para realizar la homologación de sus desarrollos. Para homologar el Webservice de Digitalización, deberá comunicarse con la dirección psad_webservices@afip.gov.ar. Para la homologación de la interfaz del visualizador, la dirección a utilizar es psad_visualizador@afip.gov.ar. Para poder realizar la Página 7 de 9

8 homologación le será solicitada la información detallada en el punto anterior, por lo que se recomienda cumpla los pasos en el orden establecido. 5. Una vez cumplimentados estos pasos y aprobada la homologación de ambos servicios, la inscripción realizada en el punto 3 quedará HABILITADA y le permitirá solicitar el WebService de Digitalización a través del Administrador de Relaciones de Clave Fiscal. Hasta tanto la homologación no este cumplimentada, este servicio no estará disponible para el operador. El siguiente checklist determina los puntos de control a cumplir para la homologación de la implementación del operador. Este mismo listado será utilizado por los contactos técnicos AFIP para determinar la homologación de los servicios. 1. Aspectos Generales Básicos HOMOLOGACION INICIAL PARA HABILITACION El Ente Digitalizador ha manifestado su voluntad de ser incluido en los términos del Anexo II RG2721 AFIP. El Ente Digitalizador ha solicitado y obtenido los certificados digitales necesarios para la implementación productiva de la solución. El Ente Digitalizador ha registrado la información de contacto (Teléfono y Mail) y los mismos han podido ser corroborados (llamada telefónica y respuesta recibida por correo electrónico). 2. Aspectos relativos al Visualizador El Ente Digitalizador ha declarado una URL valida. La URL declarada existe (no se obtiene error HTTP 404) y el certificado digital expuesto por la dirección coincide con el certificado emitido por AFIP para tal propósito. El Ente Digitalizador ha informado un legajo de prueba que contenga información para todas las familias de documentos habilitadas por AFIP. El test de obtención de documentos del legajo de prueba fue ejecutado exitosamente (Caso de Prueba exitoso). El test de obtención de mensaje de error fue ejecutado exitosamente (Caso de Prueba Mensaje de Error). 3. Aspectos relativos al Consumo de los WebServices AFIP El Ente Digitalizador cuenta con la homologación de su Aplicación consumidora del Webservice de Digitalización. Página 8 de 9

9 Una vez homologada la implementación, se habilitará a la entidad para solicitar a través del Administrador de Relaciones los WebServices provistos por AFIP para la integración de los sistemas. Posteriormente a la habilitación y de manera periódica, la AFIP ejecutará tests automáticos para controlar el nivel de servicio provisto. Para eso se tendrá en cuenta el siguiente checklist. En caso de no tener éxito en alguna de las pruebas, se emitirá un mensaje de correo electrónico al mail declarado solicitando la inmediata corrección del servicio. CONTROLES PERIODICOS 1. Testeo de la Interfaz del Aplicativo Visualizador La URL declarada existe (no se obtiene error HTTP 404) y el certificado digital expuesto por la dirección coincide con el certificado emitido por AFIP para tal propósito. El certificado digital expuesto por el servicio se encuentra vigente (control de fecha de expiración) El test de obtención de documentos del legajo de prueba fue ejecutado exitosamente (Caso de Prueba exitoso). El test de obtención de mensaje de error fue ejecutado exitosamente (Caso de Prueba Mensaje de Error). Página 9 de 9