Saltar al contenido principal

Cálculos automáticos

Al crear un comprobante solo describes lo esencial: serie y número, proveedor, cliente e ítems. Antes de generar el XML, xhandler enriquece el documento: completa los valores por defecto y calcula impuestos y totales. A este paso se le llama enrich.

Qué se completa y se calcula​

Solo se completa lo que no indicaste. Si das un valor, se respeta.

Datos del comprobante

  • Fecha de emisión: la fecha de hoy en Perú (UTC-5). En Rust, la fecha que pasas en Defaults.
  • Moneda: soles (PEN).
  • Tipo de comprobante: según la serie; F001 es factura (01) y B001 es boleta (03).
  • Tipo de operación: venta interna (0101).
  • Forma de pago: contado.
  • Firmante: los datos del proveedor.
  • Tasas: las tasas vigentes de la SUNAT para IGV, ICBPER e IVAP.

Datos de cada ítem

  • Unidad de medida (NIU) y tipo de IGV (10, gravado - operación onerosa).
  • Precio con y sin impuestos, a partir del que indicaste.
  • Base imponible, IGV, ISC, ICBPER y total de impuestos del ítem.

Totales

  • Importe sin impuestos, con impuestos e importe total.
  • Totales de impuestos por tipo de operación (gravadas, exoneradas, inafectas, gratuitas, exportación, IVAP) e importes de ISC e ICBPER.

Leyendas

Se agregan las leyendas que dependen de los datos del comprobante, por ejemplo cuando hay detracción, percepción u operaciones sujetas a IVAP.

La leyenda del monto en letras no se genera

xhandler no agrega la leyenda 1000 (monto en letras). Si la necesitas, agrégala tú en el campo leyendas del comprobante, un mapa de código a texto.

Lo que no se calcula​

En el resumen diario, la percepción y la retención los importes no se calculan: debes indicarlos tú. Revisa Resumen diario y Percepciones y retenciones.

Revisar el documento calculado​

Crear el XML no modifica tu documento. Para ver los valores calculados sin leer el XML, usa enrich: aplica exactamente los mismos cálculos que se usan al generar el XML.

enrich devuelve una copia del documento; el original no cambia.

Invoice enriched = new XBuilder().enrich(invoice);

enriched.getMoneda(); // "PEN"
enriched.getFechaEmision(); // hoy en Perú
enriched.getTipoComprobante(); // "01"
enriched.getTotalImporte().getImporteSinImpuestos(); // 200
enriched.getTotalImporte().getImporte(); // 236.00
enriched.getTotalImpuestos().getTotal(); // 36.00

Detalle detalle = enriched.getDetalles().get(0);
detalle.getIgvTipo(); // "10"
detalle.getPrecioConImpuestos(); // 118.00
detalle.getIgv(); // 36.00

Compara los BigDecimal con compareTo, no con equals: la escala puede variar (200 o 200.00).

Los valores de los comentarios corresponden a un ítem de cantidad 2 y precio 100.00 con IGV del 18 %.

Cambiar la fecha y las tasas: Defaults​

Defaults define los valores que se usan cuando el documento no los indica. Tiene cuatro campos:

CampoQué esValor por defecto
Fecha de emisiónFecha del comprobanteHoy en Perú (UTC-5)
Tasa de IGVFracción, 0.18 = 18 %Tasa vigente de la SUNAT
Tasa de ICBPERMonto en soles por bolsa plásticaTasa vigente de la SUNAT
Tasa de IVAPFracción, 0.04 = 4 %Tasa vigente de la SUNAT
Las tasas son fracciones

Escribe 0.18, no 18. La única excepción es la tasa de IGV de los ítems del resumen diario, que es un porcentaje (18).

import io.github.project.openubl.xbuilder.models.Defaults;

Defaults defaults = Defaults.builder()
.fechaEmision(LocalDate.of(2026, 11, 15))
.igvTasa(new BigDecimal("0.18"))
.icbTasa(new BigDecimal("0.50"))
.ivapTasa(new BigDecimal("0.04"))
.build(); // todos los campos son opcionales

// Para todos los documentos de un XBuilder (reutilizable y thread-safe)
XBuilder xbuilder = new XBuilder(defaults);
String xml = xbuilder.build(invoice);

// O en cada llamada
String xml2 = new XBuilder().build(invoice, defaults);
Invoice enriched = new XBuilder().enrich(invoice, defaults);

Prioridad​

Si un valor se indica en varios lugares, gana el más específico:

  1. El ítem (por ejemplo, la tasa de IGV de un Detalle).
  2. El documento (la fecha de emisión o la tasa de IGV del Invoice).
  3. Defaults.

Así puedes fijar la fecha o una tasa para un solo comprobante sin cambiar Defaults.

Pruebas reproducibles

La fecha por defecto depende del reloj. En tus pruebas, fija la fecha de emisión en Defaults o en el documento para obtener siempre el mismo XML.