bo4e_core/bo/
business_partner.rs

1//! Business partner (Geschaeftspartner) business object.
2
3use serde::{Deserialize, Serialize};
4
5use crate::com::{Address, ContactMethod};
6use crate::enums::BusinessPartnerRole;
7use crate::traits::{Bo4eMeta, Bo4eObject};
8
9/// A business partner (company or organization).
10///
11/// German: Geschaeftspartner
12///
13/// # Example
14///
15/// ```rust
16/// use bo4e_core::bo::BusinessPartner;
17/// use bo4e_core::enums::BusinessPartnerRole;
18///
19/// let partner = BusinessPartner {
20///     name1: Some("Stadtwerke Musterstadt GmbH".to_string()),
21///     roles: vec![BusinessPartnerRole::Supplier],
22///     ..Default::default()
23/// };
24/// ```
25#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize)]
26#[serde(rename_all = "camelCase")]
27pub struct BusinessPartner {
28    /// BO4E metadata
29    #[serde(flatten)]
30    pub meta: Bo4eMeta,
31
32    /// Partner ID (Geschaeftspartner-ID)
33    #[serde(skip_serializing_if = "Option::is_none", alias = "geschaeftspartnerId")]
34    pub partner_id: Option<String>,
35
36    /// Company/organization name (Name1)
37    #[serde(skip_serializing_if = "Option::is_none")]
38    pub name1: Option<String>,
39
40    /// Additional name line (Name2)
41    #[serde(skip_serializing_if = "Option::is_none")]
42    pub name2: Option<String>,
43
44    /// Additional name line (Name3)
45    #[serde(skip_serializing_if = "Option::is_none")]
46    pub name3: Option<String>,
47
48    /// Roles this partner has (Rollen)
49    #[serde(
50        default,
51        skip_serializing_if = "Vec::is_empty",
52        alias = "geschaeftspartnerrollen"
53    )]
54    pub roles: Vec<BusinessPartnerRole>,
55
56    /// Primary address (Adresse)
57    #[serde(skip_serializing_if = "Option::is_none", alias = "adresse")]
58    pub address: Option<Address>,
59
60    /// Contact methods (Kontaktwege)
61    #[serde(default, skip_serializing_if = "Vec::is_empty", alias = "kontaktwege")]
62    pub contact_methods: Vec<ContactMethod>,
63
64    /// Commercial register number (Handelsregisternummer)
65    #[serde(
66        skip_serializing_if = "Option::is_none",
67        alias = "handelsregisternummer"
68    )]
69    pub commercial_register_number: Option<String>,
70
71    /// Tax ID (Steuernummer)
72    #[serde(skip_serializing_if = "Option::is_none", alias = "steuernummer")]
73    pub tax_id: Option<String>,
74
75    /// VAT ID (Umsatzsteuer-ID)
76    #[serde(skip_serializing_if = "Option::is_none", alias = "umsatzsteuerId")]
77    pub vat_id: Option<String>,
78}
79
80impl Bo4eObject for BusinessPartner {
81    fn type_name_german() -> &'static str {
82        "Geschaeftspartner"
83    }
84
85    fn type_name_english() -> &'static str {
86        "BusinessPartner"
87    }
88
89    fn meta(&self) -> &Bo4eMeta {
90        &self.meta
91    }
92
93    fn meta_mut(&mut self) -> &mut Bo4eMeta {
94        &mut self.meta
95    }
96}
97
98#[cfg(test)]
99mod tests {
100    use super::*;
101
102    #[test]
103    fn test_supplier_partner() {
104        let partner = BusinessPartner {
105            name1: Some("Stadtwerke Musterstadt GmbH".to_string()),
106            roles: vec![BusinessPartnerRole::Supplier],
107            ..Default::default()
108        };
109
110        assert!(partner.roles.contains(&BusinessPartnerRole::Supplier));
111    }
112
113    #[test]
114    fn test_multiple_roles() {
115        let partner = BusinessPartner {
116            name1: Some("Multi-Utility AG".to_string()),
117            roles: vec![
118                BusinessPartnerRole::Supplier,
119                BusinessPartnerRole::NetworkOperator,
120            ],
121            ..Default::default()
122        };
123
124        assert_eq!(partner.roles.len(), 2);
125    }
126
127    #[test]
128    fn test_serialize() {
129        let partner = BusinessPartner {
130            meta: Bo4eMeta::with_type("Geschaeftspartner"),
131            name1: Some("Test GmbH".to_string()),
132            vat_id: Some("DE123456789".to_string()),
133            ..Default::default()
134        };
135
136        let json = serde_json::to_string(&partner).unwrap();
137        assert!(json.contains(r#""name1":"Test GmbH""#));
138        assert!(json.contains(r#""vatId":"DE123456789""#));
139    }
140
141    #[test]
142    fn test_roundtrip() {
143        let partner = BusinessPartner {
144            meta: Bo4eMeta::with_type("Geschaeftspartner"),
145            partner_id: Some("GP-001".to_string()),
146            name1: Some("Test GmbH".to_string()),
147            name2: Some("Abteilung Energie".to_string()),
148            roles: vec![BusinessPartnerRole::Supplier],
149            vat_id: Some("DE123456789".to_string()),
150            tax_id: Some("12345/67890".to_string()),
151            ..Default::default()
152        };
153
154        let json = serde_json::to_string(&partner).unwrap();
155        let parsed: BusinessPartner = serde_json::from_str(&json).unwrap();
156        assert_eq!(partner, parsed);
157    }
158
159    #[test]
160    fn test_bo4e_object_impl() {
161        assert_eq!(BusinessPartner::type_name_german(), "Geschaeftspartner");
162        assert_eq!(BusinessPartner::type_name_english(), "BusinessPartner");
163    }
164}
bo4e_core/bo/business_partner.rs

bo4e_core/bo/
business_partner.rs
