Facturar desde tu sistema: cómo funciona el web service de ARCA
Equipo de Facturo · Actualizado · 3 min de lectura
Comprobantes en línea sirve para facturar a mano. Pero si tenés una tienda online, un sistema de turnos, un CRM o simplemente muchas facturas por mes, lo que querés es que tu sistema facture solo. Para eso ARCA ofrece web services: una forma de que un programa pida la autorización de cada factura directamente.
Esta guía explica cómo funciona, para que puedas decidir si integrarlo vos o usar un servicio que ya lo resuelva.
Las dos piezas: WSAA y WSFEv1
- WSAA (autenticación y autorización): tu sistema se identifica ante ARCA con un certificado digital y recibe un ticket de acceso que dura algunas horas.
- WSFEv1 (factura electrónica): con ese ticket, el sistema envía los datos de cada comprobante y recibe el CAE y su vencimiento.
Es el web service que se usa para facturas A, B, C y sus notas de crédito y débito del mercado interno. Para exportación existe otro servicio específico.
Lo que hay que configurar en ARCA
- Generar un certificado digital. Se crea un pedido de certificado (CSR) con una clave privada y se carga en ARCA en Administración de certificados digitales. ARCA devuelve el certificado.
- Asociar el certificado al servicio. En el Administrador de Relaciones de Clave Fiscal se crea la relación entre tu CUIT, el "computador fiscal" (el certificado) y el servicio de Facturación electrónica.
- Crear un punto de venta de tipo web service. Lo explicamos en cómo dar de alta un punto de venta.
Homologación primero
ARCA tiene un entorno de homologación (pruebas) separado del de producción, con su propio certificado (se gestiona desde el servicio WSASS). Ahí podés emitir comprobantes de prueba sin efecto fiscal. Todo desarrollo debería probarse ahí antes de pasar a producción.
Cómo es emitir una factura
- El sistema obtiene el ticket de acceso con WSAA (y lo reutiliza mientras no venza).
- Consulta el último número autorizado para ese punto de venta y tipo de comprobante (método FECompUltimoAutorizado).
- Arma el comprobante con el número siguiente: tipo, concepto, documento del receptor, fechas, importes, IVA si corresponde.
- Lo envía con el método FECAESolicitar.
- ARCA responde con el CAE y su vencimiento, o con errores y observaciones.
- El sistema guarda el CAE y genera el PDF con el código QR que exige ARCA.
Lo que suele fallar
- Numeración desfasada: si otro sistema usó el mismo punto de venta, el número esperado no coincide. Solución: un punto de venta por sistema.
- Ticket vencido o pedido demasiadas veces: WSAA limita la frecuencia; hay que guardar el ticket y reutilizarlo.
- Importes que no cierran: el total tiene que coincidir exactamente con la suma del neto, el IVA y los tributos, con los redondeos correctos.
- Servicios sin fechas: si el concepto es servicios, son obligatorias las fechas del período y de vencimiento del pago.
- Caídas del servicio: ARCA a veces no responde. El sistema tiene que reintentar sin duplicar comprobantes.
¿Integrarlo o usar algo hecho?
Integrar WSFEv1 desde cero es un proyecto en sí mismo: certificados, firma de mensajes, manejo de errores, PDF con QR, reintentos. Tiene sentido si tu equipo de desarrollo lo va a mantener.
Si solo querés que tus facturas salgan solas desde tu CRM o tu tienda, es más simple usar un sistema que ya lo tenga resuelto y conectarlo por API. Facturo emite facturas por web service y expone una API REST: tu sistema manda el cliente y los ítems, y Facturo pide el CAE, guarda el comprobante y lo envía.
Preguntas frecuentes
¿Qué es WSFEv1?+
Es el web service de ARCA para pedir el CAE de facturas A, B, C y notas de crédito y débito del mercado interno.
¿Necesito un certificado digital?+
Sí. El certificado identifica a tu sistema ante ARCA y se asocia al servicio de facturación electrónica de tu CUIT.
¿Puedo probar sin emitir facturas reales?+
Sí, en el entorno de homologación de ARCA, con un certificado de pruebas.
¿Puedo usar el mismo punto de venta que en Comprobantes en línea?+
No es recomendable. Cada sistema debería tener su propio punto de venta de tipo web service.
Facturá con ARCA sin entrar a la web de ARCA. Gratis para empezar.
Crear cuenta gratis