Saltar al contenido principal

Instalación

Elige tu lenguaje. La versión actual es 6.0.0-alpha.1; al ser una versión preliminar, en algunos gestores de paquetes debes indicarla explícitamente.

Requiere Java 25 o superior.

pom.xml
<dependency>
<groupId>io.github.project-openubl</groupId>
<artifactId>xbuilder</artifactId>
<version>6.0.0-alpha.1</version>
</dependency>
<dependency>
<groupId>io.github.project-openubl</groupId>
<artifactId>xsender</artifactId>
<version>6.0.0-alpha.1</version>
</dependency>

Con Gradle (Kotlin DSL):

build.gradle.kts
dependencies {
implementation("io.github.project-openubl:xbuilder:6.0.0-alpha.1")
implementation("io.github.project-openubl:xsender:6.0.0-alpha.1")
}
  • xbuilder crea y firma el XML (XBuilder, XSigner, SigningKey).
  • xsender envía el XML a la SUNAT (FileSender, SunatClient).
  • Si solo creas y firmas, basta con xbuilder; si solo envías XML ya firmados, basta con xsender.
  • Sin código nativo: funciona en cualquier JVM y es compatible con GraalVM native.
  • Para Spring Boot, Quarkus o Jakarta EE revisa Integrar con frameworks Java.

Línea de comandos​

La línea de comandos xhandler crea, firma y envía comprobantes descritos en YAML o JSON, sin escribir código.

Descarga el binario para tu sistema (Linux, macOS o Windows) desde la página de la versión 6.0.0-alpha.1, o compílalo con Rust (necesita un compilador de C):

cargo install --locked xhandler-cli@6.0.0-alpha.1

¿Quieres probar el formato antes de instalar nada? Usa el playground.

Revisa Usar la línea de comandos.

Siguiente paso​

Sigue el inicio rápido para enviar tu primera factura al entorno beta de la SUNAT.