Contact

PPMT Function in ONLYOFFICE Spreadsheet Editor: Syntax, Examples and Troubleshooting

Financial Intermediate ONLYOFFICE Spreadsheet Editor

Calculate the principal share of a payment period with ONLYOFFICE PPMT.

Verification status: See the evidence and test scope described in this guide. How formula examples are checked

PPMT tells you how much of one scheduled payment reduces the original debt. It separates principal from interest, making it useful for a remaining-balance ledger or a payment breakdown.

Availability and version history

  • Introduced: The original release and date are not established by the official sources checked.
  • Availability: Documented in the current ONLYOFFICE Spreadsheet Editor help; no final working-version endpoint is established.
  • Scope: Docs and Desktop Editors release separately. This unversioned reference does not establish support in every older build or mobile client.
  • Checked: October 14, 2026, against the official PPMT reference. Documentation check; not a new native test.

Syntax and arguments

=PPMT(rate, per, nper, pv, [fv], [type])
Argument Meaning Default
rate Interest rate per payment period Required
per Payment number to inspect, from 1 through nper Required
nper Total scheduled payments Required
pv Signed value at the start Required
fv Signed balance targeted after the last payment 0
type 0 for period-end payments; 1 for period-start payments 0

Square brackets mark optional arguments; do not type them. A positive loan advance represents money received, while the repayment components are negative outflows. These conventions and defaults follow the official PPMT help.

Set up a loan example

In a blank worksheet enter the following. Keep these inputs unchanged when trying the formulas below in unused cells.

Cell Enter Purpose
B2 =6%/12 Monthly rate, 0.005
B3 60 Five years of monthly payments
B4 10000 Loan amount received
B5 0 No target balance after the last payment
B6 0 Payments at month end

=PMT(B2,B3,B4,B5,B6) gives an expected payment of -193.328015. PPMT returns only the principal within that payment, not the full installment.

Worked examples

Formula Expected result Meaning
=PPMT(B2,1,B3,B4) -143.328015 First monthly payment
=PPMT(B2,2,B3,B4) -144.044655 After one principal reduction
=PPMT(B2,60,B3,B4) -192.366184 Final scheduled payment
=PPMT(B2,1,B3,B4,0,1) -192.366184 First payment made immediately
=PPMT(B2,2,B3,B4,0,1) -143.328015 Second beginning-of-period payment
=PPMT(0,1,12,1200) -100.000000 Zero-interest comparison
=PPMT(B2,1,B3,-10000) 143.328015 Reverse the cash-flow perspective
=PPMT(B2,12,B3,B4,-2000,0) -121.128894 A signed nonzero terminal target

Why principal grows over time

The full payment is fixed, but interest is charged on a declining balance. In month one, -193.328015294 - (-50) gives principal -143.328015294. By month sixty, only about -0.961831 of the installment is interest, leaving approximately -192.366184 as principal.

Do not calculate principal as 10000/60: that would assume equal principal reductions rather than equal total payments.

Build a remaining-principal ledger

Enter period numbers 1 through 60 in D2:D61. In E2, enter:

=PPMT($B$2,D2,$B$3,$B$4,$B$5,$B$6)

Fill down through E61. In F2, enter the following and fill down through F61:

=$B$4+SUM($E$2:E2)

The sum’s first endpoint stays fixed while its second endpoint expands. Add the negative principal components to the positive opening balance.

Checkpoint Expected remaining principal
After payment 1 (F2) 9856.671985
After payment 12 (F13) 8231.968328
After payment 60 (F61) 0.000000

The full-term sum =SUM(E2:E61) is -10000 in the mathematical model. Tiny numerical residues may appear in a spreadsheet. This ledger assumes the unchanged scheduled payments; an extra repayment requires recalculating subsequent balances and interest.

Payment timing and a terminal balance

With type=1, the first payment is made before any period’s interest accrues. Its interest component is zero and the payment is entirely principal. Change timing consistently in PMT, IPMT and PPMT; keeping the old PMT amount would mix two schedules.

For the table’s fv=-2000 case, scheduled payments leave a positive modeled debt balance of 2,000. The signed terminal amount is negative from the borrower’s perspective. This is not an extra recurring payment: it changes the payment calculation. Check a contract separately before treating it as a balloon-loan quote.

Troubleshooting and practical limits

  • Unexpected sign: Positive loan proceeds produce negative repayment components. Negate a result for a positive cost or debt-reduction display, but retain signed values in reconciliation formulas.
  • Wrong rate or term: Match units. For a nominal 6% annual rate and monthly payments, use 6%/12 and 60, not 6 and 5.
  • Invalid period: Use whole-number payment indices from 1 through nper. A range must have its start no later than its end.
  • Totals differ by cents: Format results for display without rounding intermediate formulas. A lender that rounds each installment, uses daily interest or changes the last payment can produce different totals.
  • Formula error: Check numeric inputs, period bounds, timing and the configured formula language. The short official reference does not specify every error token or text/blank coercion rule.

These examples assume fixed rates, equal periods and the scheduled payments. Extra payments, skipped installments, fees and variable rates need a separate cash-flow schedule.

  • PMT calculates the complete periodic payment.
  • IPMT and PPMT split one payment into interest and principal.
  • CUMIPMT and CUMPRINC total a selected range.
  • SUM adds worksheet components; ROUND is useful when a model explicitly calls for rounded amounts.

The function-entry guide explains the function dialog. Advanced Settings covers formula language and regional settings; examples here use English names, decimal points and commas.

Example verification: Results were independently calculated with high-precision annuity equations and a separate discounted-payment/amortization model. Values shown use six-decimal half-up display rounding; no example was executed in ONLYOFFICE.