nfe-parser 1.0.0

Biblioteca Rust de alto desempenho para parsing e serialização de Nota Fiscal Eletrônica (NF-e) brasileira - Layout 4.00 SEFAZ
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

//! IPI - Imposto sobre Produtos Industrializados
//!
//! Este módulo implementa as estruturas para representar o IPI na NF-e,
//! conforme definido no layout 4.00 da SEFAZ.
//!
//! ## Códigos de Situação Tributária (CST) do IPI
//!
//! | CST | Descrição |
//! |-----|-----------|
//! | 00 | Entrada com recuperação de crédito |
//! | 01 | Entrada tributada com alíquota zero |
//! | 02 | Entrada isenta |
//! | 03 | Entrada não tributada |
//! | 04 | Entrada imune |
//! | 05 | Entrada com suspensão |
//! | 49 | Outras entradas |
//! | 50 | Saída tributada |
//! | 51 | Saída tributada com alíquota zero |
//! | 52 | Saída isenta |
//! | 53 | Saída não tributada |
//! | 54 | Saída imune |
//! | 55 | Saída com suspensão |
//! | 99 | Outras saídas |

use serde::{Deserialize, Serialize};

/// Container para os grupos de IPI (tag `<IPI>`)
///
/// O IPI é informado através de grupos exclusivos, onde apenas UM grupo
/// deve estar presente por item, dependendo do CST aplicável.
#[derive(Debug, PartialEq, Clone, Serialize, Deserialize)]
pub struct IpiContainer {
    /// Classe de enquadramento do IPI para Cigarros e Bebidas (opcional)
    #[serde(rename = "$unflatten=clEnq")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub classe_enquadramento: Option<String>,

    /// CNPJ do produtor da mercadoria, quando diferente do emitente
    #[serde(rename = "$unflatten=CNPJProd")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub cnpj_produtor: Option<String>,

    /// Código do selo de controle IPI
    #[serde(rename = "$unflatten=cSelo")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub codigo_selo: Option<String>,

    /// Quantidade de selo de controle
    #[serde(rename = "$unflatten=qSelo")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub quantidade_selo: Option<u32>,

    /// Código de Enquadramento Legal do IPI
    #[serde(rename = "$unflatten=cEnq")]
    pub codigo_enquadramento: String,

    /// IPI tributado (CST 00, 49, 50, 99)
    #[serde(rename = "IPITrib")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub ipi_trib: Option<IpiTrib>,

    /// IPI não tributado (CST 01, 02, 03, 04, 05, 51, 52, 53, 54, 55)
    #[serde(rename = "IPINT")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub ipi_nt: Option<IpiNt>,
}

/// IPI Tributado (tag `<IPITrib>`)
///
/// Usado para CSTs: 00, 49, 50, 99
///
/// ## Formas de Cálculo
///
/// **Por alíquota (ad valorem):**
/// ```text
/// vIPI = vBC × pIPI / 100
/// ```
///
/// **Por quantidade (específico):**
/// ```text
/// vIPI = qUnid × vUnid
/// ```
#[derive(Debug, PartialEq, Clone, Serialize, Deserialize)]
pub struct IpiTrib {
    /// Código de Situação Tributária do IPI
    #[serde(rename = "$unflatten=CST")]
    pub cst: String,

    /// Valor da Base de Cálculo do IPI (cálculo por alíquota)
    #[serde(rename = "$unflatten=vBC")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub valor_bc: Option<f32>,

    /// Alíquota do IPI em percentual (cálculo por alíquota)
    #[serde(rename = "$unflatten=pIPI")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub aliquota: Option<f32>,

    /// Quantidade total na unidade padrão para tributação (cálculo por quantidade)
    #[serde(rename = "$unflatten=qUnid")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub quantidade_unidade: Option<f32>,

    /// Valor por unidade tributável (cálculo por quantidade)
    #[serde(rename = "$unflatten=vUnid")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub valor_unidade: Option<f32>,

    /// Valor do IPI
    #[serde(rename = "$unflatten=vIPI")]
    pub valor: f32,
}

/// IPI Não Tributado (tag `<IPINT>`)
///
/// Usado para CSTs: 01, 02, 03, 04, 05, 51, 52, 53, 54, 55
#[derive(Debug, PartialEq, Clone, Serialize, Deserialize)]
pub struct IpiNt {
    /// Código de Situação Tributária do IPI
    #[serde(rename = "$unflatten=CST")]
    pub cst: String,
}

impl Default for IpiContainer {
    fn default() -> Self {
        Self {
            classe_enquadramento: None,
            cnpj_produtor: None,
            codigo_selo: None,
            quantidade_selo: None,
            codigo_enquadramento: "999".to_string(),
            ipi_trib: None,
            ipi_nt: None,
        }
    }
}