Saltar al contenido principal

Consultar y validar comprobantes

Además de recibir comprobantes, la SUNAT tiene servicios para consultar los que ya enviaste (su estado y su CDR) y para validar un comprobante, tuyo o de un tercero. xhandler los expone en SunatClient, el mismo cliente que usa FileSender para enviar.

Antes de empezar​

  • Solo producción: estos servicios no existen en el entorno beta. xhandler solo trae las URLs de producción y no define URLs beta para ellos.
  • Credenciales reales: necesitas tu usuario y clave SOL. Las credenciales de prueba 12345678959MODDATOS no sirven aquí. En los ejemplos, 12345678912USUARIOSOL / CLAVE_SOL son valores de ejemplo.
  • Se llaman en SunatClient, no en FileSender: en cada llamada pasas la URL del servicio, los datos del comprobante y las credenciales.
ServicioPara qué sirveURL (constante)
Consulta de estadoEstado de un comprobante ya enviadoBILL_CONSULT_SERVICE_URL
Obtener CDRRecuperar el CDR de un comprobante ya enviadoBILL_CONSULT_SERVICE_URL
Validar por datosComprobar que existe un comprobante con esos datosBILL_VALID_SERVICE_URL
Validar un archivoValidar el archivo de un comprobanteBILL_VALID_SERVICE_URL

En Java las constantes están en SunatClient (SunatClient.BILL_CONSULT_SERVICE_URL); en Go se llaman xsender.BillConsultServiceURL y xsender.BillValidServiceURL.

Consulta de estado​

Identificas el comprobante por el RUC del emisor, el tipo (Catálogo 1, 01 para factura), la serie y el número.

import io.github.project.openubl.xsender.Credentials;
import io.github.project.openubl.xsender.sunat.ConsultResponse;
import io.github.project.openubl.xsender.sunat.DocumentQuery;
import io.github.project.openubl.xsender.sunat.SunatClient;

SunatClient client = new SunatClient();
Credentials credentials = Credentials.builder()
.username("12345678912USUARIOSOL")
.password("CLAVE_SOL")
.build();

// RUC, tipo de comprobante, serie, número
DocumentQuery document = new DocumentQuery("12345678912", "01", "F001", 1);

ConsultResponse status = client.getStatus(SunatClient.BILL_CONSULT_SERVICE_URL, document, credentials);
System.out.println(status.statusCode() + " " + status.statusMessage());

El código de estado es el que devuelve la SUNAT para este servicio (por ejemplo 0001 para un comprobante aceptado). xhandler no lo traduce a ACEPTADO/RECHAZADO: lo recibes tal cual, con su mensaje.

Obtener el CDR​

Usa los mismos datos que la consulta de estado. Si el CDR existe, la SUNAT lo devuelve como un zip (por ejemplo, con el código 0004 "La constancia existe").

ConsultResponse response = client.getStatusCdr(SunatClient.BILL_CONSULT_SERVICE_URL, document, credentials);
if (response.cdr() != null) {
Files.write(Path.of("cdr.zip"), response.cdr()); // zip con el CDR
}

Validar un comprobante por sus datos​

Comprueba que existe un comprobante con estos datos: emisor, tipo, serie, número, receptor, fecha de emisión e importe total. Sirve, por ejemplo, para verificar una factura que te enviaron. La fecha va como texto en formato dd/MM/yyyy. Si todo coincide, la SUNAT responde con el código 0 ("El comprobante existe y está aceptado.").

import io.github.project.openubl.xsender.sunat.CdpQuery;

import java.math.BigDecimal;

CdpQuery query = new CdpQuery(
"12345678912", // RUC del emisor
"01", // tipo de comprobante
"F001", // serie
"1", // número (texto numérico)
"6", // tipo de documento del receptor
"12121212121", // número de documento del receptor
"10/11/2026", // fecha de emisión, dd/MM/yyyy
new BigDecimal("236.00"), // importe total
null // número de autorización (opcional)
);
ConsultResponse validation = client.validateCdp(SunatClient.BILL_VALID_SERVICE_URL, query, credentials);
System.out.println(validation.statusCode() + " " + validation.statusMessage());

Validar un archivo​

El servicio verificaCPEarchivo de la SUNAT valida el archivo de un comprobante. xhandler lo expone así:

LenguajeMétodoArchivo
JavavalidateFile(url, filename, bytes, credentials)nombre y bytes
Rustvalidate_file(url, &file, &credentials)File { filename, zip_base64 }
Pythonvalidate_file(url, file, credentials)File(filename=..., zip=...)
GoValidateFile(ctx, url, file, credentials)xsender.File{Filename, Zip}

En todos los casos xhandler envía el nombre y el contenido (en base64) tal como se los das, a BILL_VALID_SERVICE_URL.

Formato del archivo sin confirmar

No está documentado en xhandler si la SUNAT espera aquí el XML tal cual o comprimido en un zip, ni qué nombre debe llevar. Los tipos de Rust, Python y Go hablan de un zip, mientras que Java lo describe como "un archivo XML". Prueba primero con un comprobante conocido antes de depender de este servicio.

Tener en cuenta​

  • Un rechazo no es una excepción: si la SUNAT responde con un error (por ejemplo, credenciales inválidas), recibes el fault en la respuesta. En Rust es ConsultResponse::Fault; en Python y Go, result.fault / result.Fault. En Java no hay un tipo aparte: el código de error (de 4 dígitos, como 0111) llega en statusCode(), con httpStatus() informado.
  • Tipos de los datos: el número es entero en la consulta de estado. Para validar por datos, la fecha y el importe van como texto en Rust, Python y Go; en Java el número va como texto (debe ser numérico) y el importe como BigDecimal.
  • Reintentos: si la SUNAT limita la cantidad de peticiones, estas consultas se reintentan igual que los envíos.
  • Comparte el cliente: si consultas para varias empresas, usa un solo SunatClient y pasa las credenciales de cada una en cada llamada. Revisa Facturar para varias empresas.

Ver también​