Documentación Full WSFEX

Esta página contiene la documentación actualizada del web service de facturas electrónicas exportadores o exportación versión 0 y 1 (en adelante WSFEX y WSFEXv1).

Para experimentar en tiempo real con el WSFEX y obtener un CAE en modo prueba puede usar la planilla excel interactiva WSFEXTest.

La interfase WSAFIPFE ha incorporado métodos y propiedades (todos comienzan con la letra X) para acceder al WSFEX en forma similar al WSFE. El funcionamiento general consiste en:

• • Usar el método "xObtenerTicketAcceso" (contando previamente con un certificado digital instalado en la PC).

  • Usar la propiedad "version" para indicar si se conectará al WSFEX o al WSFEXv1.

  • Cargar las propiedades con los datos de la factura a emitir (como xFecha_cbte, ximp_total, etc.).

  • Cargar las propiedades con los datos de los items (es decir los productos a facturar), como se detalla mas abajo.

  • Si corresponde cargar las propiedades con los datos de permisos y/o comprobantes asociados.

  • LLamar al método "xRegistar" usando el argumento "identificador".

  • Recuperar el CAE obtenido (desde la propiedad xRespuestaCAE) o bien analizar el error (con xerrcode y xerrmsg).

La diferencias principales del WSFEX comparado con otros web service de factura electrónica son:

• • Requiere más datos para la factura (como moneda, forma de pago, destino pais, etc.).

  • Algunos tipos de datos (como tipo de comprobante, tipo de moneda, etc) son "dinámicos". Es decir que estos tipos datos tiene a su vez un método para recuperar la lista de valores disponibles (estos métodos devuelven una lista de valores indicando código y nombre. Por ejemplo se puede obtener una lista de monedas autorizadas por la AFIP, una lista de tipos de comprobante, etc.). Es decir en la aplicación deberemos tener precargados estos datos y periodicamente recuperalos desde el servidor de AFIP para verificar que no hubo altas y/o bajas (por ejemplo: nuevas monedas, nuevos tipo de comprobantes, etc). Más adelante hay un explicación mejorada sobre esto.

  • Requiere indicar los items de la factura. código, unidad de médida, descripción entre otros. Teniendo en cuenta que puede haber mas de 1 item en la misma factura.

  • Después de registrar una factura (o llamar a otro método del WSFEX) AFIP puede devolver un "evento" o "mensaje" que siempre debe ser consultado y mostrado (con las propiedades "xEventmsg" y "xEventCode")

  • Existe un método para recuperar (indicando tipo de comprobante, punto de venta y número) íntegramente los datos desde el servidor de AFIP de una factura electrónica.

Para cargar los datos correspondientes a los items o detalle de la factura y también para recuperar valores dinámicos (como una lista de monedas autorizadas, tipos de documentos, etc). Se usa un mecanismo llamado "indiceitem" que permite cargar o recuperar una lista de valores dinámicos (teniendo en cuenta que la cantidad de items o "lineas" de una factura son variables). Este mecanismo (y la propiedad "xindiceitem") es fundamental para usar el nuevo WSFEX por lo que dispone de una página especial para explicarlo (¡no asustarse!, es simple).

Algunas propiedades o argumentos que son tipo "long" (o que por su contenido sean problemáticas en algunos lenguajes) en el servidor de AFIP tienen un equivalente tipo "string" (generalmente es el mismo nombre con una "S" agregada al final) para los lenguajes que presentan problemas con este tipo de datos. Ver tipo de datos.