Flexible Invoice Timing

• Two Billing Modes: Choose between "Regular" (standard Odoo behavior) or "Current Month" (end-of-month billing)
• Per-Subscription Configuration: Set the billing mode individually for each subscription
• Seamless Switching: Change billing modes without disrupting existing subscriptions

Smart Date Management

• Automatic Period Calculation: Automatically calculates the full month period (1st to last day)
• End-of-Month Invoicing: Invoices are generated on the last day of each month
• Accurate Date Ranges: Invoice lines display the complete monthly period
• Leap Year Support: Correctly handles February and all month variations

Cron Protection

• Bulletproof Logic: Preserves end-of-month dates even after cron job execution
• Override Prevention: Prevents standard Odoo processes from modifying configured dates
• Reliable Automation: Ensures invoices are always generated at the correct time

Seamless Integration

• Zero Conflicts: Works perfectly with existing Odoo subscription workflows
• Standard Compatibility: Fully compatible with Odoo 18 subscription system
• No Customization Required: Works out-of-the-box with standard Odoo installations
• Preserves Functionality: All standard subscription features remain available

Requirements

• Odoo 18.0 or higher
• sale_subscription module (Odoo Enterprise)

Installation Steps

1. Copy the module to your Odoo addons directory
2. Update the apps list in Odoo
3. Install the "Subscription End of Month Invoicing" module
4. The module is ready to use immediately

Subscription Setup

1. Navigate to Sales > Subscriptions
2. Open an existing subscription or create a new one
3. In the subscription form, locate the Invoice Mode field
4. Select one of the two options:
   • Regular: Standard Odoo behavior (invoice at start of period)
   • Current Month: End-of-month billing (invoice at end of period)
5. Save the subscription

The module will automatically handle the rest.

End-of-Month Billing Workflow

1. Create Subscription
   • Create a new subscription with monthly recurrence
   • Set Invoice Mode to "Current Month"
   • Configure subscription lines as usual
2. Automatic Invoicing
   • The system automatically generates invoices on the last day of each month
   • Invoice lines show the period from the 1st to the last day of the month
   • No manual intervention required
3. Invoice Review
   • Review generated invoices in Sales > Invoices
   • Verify that date ranges cover the complete month
   • Process invoices according to your standard workflow

Regular Billing Mode

For subscriptions that should use standard Odoo behavior:

1. Set Invoice Mode to "Regular"
2. The subscription will invoice at the beginning of each period
3. Standard Odoo date calculation applies

Perfect For

• Service Companies: Bill monthly for services already delivered
• SaaS Businesses: End-of-month billing cycles for software subscriptions
• Consultancy Firms: Track and bill for monthly deliverables
• Professional Services: Invoice for completed work periods
• Any Business: Requiring precise monthly billing periods

Business Benefits

• Simplified Accounting: Bill for completed services, not future commitments
• Better Cash Flow: Invoice for delivered services improves cash flow management
• Accurate Revenue Recognition: Deferred revenue automatically calculated for current month
• Professional Presentation: Clean invoices with proper date ranges
• Customer Clarity: Customers see exactly what period they're being billed for

How It Works

The module extends the standard Odoo subscription model with:

1. New Field: invoice_mode (Selection field with "Regular" and "Current Month" options)
2. Date Override Logic: Automatically adjusts invoice dates for end-of-month billing
3. Cron Protection: Prevents standard processes from overriding configured dates
4. Period Calculation: Computes accurate month periods including leap years

Architecture

• Model Extension: Extends sale.order model
• Method Override: Overrides invoice generation methods
• View Enhancement: Adds invoice mode field to subscription form
• No Database Changes: Works with standard Odoo database schema

Compatibility

• Odoo Version: 18.0 and higher
• Enterprise Module: Requires sale_subscription (Odoo Enterprise)
• Other Modules: Compatible with standard Odoo modules
• Customizations: Works alongside custom subscription modifications

Common Issues

Invoice dates not at end of month

• Verify Invoice Mode is set to "Current Month"
• Check that the subscription is active
• Ensure cron jobs are running properly

Subscription not generating invoices

• Verify the subscription is in "In Progress" state
• Check the next invoice date
• Review cron job logs for errors

Date ranges incorrect

• Confirm the subscription recurrence is set to monthly
• Verify timezone settings in Odoo
• Check for custom date modifications in other modules