fiscal 0.6.0

Brazilian fiscal document library (NF-e/NFC-e) — Rust port of sped-nfe
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

use fiscal::complement::{attach_inutilizacao, attach_protocol};

const SAMPLE_NFE_XML: &str = "\
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\
<NFe xmlns=\"http://www.portalfiscal.inf.br/nfe\">\
<infNFe xmlns=\"http://www.portalfiscal.inf.br/nfe\" versao=\"4.00\" Id=\"NFe35260112345678000199650010000000011123456780\">\
<ide><cUF>35</cUF></ide>\
</infNFe>\
<Signature xmlns=\"http://www.w3.org/2000/09/xmldsig#\">\
<SignedInfo><Reference><DigestValue>abc123digest==</DigestValue></Reference></SignedInfo>\
<SignatureValue>sig==</SignatureValue>\
</Signature>\
</NFe>";

const SAMPLE_PROTOCOL_XML: &str = "\
<retEnviNFe xmlns=\"http://www.portalfiscal.inf.br/nfe\" versao=\"4.00\">\
<tpAmb>2</tpAmb>\
<cStat>104</cStat>\
<protNFe versao=\"4.00\">\
<infProt>\
<cStat>100</cStat>\
<xMotivo>Autorizado o uso da NF-e</xMotivo>\
<chNFe>35260112345678000199650010000000011123456780</chNFe>\
<digVal>abc123digest==</digVal>\
<nProt>141260000000001</nProt>\
<dhRecbto>2026-01-15T10:30:00-03:00</dhRecbto>\
</infProt>\
</protNFe>\
</retEnviNFe>";

// ── attachProtocol ──────────────────────────────────────────────────────────

mod attach_protocol_tests {
    use super::*;

    #[test]
    fn creates_nfe_proc_wrapper_with_nfe_and_prot_nfe() {
        let result = attach_protocol(SAMPLE_NFE_XML, SAMPLE_PROTOCOL_XML).expect("should succeed");
        assert!(result.contains("<nfeProc"));
        assert!(result.contains("versao=\"4.00\""));
        assert!(result.contains("<NFe"));
        assert!(result.contains("<protNFe"));
        assert!(result.contains("</nfeProc>"));
    }

    #[test]
    fn preserves_original_nfe_content() {
        let result = attach_protocol(SAMPLE_NFE_XML, SAMPLE_PROTOCOL_XML).expect("should succeed");
        assert!(result.contains("<cUF>35</cUF>"));
        assert!(result.contains("abc123digest=="));
    }

    #[test]
    fn includes_protocol_number() {
        let result = attach_protocol(SAMPLE_NFE_XML, SAMPLE_PROTOCOL_XML).expect("should succeed");
        assert!(result.contains("141260000000001"));
    }

    #[test]
    fn errors_on_empty_request_xml() {
        let result = attach_protocol("", SAMPLE_PROTOCOL_XML);
        assert!(result.is_err(), "empty request XML should return Err");
    }

    #[test]
    fn errors_on_empty_response_xml() {
        let result = attach_protocol(SAMPLE_NFE_XML, "");
        assert!(result.is_err(), "empty response XML should return Err");
    }

    #[test]
    fn errors_when_nfe_tag_is_missing() {
        let result = attach_protocol("<root>no nfe</root>", SAMPLE_PROTOCOL_XML);
        assert!(result.is_err(), "missing NFe tag should return Err");
    }

    #[test]
    fn rejects_mismatched_digest() {
        let mismatch_protocol = SAMPLE_PROTOCOL_XML
            .replace(
                "35260112345678000199650010000000011123456780",
                "99999999999999999999999999999999999999999999",
            )
            .replace("abc123digest==", "wrongdigest==");
        // PHP parity: rejects when digest values do not match
        let result = attach_protocol(SAMPLE_NFE_XML, &mismatch_protocol);
        assert!(result.is_err(), "should fail when digests do not match");
    }
}

// ── attachInutilizacao ──────────────────────────────────────────────────────

mod attach_inutilizacao_tests {
    use super::*;

    #[test]
    fn creates_proc_inut_nfe_wrapper() {
        let inut_request = "\
<inutNFe xmlns=\"http://www.portalfiscal.inf.br/nfe\" versao=\"4.00\">\
<infInut><cStat>102</cStat></infInut>\
</inutNFe>";

        let inut_response = "\
<retInutNFe xmlns=\"http://www.portalfiscal.inf.br/nfe\" versao=\"4.00\">\
<infInut><cStat>102</cStat><xMotivo>Inutilizacao homologada</xMotivo></infInut>\
</retInutNFe>";

        let result = attach_inutilizacao(inut_request, inut_response).expect("should succeed");
        assert!(result.contains("<ProcInutNFe"));
        assert!(result.contains("<inutNFe"));
        assert!(result.contains("<retInutNFe"));
        assert!(result.contains("</ProcInutNFe>"));
    }
}