sunat_sire 0.2.1

Cliente y utilidades para la integración con el Sistema Integrado de Registros Electrónicos (SIRE) de SUNAT (Perú) con soporte TUS y validación PLE.
Documentation

sunat_sire

Crates.io Documentation License

Librería en Rust para la integración, consulta y gestión de información con el Sistema Integrado de Registros Electrónicos (SIRE) de la SUNAT (Perú).

Diseñada para entornos de producción, con soporte asíncrono sobre Tokio, precisión decimal exacta mediante rust_decimal y soporte nativo para el protocolo abierto de cargas masivas TUS 1.0.0.

Características Principales

  • Registro de Ventas e Ingresos Electrónico (RVIE): Consulta y aceptación de propuestas oficiales, descarga de comprobantes y generación de archivos de reemplazo.
  • Registro de Compras Electrónico (RCE): Gestión completa de compras nacionales, casillas de crédito fiscal y aceptación o reemplazo de propuestas.
  • Núcleo Común y Nomenclatura PLE (sire_comun):
    • Generador tipado de nombres de archivo PLE de 33 caracteres (SireNombreArchivoPle).
    • Empaquetador ZIP en memoria (SireEmpaquetador) con cálculo automático de hash SHA-256 (64 hex lowercase).
  • Cargas Masivas Resumibles (TUS 1.0.0):
    • Soporte para transmisión de grandes volúmenes de datos en fragmentos (chunks de 5MB configurables) con reintentos y reporte de progreso en tiempo real (SireClienteTus).
  • Autenticación OAuth 2.0 en Memoria:
    • Gestión segura de credenciales SOL (client_id, client_secret, RUC, usuario y clave SOL).
    • Almacenamiento concurrente del token Bearer con auto-refresco asíncrono no bloqueante (RwLock).
  • Catálogos Oficiales Tipados:
    • Catálogos 01 (Documentos), 02 (Comprobantes), 03 (Monedas), 11 (Afectación IGV) y Estados con soporte para std::str::FromStr y serialización Serde.
  • Monitoreo Asíncrono de Procesos:
    • Sondeo (polling) inteligente no bloqueante para tickets de procesos masivos (SireTickets).
  • Cero Pérdida de Precisión Monetaria:
    • Prohibición estricta de coma flotante (f32/f64); importes monetarios respaldados al 100% por Decimal (128 bits base 10).

Instalación

Agrega sunat_sire a tu Cargo.toml:

[dependencies]
sunat_sire = "0.2.1"
tokio = { version = "1", features = ["full"] }

O vía cargo:

cargo add sunat_sire

Ejemplo Rápido de Uso

1. Inicialización y Autenticación con Clave SOL

use sunat_sire::{SireAmbiente, SireCliente, SireConfiguracion, SireCredenciales};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let credenciales = SireCredenciales::new(
        "TU_CLIENT_ID",
        "TU_CLIENT_SECRET",
        "20123456789",
        "MODDATOS",
        "MODDATOS",
    );

    let config = SireConfiguracion::new(SireAmbiente::PruebasBeta);
    let cliente = SireCliente::new(credenciales, config)?;

    // El token OAuth 2.0 se obtiene y refresca automáticamente
    let token = cliente.obtener_token().await?;
    println!("Token Bearer vigente: {}", token);

    Ok(())
}

2. Generación de Archivo PLE y Empaquetado ZIP en Memoria

use sunat_sire::{SireLibroRegistro, SireNombreArchivoPle, SireTipoOperacionPle, sire_empaquetar_zip_en_memoria};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 1. Construir nombre oficial PLE de 33 caracteres
    let ple = SireNombreArchivoPle::new(
        "20123456789",
        2026,
        9,
        SireLibroRegistro::RvieVentas,
        SireTipoOperacionPle::Cierre,
    )?;

    println!("Nombre PLE oficial: {}", ple.generar_nombre_txt());
    // "LE2012345678920260900140400021112.txt"

    // 2. Empaquetar contenido plano en ZIP con hash SHA-256
    let contenido_txt = "20123456789|01|F001|00000001|...\n";
    let archivo_zip = sire_empaquetar_zip_en_memoria(&ple.generar_nombre_txt(), contenido_txt.as_bytes())?;

    println!("Archivo ZIP: {}", archivo_zip.nombre_archivo);
    println!("Hash SHA-256: {}", archivo_zip.hash_sha256);

    Ok(())
}

3. Carga Resumible de Grandes Volúmenes (Protocolo TUS)

use sunat_sire::{SireCliente, SireConfiguracionTus, SireMetadatosTus};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    # let cliente: SireCliente = todo!();
    let zip_bytes = vec![0u8; 1024]; // Bytes del ZIP generado
    let metadatos = SireMetadatosTus::new(
        "20123456789",
        "202609",
        "LE2012345678920260900140400021112.zip",
        "hash_sha256_hex",
    );

    let config_tus = SireConfiguracionTus::default();
    let respuesta = cliente.ejecutar_upload_tus(&config_tus, &metadatos, zip_bytes).await?;

    println!("Ticket de proceso generado: {}", respuesta.num_ticket);
    Ok(())
}

Documentación y Arquitectura

Licencia y Copyright

Copyright (c) 2026 César A Vergara Buenaventura cesarvergarab@gmail.com

Este proyecto está licenciado bajo los términos de cualquiera de las siguientes licencias, a su elección:

A menos que se indique explícitamente lo contrario, cualquier contribución enviada intencionalmente para su inclusión en este trabajo estará sujeta a la doble licencia anterior, sin términos ni condiciones adicionales.