boleto_utils/
lib.rs

1mod utils;
2pub mod cobranca;
3pub mod arrecadacao;
4pub mod builder;
5
6use serde::Serialize;
7
8use thiserror::Error;
9
10use arrecadacao::CodBarras as CodBarrasArr;
11use cobranca::CodBarras as CodBarrasCob;
12
13use crate::cobranca::Cobranca;
14use crate::arrecadacao::Arrecadacao;
15
16
17#[derive(Error, Debug)]
18pub enum BoletoError {
19    #[error("deve conter apenas números")]
20    NumbersOnly,
21    #[error("tamanho inválido")]
22    InvalidLength,
23    #[error("código moeda inválido")]
24    InvalidCodigoMoeda,
25    #[error("dígito verificador geral inválido")]
26    InvalidDigitoVerificadorGeral,
27    #[error("dígito verificador de campos inválido")]
28    InvalidDigitoVerificadorCampos,
29    #[error("código de barras de cobrança inválido")]
30    InvalidCobrancaBarcode,
31    #[error("fator de vencimento inválido")]
32    InvalidFatorVencimento,
33    #[error("código de barras de arrecadação inválido")]
34    InvalidArrecadacaoBarcode,
35    #[error("segmento inválido")]
36    InvalidSegmento,
37    #[error("tipo de valor inválido")]
38    InvalidTipoValor,
39}
40
41
42#[derive(Debug, Serialize)]
43#[serde(tag = "tipo", content = "dados")]
44pub enum Boleto {
45    #[serde(rename = "arrecadacao")]
46    Arrecadacao(Arrecadacao),
47    #[serde(rename = "cobranca")]
48    Cobranca(Cobranca),
49}
50
51impl std::fmt::Display for Boleto {
52    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
53        write!(f, "{}", match self {
54            Self::Arrecadacao(dados) => format!("{dados}"),
55            Self::Cobranca(dados) => format!("{dados}"),
56        })
57    }
58}
59
60impl Boleto {
61    pub fn new(value: &[u8]) -> Result<Self, BoletoError> {
62        match value.first() {
63            None => Err(BoletoError::InvalidLength),
64            Some(b'8') => Ok(Boleto::Arrecadacao(Arrecadacao::new(value)?)),
65            _ => Ok(Boleto::Cobranca(Cobranca::new(value)?)),
66        }
67    }
68
69    pub fn calculate_digito_verificador(value: &[u8]) -> Result<u8, BoletoError> {
70        match value.first() {
71            None => Err(BoletoError::InvalidLength),
72            Some(b'8') => Ok(CodBarrasArr::new(value)?.calculate_dv()),
73            _ => Ok(CodBarrasCob::new(value)?.calculate_dv()),
74        }
75    }
76}
77
78#[cfg(test)]
79mod tests {
80    use chrono::NaiveDate;
81    use crate::Boleto;
82
83    #[test]
84    fn valid_barcode() {
85        let barcode = b"10499898100000214032006561000100040099726390";
86
87        let boleto = Boleto::new(barcode).unwrap();
88
89        match boleto {
90            Boleto::Cobranca(cob) => {
91                assert_eq!(
92                    cob.data_vencimento,
93                    Some(NaiveDate::from_ymd_opt(2022, 5, 10).unwrap())
94                );
95                assert_eq!(cob.valor, Some(214.03));
96            },
97            _ => panic!("Should be Cobranca"),
98        }
99    }
100}
boleto_utils/lib.rs

boleto_utils/
lib.rs
