sunat_sire
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).
- Generador tipado de nombres de archivo PLE de 33 caracteres (
- 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).
- 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 (
- 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).
- Gestión segura de credenciales SOL (
- Catálogos Oficiales Tipados:
- Catálogos 01 (Documentos), 02 (Comprobantes), 03 (Monedas), 11 (Afectación IGV) y Estados con soporte para
std::str::FromStry serialización Serde.
- Catálogos 01 (Documentos), 02 (Comprobantes), 03 (Monedas), 11 (Afectación IGV) y Estados con soporte para
- Monitoreo Asíncrono de Procesos:
- Sondeo (polling) inteligente no bloqueante para tickets de procesos masivos (
SireTickets).
- Sondeo (polling) inteligente no bloqueante para tickets de procesos masivos (
- Cero Pérdida de Precisión Monetaria:
- Prohibición estricta de coma flotante (
f32/f64); importes monetarios respaldados al 100% porDecimal(128 bits base 10).
- Prohibición estricta de coma flotante (
Instalación
Agrega sunat_sire a tu Cargo.toml:
[]
= "0.2.1"
= { = "1", = ["full"] }
O vía cargo:
Ejemplo Rápido de Uso
1. Inicialización y Autenticación con Clave SOL
use ;
async
2. Generación de Archivo PLE y Empaquetado ZIP en Memoria
use ;
3. Carga Resumible de Grandes Volúmenes (Protocolo TUS)
use ;
async
Documentación y Arquitectura
- Documentación de la API: docs.rs/sunat_sire
- Manual Técnico:
docs/MANUAL_TECNICO.md - Diagrama Interactivo de Arquitectura:
docs/arquitectura-sire.html
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:
- Licencia Apache, Versión 2.0 (LICENSE-APACHE o https://www.apache.org/licenses/LICENSE-2.0)
- Licencia MIT (LICENSE-MIT o https://opensource.org/licenses/MIT)
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.