sunat_cpe 0.2.0

Librería en Rust para la generación, firma digital, validación y envío de Comprobantes de Pago Electrónicos (CPE) bajo los estándares de SUNAT (Perú).
Documentation
//! # Modelo de Nota de Débito Electrónica - `cpe_nota_debito`
//!
//! Representa un comprobante de pago electrónico tipo 08 (Nota de Débito Electrónica).

use super::cpe_comun::{
    CpeDocumentoReferencia, CpeEmisor, CpeItem, CpeLeyenda, CpeReceptor, CpeTotales,
};
use crate::cpe_catalogos::{CpeTipoDocumento, CpeTipoMoneda, CpeTipoNotaDebito};
use serde::{Deserialize, Serialize};

/// Estructura de Nota de Débito Electrónica (CPE Tipo 08).
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct CpeNotaDebito {
    /// Serie del comprobante (4 caracteres, ej. "FD01" o "BD01").
    pub serie: String,
    /// Número correlativo (1 a 8 dígitos numéricos).
    pub correlativo: u32,
    /// Fecha de emisión (YYYY-MM-DD).
    pub fecha_emision: String,
    /// Hora de emisión (HH:MM:SS).
    pub hora_emision: Option<String>,
    /// Moneda del documento.
    pub moneda: CpeTipoMoneda,
    /// Motivo / Tipo de Nota de Débito (Catálogo 10).
    pub tipo_nota_debito: CpeTipoNotaDebito,
    /// Descripción detallada del motivo de emisión.
    pub sustento_motivo: String,
    /// Documento que se modifica (Factura o Boleta afectada).
    pub documento_modificado: CpeDocumentoReferencia,
    /// Datos del emisor.
    pub emisor: CpeEmisor,
    /// Datos del adquirente / cliente.
    pub receptor: CpeReceptor,
    /// Ítems adicionados o penalidades.
    pub items: Vec<CpeItem>,
    /// Totales liquidados.
    pub totales: CpeTotales,
    /// Leyendas tributarias.
    pub leyendas: Vec<CpeLeyenda>,
}

impl CpeNotaDebito {
    /// Retorna el tipo de documento oficial (08).
    #[must_use]
    pub const fn tipo_documento(&self) -> CpeTipoDocumento {
        CpeTipoDocumento::NotaDebito
    }

    /// Genera el nombre base oficial: `{RUC}-08-{SERIE}-{CORRELATIVO}`.
    #[must_use]
    pub fn nombre_base(&self) -> String {
        format!(
            "{}-08-{}-{:08}",
            self.emisor.ruc.trim(),
            self.serie.trim(),
            self.correlativo
        )
    }

    /// Retorna el nombre de archivo `.xml`.
    #[must_use]
    pub fn nombre_archivo_xml(&self) -> String {
        format!("{}.xml", self.nombre_base())
    }

    /// Retorna el nombre de archivo `.zip`.
    #[must_use]
    pub fn nombre_archivo_zip(&self) -> String {
        format!("{}.zip", self.nombre_base())
    }
}