Invoices

How MonetizeNow decides when to send an invoice, what goes on it, how to check it before it goes out, and what to do when an invoice you expected doesn't appear.


The short version

  • Invoices are created per bill group, not per quote. A bill group is a customer's billing arrangement: who gets the invoice, in what currency, how often, and on what terms. One account can have several bill groups, each with its own invoices.
  • Each bill group has a Next Invoice Date. On that date, MonetizeNow bills whatever the contract's billing schedule says is due.
  • Preview Invoice shows you exactly what the next invoice will contain. It doesn't create an invoice and doesn't change anything, so you can open it as often as you like.
  • If there's nothing on the billing schedule for that date, no invoice is created and the preview is empty.

Where to find invoice information

Open an account and stay on the Overview tab. Each bill group is listed with its status, its Next Invoice date, and a Preview Invoice link.

Account overview showing two bill groups. Northwind – Platform & API shows Next Invoice: Nov 1, 2026 and a Preview Invoice link. A blue banner above the second bill group reads "This Bill Group has pending invoice(s). Next Invoice Date is Oct 15, 2026. Generate".

The Next Invoice Estimate column is a forecast of recurring charges only. Usage is added when the invoice is actually created, so the final invoice can be higher.

Click a bill group's name to open it. The top of the bill group page summarizes where billing stands:

Bill group summary showing Next Invoice Date Nov 1, 2026; Open Quotes 0; Currency USD; Invoiced $8,164.30; Amount Outstanding $647.80.
FieldWhat it tells you
Next Invoice DateThe billing date of the next invoice this bill group will produce.
InvoicedTotal invoiced to date for this bill group.
Amount OutstandingWhat the customer still owes across this bill group's invoices, after payments and credits.

When invoices are created

MonetizeNow creates an invoice when all of the following are true. If any one fails, no invoice is created and the preview comes back empty. That's expected behavior, not an error.

1. The bill group is Active

Only Active bill groups are invoiced. Inactive, Canceled, and Suspended bill groups are skipped.

A bill group with an unresolved problem is also paused until the problem is fixed. The most common is a tax calculation error on the previous invoice (see Troubleshooting).

2. The Next Invoice Date has arrived

The bill group's Next Invoice Date sets which billing period is due. It moves forward automatically after each invoice is created. A monthly bill group invoiced on Oct 1 moves to Nov 1.

You can't bill a date that's already been billed. MonetizeNow won't create an invoice for any date before the Next Invoice Date, which protects you from billing the same period twice.

3. A contract is billable on that date

The contract must be billable on the Next Invoice Date:

Contract statusWill it be invoiced?
ActiveYes.
CanceledYes, until its remaining billing schedule runs out. Canceling doesn't erase periods that are still due.
FinishedOnly once more, right after the end date, to bill usage from the final period.
PendingNo. It isn't billed until it starts.

4. The billing schedule has a period due on that date

The billing schedule is the contract's list of every invoice it will ever produce. MonetizeNow looks for the period whose Invoice Date matches the Next Invoice Date exactly. No match means nothing is due, so no invoice is created.

5. The invoice is built and sent

Charges are added, tax is calculated, and any available credits are applied. The invoice becomes Unpaid and gets its invoice number. If the bill group has Email Customer Invoices set to Automatically, it's emailed to the billing contact.

Check the billing schedule

To see exactly which invoices a contract will produce, open the bill group and go to the Billing Schedule tab. Expand a contract to see each period.

Billing Schedule tab with contract ctrt_nw2026 expanded. Ten monthly periods from Jan 1 to Oct 1, 2026 are marked Invoiced and link to invoices. The Nov 1 and Dec 1 periods are labeled Upcoming Invoice, Not Invoiced, $500.00*.
  • Invoiced periods link to the invoice that billed them.
  • Upcoming Invoice rows are periods that haven't been billed yet. The next one should match the bill group's Next Invoice Date.
  • An asterisk (*) means the amount excludes usage. Usage is only known once the period is over, so it's calculated when the invoice is created.
  • One-time invoices don't appear on this screen.
💡

Tip:

If the Next Invoice Date has no matching Upcoming Invoice row, that contract has nothing to bill on that date.

How the bill group controls timing

Open the bill group's Details tab and scroll to Invoice Settings:

Invoice Settings section showing Next Invoice Date Nov 1, 2026; Invoice Template Default; Invoice Frequency Monthly; Create Invoices "Automatically according to Billing Schedule"; Offset from Billing Schedule "Keep as scheduled"; Email Customer Invoices set to Automatically.
SettingWhat it does
Create InvoicesAutomatically according to Billing Schedule: invoices are created by the scheduled billing run on the due date. Manually: nothing is created until someone runs billing for this bill group (see Generate a pending invoice).
Offset from Billing ScheduleCreates invoices up to 30 days earlier or later than scheduled. This changes when the invoice is created, not the period it covers or its bill date. If the contract has usage or minimum-commitment products, invoices can't be created early, because usage must be complete first.
Email Customer InvoicesAutomatically emails each new invoice to the billing contact. Manually means you send it yourself.
Invoice FrequencyHow often the bill group is invoiced (for example, monthly).

Generate a pending invoice

If a bill group's invoice date has passed but no invoice exists yet, you'll see a banner on the account overview:

Blue banner: "This Bill Group has pending invoice(s). Next Invoice Date is Oct 15, 2026. Generate"

The bill group page shows the same thing as a Pending Invoice indicator in the top right:

Pending Invoice popover: "This Bill Group has a pending invoice. Next Invoice Date is Oct 15, 2026." with a Generate button.

This usually happens on bill groups set to create invoices Manually. Click Generate to create the invoice now.

🚧

Click Generate once.

Invoice creation runs in the background and can take a few minutes. Clicking again while it's still running can create duplicate invoices. Each click bills one period. If several periods are overdue, the banner reappears after each one so you can generate the next.

Generate is only available when the account and the bill group are both Active and your role can update billing.


What's on an invoice

An invoice is built from the billing period's charges, then tax and credits are applied. This is why the invoice total often differs from the quote total.

Generated invoice INV-001042 for Northwind Analytics. Lines: API Calls (Usage), Sep 1–Sep 30, 2026, 28,500 × $0.01 = $285.00; Platform Subscription (Subscription), Oct 1–Oct 31, 2026, $500.00. Subtotal $785.00, Tax $62.80, Total $847.80, Credits ($200.00), Payments $0.00, Amount Due $647.80.

Line types

Shown on the invoice asWhat it isWhen it's billed
SubscriptionRecurring fixed charges, such as a platform fee.Usually in advance: the Nov 1 invoice covers Nov 1–30. Some subscriptions are billed in arrears instead.
UsageMetered charges priced from actual consumption (per unit, tiered, and so on).In arrears: the Nov 1 invoice bills October's usage. The invoice header shows this separately as the Usage Period.
OnetimeOne-off charges, such as an implementation fee.Once, on the period they fall in.
Minimum CommitA minimum-spend commitment on the contract. See below.Depends on whether the commitment is paid in arrears or in advance.

Totals, top to bottom

RowMeaning
SubtotalSum of all lines before tax.
DiscountShown only if the invoice has discounts.
TaxCalculated on the invoice when it's created. Labeled VAT for some countries.
TotalSubtotal − discount + tax.
CreditsCredits applied to this invoice. They reduce what's owed without changing the lines above.
PaymentsPayments received against this invoice.
Amount DueWhat the customer still owes on this invoice.

Minimum commitments

Commitment billed in arrears (a "true-up"). If eligible usage for the period is below the commitment, a Minimum Commit line is added for the difference. If usage meets or exceeds the commitment, the true-up is $0.

Monthly minimum commitment     $1,000.00
Eligible usage this period       $700.00
──────────────────────────────────────────
Minimum Commit line              $300.00   (brings the period up to $1,000)

Commitment paid in advance. The customer prepays the commitment. Later invoices show usage at full price, then a negative Minimum Commit line that draws the usage down from the prepaid balance. The line shows the Starting Balance and Balance Remaining, and usage lines covered by the commitment are marked with an asterisk ("Applied to your minimum commitment balance").

API Calls (Usage)                    $900.00*
Minimum Commit (drawdown)           ($900.00)
──────────────────────────────────────────
Subtotal                               $0.00

Credits

Available credits are applied automatically when an invoice is created. They're applied in this order:

  1. Credit notes
  2. Service credits
  3. Prepaid credits, which can be limited to all products or to usage products only. Expired credits are skipped.

Credits appear in the Credits row of the totals. They never change the individual line amounts.

$0 invoices

A recurring invoice that totals $0 (for example, fully covered by a commitment) is still created and is marked Paid right away. There's no setting to switch this off.

The exception is an amendment that changes nothing billable. If there's nothing to charge or credit, no adjustment invoice is created.

Amendments and past invoices

Pricing comes from the contract's most recently processed quote and its billing schedule. MonetizeNow never edits an invoice after it's created. If an amendment changes a period you've already billed, MonetizeNow creates a separate adjustment invoice, or a credit note if the customer is owed money. Periods that haven't been billed yet are simply invoiced at the new pricing.

Invoice statuses

StatusMeaning
DraftNot finalized yet and has no invoice number. Recurring invoices only stay in Draft if tax couldn't be calculated. One-time invoices start as Draft.
UnpaidFinalized, numbered, and owed.
PaidAmount Due is $0, whether from payments, credits, or a $0 invoice.
ReversedFully offset by credit notes.
VoidCanceled. Only possible for an Unpaid invoice with no payments or credits applied. (Feature currently in closed Beta)

Paid, Reversed, and Void invoices can't be changed.


Preview an invoice before it goes out

Preview Invoice runs the same billing logic used to create real invoices, then shows you the result without saving anything. The Next Invoice Date doesn't move, no invoice number is used, and nothing is sent to the customer.

A preview isn't a mock-up.

It's the real calculation. If the preview is empty, MonetizeNow found nothing due on the Next Invoice Date, and it won't create an invoice on that date either.

How to preview

  1. Open the account and find the bill group on the Overview tab.
  2. Click Preview Invoice next to Next Invoice.
Preview drawer showing a DRAFT-watermarked invoice for Northwind Analytics. Invoice Number: Generated upon finalization. Invoice Period Nov 1–Nov 30, 2026; Usage Period Oct 1–Oct 31, 2026. Lines: API Calls (Usage) 32,000 × $0.01 = $320.00; Platform Subscription $500.00. Subtotal $820.00, Tax $65.60, Total $885.60, Amount Due $885.60.

Things to notice on a preview:

  • It's watermarked DRAFT, and the invoice number reads Generated upon finalization.
  • Invoice Period is the period being billed in advance (Nov 1–30). Usage Period is the period whose usage is being billed in arrears (Oct 1–31).
  • Use the download icon in the top right to save the preview as a PDF, for example to share it with the customer's AP team for pre-approval.

You can also preview from the account's Contracts tab when it's in Cards view. Open the Invoicing menu on a contract card and choose Preview Invoice.

What a preview may not match exactly

On the previewOn the real invoice
Tax is an estimate.Tax is calculated when the invoice is created. Small differences are normal.
Credits are not applied.Available credits are applied automatically, which lowers the Amount Due.
Usage reflects what's been recorded so far.Usage reflects everything recorded by the time the invoice is created.

Use the preview to check that the right products, quantities, prices, and periods are billed, rather than to predict the final Amount Due to the cent.

When there's nothing to preview

If nothing is due on the Next Invoice Date, the preview drawer opens without an invoice and shows Failed to load PDF file.

Despite the wording, this usually doesn't mean something is broken. It means there's no invoice to show. Check the billing schedule to confirm what's due next.

The Preview Invoice link is hidden entirely when the bill group has no Next Invoice Date, or when the bill group uses a custom Output Configuration (split invoicing). On the Contracts tab, the Invoicing menu shows No upcoming invoice to preview instead.

If a renewal contract is waiting to start, the preview shows the renewal's first invoice.


Troubleshooting

What you seeLikely causeWhat to do
Preview shows "Failed to load PDF file."No billing schedule period has an Invoice Date equal to the Next Invoice Date. Common causes: the contract ended, every period is already invoiced, or the contract hasn't started (Pending).Check the Billing Schedule tab. If a renewal or amendment should be in place, confirm its quote has been processed.
No Preview Invoice linkThe bill group has no Next Invoice Date, isn't Active, or uses a custom Output Configuration.Check the bill group's status and Invoice Settings.
"There is a tax calculation error on your most recent invoice."Tax couldn't be calculated, usually because of an incomplete or invalid billing or shipping address. The invoice stays in Draft, and the bill group won't create new invoices until this is fixed.Open the Draft invoice, correct the contact or address details, and finalize it.
The invoice date passed but there's no invoiceThe bill group is set to create invoices Manually, or it's paused because of an error.Use Generate on the pending-invoice banner, or resolve the error first.
Invoice total is higher than the quoteUsage, minimum-commit true-ups, and tax are added when the invoice is created.Compare against the line types above. Preview the next invoice to see the breakdown in advance.
Invoice total is lower than expectedCredits were applied, or a prepaid commitment covered usage.Look at the Credits row and any negative Minimum Commit lines.
Amendment didn't change last month's invoiceCreated invoices are never edited.Look for a separate adjustment invoice or credit note created when the amendment was processed.

For your technical team: preview through the API

The same preview is available at GET /api/billGroups/{billGroupId}/invoices/preview.

  • It returns JSON by default, or a PDF when the request sends Accept: application/pdf. JSON is faster because it skips rendering the document.
  • 204 No Content means nothing is due to preview.
  • Like the in-app preview, it saves nothing and can be called repeatedly.

Did this page help you?