Subscriptions Overview
11 min
In the Nue Self-Service API, Subscriptions represent ongoing contractual relationships between customers and your business. Subscriptions are created from activated orders and manage the entire lifecycle of recurring services, from initial provisioning through renewals, modifications, and eventual termination.
What Are Subscriptions?
Subscriptions are long-term service agreements that define:
- Service delivery terms (what the customer receives)
- Billing cycles and amounts (when and how much they pay)
- Usage limits and entitlements (what they can access)
- Contract duration and renewal terms (how long the agreement lasts)
- Modification policies (how changes can be made)
Core Subscription Concepts
Subscription Lifecycle
Subscriptions progress through several key phases:
- Creation: Generated automatically when orders are activated
- Active Service: Ongoing delivery of products and services
- Modifications: Changes to quantity, terms, or products via change orders
- Renewals: Extension of service terms and commitments
- Termination: End of service delivery (cancellation or expiration)
Subscription Types
The Nue platform supports various subscription models:
- Standard Subscriptions: Fixed-term commitments with regular billing
- Evergreen Subscriptions: Month-to-month services without fixed end dates
- Trial Subscriptions: Time-limited evaluation periods
- Bundle Subscriptions: Complex packages with multiple components
Key Subscription Components
Service Definition
Each subscription includes:
- Product Details: What services are being provided
- Quantity Information: How many units/licenses/seats
- Pricing Structure: Rate cards, volume discounts, promotional pricing
Billing Configuration
Subscriptions define billing parameters:
- Billing Frequency: Monthly, quarterly, annual cycles
- Payment Terms: When payments are due
- Tax Calculations: Location-based tax requirements
Contract Terms
Legal and business terms include:
- Service Start and End Dates: Contract duration
- Auto-Renewal Settings: Automatic extension policies
Subscription Data Views
Current Contract View
The default subscription view shows:
- Complete subscription timeline with all historical and future changes
- Current service levels and entitlements
- Upcoming modifications scheduled for future dates
- Full billing history and projected charges
Use Cases:
- Customer service inquiries
- Complete subscription management
- Renewal planning and negotiations
- Full contract analysis
Snapshot View
Point-in-time subscription views show:
- Subscription state as of a specific date
- What services were active at that time
- Billing amounts and terms that were in effect
- Changes that occurred around that period
Use Cases:
- Live customer display of current subscription state
- Billing dispute resolution
- Compliance and regulatory reporting
- Impact analysis of changes
Common Subscription Operations
Retrieval Operations
- Fetch Customer Subscriptions: Get all subscriptions for specific customers
- Get Subscription Details: Retrieve complete information for individual subscriptions
- Generate Snapshots: Create point-in-time views for historical analysis
- Include Related Data: Fetch products, pricing, and change history
Management Operations
- Update Subscription Settings: Modify auto-renewal and custom fields
- Create Change Orders: Request modifications to existing subscriptions
- Generate Pricing Data: Support client-side pricing engines for real-time quotes
- Monitor Status Changes: Track subscription health and lifecycle events
Integration Patterns
Customer Self-Service
Subscriptions power customer portal experiences:
- Subscription Dashboards: Overview of all customer services
- Usage Monitoring: Track consumption against entitlements
- Modification Requests: Self-service upgrade/downgrade capabilities
- Billing History: Access to invoices and payment records
Business Operations
Subscriptions support internal business processes:
- Revenue Recognition: Financial reporting and accounting
- Customer Success: Monitoring subscription health and usage
- Sales Operations: Renewal forecasting and expansion opportunities
- Support Operations: Service delivery and issue resolution
External System Integration
Subscriptions synchronize with:
- CRM Systems: Customer relationship management (Salesforce)
- Billing Platforms: Invoice generation and payment processing
- Service Delivery: Provisioning and entitlement systems
- Analytics Platforms: Business intelligence and reporting
Getting Started with Subscriptions
To effectively work with subscriptions in your application:
- Understand subscription types and lifecycle stages
- Learn retrieval patterns for current and historical data
- Implement subscription management operations
- Design customer experiences around subscription data
- Integrate with business systems for operational efficiency
Next Steps
Explore the subscription implementation guides:
- Getting Started with Subscription Management - Learn core retrieval and management operations
- Subscription Data Reference - Complete field documentation and data structures
- Advanced Subscription Workflows - Complex scenarios and integration patterns
- Key Considerations for Subscriptions - Best practices and strategic guidance
Each guide builds upon the previous one, providing comprehensive coverage of subscription capabilities in the Nue Self-Service API.