Saltar al contenido principal

Percepciones y retenciones

Un comprobante de percepción acredita el monto que cobraste por adelantado a tu cliente como agente de percepción. Un comprobante de retención acredita el monto que retuviste al pagar a tu proveedor como agente de retención. Ambos se firman igual que una factura, pero se envían a un servicio distinto de la SUNAT.

Antes de empezar​

Estos comprobantes se diferencian de una factura en tres puntos:

  • Serie y número van separados: usas serie (P001, R001) y numero (1), no serie_numero. El identificador del documento (P001-1) se calcula a partir de ellos.
  • Los importes no se calculan: tú indicas el porcentaje, el monto percibido o retenido y el total cobrado o pagado. Solo se completan automáticamente la fecha de emisión (hoy), la moneda (PEN), el firmante (el proveedor) y el identificador.
  • Otro servicio de la SUNAT: al enviarlos, xhandler elige solo la URL de percepciones y retenciones (perception_retention) de tus URLs. La respuesta es un CDR directo, no un ticket.

Cada comprobante tiene una sola operación (operacion), es decir, un solo comprobante afectado.

Percepción​

En el ejemplo, la factura F001-1 de 236.00 soles tiene una percepción del 2% (régimen 01 del Catálogo 22): 236.00 × 2% = 4.72 percibido, y 236.00 + 4.72 = 240.72 cobrado.

Percepcion.java
import io.github.project.openubl.xbuilder.XBuilder;
import io.github.project.openubl.xbuilder.models.Cliente;
import io.github.project.openubl.xbuilder.models.PercepcionRetencionComprobanteAfectado;
import io.github.project.openubl.xbuilder.models.PercepcionRetencionOperacion;
import io.github.project.openubl.xbuilder.models.Perception;
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.time.LocalDate;

LocalDate fecha = LocalDate.of(2026, 11, 10);

Perception perception = Perception.builder()
.serie("P001")
.numero(1L)
.proveedor(Proveedor.builder()
.ruc("12345678912")
.razonSocial("Softgreen S.A.C.")
.build())
.cliente(Cliente.builder()
.tipoDocumentoIdentidad("6")
.numeroDocumentoIdentidad("12121212121")
.nombre("Carlos Feria")
.build())
.tipoRegimen("01") // Catálogo 22
.tipoRegimenPorcentaje(new BigDecimal("2"))
.importeTotalPercibido(new BigDecimal("4.72"))
.importeTotalCobrado(new BigDecimal("240.72"))
.observaciones("Percepción de prueba")
.operacion(PercepcionRetencionOperacion.builder()
.numeroOperacion(1L)
.fechaOperacion(fecha)
.importeOperacion(new BigDecimal("236.00"))
.comprobanteAfectado(PercepcionRetencionComprobanteAfectado.builder()
.tipoComprobante("01") // factura
.serieNumero("F001-1")
.fechaEmision(fecha)
.importeTotal(new BigDecimal("236.00"))
.moneda("PEN")
.build())
.build())
.build();
String xml = new XBuilder().build(perception);

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

FileSender sender = new FileSender(
URLs.beta(),
Credentials.builder()
.username("12345678959MODDATOS")
.password("MODDATOS")
.build()
);
SunatResponse response = sender.sendFile(signed); // va a la URL de percepciones y retenciones
System.out.println(response.getStatus());

Retención​

La retención tiene la misma forma que la percepción. Solo cambian tres cosas:

PercepciónRetención
ModeloPerceptionRetention
Régimen (tipo_regimen)Catálogo 22Catálogo 23
Importesimporte_total_percibido, importe_total_cobradoimporte_total_retenido, importe_total_pagado

En el ejemplo, al pagar la factura F001-1 de 236.00 soles retienes el 3% (régimen 01 del Catálogo 23): 236.00 × 3% = 7.08 retenido, y 236.00 − 7.08 = 228.92 pagado. La firma y el envío son idénticos a los de la percepción.

Retention retention = Retention.builder()
.serie("R001")
.numero(1L)
.proveedor(Proveedor.builder()
.ruc("12345678912")
.razonSocial("Softgreen S.A.C.")
.build())
.cliente(Cliente.builder()
.tipoDocumentoIdentidad("6")
.numeroDocumentoIdentidad("12121212121")
.nombre("Carlos Feria")
.build())
.tipoRegimen("01") // Catálogo 23
.tipoRegimenPorcentaje(new BigDecimal("3"))
.importeTotalRetenido(new BigDecimal("7.08"))
.importeTotalPagado(new BigDecimal("228.92"))
.observaciones("Retención de prueba")
.operacion(PercepcionRetencionOperacion.builder()
.numeroOperacion(1L)
.fechaOperacion(fecha)
.importeOperacion(new BigDecimal("236.00"))
.comprobanteAfectado(PercepcionRetencionComprobanteAfectado.builder()
.tipoComprobante("01")
.serieNumero("F001-1")
.fechaEmision(fecha)
.importeTotal(new BigDecimal("236.00"))
.moneda("PEN")
.build())
.build())
.build();
String xml = new XBuilder().build(retention);

Tener en cuenta​

  • Revisa tus cálculos: la librería no verifica que el monto percibido o retenido corresponda al porcentaje. Lo que indiques es lo que va en el XML.
  • Moneda extranjera: si el comprobante afectado no está en soles, agrega el tipo de cambio en la operación (tipo_cambio, con valor y fecha).
  • Nombre del archivo: al enviar, el zip se nombra con el tipo de comprobante de la SUNAT: 12345678912-40-P001-1.zip para la percepción y 12345678912-20-R001-1.zip para la retención. No tienes que hacer nada, xhandler lo arma por ti.
  • Anular: una percepción o retención no se anula con una comunicación de baja, sino con una reversión. Revisa Anular comprobantes.

Ver también​