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.
- Java
- Rust
- Python
- Go
Requiere Java 25 o superior.
<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):
dependencies {
implementation("io.github.project-openubl:xbuilder:6.0.0-alpha.1")
implementation("io.github.project-openubl:xsender:6.0.0-alpha.1")
}
xbuildercrea y firma el XML (XBuilder,XSigner,SigningKey).xsenderenvía el XML a la SUNAT (FileSender,SunatClient).- Si solo creas y firmas, basta con
xbuilder; si solo envías XML ya firmados, basta conxsender. - 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.
cargo add xhandler@6.0.0-alpha.1
Los ejemplos de esta documentación también usan estos crates:
[dependencies]
xhandler = "6.0.0-alpha.1"
rust_decimal = "1"
rust_decimal_macros = "1"
chrono = "0.4"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
anyhow = "1"
- La feature
http(activa por defecto) incluye el cliente HTTP para enviar a la SUNAT. Necesita un compilador de C para la capa TLS. - Con
default-features = falseobtienes una librería Rust pura que arma las peticiones y lee las respuestas para que uses tu propio cliente HTTP.
Requiere Python 3.10 o superior, en Linux, macOS o Windows.
pip install --pre xhandler
# o, fijando la versión
pip install "xhandler==6.0.0a1"
uv add "xhandler==6.0.0a1"
- No hay extensiones nativas que compilar: el paquete es una wheel universal.
--prees necesario mientras la versión 6 sea preliminar.
Requiere Go 1.25 o superior.
go get github.com/project-openubl/xhandler-go/v6@v6.0.0-alpha.1
import (
"github.com/project-openubl/xhandler-go/v6/xbuilder" // crear
"github.com/project-openubl/xhandler-go/v6/xsigner" // firmar
"github.com/project-openubl/xhandler-go/v6/xsender" // enviar
)
- Go puro, sin cgo: compila para cualquier sistema operativo y arquitectura que soporte Go.
- Indica la versión (
@v6.0.0-alpha.1) mientras la versión 6 sea preliminar;@latestno elige versiones preliminares.
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.