Cómo construir clase proxy para obtener semilla del SII
Bueno unos de los problemas más frecuentes para el proceso de conexión y autentificación contra el SII es que muchos de los programas que hoy realizan esta tarea se comunican de forma nativa a través de JAVA. Generalmente los desarrolladores como yo tenemos muchos problemas para hacerlo pues necesitamos algún conector ( proxy ) que nos ayude con la comunicación a servicios del tipo java. Para solucionar esto les dejo un pequeño tutorial para generar su clase proxy y también el cómo pueden acceder a el para utilizarlo.
Definición según el SII
Según la definición formal del SII ( Servicio de Impuestos Internos ), el proceso de autenticación automatica corresponde a:
"Es un chequeo del uso de la llave privada del certificado del cliente, mediante el uso de Web Services (WS).". En donde el certificado del cliente es aquel que utiliza el usuario registrado en el SII
para acceder a los servicios del portal del SII.
Les dejo el link del archivo
Manual de Desarrollador Autenticación Autemática SII para que tengan mas información técnica del proceso.
Como crear el proxy
Primero que nada debemos saber que el SII tiene dos formas de trabajo disponibles para los usuarios registrados en su portal. Un ambiente de pruebas denominado ‘Certificación’ y otro en donde aquellos postulantes de la factura electrónica ya pasaron todos los test del SII para incorporarse completamente al ambiente de ‘Producción ‘ del SII.
Para tales efectos los dejo las direcciones de donde obtener los manifiestos de los servicios disponibles del SII.
Para el ambiente de certificación es la siguiente dirección:
https://maullin.sii.cl/DTEWS/CrSeed.jws?WSDL
https://maullin.sii.cl/DTEWS/GetTokenFromSeed.jws?WSDL
Para el ambiente de Producción es la siguiente dirección:
https://palena.sii.cl/DTEWS/CrSeed.jws?WSDL
https://palena.sii.cl/DTEWS/GetTokenFromSeed.jws?WSDL
Nota:
Donde CrSeed.jws permite recuperar la semilla del SII y GetTokenFromSeed
representa el método a consultar cuando ya firmamos la semilla, el último método
regresa una respuesta en formato xml que nos indica si la autenticación fue
posible o no.
Lo primero que debe hacer es intentar conectarse en su explorador a estas urls, de tal forma que sepamos que el servicio esta operativo. En el caso que Ud. Sea un desarrollador .Net debe tener presente que para poder generar la conexión al SII es necesario tener activado de forma predeterminada el IExplorer de Microsoft en su equipo o servidor.
Nota:
Recuerde que al momento de generar la conexión debe saber claramente a donde lo esta haciendo, el SII asume gracias al certificado digital que tiene asignado el usuario del portal, que él sabe lo que esta haciendo y todas las responsabilidades que tiene por utilizar este servicio.
Una vez que ya sabe que puede llegar al servicio ( Conectarse ), podemos iniciar el proceso de construcción del proxy. Para tales efectos utilizaremos herramientas de Microsoft que nos ayudarán a realizar el proceso casi sin necesidad de escribir una línea de código. Para algunos esto resulta muy bueno, pero para desarrolladores como yo muchas veces se transforma en armas de doble filo, que funcionan correctamente en ambientes controlados, pero que dan muchos dolores de cabeza cuando no se comprende la lógica detrás de ellas.
Visual Studio 2011 tiene un gran número de herramientas disponibles que están disponibles a nivel de línea de comandos, las cuales deberás utilizar para generar el proxy.
Les dejo aquí la url de Microsoft para que lean detalladamente las características de la herramienta.
Web Services Description Language Tool ( WSDL.EXE )
Procedimiento
Bueno en el caso mío, fueron varias horas de trabajo hasta conseguir lo que necesitaba, pero al final logré construir el conector (Proxy) utilizando la siguiente sintaxis. Primero, cree el archivo de contrato el cual almacenara la descripción de los servicios a los cuales quiere acceder, en mi caso cree un archivo plano denominado Contrato.wsdl donde deposite el contrato de servicios extraído de la URL de Producción. Lo cual me quedo algo como esto:
Ver archivo con descripción de GetSeed
Ver archivo con descripción de GetTokenFromSeed
Nota:
Los archivos creados apuntan al servidor de producción del SII, para crear los archivos de certificación, deberá editar los archivos y cambiar la referencia 'palena' por 'maullin'.
Una vez creado el archivo wsdl es necesario indicarle al ejecutable que es lo que se necesita hacer con el. En mi caso yo necesitaba que a partir de este archivo generará una clase del tipo librería que me permitiera acceder a los servicios del SII. Así que aplique esta sintaxis:
Wsdl /out:myProxyClass.cs Contrato.wsdl
Donde el primer parámetro corresponde al archivo de salida tipo clase c# y el segundo parámetro corresponde a nuestro archivo de contrato wsdl generado en el paso anterior. La nueva clase generada ahora puede ser insertada en nuestro proyecto .NET para ser consumida. El resultado de la conversión es algo como esto:
El resultado de la operacion arroja los siguientes archivos. En este caso les dejo una url de donde verlos utilizando Google Drive.
Ver clase proxy GetSeed
Ver clase proxy GetTokenFromSeedService
Con estas dos clases ya se encuentra listo para incluirlas en su proyecto y de esta forma iniciar el proceso de autenticación sobre el SII.