Factura Electrónica. Web Service - Pasos a seguir. Versión 1.0

Transcripción

1 Web Service - Pasos a seguir Versión 1.0

2 Historial de Versiones Fecha Versión Descripción Autor Revisión Aprobación / Vigencia Fecha Revisó Fecha Aprobó 22/04/ Versión Inicial CB 22/04/2015 CB/EP 22/04/2015 FL Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 2 / 13

3 Tabla de contenido 1. INTRODUCCIÓN WEB SERVICE Instalación del certificado público oficial en un puesto Instalación del certificado público de pruebas en un puesto Verificación de los certificados públicos instalados... 6 APÉNDICE A - GENERACIÓN DE CERTIFICADOS PARA EL CLIENTE/USUARIO DEL SERVICIO... 7 APÉNDICE B - REQUERIMIENTOS LEGALES... 9 Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 3 / 13

4 Factura Electrónica 1. INTRODUCCIÓN La presente guía muestra los pasos necesarios para la configuraciónde Facturas Electrónicas, vía Web Service. 2. WEB SERVICE Para poder conectarse al Web Service brindado por AFIP, se deben utilizar dos certificados: 1. Certificado privado: Es un archivo de tipo PFX, el cual se tramita en el site de AFIP. Deben utilizarse los Apéndice A y B para generar los archivos requeridos. 2. Certificado público: Es un archivo de tipo CER, que debe instalarse en los puestos que se utilice la conexión. Existe la posibilidad de conectarse a un web service de prueba previsto por AFIP, para lo cual deberá instalar los componentes correspondientes. Los certificados públicos se instalan y los certificados privados solo se referencian en la opción Configuración de Soportes Electrónicos. 2.1 Instalación del certificado público oficial en un puesto El certificado público de Web Service se debe instalar en cada una de las computadoras que requieran obtener el número de CAE. Dentro del paquete de aplicaciones a utilizar es necesario considerar la instalación de la siguiente aplicación: SLWSCOMP.msi utilizando la aplicación Setup.exe, la cual se encuentra ubicada en la carpeta DOC del servidor. El archivo Setup.exe realiza la instalación de los distintos componentes necesarios para entablar la comunicación con el certificado oficial ofrecido por AFIP. Esta aplicación es recomendable instalarla sólo en los puestos que realizarán la comunicación con AFIP, motivo por el cual no se distribuye en todos los puestos. 2.2 Instalación del certificado público de pruebas en un puesto AFIP permite realizar pruebas de obtención de CAE/CAEA por medio de un certificado publico específico para pruebas. La instalación de este certificado no es obligatoria para el usar la conexión oficial, solo es necesario en la computadora que se requiera para realizar pruebas. El certificado privado de pruebas se tramita en la dirección de mail webservices@afip.gov.ar según las instrucciones del apéndice A. Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 4 / 13

5 Para instalar el certificado público de prueba se deben realizar los pasos del punto anterior y luego instalar el archivo AFIPcerthomo.cer: Ejecutar el archivo de tipo.cer y luego seleccionar la opción Install Certificate. En el paso de definición de la ubicación, se deben seleccionar las siguientes opciones: Colocar todos los certificados en el siguiente almacén (Place all certificates in the following stored) Entidades emisoras raíz de confianza (Trusted Root Certification Authorities). Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 5 / 13

6 2.3 Verificación de los certificados públicos instalados Para verificar los certificados instalados en cada puesto se debe ingresar a la opción Internet Options (Opciones de internet), del Windows Internet Explorer y seguir los siguientes pasos: Seleccionar la solapa Content y luego la opción Certificates: En la solapa Trusted Root Certificaction Authorities se visualizan los certificados de cada puesto: AFIP Root CA: Es el certificado para realizar la facturación en forma oficial. AFIP Autoridad Certificante: Es el certificado para realizar pruebas de facturación. Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 6 / 13

7 APÉNDICE A - GENERACIÓN DE CERTIFICADOS PARA EL CLIENTE/USUARIO DEL SERVICIO Para genera el certificado para el cliente/usuario se deben realizar los siguientes pasos: Instalar Open SSL. Generar clave privada (private key) Se debe generar el archivo privada el cual se debe guardar para luego generar el archivo.pfx. Para generar el archivo se debe ejecutar la siguiente línea de comando: C:\ Program Files\OpenSSL\bin>openssl genrsa -out privada 1024 Generar la clave CSR (Certificate Signing Request) Para generar el archivo pedido se debe ejecutar la siguiente línea de comando: C:\ Program Files\OpenSSL\bin>openssl req new key privada subj /C=AR/O=Subj_o/CN=subj_cn/serialNumber=CUIT subj_cuit out pedido Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 7 / 13

8 Reemplace: subj_o por el nombre de su empresa. subj_cn por su nombre o server hostname. subj_cuit por la CUIT sin guiones de la empresa o programador. Si ya se generó oportunamente un certificado y se necesita generar uno nuevo los valores a asignar se pueden consultar en la opción Administración de certificados digitales en el site de AFIP: Generar el certificado digital X.509 (.crt) Para generar el certificado de pruebas se debe enviar un mail solicitando el archivo de tipo.crt a la casilla webservice@afip.gov.ar para solicitar el certificado, aclarando a qué Web Service "de negocio" (por ej.: "wsfe", "wsseg", etc.) pretende acceder usando este certificado. Para generar el certificado oficial se debe ingresar a Acceso con clave fiscal del site de AFIP al servicio "Administración de Certificados Digitales", y luego deberá asociar el certificado al Web Service de Negocio en el cual está interesado, usando el servicio "Administrador de Relaciones de Clave Fiscal". Para más datos, ver los siguientes documentos: Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 8 / 13

9 Generar la clave pkcs12 Para generar el archivo.pfx se debe ejecutar la siguiente línea de comando: C:\ Program Files\OpenSSL\bin>openssl pkcs12 -export -inkey privada -in certificado.crt -out archio.pfx Verifique que el nuevo archivo.pfx generado, tenga el mismo nombre que el archivo anterior y/o asigne el nuevo nombre del archivo en la opción de menú Configuración de Soportes Electrónicos. Verificación del certificado digital X.509 (.crt) Los certificados emitidos por AFIP tienen vencimientos. Los mismos se pueden consultar en el site de AFIP y también se puede verificar el vencimiento en los archivos de tipo.crt con el siguiente comando: C:\ Program Files\OpenSSL\bin>openssl x509 -noout -dates -in certificado.crt Para consultar los datos informados en el archivo de tipo.crt se debe ejecutar el siguiente comando: C:\ Program Files\OpenSSL\bin>openssl x509 -noout -subject -in certificado.crt APÉNDICE B - REQUERIMIENTOS LEGALES El objetivo de este Apéndice es detallar los trámites legales que hay que realizar para poder implementar posteriormente en Softland. Cabe destacar que todos los trámites son on-line en el sitio de AFIP, mediante la clave fiscal. 1. Empadronamiento: El Empadronamiento solo es necesario para Factura Electrónica Local, en el cual uno declara a qué Régimen de facturación y registración se asocia la empresa. Como dato destacado, se debe informar en este empadronamiento cuál es el método de solicitud para autorizar los comprobantes electrónicos. Nosotros utilizamos Web Service. El servicio para acceder a este Empadronamiento se encuentra ingresando con Clave Fiscal, a Regímenes de Facturación y Registración (REAR/RECE/RFI). Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 9 / 13

10 Los datos obligatorios a completar son: Teléfono, Mail, Es reorganización de sociedad? SI, NO, Rubro I., Período Propuesto. 2. Certificados: Una vez generado el Certificate Signing Request, que es el archivo Pedido (Véase: Apéndice A - GENERACIÓN DE CERTIFICADOS PARA EL CLIENTE/USUARIO DEL SERVICIO)se debe proceder a solicitar el certificado de producción, ingresando con la clave Fiscal al servicio Administración de Certificados Digitales. Dentro del mismo se define un Alias, que es el Computador Fiscal, por el cual luego vamos a asociar el certificado al servicio que vamos a utilizar, por ej: WS-Factura Electrónica; WS-Factura Electrónica de Exportación. PASO 1 Seleccionar el contribuyente para el que va a operar el servicio (si representa a más de un contribuyente): PASO 2 Cliquear en Agregar alias: Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 10 / 13

11 PASO 3 Elegir un nombre para el alias y subir un Certificate Signing Request (Archivo Pedido). Ver Apéndice A para generar el mismo. Luego cliquear en Agregar alias: Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 11 / 13

12 PASO 4 Cliquear en Ver (link ubicado a la derecha del alias generado) para poder visualizar y en Descargar a su PC el certificado. Asociar Certificado a un Web Service de Negocio. Una vez realizados los pasos anteriores se debe asociar el certificado obtenido al Web Service que vamos a utilizar. En este punto tenemos dos opciones WS Facturación Electrónica y WSFEX Facturación Electrónica de Exportación. Esta última también la podemos encontrar solo como Facturación Electrónica de Exportación, (dependiendo del servicio de AFIP que ingresemos) Esto se puede realizar por dos servicios distintos. El primero, ingresando por Administración de Clave Fiscal, desde acá ingresaremos en la opción Nueva Relación, y luego iremos al menú Web Service. La segunda opción es ingresar por el servicio ARFE Gestionar Relaciones. Básicamente lo que debemos realizar, es elegir el Computador Fiscal que es el ALIAS que definimos cuando solicitamos el Certificado y asociamos al servicio que corresponda. Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 12 / 13

13 El Certificado de Producción generado puede ser utilizado para los Web Services que se empleen. Con esto queremos decir, que si una organización utiliza factura electrónica local y de exportación, solo tramita un certificado y lo asocia a los dos servicios. AMB Puntos de Ventas: Para trabajar con factura Electrónica se deben dar de alta Puntos de Ventas nuevos. Esto se hace mediante el Servicio Regímenes de Facturación y Registración (REAR/RECE/RFI) dentro del mismo hay una opción que se llama ABM Puntos de Ventas. Cada uno tendrá un Sistema de Facturación único a utilizar, los dos utilizados para la implementación de Softland son Comprobantes de Exportación Web Services (Para facturación de exportación) y RECE para aplicativos y web services (Para facturación local). Es importante destacar que no estará disponible el segundo Sistema mencionado, si no se realiza previamente el Empadronamiento. Fecha Impresión: 23/04/15 Softland Argentina, 2015 Pág.: 13 / 13