use std::fmt;
use serde::{Deserialize, Serialize};
use serde_json::Value;
use crate::core::models::buyer_portal::InvoiceParty;
pub type InvoiceKind = String;
pub type InvoiceDocumentStatus = String;
pub type InvoiceSourceKind = String;
pub type InvoiceLineRole = String;
pub type InvoiceLineTaxSource = String;
pub type InvoiceNoTaxRuleReason = String;
pub type InvoiceEmailOrigin = String;
pub type InvoiceEmailStatus = String;
pub type InvoiceEmailDeliveryStatus = String;
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[non_exhaustive]
pub struct InvoiceNoTaxReason {
pub kind: String,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub provision: Option<String>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
impl InvoiceNoTaxReason {
fn of_kind(kind: &str, provision: Option<String>) -> Self {
Self {
kind: kind.to_string(),
provision,
extra: serde_json::Map::new(),
}
}
pub fn reverse_charge() -> Self {
Self::of_kind("reverse_charge", None)
}
pub fn exempt(provision: impl Into<String>) -> Self {
Self::of_kind("exempt", Some(provision.into()))
}
pub fn small_business() -> Self {
Self::of_kind("small_business", None)
}
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct InvoiceLine {
pub id: String,
pub position: i32,
pub description: String,
pub quantity: i64,
pub unit_net_amount: i64,
pub line_net_amount: i64,
#[serde(default)]
pub tax_rate_bp: Option<i32>,
#[serde(default)]
pub tax_amount: Option<i64>,
#[serde(default)]
pub tax_exemption_note: Option<String>,
pub gross_amount: i64,
#[serde(default)]
pub product_id: Option<String>,
#[serde(default)]
pub price_id: Option<String>,
#[serde(default)]
pub line_role: Option<InvoiceLineRole>,
#[serde(default)]
pub parent_line_id: Option<String>,
#[serde(default)]
pub included: bool,
#[serde(default)]
pub source_payment_line_id: Option<String>,
#[serde(default)]
pub corrects_line_id: Option<String>,
#[serde(default)]
pub tax_source: Option<InvoiceLineTaxSource>,
#[serde(default)]
pub tax_category: Option<String>,
#[serde(default)]
pub tax_rule_id: Option<String>,
#[serde(default)]
pub tax_rule_name: Option<String>,
#[serde(default)]
pub tax_label: Option<String>,
#[serde(default)]
pub tax_rule_note: Option<String>,
#[serde(default)]
pub tax_reason: Option<InvoiceNoTaxRuleReason>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct InvoiceCreditNoteSummary {
pub id: String,
#[serde(default)]
pub document_number: Option<String>,
pub status: InvoiceDocumentStatus,
pub gross_amount: i64,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct InvoiceTaxReporting {
pub currency: String,
#[serde(default)]
pub tax_amount: Option<i64>,
#[serde(default)]
pub rate: Option<String>,
#[serde(default)]
pub source: Option<String>,
#[serde(default)]
pub rate_date: Option<String>,
pub unavailable: bool,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct InvoiceProcessorTax {
pub source: String,
pub amount: i64,
pub currency: String,
pub inclusive: bool,
#[serde(default)]
pub rate_bp: Option<i32>,
#[serde(default)]
pub country: Option<String>,
#[serde(default)]
pub region: Option<String>,
pub merchant_of_record: bool,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct InvoiceTaxWarning {
pub code: String,
pub message: String,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct InvoiceRefundSummary {
pub refunded_amount: i64,
pub credited_amount: i64,
pub refunded_not_credited: i64,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct MerchantInvoiceDocument {
pub id: String,
pub merchant_id: String,
pub profile_id: String,
pub kind: InvoiceKind,
pub status: InvoiceDocumentStatus,
pub source: InvoiceSourceKind,
#[serde(default)]
pub payment_id: Option<String>,
#[serde(default)]
pub subscription_id: Option<String>,
#[serde(default)]
pub subscription_invoice_id: Option<String>,
#[serde(default)]
pub corrects_invoice_id: Option<String>,
pub test_mode: bool,
#[serde(default)]
pub document_number: Option<String>,
#[serde(default)]
pub number: Option<i64>,
#[serde(default)]
pub series: Option<String>,
#[serde(default)]
pub issued_at: Option<String>,
pub supply_date: String,
#[serde(default)]
pub period_start: Option<String>,
#[serde(default)]
pub period_end: Option<String>,
#[serde(default)]
pub due_date: Option<String>,
pub seller: InvoiceParty,
pub buyer: InvoiceParty,
pub currency: String,
pub net_amount: i64,
#[serde(default)]
pub tax_amount: Option<i64>,
pub gross_amount: i64,
#[serde(default)]
pub paid_amount: Option<i64>,
#[serde(default)]
pub no_tax_reason: Option<InvoiceNoTaxReason>,
#[serde(default)]
pub notes: Option<String>,
pub locale: String,
#[serde(default)]
pub void_reason: Option<String>,
#[serde(default)]
pub tax_reporting: Option<InvoiceTaxReporting>,
#[serde(default)]
pub processor_tax: Option<InvoiceProcessorTax>,
#[serde(default)]
pub tax_warnings: Vec<InvoiceTaxWarning>,
#[serde(default)]
pub refund: Option<InvoiceRefundSummary>,
#[serde(default)]
pub lines: Vec<InvoiceLine>,
#[serde(default)]
pub credit_notes: Vec<InvoiceCreditNoteSummary>,
pub created_at: String,
pub modified_at: String,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct InvoiceList {
#[serde(default)]
pub data: Vec<MerchantInvoiceDocument>,
pub total_count: i64,
pub limit: i64,
pub offset: i64,
#[serde(default)]
pub merchant_of_record: Option<String>,
#[serde(default)]
pub refunded_amount: Option<i64>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Clone, Deserialize)]
#[non_exhaustive]
pub struct InvoiceShareLink {
pub url: String,
pub expires_at: String,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
impl fmt::Debug for InvoiceShareLink {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.debug_struct("InvoiceShareLink")
.field("url", &"<redacted>")
.field("expires_at", &self.expires_at)
.finish_non_exhaustive()
}
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct InvoiceEmailDelivery {
pub id: String,
pub invoice_id: String,
pub template_id: String,
pub revision: i32,
pub origin: InvoiceEmailOrigin,
pub status: InvoiceEmailStatus,
#[serde(default)]
pub recipient: Option<String>,
#[serde(default)]
pub locale: Option<String>,
pub test_mode: bool,
pub attempts: i32,
#[serde(default)]
pub provider_message_id: Option<String>,
#[serde(default)]
pub error_code: Option<String>,
#[serde(default)]
pub error_message: Option<String>,
pub created_at: String,
pub modified_at: String,
#[serde(default)]
pub sent_at: Option<String>,
#[serde(default)]
pub delivery_status: Option<InvoiceEmailDeliveryStatus>,
#[serde(default)]
pub delivery_detail: Option<String>,
#[serde(default)]
pub delivery_updated_at: Option<String>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct InvoiceEmailDeliveryList {
#[serde(default)]
pub data: Vec<InvoiceEmailDelivery>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn party_debug_prints_no_personal_data() {
let party: InvoiceParty = serde_json::from_str(
r#"{"country":"DE","name":"Erika Muster","address":"Hauptstr. 1",
"email":"erika@example.com","vat_id":"DE123456789"}"#,
)
.unwrap();
let out = format!("{party:?}");
assert!(out.contains("DE"));
for secret in ["Erika", "Hauptstr", "erika@example.com", "DE123456789"] {
assert!(!out.contains(secret), "Debug leaked `{secret}`: {out}");
}
}
#[test]
fn share_link_debug_redacts_the_url() {
let link: InvoiceShareLink = serde_json::from_str(
r#"{"url":"https://api.test/invoice-documents/m/inv/pdf?token=tok_secret",
"expires_at":"2026-01-08T00:00:00Z"}"#,
)
.unwrap();
let out = format!("{link:?}");
assert!(!out.contains("tok_secret"), "Debug leaked the link: {out}");
assert!(out.contains("2026-01-08"));
}
#[test]
fn no_tax_reason_serializes_as_the_tagged_object() {
assert_eq!(
serde_json::to_value(InvoiceNoTaxReason::exempt("Art. 132")).unwrap(),
serde_json::json!({"kind":"exempt","provision":"Art. 132"})
);
assert_eq!(
serde_json::to_value(InvoiceNoTaxReason::reverse_charge()).unwrap(),
serde_json::json!({"kind":"reverse_charge"})
);
}
}