Saltar al contenido principal

Inicio rápido

En esta guía vas a crear una factura, firmarla y enviarla al entorno beta de la SUNAT, que acepta comprobantes de prueba sin valor tributario.

Antes de empezar​

  1. Instala xhandler para tu lenguaje.
  2. Descarga el certificado digital de prueba LLAMA-PE-CERTIFICADO-DEMO-12345678912.pfx (contraseña password) y guárdalo como certificado.pfx. El entorno beta solo acepta firmas de este certificado para el RUC de prueba 12345678912.
  3. Usa las credenciales públicas del entorno beta: usuario 12345678959MODDATOS y contraseña MODDATOS.

Crea, firma y envía​

Todo el flujo tiene tres pasos:

  • Crear: describes la factura solo con los datos esenciales. La fecha de emisión, los impuestos, los totales y las leyendas se calculan automáticamente.
  • Firmar: firmas el XML con tu certificado digital.
  • Enviar: envías el XML firmado a la SUNAT y recibes la respuesta (el CDR).
Quickstart.java
import io.github.project.openubl.xbuilder.XBuilder;
import io.github.project.openubl.xbuilder.models.Cliente;
import io.github.project.openubl.xbuilder.models.Detalle;
import io.github.project.openubl.xbuilder.models.Invoice;
import io.github.project.openubl.xbuilder.models.Proveedor;
import io.github.project.openubl.xsigner.SigningKey;
import io.github.project.openubl.xsigner.XSigner;
import io.github.project.openubl.xsender.Credentials;
import io.github.project.openubl.xsender.FileSender;
import io.github.project.openubl.xsender.URLs;
import io.github.project.openubl.xsender.models.SunatResponse;

import java.math.BigDecimal;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;

public class Quickstart {

public static void main(String[] args) throws Exception {
// 1. Crear
Invoice invoice = Invoice.builder()
.serieNumero("F001-1")
.proveedor(Proveedor.builder()
.ruc("12345678912")
.razonSocial("Softgreen S.A.C.")
.build())
.cliente(Cliente.builder()
.tipoDocumentoIdentidad("6") // RUC (Catálogo 6)
.numeroDocumentoIdentidad("12121212121")
.nombre("Carlos Feria")
.build())
.detalles(List.of(Detalle.builder()
.descripcion("Item")
.cantidad(new BigDecimal("2"))
.precio(new BigDecimal("100.00"))
.build()))
.build();
String xml = new XBuilder().build(invoice);

// 2. Firmar
SigningKey key = SigningKey.fromPkcs12(Files.readAllBytes(Path.of("certificado.pfx")), "password");
byte[] signed = new XSigner().sign(xml.getBytes(StandardCharsets.UTF_8), key);

// 3. Enviar
FileSender sender = new FileSender(
URLs.beta(),
Credentials.builder()
.username("12345678959MODDATOS")
.password("MODDATOS")
.build()
);
SunatResponse response = sender.sendFile(signed);

System.out.println(response.getStatus()); // ACEPTADO
System.out.println(response.getMetadata().getDescription()); // La Factura numero F001-1, ha sido aceptada
}
}

Si todo salió bien, la SUNAT responde:

ACEPTADO La Factura numero F001-1, ha sido aceptada
El entorno beta recuerda los comprobantes

Si vuelves a enviar F001-1, la SUNAT puede rechazarlo por duplicado. Cambia el número (F001-2, F001-3...) en cada prueba.

¿Qué acaba de pasar?​

  1. Crear generó el XML UBL 2.1 de la factura. Como no indicaste la fecha, la moneda ni los impuestos, se usaron la fecha de hoy en Perú, soles (PEN) y las tasas vigentes, y se calcularon el IGV y los totales.
  2. Firmar agregó la firma digital al XML.
  3. Enviar comprimió el XML, eligió el servicio correcto de la SUNAT según el tipo de comprobante y devolvió la respuesta: un CDR (constancia de recepción) con el estado ACEPTADO.

Un rechazo de la SUNAT no es un error de programación: llega como parte de la respuesta, igual que una aceptación. Revisa Envío y respuestas de la SUNAT para procesar todos los casos.

Siguientes pasos​