Calculation errors for refunded amounts

2026-09-04 01:15:37 +02:00
parent 5beb2b1d97
commit c1c1a4f143
28 changed files with 1436 additions and 26 deletions
@@ -104,6 +104,26 @@ class CreateRefundDocumentCommand
     * Fallback stünde hier ein Fatal Error auf `null` -- so steht es heute im Deckblatt-Code der
     * Auslagenerstattung, und daran soll sich der Beleg kein Beispiel nehmen.
     */
+    /**
+     * Der Hinweis, warum ein Teil des Beitrags beim Verband bleibt -- leer bei voller Erstattung.
+     *
+     * Der Beleg wandert in die Buchhaltung und ins Archiv; dort muss die Differenz zwischen gezahltem
+     * und erstattetem Betrag ohne Rückfrage erklärt sein.
+     */
+    private function retentionNote(): string
+    {
+        if (!$this->refund->hasRetention()) {
+            return '';
+        }
+
+        $text = trim($this->refund->retentionReasonText());
+        $label = $this->refund->retentionReasonLabel();
+
+        return $text !== '' && $text !== $label
+            ? sprintf('%s (%s)', $label, $text)
+            : $label;
+    }
+
    /**
     * Der Vermerk, wenn die Aktionsleitung die Angaben aufgenommen hat.
     *
@@ -199,6 +219,9 @@ class CreateRefundDocumentCommand
            'account_owner' => (string) $refund->account_owner,
            'account_iban' => $this->formatIban((string) $refund->account_iban),

+            'retained_amount' => $this->money($refund->retained_amount?->getAmount() ?? 0.0),
+            'retention_note' => $this->retentionNote(),
+
            'declaration_text' => $this->declarationText(),
            'capture_note' => $this->captureNote(),

@@ -242,6 +265,13 @@ class CreateRefundDocumentCommand
            $rows[] = ['Begründung', e($reasonText)];
        }

+        // Nur bei einer Teilerstattung: Ohne diese Zeile bliebe die Differenz zwischen gezahltem und
+        // erstattetem Betrag im Beleg unerklärt.
+        if ($refund->hasRetention()) {
+            $rows[] = ['Einbehalten', $this->money($refund->retained_amount?->getAmount() ?? 0.0)];
+            $rows[] = ['Grund der Einbehaltung', e($this->retentionNote())];
+        }
+
        $rows[] = ['Kontoinhaber*in', e((string) $refund->account_owner)];
        $rows[] = ['IBAN', e($this->formatIban((string) $refund->account_iban))];