XHandler Java es una suite de herramientas diseñada para facilitar la integración de Facturación Electrónica en Perú (SUNAT) en aplicaciones Java. Este repositorio es un "monorepo" que alberga las librerías XBuilder y XSender, proporcionando una solución integral para crear, firmar y enviar comprobantes de pago electrónicos.

El proyecto se divide en módulos principales y extensiones para frameworks populares:

Componente	Descripción	Maven Central
XBuilder	Creación y firma de XMLs (UBL 2.1)
XSender	Envío de comprobantes a SUNAT/OSE
Quarkus XBuilder	Extensión XBuilder para Quarkus
Quarkus XSender	Extensión XSender para Quarkus
Spring Boot XSender	Starter XSender para Spring Boot

XBuilder abstrae la complejidad de los estándares UBL y XML, permitiéndote construir documentos tributarios válidos escribiendo código Java simple.

• Simple: No necesitas manipular XML directamente ni conciliar namespaces complejos.
• Completo: Soporte para Facturas, Boletas, Notas de Crédito/Débito, Guías de Remisión y Percepciones/Retenciones.
• Validado: Realiza cálculos automáticos y validaciones básicas según normativa SUNAT.

// Ejemplo simplificado de creación de facturaInvoiceinvoice = Invoice.builder() .serie("F001") .numero(1) .proveedor(proveedor) .cliente(cliente) .detalle(detalle) .build(); XMLInvoicexml = newInvoiceXMLBuilder().build(invoice);

XSender se encarga de la comunicación con los servicios SOAP de la SUNAT o de los Operadores de Servicios Electrónicos (OSE).

• Compatible: Soporta los diversos endpoints de SUNAT (Beta/Producción) y OSEs.
• Resiliente: Gestiona el envío de archivos ZIP y el procesamiento de respuestas (CDR, Tickets).
• Flexible: Fácil integración con frameworks modernos como Quarkus y Spring Boot.

Explora la carpeta examples/ para ver implementaciones de referencia:

• Spring Boot: Ejemplo de integración completa usando Spring Boot.
• Wildfly: Ejemplo para servidores de aplicaciones Jakarta EE.
• Tomcat: Ejemplo ligero desplegable en Tomcat.
• XBuilder/XSender: Ejemplos "standalone" de uso de las librerías.

Para guías detalladas, referencia de API y tutoriales, consulta nuestra documentación oficial.

• 📖 Sitio Web: project-openubl.github.io
• 💬 Comunidad: Únete al chat en Zulip
• 🐛 Soporte: Reportar un problema o discutir mejoras

Este proyecto se distribuye bajo la licencia Apache 2.0. Consulta el archivo LICENSE para más detalles.

Copyright © Project OpenUBL.