Korrektur Buchungstexte bei Auslagenerstattungen

app/Models/Invoice.php

@@ -71,6 +71,26 @@ class Invoice extends InstancedModel
         'denied_reason',
     ];
 
+    /**
+     * Der Verwendungszweck für Überweisung, Buchungstext und Anzeige.
+     *
+     * Der Freitext gewinnt, wenn einer erfasst wurde. Sonst benennt der Text den Vorgang: eine
+     * Beitragserstattung ist keine Auslage des Teilis, sondern die Rücknahme seiner Zahlung -- auf dem
+     * Kontoauszug muss der Unterschied erkennbar sein. Genannt wird die Abrechnungsnummer, und zwar als
+     * Belegnummer: unter "Rechnungsnummer" gibt es sie nirgends.
+     */
+    public function paymentPurposeText() : string {
+        if ($this->payment_purpose !== null) {
+            return $this->payment_purpose;
+        }
+
+        $subject = $this->type === InvoiceType::INVOICE_TYPE_PARTICIPATION_REFUND
+            ? 'Beitragserstattung'
+            : 'Auslagenerstattung';
+
+        return $subject . ' Belegnummer ' . $this->invoice_number;
+    }
+
     public function costUnit() : BelongsTo{
         return $this->belongsTo(CostUnit::class);
     }