Automating wealth management quarterly portfolios via programmatic print.

The high-net-worth client expectation gap in private wealth management

Regulatory mandates: FCA COBS 16, MiFID II ex-post disclosures, and the 10% depreciation rule

The anatomy of an elite private wealth quarterly briefing

The 3-step programmatic wealth reporting automation blueprint

Code walkthrough: Programmatic wealth portfolio report dispatch

src/services/wealthReportingService.ts — typescript
interface PortfolioReportPayload {
  clientId: string;
  clientName: string;
  addressLine1: string;
  city: string;
  postcode: string;
  quarterTitle: string; // e.g., 'Third Quarter 2026 (Q3)'
  valuationDate: string;
  totalPortfolioValue: number;
  quarterlyReturnPercent: number;
  benchmarkReturnPercent: number;
  totalFeesPaidGbp: number;
  assetAllocation: Array<{
    assetClass: string;
    weightPercent: number;
    currentValue: number;
    targetWeightPercent: number;
  }>;
  relationshipManagerName: string;
}
​
export class WealthReportingService {
  private apiKey: string;
  private apiUrl: string = 'https://api.letterapi.uk/v1';
​
  constructor(apiKey: string) {
    this.apiKey = apiKey;
  }
​
  public async dispatchQuarterlyReport(data: PortfolioReportPayload): Promise<string> {
    const payload = {
      recipient: {
        name: data.clientName,
        address_line_1: data.addressLine1,
        city: data.city,
        postcode: data.postcode,
        country: 'GB'
      },
      template: 'private_wealth_quarterly_portfolio_v3',
      variables: {
        client_name: data.clientName,
        quarter_title: data.quarterTitle,
        valuation_date: data.valuationDate,
        total_value_gbp: data.totalPortfolioValue.toLocaleString('en-GB', { style: 'currency', currency: 'GBP' }),
        quarterly_return: `${data.quarterlyReturnPercent > 0 ? '+' : ''}${data.quarterlyReturnPercent.toFixed(2)}%`,
        benchmark_return: `${data.benchmarkReturnPercent > 0 ? '+' : ''}${data.benchmarkReturnPercent.toFixed(2)}%`,
        total_fees_gbp: data.totalFeesPaidGbp.toLocaleString('en-GB', { style: 'currency', currency: 'GBP' }),
        allocations: data.assetAllocation,
        manager_name: data.relationshipManagerName,
        office_location: 'Mayfair, London'
      },
      postage: 'first_class',
      options: {
        paper_weight: '90gsm_premium_bond',
        color: true,
        double_sided: true,
        cleanroom_processing: true
      },
      metadata: {
        client_id: data.clientId,
        report_period: data.quarterTitle,
        compliance_tag: 'FCA_COBS_16_PERIODIC_REPORT'
      }
    };
​
    const response = await fetch(`${this.apiUrl}/letters`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify(payload)
    });
​
    if (!response.ok) {
      const error = await response.json();
      throw new Error(`Quarterly report dispatch failed: ${error.message}`);
    }
​
    const result = await response.json();
    return result.id;
  }
}

Capital Gains Tax (CGT) harvesting and annual tax pack distribution

Confidential cleanroom printing and protecting high-net-worth client wealth data

The psychological impact: Tactile luxury in an era of digital commoditization

Integrating with wealth core platforms: Iress Xplan, SEI, Avaloq, and Addepar

FCA Sustainability Disclosure Requirements (SDR) and climate risk reporting

Multi-trustee structures and legal correspondence registers: Serving complex family trusts

The financial economics: Slashing private client reporting costs by 45% while eliminating burnout

The commercial transformation: Elevating client retention and attracting multi-generational referrals

Elevate your wealth management reporting with LetterAPI