Struct PaymentReminder 

pub struct PaymentReminder {

    pub id: Uuid,
    pub acp_id: Uuid,
    pub organization_id: Uuid,
    pub expense_id: Uuid,
    pub owner_id: Uuid,
    pub level: ReminderLevel,
    pub status: ReminderStatus,
    pub amount_owed: Decimal,
    pub penalty_amount: Decimal,
    pub total_amount: Decimal,
    pub due_date: DateTime<Utc>,
    pub days_overdue: i64,
    pub delivery_method: DeliveryMethod,
    pub sent_date: Option<DateTime<Utc>>,
    pub opened_date: Option<DateTime<Utc>>,
    pub pdf_path: Option<String>,
    pub tracking_number: Option<String>,
    pub notes: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Représente une relance de paiement pour charges impayées

Fields

id: Uuid

acp_id: Uuid

L’ACP au profit de laquelle la somme est réclamée.

Art. 3.86 § 3 : « Le syndic peut prendre toutes les mesures judiciaires et extrajudiciaires pour la récupération des charges ». Il recouvre pour l’association ; la créance et les pénalités lui reviennent. Cf. ADR-0045.

organization_id: Uuid

Le syndic qui a émis la relance, conservé comme trace d’auteur.

expense_id: Uuid

owner_id: Uuid

level: ReminderLevel

status: ReminderStatus

amount_owed: Decimal

Montant dû (en euros). Decimal — ADR-0007/0008 : montant opposable.

penalty_amount: Decimal

Pénalités de retard (taux légal civil belge, 4,5 % annuel en 2026).

total_amount: Decimal

Montant total (amount_owed + penalty_amount). L’égalité est garantie par un CHECK en base, exact depuis le passage en NUMERIC.

due_date: DateTime<Utc>

days_overdue: i64

delivery_method: DeliveryMethod

sent_date: Option<DateTime<Utc>>

opened_date: Option<DateTime<Utc>>

pdf_path: Option<String>

tracking_number: Option<String>

notes: Option<String>

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl PaymentReminder

pub const BELGIAN_PENALTY_RATE: Decimal

Taux légal civil de pénalité de retard en Belgique (Moniteur belge) Ce taux est publié annuellement par Arrêté Royal. 2024: 5.25%, 2025: 4.0%, 2026: 4.5% A mettre à jour chaque année selon publication au Moniteur belge.

pub fn new( acp_id: Uuid, organization_id: Uuid, expense_id: Uuid, owner_id: Uuid, level: ReminderLevel, amount_owed: Decimal, due_date: DateTime<Utc>, days_overdue: i64, ) -> Result<Self, String>

Crée une nouvelle relance de paiement

pub fn calculate_penalty(amount: Decimal, days_overdue: i64) -> Decimal

Calcule les pénalités de retard selon le taux légal civil belge (4,5 % annuel en 2026).

Formule : pénalité = montant × 0,045 × (jours_retard / 365), arrondie au centime.

Calcul en Decimal (suite #661) : c’est un montant réclamé à un copropriétaire, et l’ancienne version arrondissait via (x * 100.0).round() / 100.0 en f64 — un motif qui produit des écarts d’un centime sur des valeurs parfaitement ordinaires, et qui n’arrondit pas au plus proche de façon fiable près des demis.

L’arrondi est MidpointAwayFromZero (arrondi commercial : 0,005 € donne 0,01 €), et non le « banker’s rounding » que round_dp applique par défaut : sur une somme due, arrondir la moitié vers le pair n’a aucun fondement, et diverge de ce que produit un tableur.

pub fn mark_as_sent(&mut self, pdf_path: Option<String>) -> Result<(), String>

Marque la relance comme envoyée

pub fn mark_as_opened(&mut self) -> Result<(), String>

Marque la relance comme ouverte (email ouvert)

pub fn mark_as_paid(&mut self) -> Result<(), String>

Marque la relance comme payée

pub fn can_escalate(&self) -> Result<(), String>

Escalade vers le niveau de relance supérieur Vérifie sans muter qu’une escalade est permise.

Extrait de escalate pour que l’appelant puisse contrôler l’ordre : la couche application doit refuser un dossier soldé AVANT de construire le niveau suivant, sinon un dossier payé se voit reprocher son délai plutôt que son statut — un message qui envoie chercher le problème au mauvais endroit.

pub fn escalate(&mut self) -> Result<Option<ReminderLevel>, String>

pub fn cancel(&mut self, reason: String) -> Result<(), String>

Annule la relance (paiement reçu avant envoi)

pub fn set_tracking_number( &mut self, tracking_number: String, ) -> Result<(), String>

Ajoute un numéro de suivi (pour lettre recommandée)

pub fn needs_escalation(&self, current_date: DateTime<Utc>) -> bool

Vérifie si la relance nécessite une escalade

pub fn recalculate_penalties(&mut self, current_days_overdue: i64)

Recalcule les pénalités en fonction du nombre de jours actuel

Trait Implementations

impl Clone for PaymentReminder

fn clone(&self) -> PaymentReminder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PaymentReminder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PaymentReminder

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<PaymentReminder> for PaymentReminderResponseDto

fn from(reminder: PaymentReminder) -> Self

Converts to this type from the input type.

impl PartialEq for PaymentReminder

fn eq(&self, other: &PaymentReminder) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PieceDeGestion for PaymentReminder

fn acp_id(&self) -> Uuid

L’ACP dont relève la pièce. C’est elle qui en est propriétaire.

impl Serialize for PaymentReminder

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PaymentReminder