sunat_cpe
Librería en Rust de alto rendimiento para la generación, firma digital XML (XMLDSig), validación pre-vuelo y comunicación con los servicios web (SOAP / REST) de la SUNAT (Superintendencia Nacional de Aduanas y de Administración Tributaria del Perú) para Comprobantes de Pago Electrónicos (CPE).
Para detalles completos de algoritmos y arquitectura, consulte docs/MANUAL_TECNICO.md.
Características Principales
- 100% Rust Nativo: Cero dependencias dinámicas o estáticas de OpenSSL / C. La criptografía RSA-SHA256, canonicalización C14N y el parsing PKCS#12 (
.p12/.pfx) se ejecutan puramente en Rust. - Aritmética Decimal Exacta (Antifloating-Point): Prohibición estricta de punto flotante binario (
f32/f64) para importes monetarios. Todos los cálculos se realizan con precisión exacta de 128 bits víarust_decimal::Decimal. - Esquemas OASIS UBL 2.1:
- Factura Electrónica (
01-Invoice-2) - Boleta de Venta Electrónica (
03-Invoice-2) - Nota de Crédito Electrónica (
07-CreditNote-2) concac:DiscrepancyResponseycac:BillingReference - Nota de Débito Electrónica (
08-DebitNote-2)
- Factura Electrónica (
- Validador Pre-Vuelo (
CpeValidador):- Verificación oficial de RUC mediante algoritmo de Módulo 11 de SUNAT.
- Validación de DNI (8 dígitos) y consistencia de series (
F/B/E). - Cuadre aritmético estricto de bases imponibles, tributos, descuentos y total a pagar.
- Validación de reglas comerciales (ej. obligatoriedad de receptor para boletas > S/ 700.00).
- Representación Impresa y Código QR (
CpeRepresentacionImpresa): Generación estandarizada de la cadena oficial de 10 campos delimitada por pipes (|) requerida por la R.S. N.° 097-2012/SUNAT. - Extracción de DigestValue (
cpe_extraer_hash_resumen): Extracción directa del valor hash SHA-256 en Base64 para impresión en tickets y códigos de barras. - Parser de Constancias de Recepción CDR (
CpeCdr): Lectura semántica basada en eventosquick-xml, tolerante a namespaces y con captura exhaustiva de observaciones y advertencias (<cbc:Note>). - Conectividad SOAP Dual:
- Variante asíncrona (
_async) impulsada portokioyreqwest. - Variante síncrona bloqueante (
_sync) conureqpara servicios CLI o batch.
- Variante asíncrona (
- Catálogos Oficiales SUNAT: Implementación exhaustiva de los catálogos 01, 02, 06, 07, 08, 09, 10, 17, 52 y 59 con variantes abiertas
Desconocido(String)para compatibilidad hacia adelante.
Instalación
Agregue sunat_cpe a su archivo Cargo.toml:
[]
= "0.2"
= "1.36"
= "1.36"
Por defecto, se incluye el cliente asíncrono (async). Si prefiere utilizar el cliente síncrono bloqueante sin runtime de Tokio:
[]
= { = "0.2", = false, = ["blocking"] }
Guía Rápida de Uso
1. Construcción y Validación de una Factura Electrónica
use dec;
use *;
use *;
use CpeValidador;
2. Firma Digital y Extracción de Código QR
use ;
3. Empaquetado y Envío Asíncrono a SUNAT
use ;
async
Módulos de la Librería
| Módulo | Descripción |
|---|---|
cpe_catalogos |
Catálogos normativos oficiales de SUNAT (01, 02, 06, 07, 08, 09, 10, 17, 52, 59). |
cpe_modelos |
Modelos fuertemente tipados con precisión rust_decimal y trait CpeRepresentacionImpresa. |
cpe_validador |
Validador pre-vuelo con algoritmo de Módulo 11 para RUC, DNI, series y balance aritmético. |
cpe_ubl |
Generador de XML OASIS UBL 2.1 para Facturas, Boletas, Notas de Crédito y Débito. |
cpe_firma |
Criptografía nativa en Rust: XMLDSig RSA-SHA256, certificados PKCS#12 y extracción de hash. |
cpe_empaquetado |
Compresión ZIP y codificación Base64 en memoria con nomenclatura oficial de SUNAT. |
cpe_ws |
Clientes SOAP (sendBill, sendSummary, getStatus) para entornos Beta y Producción. |
cpe_cdr |
Descompresión y lectura semántica basada en eventos del XML de Constancia de Recepción. |
cpe_error |
Tipado exhaustivo de errores mediante CpeError. |
Licencia
Este proyecto está licenciado bajo cualquiera de las siguientes licencias, a su elección:
- Licencia Apache, Versión 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
- Licencia MIT (http://opensource.org/licenses/MIT)
Copyright
Copyright © 2026 César A Vergara Buenaventura <cesarvergarab@gmail.com>.