Appendix Q: SuiteBilling Deep Dive | NetSuite Implementation Guide

SuiteBilling Overview

SuiteBilling is NetSuite's native subscription billing engine for recurring revenue businesses — SaaS, subscriptions, memberships, and usage-based services.

SuiteBilling lets you:

Create subscription plans, price books, and price plans
Manage subscription lifecycles via change orders (activate, suspend, modify, terminate, renew)
Configure usage-based billing with tiered/volume pricing, included usage multipliers, and commit-plus-overage models
Automate rating runs (charge calculation) and recurring invoicing via billing operations
Integrate with Advanced Revenue Management (ARM) for ASC 606 / IFRS 15 compliance
Track SaaS metrics — ARR, MRR, TCV, churn

⚠️ Licensing Required

SuiteBilling must be provisioned by your NetSuite account representative before you can enable it. It is not a self-service feature toggle.

Quick Example — Software Subscription

Aspect	Details
Product	Cloud CRM — 50 seats
Term	12 months (annual)
Recurring Price	$100/seat/month = $5,000/month
One-Time Setup Fee	$2,500
Usage Add-On	API calls at $0.01/call beyond 100k included
Billing Mode	Recurring: In Advance \| Usage: In Arrears
Revenue	Recognized ratably via ARM (straight-line)

🎯 Consultant Insight

SuiteBilling is not for physical inventory items. It handles non-inventory items and service items only. If you need to bundle hardware with a subscription, place hardware on a sales order and the subscription lines separately.

Key Terminology

Master these terms before diving into configuration.

Term	Definition
Subscription Plan	A template of all items sold as part of a subscription. Includes price book references and renewal rules. Think of it as the "product catalog" for subscriptions.
Price Book	Defines pricing for a collection of items in a subscription plan. A single plan can have multiple price books (e.g., different currencies, monthly vs. annual billing).
Price Plan	Sets the actual price for an individual item — tiered or volume pricing, rate or fixed amount. Defined inside a price book.
Subscription	A customer-specific instance created from a subscription plan. Contains the items, pricing, quantities, and billing terms for one customer.
Billing Account	Holds billing schedule, bill-to/ship-to addresses, currency, and payment terms for a customer. One customer can have multiple billing accounts.
Change Order	The mechanism for modifying an active subscription — Activate, Modify Pricing, Suspend, Reactivate, Terminate, Renew. All mid-life changes go through change orders.
Ratable Event	Any action on a subscription line that triggers charge recalculation — activating, suspending, modifying pricing, saving a change order, etc.
Rating Run	The charge calculation process. Triggered automatically by ratable events, or manually/scheduled via Billing Operations.
Usage	Consumable resource tracking (minutes, API calls, data, licenses). Billed in arrears after a rating run.
Commit Plus Overage	A pricing model where customers prepay for committed usage units and pay separately for overage beyond the commitment.

💡 Record Renaming

You can rename SuiteBilling records at Setup › Company › Rename Records/Transactions . For example, change "Subscription" to "Contract" — all UI, searches, reports, and KPIs update automatically. Help Center topics retain the original names.

Process Flows

High-level workflows for subscription creation and lifecycle management.

Subscription Plan Creation Flow

flowchart LR A[Create Items] --> B[Create Subscription Plan] B --> C[Create Price Book] C --> D[Create Price Plans per Item] D --> E[Plan Ready for Subscriptions]

Stand-Alone Subscription Lifecycle

flowchart LR A[Create Billing Account] --> B[Create Subscription] B --> C[Set Lines to Pending Activation] C --> D[Submit Activation Change Order] D --> E[Active — Charges Generated] E --> F{Mid-Term?} F -->|Modify| G[Modify Pricing CO] F -->|Suspend| H[Suspend CO] F -->|Terminate| I[Terminate CO] F -->|Renew| J[Renew CO] H --> K[Reactivate CO] K --> E

Subscription from Sales Order

flowchart LR A[Create Sales Order] --> B[Add Subscription to SO] B --> C[Approve SO] C --> D[Lines move to Pending Activation] D --> E[Activate Subscription] E --> F[Rating & Invoicing]

Roles & Permissions

Which standard roles can do what with SuiteBilling records.

Role	Sub. Plan	Subscriptions	Price Book	Price Plan	Change Order	Usage
System Administrator	Full	Full	Full	Full	Full	Full
CFO	Full	Full	Full	Full	Full	Full
CEO	Full	Full	Full	Full	Full	Full
Bookkeeper	Full	Full	Full	Full	Edit	Full
Accountant	Full	Edit	Full	Full	Edit	Full
Sales Administrator	View	Full	Full	Full	Full	View
Sales Manager	View	View	Full	Full	Full	View
Sales Person	View	—	Full	Full	Full	View
Support Admin	View	—	View	View	Full	View
Customer Center	None	—	None	View	View	None

ℹ️ Permission Details

By default all roles can view subscriptions. Create/Edit are optional. Only System Administrators can set up custom records and grant access to subscription processes. Navigate to Setup › Users/Roles › Manage Roles to review or customize.

Prerequisites & Setup

Steps you must complete before enabling SuiteBilling features.

🚨 Before You Enable SuiteBilling

Two prerequisites are mandatory — skip these and the feature toggle will be grayed out.

1. Consolidate Projects on Sales Transactions

Go to Setup › Company › Enable Features › Company
Check Projects and Project Management
Go to Setup › Accounting › Accounting Preferences › Items/Transactions
Check Consolidate Projects on Sales Transactions
Click Save

2. Disable Employee Commissions

Go to Setup › Company › Enable Features › Employees
In the Commissions section, clear the Employee Commissions box
Click Save

⚠️ Commissions Data

Existing commissions data remains in the account but becomes inaccessible when Employee Commissions is disabled. Export commission reports first via Reports › Commissions › Commission Overview Report before disabling.

Enable SuiteBilling Features

Feature toggles on the Transactions subtab.

Navigate to Setup › Company › Enable Features › Transactions › Billing :

Required Features

Feature	Purpose
Bill Costs to Customers	Foundation for charge-based billing
Advanced Billing	Enables advanced billing capabilities
Charge-Based Billing	Required to see subscription line charge pricing details
Billing Accounts	Customer billing schedule and address management
Billing Operations	Automated rating and invoicing
Subscription Billing	Core subscription functionality
Advanced Subscription Billing	Full SuiteBilling feature set

Optional Features

Feature	Purpose
Add-on Items	Add items to subscriptions without a subscription plan. Required for plan-less subscriptions.
Time-Based Pricing	Multiple pricing intervals (free trials, ramp pricing, introductory rates)
Invoice Groups	Group multiple invoices before sending to a customer
Commit Plus Overage	Prepay for committed minimum usage with negotiated rate overage
Uplift Pricing	Automatic percentage price increases at defined intervals (requires Time-Based Pricing)
Prepaid Usage with Drawdown	Bill usage in advance, draw down from prepaid balance

💡 Classification Segments

Also enable Departments, Locations, and/or Classes on the Company tab > Classifications to segment your recurring revenue for reporting.

Optional Preferences

Fine-tune subscription behavior via Invoicing Preferences.

Navigate to Setup › Accounting › Invoicing Preferences › Subscription Management :

Preference	What It Does
Auto-Change to Pending Activation on SO Approval	Moves Draft lines to Pending Activation when the linked sales order is approved
First Activation Sets Start Date	Forces the subscription start date to match the activation date
Request Credit Memo for Off-Cycle Change Orders	Automatically creates credit memos for mid-cycle pricing changes
Create Delta Charges for Changes to Invoiced Periods	Generates incremental charges when mid-period changes affect already-invoiced amounts. Cannot be turned off once the first delta charge is created.
Align Charge Amounts with Subscription	Aligns charge patterns with the subscription header start date instead of bill dates
Exclude Feb 29 When Prorating	Ensures all days are prorated equally regardless of leap years
Default Terminations Effective at Start of Day	Removes one-day charges caused by same-day terminate-after-activate scenarios
Use Location from Subscription on Line Items	Sources invoice line locations from the subscription record instead of the employee record

Proration Options

On subscription plan items, check Prorate Start Date and Prorate End Date to charge only for days used. If cleared, the customer is charged for the full period regardless of start/end dates.

Proration Example

12-month subscription, $100/month, activated January 15:

Both boxes cleared: January charge = $100 (full month)
Both boxes checked: January charge = $54.84 (17 days / 31 days)

Create Subscription Items

Items must be Non-Inventory for Sale or Service for Sale.

Go to Lists › Accounting › Items › New
Choose Non-Inventory Item > For Sale or Service Item > For Sale
Enter Item Name/Number
On the Accounting subtab, select a Tax Schedule
On the Preferences subtab, clear the Can Be Fulfilled/Received box (already cleared for service items)
Click Save

ℹ️ Class / Department / Location Sourcing

These fields on subscription lines are auto-populated in this order: Item record → Subscription Plan → Billing Account. If per-line preferences are enabled, the line-level value is used for revenue reporting.

Revenue Recognition Configuration

On each item's Revenue Recognition/Amortization subtab, set the appropriate rule based on line type:

Line Type	Rev Rec Rule	Create Rev Plans On	Allocation Type
Recurring — Fixed	Default Fixed Recurring Fee	Revenue Arrangement Creation	Normal
Recurring — Adjustable	Default Adjustable Recurring Fee (or Fixed if Subscription Revisions checked)	Subscription Events (or Rev Arrangement Creation)	Normal
One-Time	Default Fixed Recurring Fee	Revenue Arrangement Creation	Normal
Usage	Default Usage	Subscription Events	Exclude
Prepaid	Default Usage	Subscription Events	Exclude
Commit (C+O)	Default Adjustable/Fixed/Usage	Subscription Events	Normal or Exclude
Overage	Default Usage	Subscription Events	Exclude

⚠️ Usage Allocation

Always set Usage line types to Allocation Type: Exclude to prevent errors when merging revenue arrangements.

Subscription Plans

The template that defines what items are sold together.

Go to Lists › Subscriptions › Subscription Plans › New
Enter the Subscription Plan Name
Choose Initial Term:
- Standard Term — End date calculated from term + start date
- Custom Term — You set the end date manually
- Evergreen — No end date; revenue recognition uses the Estimated Revenue Recognition End Date
On the Lines subtab, add items:
- Required — Always included vs. optional at sale time
- Type — One Time, Recurring, Usage, or Commit Plus Overage
- Mode — In Advance or In Arrears
- Prorate Start/End Date — Check for partial-period billing
Configure the Renewal subtab (term, method, auto-initiation)
With Uplift Pricing enabled, configure the Uplift subtab (percentage, frequency)
Click Save — the Price Books subtab opens

💡 Optional Plans

With the Add-on Items feature enabled, you can create subscriptions without a subscription plan or price book — useful for ad-hoc or simple subscriptions.

Price Books & Price Plans

Define how much to charge for each item in the subscription plan.

Price Books

A price book groups pricing for all items in a subscription plan. Use multiple price books for different currencies, billing frequencies, or customer tiers.

On the saved subscription plan, click the Price Books subtab
Click New Price Book
Set the Currency
For each item, click the edit icon to create its price plan
Set Charge Frequency (Weekly / Monthly / Annually) and Repeat Every
Set Prorate By (Month or Day)
Click Save

Price Plans — Pricing Models

Type	How It Works	Example
Tiered	Each tier has its own rate. Units in Tier 1 pay Tier 1 rate, overflow goes to Tier 2 rate, etc.	0-10 items @ $5, 11-20 @ $4.95, 21+ @ $4.90. 22 items = (10×$5) + (10×$4.95) + (2×$4.90) = $109.30
Volume	Total quantity determines a single rate for all units.	0-10 items @ $5, 11-20 @ $4.95. 22 items = 22×$4.95 = $108.90

For each tier, choose a Pricing Option:

Rate — Amount = Quantity × Rate
Fixed Amount — Charge is fixed regardless of quantity

Minimum & Maximum Amounts

Set overall Minimum Amount and Maximum Amount on the Price Plan to cap charges per period, overriding tier calculations. Tier-level min/max is also supported.

Time-Based Pricing (Intervals)

Create pricing that changes over time — free trials, ramp pricing, introductory discounts:

Each interval has a Start On value (e.g., Month 1, Month 4)
Use Add Interval to All to apply across all items at once
Pass-through: mid-interval change orders automatically update subsequent intervals that share the same values

Time-Based Pricing Example

12-month SaaS subscription:

Months 1-3: $50/seat/month (introductory rate, 50% off)
Months 4-12: $100/seat/month (full price)

Uplift Pricing

Automatic percentage price increases at defined intervals during the subscription term and at renewal. Configure on the Uplift subtab with Uplift Percent, Uplift Frequency, and Repeat Every fields. Supports up to 7 decimal places for precision.

Billing Accounts

The link between subscriptions and invoicing — schedule, address, and currency.

Navigate to Lists › Relationships › Billing Accounts › New :

Select the Customer (or create new)
Set Subsidiary (if applicable)
Select Currency
Choose Billing Schedule:
- Fixed bill date — Invoices on a set date (e.g., 1st of month)
- Anniversary bill date — Invoices annually on the service start date
Set the Start Date
Click Save

ℹ️ Multiple Billing Accounts

A customer can have multiple billing accounts. Example: Annual license fees billed to HQ on January 1, usage billed monthly to each branch location.

Invoicing Methods

Next Bill button on the billing account — creates recurring invoice
Invoice Customers page — batch invoicing
Billing Operations — automated process/schedule
Off-Cycle Invoice — for mid-cycle immediate charges (clear the Recurring Bill checkbox)

Create a Subscription

Three paths: stand-alone, from a sales order, or plan-less with add-on items.

Stand-Alone Subscription

Go to Transactions › Subscriptions › Create Subscriptions
Select Customer → Billing Account → Subscription Plan → Price Book
Choose Initial Term and Start Date
Set Class, Department, Location if needed
Apply discounts (0-100%, flat rate, or percentage with % sign)
Configure Renewal and Uplift subtabs
Click Save

From a Sales Transaction

Add a subscription to an Opportunity, Estimate, or Sales Order. The subscription carries over through the transaction lifecycle (Opportunity → Estimate → Sales Order). When the SO is approved, subscription lines auto-move to Pending Activation.

Without a Plan (Add-On Items Only)

With the Add-on Items feature enabled, leave Subscription Plan and Price Book blank, add items directly, and set pricing inline. After saving, these fields lock.

🎯 Subscription Status Flow

Draft → Pending Activation → Active → (Suspended / Modified / Terminated) → Closed. Discounts can only be applied in Draft status or via Modify Pricing change orders when Active.

Key Limits

Limit	Value
Max quantity	9,999,999,999.99999999
Max subscription lines (UI)	200 lines
Decimal precision (Price/Qty/Discount)	8 decimal places
Uplift decimal precision	7 decimal places
Billing Operations batch size	100,000 lines per operation

Change Orders

The mechanism for every subscription lifecycle change.

Change Order Type	What It Does	Key Rules
Activation	Moves subscription from Pending Activation → Active. Generates charges based on effective date.	Can be backdated. Deletable only if no subsequent change orders exist.
Modify Pricing	Changes rate, quantity, discount, or uplift on active lines.	Effective date must be after activation. Automatically updates charges. Supports off-cycle invoicing.
Suspend	Temporarily stops billing. Line moves to Suspended status.	Must suspend related multiplier items together. Can't modify suspended lines — reactivate first.
Reactivate	Restores a suspended line to Active on the effective date.	Can be created on the same day as Suspend to remove one-day charges.
Renew	Extends or creates a new subscription at end of term.	Can't be deleted, but editable before renewal start date.
Terminate	Ends a line at end of day on effective date. Status → Terminated next day.	No further change orders after termination date. Backdating prevents edit/delete. Future charges canceled.

⚠️ Change Order Rules

Changes take effect at start of day except Terminate (end of day)
Only one change order per type per line per day
As of 2020.1, change orders are voided, not deleted (except Renew-New)
Conflicting change orders are rejected (e.g., can't reactivate an already-active line)

Modification Types (for Analytics)

When creating Suspend, Reactivate, or Modify Pricing change orders, classify the revenue impact:

New or Churn — Analytics classifies as new/lost revenue
Upsell or Downsell — Expansion/contraction revenue
Ignored — No analytics impact

Subscription Revisions

Every change order generates a subscription revision that tracks contract modifications and revenue impacts. View revisions on the Subscription Line record's Revisions subtab or the Change Order's Lines subtab.

Usage & Rating

Tracking consumption and calculating charges.

Creating Usage Records

Go to Transactions › Subscriptions › Create Usage
Select the Subscription and Subscription Line
Enter Quantity and Usage Date
Click Save

Usage can also be created via the SuiteBilling Enhancements SuiteApp RESTlet for bulk/automated ingestion.

ℹ️ Voiding Usage

You can void any Active or Suspended usage record at any time — even after it's been rated and invoiced. Voiding automatically generates reversing charges and revenue. Navigate to Transactions › Subscriptions › Create Usage › List and click Void on the record.

Rating Runs

Rating is the process of calculating charges from subscription line details (quantities, pricing, usage, status). Rating runs are triggered:

Automatically — When saving a change order or modifying draft pricing
Manually — Transactions › Billing › Process Billing Operations → check Rating Run → Run
Scheduled — Transactions › Billing › Schedule Billing Operations → configure frequency

⚠️ 24-Hour Rule

You can only submit one change order of a specific type per subscription line per day. If you modify a line's quantity, you must wait 24 hours before submitting another quantity change to the same line.

Accumulated Rating

Price in one frequency, charge in another. Example: annual pricing tiers that reset yearly, but monthly billing. The pricing frequency and charge frequency must be evenly divisible (e.g., quarterly pricing / monthly charging).

Renewals

Extend or create new subscriptions at term end.

Renewal Methods

Method	Description	Best For
Extend Existing	Pushes out the end date on the same subscription record	Low-touch renewals (magazines, streaming)
Create New Subscription	Creates a new subscription record, optionally with a new plan/price book	High-touch renewals requiring renegotiation

Automatic Renewal

On the Renewal subtab, check Automatically Initiate Renewal Process and set the number of days before the end date. Best practice: initiate at least 30 days before expiry.

Renewal with Uplift

With Uplift Pricing enabled, set a default percentage renewal uplift. When the renewal is created, price plans are automatically updated with the increase. The uplift applies to both minimum and maximum values at tier and header levels.

💡 Closed Subscription Renewal

You can renew a subscription even after it has closed. Renewing a closed subscription pulls information from the previous subscription and retains original links, avoiding re-entry.

Advanced Billing Models

Commit-plus-overage, prepaid drawdown, and charge-commit-on-usage.

Commit Plus Overage

Customers prepay for a committed quantity per period at a negotiated rate. Any usage beyond the commitment is charged at a different (typically higher) overage rate.

Commitment and overage can have different charge frequencies (e.g., annual commitment, monthly overage)
Overage frequency cannot exceed commitment frequency
Commitment credits can be shared across multiple usage lines
Breakage and overage revenue are tracked against the C+O line

Prepaid Usage with Drawdown

Enable at Setup › Company › Enable Features › Transactions › Billing › Prepay with Drawdown .

Customers pay a lump sum upfront. As usage occurs, the prepaid balance is drawn down. Two frequency modes:

Mode	Behavior
One-Time	When prepaid balance reaches $0, switches to pay-as-you-go
Auto-Refill	When balance reaches minimum threshold, a new prepayment charge is automatically created

Prepay with Drawdown Example

IT Support Company provides 3-month contract to Vertex Company:

Prepaid: $5,000 upfront, auto-refill at $300 minimum
Emergency Support: $2.50/minute
Standard Support: $1.30/minute

May: 1,200 min emergency ($3,000) + 1,500 min standard ($1,950) = $4,950 drawn. Remaining $50 triggers $5,000 refill.

June: 500 min emergency ($1,250) + 2,000 min standard ($2,600) = $3,850 drawn. Balance $1,200 — no refill.

July: No usage. Remaining $1,200 recognized as revenue at subscription end.

Charge Commit On Usage

Line-level preference that defers the full minimum/commitment charge until usage occurs, rather than charging upfront on the first usage record. For usage services, the unused portion of the minimum is billed at the end of the pricing period.

Revenue Recognition & ARM Integration

ASC 606 / IFRS 15 compliance via Advanced Revenue Management.

SuiteBilling integrates with ARM (Essentials) and ARM (Revenue Allocation). When both are enabled, each subscription line generates a revenue element inside a revenue arrangement.

🚨 Configuration Mode Warning

ARM in Configuration Mode prevents revenue arrangement creation for subscriptions. Disable Configuration Mode before creating revenue arrangements for subscriptions.

Default Revenue Recognition Rules

Rule	Recognition Method	Amount Source	Start Date Source	End Date Source
Default Adjustable Recurring Fee	Straight-line, prorate first & last (period-rate)	Event-Percent based on amount	Subscription Event Start Date	Subscription Event End Date
Default Fixed Recurring Fee	Straight-line, prorate first & last (period-rate)	Event-Percent based on amount	Revenue Element Start Date	Revenue Element End Date
Default Usage	Straight-line, prorate first & last (period-rate)	Event-Percent based on amount	Event Date	Event Date

Create Revenue Elements for Subscription Revisions

Optional accounting preference at Setup › Accounting › Accounting Preferences › General › Subscription Management :

When checked: Each subscription change order creates separate revenue arrangements and modification elements (ASC 606 compliant)
When cleared: Subscription events update existing revenue plans

🚨 Irreversible Preference

Once you check "Create Revenue Elements for Subscription Revisions," you cannot uncheck it. Plan carefully before enabling.

Month-End Revenue Recognition Steps

Create revenue recognition journal entries (schedulable)
Reclassify deferred revenue (schedulable)
Recalculate revenue forecast plans
Run and save the Deferred Revenue Waterfall Report

Change Order Revenue Impacts

Change Order Type	Revenue Impact
Activation / Reactivation	Creates revenue elements from effective date to subscription end date. Serves as the base element.
Modify Pricing	May create multiple revenue elements per revision depending on future scheduled changes.
Suspend / Terminate	Reverses all revenue beyond the effective date.
Renew — Extend	Creates revenue elements for each active line on the extension start date.

SaaS Metrics & Reports

Track the health of your subscription business.

Navigate to Reports › Subscriptions for all SuiteBilling reports.

Report	What It Shows	Key Details
Monthly Recurring Revenue (MRR)	Sum of recurring line items for a specified month or range	Columns: Customer, Subscription Plan, Subscription. Default range: rolling previous year. Does not include prorated amounts. Assumes renewals.
Annual Recurring Revenue (ARR)	ARR workbook with standard reports and enhanced dashboard portlets	Includes: ARR pivot, Current ARR Detail, Customer Lifetime Value, Month-over-Month, Year-over-Year chart. Access via `Analytics › Annual Recurring Revenue`
Total Contract Value (TCV)	Total bill charges for the full subscription term	Does not include usage/overage charges (they vary per period)
Billings to Date	Charges billed up to the current date	Compare with TCV to see remaining value
Churn by Customer	Customers who have terminated or not renewed	Essential for retention analysis
Churn by Revenue	Revenue lost from terminated/non-renewed subscriptions	Track net revenue retention rate

Subscription Total Contract Value Metrics (on the Record)

The subscription's Summary section displays real-time metrics:

Total Active Contract Value — All lines with activation change orders
Pending Total Contract Value — Lines in Pending Activation
Total Active One-Time / Recurring / Usage / Commit Plus Overage / Prepaid — Breakdown by line type

These metrics are accessible via SuiteAnalytics, REST, SuiteScript, and Saved Searches (not legacy reports). Values update after rating completes.

SuiteApps & Bulk Operations

Extended functionality via NetSuite SuiteApps.

Subscription Billing Enhanced UI

A SuiteApp that provides an improved user interface for SuiteBilling with Time-Based Pricing. Features include:

Enhanced subscription plan creation with visual pricing intervals
Improved price book and price plan management
Better subscription management views

SuiteBilling Enhancements SuiteApp

Provides performance optimization and bulk operations:

Feature	Description
Usage RESTlet	Create usage records programmatically via RESTlet for high-volume automated usage ingestion
Bulk Subscription Creation	Create multiple subscriptions at once via CSV upload or scripting
Bulk Change Orders	Apply activation, modify pricing, suspend, reactivate, or terminate across multiple subscriptions simultaneously
Bulk Customer Payments	Process payments for multiple customers in batch
Performance Optimization	Script optimization for large subscription volumes

💡 Email Alerts

Set up saved search email alerts for subscriptions, subscription lines, or change orders. Navigate to the subscription search, personalize it, and on the Email tab check "Send Email Alerts When Records Are Created/Updated." You can filter by specific field changes.