Como Empezar
¿Para quien es esta página?
Esta página esta orientada a los desarrolladores o programadores que necesiten obtener el CAE, para emitir posteriormente una factura electrónica, conectando con los web services de AFIP desde la aplicación sin intervención manual. Usando para esto una única interfaz sin requerir de otros conocimientos (criptografía, web services, XML, etc). No cubre los demás pasos relacionados con una factura electrónica (trámites legales y fiscales, generación del PDF o impresión del comprobante, código de barras, etc).
Guia.
El CAE se obtiene conectando con el web service de AFIP correspondiente (hay varios como se detalla más adelante), enviando los datos requeridos y recibiendo la respuesta que puede ser el CAE, el motivo de rechazo u otro tipo de información (monedas autorizadas, tipos de comprobantes, etc). En caso de usar la interfaz WSAFIPFE todo esto se implementa por medio de los métodos y propiedades del control que replican todos y cada uno de los web services. Todos los web services tienen 2 modos: una de prueba u homologación y otro real o de producción, para el modo prueba el instalador de la interfaz es libre y sin límites. El CAE es un código de autorización electrónica global único para cada comprobante. Quien recibe (por cualquier medio: PDF, papel, web, mail, etc.) el comprobante electrónico (el cliente) puede validar en el portal de AFIP que ese CAE esta asociado a los datos recibidos, lo que le da validez al comprobante electrónico, no tiene valor legal el medio por el que se envía la factura electrónica (PDF, mail, o cualquier otro). Aunque por comodidad muchos optan por generar un PDF imitando una factura tradicional.
Como obtener CAE:
El CAE se obtiene siguiendo una serie de pasos:
Definir en que modo se trabajará. Cada web service de AFIP tiene 2 servidores: uno de homologación o prueba y otro de producción o real. Ambos son idénticos pero solo los CAE en modo producción son legalmente validos.
Definir a que web service conectarse. Aunque toda factura electrónica se autoriza con un CAE este puede obtenerse de diferentes web services o servidores. Cada web service autoriza el CAE para un tipo de factura electrónica particular (por ejemplo WSFEX para factura electrónica de exportación, WSFEv1 para factura electrónica nacional, etc) aunque todos son similares cada web service implementa un conjunto de métodos y propiedades por separado.
Obtener el certificado digital requerido por AFIP para conectarse a sus servidores. Aun en modo prueba es necesario tramitar un certificado digital. Los certificados deben ser para el modo y web service a usar.
Instalar la interfaz para usarla desde cualquier lenguaje (insertando el OCX en un formulario o implementando el objeto COM en forma no visual).
Dependiendo del web service a usar cada uno tiene su documentación completa en esta página. En base a esa documentación (y ejemplos) conectar al web service, usando el método correspondiente, cargar las propiedades con los datos requeridos (total, numero de comprobante, etc), ejecutar el método autorizador y leer la respuesta del web service de AFIP (CAE y fecha de vencimiento o bien los errores devueltos).
En caso de fallos de conexión verificar si se produjo la interrupción DESPUÉS que AFIP enviara la respuesta (con el CAE) pero ANTES que la recibieramos. Para evitar autorizar 2 veces el mismo comprobante y recuperar el CAE original perdido en la falla de conexión.
Como usar la interfaz:
Cada web service tiene su documentación donde se detallan todos los métodos y propiedades. Estos métodos y propiedades son un duplicado del web service original pero agregando una letra característica. Por ejemplo todos los métodos y propiedades para el WSFEv1 (factura electrónica nacional) comienzan con "f1", todos los métodos y propiedades para el WSFEX (factura electrónica exportación) comienzan con "x", etc). Los que varia entre los web service son los datos (y las propiedades correspondientes) a cargar (fecha, total, si se informa o no los items facturados, etc) y la forma en que AFIP responde, especialmente como interpretar y descubrir los motivos de un rechazo. En general la mecánica de todos los web services es:
Para el modo prueba instalar la interfaz y comenzar a usar, no tiene límites.
Ejecutar el método "iniciar" de la interfaz (único método común a todos los web service).
Ejecutar el método para obtener acceso al web service.
Cargar en las propiedades correspondientes los datos requeridos (total, i.v.a., neto, fecha, punto de venta, tipo de comprobante, etc).
Ejecutar el método autorizador.
Leer en las propiedades correspondientes la respuesta de AFIP (CAE, motivo de rechazo, etc).
Cada web service tambien tiene métodos propios (por ejemplo recuperar el último número de comprobante usado, lista de comprobante válidos para el web service, etc).
Para pasar al modo real activar la interfaz y bajar un archivo de licencia provisorio por 30 días antes de efectuar el pago y obtener un archivo de licencia definitivo.
Ejemplos:
Cada web service en su documentación cuenta con una planilla excel interactiva que implementa todos los métodos y propiedades (mediante macros) para poder experimentar con el comportamiento y respuestas del servidor. También cada web service incluye un ejemplo operativo. En el caso del WSFEv1 uno para cada lenguaje ( y en los otros web service una ejemplo base en visual basic para usarlo como referencia en cualquier lenguaje. Para comenzar ir directamente a la documentación del web service a usar según el panel de la izquierda.