Especificación de Intercambio de Información AFIP –PSAD Versión 3.0.0 Ultima Actualización 17/02/2014
DEPOSITARIO FIEL Aplicativo Visualizador de Carpetas Digitalizadas Especificación de Intercambio de Información AFIP – PSAD
Versión 3.0.0 Última Actualización 17/02/2014
Página 1 de 11
Especificación de Intercambio de Información AFIP –PSAD Versión 3.0.0 Ultima Actualización 17/02/2014
Historial de modificaciones
Versión
Fecha
Descripción
1.0.0
29/01/2010 Versión inicial del Documento
1.1.0
22/02/2010 Incorporación de Diagrama faltante y aclaraciones producto de las consultas recibidas.
1.2.0
19/05/2010 Incorporación de un nuevo servicio de Registro de PSAD y sus implicancias con la interfaz Visualizador.
1.3.0
20/05/2010 Incorporación de proceso de Homologación de la Implementación.
1.3.1
21/05/2010 Especificación de los Actores intervinientes y aclaración de términos dentro del documento.
1.3.2
28/05/2010 Modificación de método para solicitar el Certificado Digital
2.0.0
27/07/2011 Modificación del Ticket de solicitud de acuerdo a la nueva reglamentación AFIP.
2.1.0
02/09/2011 Incorporación al Ticket de solicitud un dato adicional
2.2.0
06/09/2011 Incorporación al Ticket de solicitud datos adicionales únicamente para la interfaz AFIP sobre los documentos enviados por el servicio SETIDJ.
2.3.0
04/01/2011 Incorporación al Ticket de solicitud el HASH enviado en el aviso de digitalización para solicitar a los Digitalizadores información que fuera redigitalizada previo a la implementación de las Rectificativas A y B.
2.3.1
17/07/2012 Incorporación de códigos de error.
3.0.0
17/02/2014 Nueva versión preliminar para atender la necesidad de visualización de Legajos Electrónicos de Viaje del Medio de Transporte
Página 2 de 11
Especificación de Intercambio de Información AFIP –PSAD Versión 3.0.0 Ultima Actualización 17/02/2014
1
Objetivo
El presente documento define el esquema a utilizar para la visualización de documentación digitalizada. 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 sea un PSAD u otro operador debidamente autorizado - que haya optado por desarrollar Servicios Web específicos para este propósito.
2
Esquema General
El siguiente gráfico presenta el esquema definido para la arquitectura del intercambio de documentación digitalizada implementada por el aplicativo visualizador. El mismo contempla los siguientes actores:
Usuario AFIP: Es un operador de la Administración Federal de Ingresos Públicos utilizando un servicio interno.
Aplicativo Visualizador: Servicio Interno desarrollado por AFIP que será utilizado por el Usuario AFIP y enviara requerimientos al Servicio desarrollado por el Ente Digitalizador.
Ente Digitalizador: Es la persona o empresa responsable por el proceso de digitalización y archivo de la documentación. Puede ser un PSAD u otro operador - debidamente autorizado - que haya optado por desarrollar Servicios Web específicos para este propósito.
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 documentos digitalizadas. Una vez identificada el documento buscado, podrá solicitar las imágenes asociadas a ese documento de manera completa, o bien solamente un subconjunto de las mismas mediante ciertos criterios de selección.
Página 3 de 11
Especificación de Intercambio de Información AFIP –PSAD Versión 3.0.0 Ultima Actualización 17/02/2014
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 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. En el documento PDF generado el ente digitalizador deberá respetar el orden en que fuera digitalizado cada documento incluido en cada uno de los avisos de digitalización. 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 3.1
Requerimientos técnicos Ticket de Solicitud
El ticket de solicitud se representa como un documento XML versionado con el siguiente formato: ...
Página 4 de 11
Especificación de Intercambio de Información AFIP –PSAD Versión 3.0.0 Ultima Actualización 17/02/2014
... 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 mínima de 30 días a la fecha prevista de su implementación. La versión actual del Ticket es la 3.0 que será implementada en Marzo de 2014, fecha en la que la versión anterior (2.3) quedará deshabilitada. En esta nueva versión se incorpora un nuevo tipo de requerimiento (trip-req) al existente actualmente (folder-req). Este requerimiento responde a la necesidad de solicitar al Ente Digitalizador documentación del Legajo Electrónico del Viaje del Medio de Transporte. La estructura utilizada para solicitar información de Legajos Aduaneros no sufre alteraciones, por lo que aquellos Entes Digitalizadores que no procesen documentos del tipo Legajo Electrónico del Viaje del Medio de Transporte no necesitaran realizar mayores adaptaciones a sus sistemas, simplemente soportar la versión 3.0 del ticket.