En esta página contiene la documentación del web service de facturas electrónicas de bonos fiscales y bienes de capital (en adelante WSBFE) y para el web service de seguros de caución (en adelante WSSEG). Es recomendable leer también la documentación del WSFE.
Como el WSBFE y el WSSEG son muy similares en funcionamiento comparten esta documentación. En cada caso se indica cual es el método o propiedad que corresponde a cada web service separandolos por el signo /.
El control tiene métodos y propiedades (todos comienzan con la letra B para el WSBFE / S para el WSSEG) y funcionamiento similar a WSFE. Por lo tanto los pasos a seguir son:
Usar el método "bObtenerTicketAcceso" / "sObtenerTicketAcceso" (contando previamente con un certificado digital instalado en la PC).
Usar la propiedad "bversion" para indicar si nos conectamos al WSBFE o al nuevo WSBFEv1.
Cargar las propiedades con los datos de la factura a emitir (como bFecha_cbte / sFecha_cbte, bimp_liq / simp_liq, bimp_neto / simp_neto, etc.).
Cargas las propiedades con los datos de los items (como se detalla mas abajo).
LLamar al método "bRegistar" / "sRegistrar" usando el argumento "identificador".
Recuperar el CAE obtenido (desde la propiedad bFERespuestaCAE / sRespuestaCAE) o bien analizar el error (con berrcode / serrcode y berrmsg / serrmsg).
La diferencias principales del WSBFE/WSSEG comparado con el de factura electrónica actual (WSFE) son:
Requiere más datos para la factura (como moneda, zona (en caso del WSBFE), 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.). Más adelante hay un explicación mejorada sobre esto.
Requiere indicar los items de la factura. Incluyendo (para el WSBFE) código, unidad de médida, descripción entre otros, y (para el WSSEG) poliza, endosa, etc.
Después de registrar una factura (o llamar a otro método del WSBFE / WSSEG) AFIP puede devolver un "evento" o "mensaje" que siempre debe ser consultado y mostrado (con las propiedades "bEventmsg" y "bEventCode")
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 "bindiceitem" / "sindiceitem) es fundamental para usar el nuevo WSBFE / WSSEG por lo que dispone de una página especial para explicarlo (¡no asustarse!, si llegó hasta aqui nada debería espantarlo).
En la lista al pie figura toda la información para usar el nuevo Web Service de AFIP (WSBFE / WSSEG).