Generierung von monatlichen Kontoauszügen als PDF-Dokumente

Das Problem der statischen und manuellen Dokumentenlieferung

Wenn ein Versicherungsnehmer anruft, um seine aktuelle Deckblätterseite zu erfragen, oder ein Bankkunde ein Support-Ticket eröffnet, um eine dreimonatige Aufstellung anzufordern, landet die Anfrage auf dem Schreibtisch eines Mitarbeiters. Diese Person fragt ein System ab, formatiert ein Dokument und sendet es per E-Mail zurück, manchmal am selben Tag, manchmal 48 Stunden später. Bei Tausenden von Kunden skaliert dieser Arbeitsablauf nicht, und jede abgewickelte Anfrage ist eine, die ein Selbstbedienungsportal überflüssig gemacht haben sollte.

Die Alternativen, zu denen Organisationen greifen, neigen dazu, ein Problem gegen ein anderes einzutauschen. Vor-generierte PDFs für jeden Kunden über einen nächtlichen Zeitplan produzieren einen Berg von Dokumenten, die möglicherweise nie heruntergeladen werden, und jedes von ihnen beginnt zu veralten, sobald sich die zugrunde liegenden Daten ändern. Ein Kunde, der seine Zahlungsmethode aktualisiert oder seine Deckungskategorie ändert, kann ein PDF herunterladen, das sein Konto nicht mehr widerspiegelt, und dennoch den Support kontaktieren.

Drittanbieter-Dokumentenerzeugungs-APIs bieten On-Demand-Rendering, fügen jedoch Pro-Anforderungs-Kosten hinzu, die direkt mit dem Portaltraffik skalieren, plus eine Netzwerkabhängigkeit, die im kritischen Pfad einer benutzerorientierten Aktion sitzt. Ein Bankportal, das 200.000 Kontoauszüge pro Monat sendet, möchte das nicht auf einer gemessenen API.

Die Erwartung des Benutzers ist einfach: Eine "PDF herunterladen"-Schaltfläche, die das richtige Dokument, genau jetzt, produziert. Ein Versicherungsnehmer, der seine Deckblätterseite herunterlädt, ein Versorgungsunternehmenkunde, der seine letzte Rechnung zieht, ein SaaS-Admin, der einen aktuellen Abonnementbericht exportiert, ein Telekommunikationskunde, der einen Gesprächsnachweis herunterlädt, alle erwarten ein sofortiges Ergebnis, keine wartende Anfrage.

Die Lösung: On-Demand-Rendering im API-Endpunkt

IronPDF ermöglicht es .NET-Webanwendungen, PDF-Dateien bei Bedarf innerhalb einer Controller-Aktion oder minimalen API-Endpunkte zu erstellen. Wenn ein Benutzer auf "PDF herunterladen" klickt, zieht der Server seine Live-Daten aus der Datenbank, füllt eine HTML-Vorlage aus und ChromePdfRenderer rendert den PDF-Inhalt im Speicher. Die Antwort streamt die Datei direkt als Download in den Browser, keine Vor-Generierung, keine veralteten Dateien, keine Support-Warteschlange.

Das Dokument spiegelt die Kontodaten des Benutzers zum Zeitpunkt der Anfrage wider. Das Rendering findet innerhalb der bestehenden .NET-Anwendung als einzige NuGet-Bibliothek statt, es gibt keine externen Prozesse, keine zu rufende Dokumenten-API, keinen Sidecar-Service, der am Leben gehalten werden muss, und keine Pro-Download-Kosten zur Nachverfolgung.

Da es sich um eine C# NuGet-Bibliothek für PDF-Workflows handelt, können Sie IronPDF einfach über den NuGet-Paketmanager installieren. Mit wichtigen Funktionen wie PDF-Erzeugung, Werkzeugen zum Ändern neuer und vorhandener PDF-Dateien, Anwendung von Sicherheitsmaßnahmen wie digitalen Signaturen und Passwörtern und mehr ist IronPDF ein großartiges Werkzeug, um Ihre Projekte zu ergänzen.

Wie es in der Praxis funktioniert

using IronPdf;

[HttpGet("portal/documents/statement")]
[Authorize]
public IActionResult DownloadStatement([FromQuery] string period)
{
    var userId = User.GetUserId();
    var data = _accountService.GetStatementData(userId, period);

    string html = $@"
        <h1>Account Statement — {data.Period}</h1>
        <p><strong>Account:</strong> {data.AccountNumber}</p>
        <p><strong>Name:</strong> {data.CustomerName}</p>
        {data.LineItemsHtml}
        <p><strong>Closing Balance:</strong> {data.ClosingBalance:C}</p>";

    var renderer = new ChromePdfRenderer();

    renderer.RenderingOptions.MarginTop = 20;

    renderer.RenderingOptions.MarginBottom = 20;

    PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

    return File(pdf.BinaryData, "application/pdf",
        $"Statement-{data.Period}-{data.AccountNumber}.pdf");

}

using IronPdf;

[HttpGet("portal/documents/statement")]
[Authorize]
public IActionResult DownloadStatement([FromQuery] string period)
{
    var userId = User.GetUserId();
    var data = _accountService.GetStatementData(userId, period);

    string html = $@"
        <h1>Account Statement — {data.Period}</h1>
        <p><strong>Account:</strong> {data.AccountNumber}</p>
        <p><strong>Name:</strong> {data.CustomerName}</p>
        {data.LineItemsHtml}
        <p><strong>Closing Balance:</strong> {data.ClosingBalance:C}</p>";

    var renderer = new ChromePdfRenderer();

    renderer.RenderingOptions.MarginTop = 20;

    renderer.RenderingOptions.MarginBottom = 20;

    PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

    return File(pdf.BinaryData, "application/pdf",
        $"Statement-{data.Period}-{data.AccountNumber}.pdf");

}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

<HttpGet("portal/documents/statement")>
<Authorize>
Public Function DownloadStatement(<FromQuery> period As String) As IActionResult
    Dim userId = User.GetUserId()
    Dim data = _accountService.GetStatementData(userId, period)

    Dim html As String = $"
        <h1>Account Statement — {data.Period}</h1>
        <p><strong>Account:</strong> {data.AccountNumber}</p>
        <p><strong>Name:</strong> {data.CustomerName}</p>
        {data.LineItemsHtml}
        <p><strong>Closing Balance:</strong> {data.ClosingBalance:C}</p>"

    Dim renderer As New ChromePdfRenderer()

    renderer.RenderingOptions.MarginTop = 20

    renderer.RenderingOptions.MarginBottom = 20

    Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

    Return File(pdf.BinaryData, "application/pdf", $"Statement-{data.Period}-{data.AccountNumber}.pdf")
End Function

var dataHash = _accountService.GetStatementDataHash(userId, period);

string cacheKey = $"statement/{userId}/{period}/{dataHash}";

byte[] pdfBytes = await _cache.GetAsync(cacheKey);

if (pdfBytes == null)
{
    var renderer = new ChromePdfRenderer();
    PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

    pdfBytes = pdf.BinaryData;

    await _cache.SetAsync(cacheKey, pdfBytes,
        new DistributedCacheEntryOptions
        {
            AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(24)
        });
}

return File(pdfBytes, "application/pdf", $"Statement-{period}.pdf");

var dataHash = _accountService.GetStatementDataHash(userId, period);

string cacheKey = $"statement/{userId}/{period}/{dataHash}";

byte[] pdfBytes = await _cache.GetAsync(cacheKey);

if (pdfBytes == null)
{
    var renderer = new ChromePdfRenderer();
    PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

    pdfBytes = pdf.BinaryData;

    await _cache.SetAsync(cacheKey, pdfBytes,
        new DistributedCacheEntryOptions
        {
            AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(24)
        });
}

return File(pdfBytes, "application/pdf", $"Statement-{period}.pdf");

Imports System
Imports System.Threading.Tasks
Imports IronPdf

Dim dataHash = _accountService.GetStatementDataHash(userId, period)

Dim cacheKey As String = $"statement/{userId}/{period}/{dataHash}"

Dim pdfBytes As Byte() = Await _cache.GetAsync(cacheKey)

If pdfBytes Is Nothing Then
    Dim renderer As New ChromePdfRenderer()
    Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

    pdfBytes = pdf.BinaryData

    Await _cache.SetAsync(cacheKey, pdfBytes, New DistributedCacheEntryOptions With {
        .AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(24)
    })
End If

Return File(pdfBytes, "application/pdf", $"Statement-{period}.pdf")

Nutzen in der realen Welt

Immer aktuell. Dokumente werden aus Live-Daten zum Zeitpunkt der Anfrage generiert. Es gibt keine Synchronisierungsverzögerung zwischen Datenänderungen und Dokumenteninhalt, ein Kunde, der seine Kontoinformationen aktualisiert, lädt ein PDF herunter, das es sofort widerspiegelt.

Keine Unterstützungskosten. Kunden, die ihre eigene Police, Abrechnung oder einen Brief herunterladen können, öffnen keine Tickets, um sie anzufordern. Die Schaltfläche zum Herunterladen ersetzt einen Support-Arbeitsablauf, der pro Anfrage Zeit kostet.

Kein Speicherbedarf. PDFs werden auf Abruf generiert und in den Browser gestreamt. Es besteht keine Notwendigkeit, Dokumente für jeden Kunden über jede Abrechnungsperiode vor-zu generieren und zu speichern, die Speicherkosten skalieren nicht mit der Kundenbasis.

Schnelle Antwortzeiten. ChromePdfRenderer produziert ein typisches Portal-Dokument: einseitigen Auszug, Versicherungsauszug, Zahlungsbeleg, in Millisekunden. Der Benutzer erlebt einen nahezu sofortigen Download anstelle eines Fortschrittsanzeigers.

Markenkonsistenz. Jeder Dokumenttyp verfügt über eine genehmigte HTML und CSS-Vorlage. Jedes heruntergeladene PDF trägt dasselbe Logo, dieselbe Typografie, Layout und rechtliche Disclaimer, unabhängig davon, welcher Endpunkt die Anfrage bearbeitet hat oder wann es generiert wurde.

Keine Kosten pro Dokument. Das Rendering erfolgt in-Prozess innerhalb der Webanwendung. Es gibt kein Drittanbieter-API-Messen, keine nutzungsbasierte Preisgestaltung und keine Position auf der Infrastrukturrechnung, die mit dem Portalverkehr wächst.

Abschluss

Ein On-Demand-PDF-Download ist eine kleine Funktion mit unverhältnismäßig großer Wirkung. Es entfernt eine Klasse von Support-Anfragen vollständig, eliminiert das Risiko von Kundenaktionen auf Basis veralteter Dokumente und ersetzt einen manuellen Lieferungsablauf mit etwas, das einige hundert Millisekunden dauert.

Die Implementierung passt in eine einzelne Controller-Aktion, eine Datenbankabfrage, eine HTML-Vorlage, ein Render-Aufruf und eine Dateiausgabe. IronPDF behandelt den gesamten Lebenszyklus der PDF-Generierung in C# unter ironpdf.com, vom Rendering von HTML-Vorlagen bis zum Speichern, Streamen und Manipulieren von Dokumenten. Die kostenlose 30-Tage-Testversion bietet Ihnen genügend Zeit, um einen On-Demand-Download-Endpunkt gegen Ihr eigenes Portal und Ihre Daten zu erstellen und zu testen.