Configuración Web Service AFIP

Introducción

Especificación Técnica

WebService de Autenticación y Autorización

Se describen los aspectos técnicos del servicio de Autenticación y Autorización de WebServices (WSAA) perteneciente a la AFIP.

Dicho servicio es necesario para que Entes Externos a la AFIP (EE) accedan a los WebServices de Negocio (WSN) ofrecidos por la AFIP.

El WS de Autenticación y Autorización es un servicio B2B (Business to Business) que permite que los computadores pertenecientes a la AFIP y Entes Externos a la AFIP intercambien información en forma directa sin intervención de operadores. En dicha tarea intervienen los siguientes componentes:

• Un cliente de WS desarrollado por un EE siguiendo las especificaciones de este documento.
• El WSAA, WS publicado por la AFIP que implementa la autenticación de los computadores del EE (CEE) mediante certificados digitales X.509 y la autorización del mismo como consumidor de un determinado WebService de Negocio (WSN).

Para que un Ente Externo a la AFIP (EE) esté autorizado a usar un WSN de AFIP, deberá realizar un tramite administrativo previo. Una vez finalizado exitosamente dicho trámite, el que incluye el alta de los CEE, el EE quedará registrado en el servicio de autorización de AFIP como entidad autorizada para usar el WSN. Para que un CEE pueda utilizar efectivamente un WSN, deberá solicitar un “Ticket de Acceso” (TA) por medio del WS de Autenticación y Autorización (WSAA). Dicho requerimiento se realiza mediante el envío de un "Ticket de Requerimiento de Acceso" (TRA) del CEE al WSAA.

El WSAA realiza la verificación del TRA y si el requerimiento es correcto, devuelve un mensaje que contiene el TA que habilita al CEE a utilizar el WSN solicitado. El TA deberá ser utilizado por el CEE para acceder al WSN.

En términos generales, el presente documento detalla las operaciones a realizar para:

• Generar un "Ticket de Requerimiento de Acceso" (TRA)
• Invocar el "Web Service de Autenticación y Autorización" (WSAA)
• Interpretar el mensaje de respuesta del WSAA y obtener el "Ticket de Acceso" (TA)

Informe

Todos los archivos se deben alojar en: /local/EternumIT/webservice

Programas

crearCRT: este programa se utiliza para genera la clave privada y el requerimiento de cetificado firmado.

Para utilizar este programa (shell) se deben proporcionar los siguientes parametros:

• -c (numero CUIT),
• -e (nombre de la empresa),
• -s (nombre del servidor).

Una vez concluida la ejecucion del programa tendremos como resultado los siguientes archivos:

• Archivo de clave privada - ( nombre: 99999999999PRIV.key, donde 99999999999 es el CUIT de la empresa)

Este se utiliza para generar cada solicitud de web service.

• Archivo de requerimiento de certificado firmado: (nombre 99999999999REQ) este archivo se utiliza para gestionar el certificado firmado por AFIP para realizar las consultas a los webservice. El procedimiento de obtencion de dicho certificado se detalla en el siguiente archivo. Descargar
• Achivo WSDL - es el archivo de definición del web service, este se obtiene desde la web del AFIP