월별 계정 명세서를 PDF 문서로 생성하기

정적 및 수동 문서 전송의 문제점

보험 계약자가 자신의 현재 선언 페이지를 요청하기 위해 전화를 걸거나 은행 고객이 지원 티켓을 열어 3개월 명세서를 요청할 때, 요청은 직원의 책상에 쌓입니다. 그 사람은 시스템을 조회하고 문서를 형식화하여 이메일로 답장을 보냅니다. 때로는 같은 날, 때로는 48시간 후에. 수천 명의 고객을 대상으로 한 그 워크플로우는 확장되지 않으며, 그것이 처리하는 각 요청은 셀프 서비스 포털이 불필요하게 할 수 있었던 것입니다.

조직이 대처할 수 있는 대안들은 한 문제를 다른 문제로 대체하는 경향이 있습니다. 매일 밤 모든 고객을 대상으로 하는 PDF 생성은 다운로드되지 않는 다수의 문서를 만들어냅니다. 그리고 기본 데이터가 변경되는 순간부터 모든 문서가 먼저 구식이 됩니다. 결제 방법을 업데이트하거나 적용 범위를 변경한 고객은 더 이상 계정을 반영하지 않는 PDF를 다운로드할 수 있고, 지원팀에 전화를 걸 수도 있습니다.

타사 문서 생성 APIs는 요청시 렌더링을 제공하지만, 포털 트래픽과 직접적으로 비례하는 요청당 비용뿐만 아니라 사용자 행동의 주요 경로에 있는 네트워크 의존성을 추가합니다. 매월 200,000건의 명세서 다운로드를 전송하는 은행 포털은 측정된 API에 의존하고 싶지 않습니다.

사용자가 기대하는 것은 간단합니다: "PDF 다운로드" 버튼은 즉시 올바른 문서를 생성해야 합니다. 보험 계약자가 자신의 선언 페이지를 다운로드하거나, 유틸리티 고객이 자신의 최신 고지서를 가져가거나, SaaS 관리자가 현재 구독 보고서를 내보내거나, 텔레콤 고객이 통화 세부 정보 기록을 다운로드하는 모든 작업에서 대기열 요청이 아닌 즉각적인 결과를 기대합니다.

해결책: API 엔드포인트 내에서 요구할 때마다 렌더링

IronPDF는 .NET 웹 애플리케이션이 컨트롤러 액션 또는 최소 API 엔드포인트 내에서 요구할 때마다 PDF 파일을 생성할 수 있게 해 줍니다. 사용자가 "PDF 다운로드"를 클릭하면 서버는 데이터베이스에서 라이브 데이터를 가져와 HTML 템플릿을 채우고, ChromePdfRenderer는 메모리에서 PDF 콘텐츠를 렌더링합니다. 응답은 파일을 다운로드로 브라우저에 직접 스트리밍합니다. 사전 생성이 없고, 구식 파일도 없으며, 지원 대기열도 없습니다.

문서는 사용자의 계정 데이터를 요청한 정확한 순간에 반영합니다. 렌더링은 외부 프로세스 없이 단일 NuGet 패키지로 기존 .NET 앱 내에서 실행되며, 호출할 문서 API가 없고, 측면 서비스를 유지할 필요가 없으며, 다운로드당 비용을 추적할 필요가 없습니다.

이는 PDF 워크플로우를 위한 C# NuGet 라이브러리이므로, IronPDF를 NuGet 패키지 관리자를 통해 쉽게 설치할 수 있습니다. PDF 생성, 새 PDF 파일과 기존 PDF 파일을 수정하거나 디지털 서명 및 비밀번호 같은 보안을 적용하는 도구 등을 포함한 주요 기능으로, IronPDF는 프로젝트에 추가할 수 있는 좋은 도구입니다.

실제 적용 사례

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")

실제 이점

항상 최신. 문서는 요청 순간에 라이브 데이터로 생성됩니다. 데이터 변경과 문서 콘텐츠의 동기화 지연이 없어서, 자신의 계정 정보를 업데이트한 고객은 즉시 이를 반영하는 PDF를 다운로드할 수 있습니다.

지원 부담 제로. 자신의 정책, 명세서 또는 편지를 다운로드할 수 있는 고객은 이를 요청하는 티켓을 열지 않습니다. 다운로드 버튼은 요청당 시간이 소요되는 지원 워크플로우를 대체합니다.

저장소 붓기 없음. PDF는 필요할 때마다 생성되어 브라우저에 스트리밍됩니다. 모든 고객에 대한 문서를 모든 청구 주기에 대해 생성하고 저장할 필요가 없으며, 저장소 비용은 고객 기반과 함께 확장되지 않습니다.

빠른 응답 시간. ChromePdfRenderer는 일반적인 포털 문서: 단일 페이지 명세서, 정책 요약, 결제 영수증을 밀리초 내에 생성합니다. 사용자는 진행 표시기보다는 거의 즉각적인 다운로드를 경험합니다.

브랜드 일관성. 모든 문서 유형에는 승인된 HTML 및 CSS 템플릿이 있습니다. 다운로드된 모든 PDF는 어느 엔드포인트에서 요청을 처리했는지, 언제 생성되었는지에 관계없이 동일한 로고, 글꼴, 레이아웃 및 법적 고지를 가집니다.

문서당 비용 없음. 렌더링은 웹 애플리케이션 내부에서 처리됩니다. 타사 API 계량도 없고, 사용량 기반 가격 책정도 없으며, 포털 트래픽과 함께 성장하는 인프라 비용 청구 항목도 없습니다.

마무리

요청 여부에 따라 PDF를 다운로드하는 것은 불균형한 영향을 미칩니다. 지원 요청의 한 분류를 완전히 제거하고, 고객이 구식 문서를 가지고 행동할 위험을 없애며, 수동 전달 워크플로우를 몇백 밀리초가 걸리는 무언가로 대체합니다.

구현은 단일 컨트롤러 액션, 데이터베이스 조회, HTML 템플릿, 렌더 호출, 파일 응답 내에 적합합니다. IronPDF는 C#에서 ironpdf.com에서 PDF 생성을 위한 전체 수명 주기를 처리하며, HTML 템플릿 렌더링부터 문서 저장, 스트리밍 및 조작까지 가능합니다. 무료 30일 체험은 자신의 포털 및 데이터를 통한 요구 다운로드 엔드포인트를 구축하고 테스트할 충분한 시간을 제공합니다.