--- title: GlobalHeaderObjectService - UpdateStartDate Method slug: xpert.nue.io docTags: createdAt: 2025-10-30T21:20:11.045Z --- ## Overview The `GlobalHeaderObjectService` provides a comprehensive set of global methods for updating Quote start dates directly. This service automatically recalculates end dates and updates all associated line items when the start date is changed. **Key Features:** - Automatically recalculates Quote end dates based on subscription terms - Updates all associated QuoteLineItem start and end dates - Integrates with the pricing engine for accurate date calculations - Supports both single and bulk operations - Includes validation and error handling *** ## Method 1: Simple Quote Start Date Update **Use Case:** Update a single Quote's start date when you have the Quote ID and new date. ### Example Code ```apex // Initialize the service GlobalHeaderObjectService service = new GlobalHeaderObjectService(); // Get your Quote ID (example) Id quoteId = '0Q0XX0000000001'; // Replace with actual Quote ID // Set the new start date Date newStartDate = Date.newInstance(2024, 1, 15); // January 15, 2024 // Update the Quote start date service.updateStartDate(quoteId, newStartDate); System.debug('Quote start date updated successfully!'); ``` ### What Happens Behind the Scenes 1. The service queries the Quote and all its QuoteLineItems 2. Sends the data to the Ruby pricing engine for recalculation 3. Updates the Quote's `SubscriptionStartDate__c` and `SubscriptionEndDate__c` 4. Updates all QuoteLineItem `SubscriptionStartDate__c` and `SubscriptionEndDate__c` fields 5. Saves all changes to the database ### Quick Example: Update Quote Start Date to Today **Use Case:** Set a Quote's start date to the current date - commonly used for immediate activation or "start now" scenarios. ```apex // Initialize the service GlobalHeaderObjectService service = new GlobalHeaderObjectService(); // Get your Quote ID Id quoteId = '0Q0XX0000000001'; // Replace with actual Quote ID // Update Quote to start today service.updateStartDate(quoteId, Date.today()); System.debug('Quote start date set to today: ' + Date.today()); ``` **Alternative using System.today():** ```apex // Both Date.today() and System.today() work the same way GlobalHeaderObjectService service = new GlobalHeaderObjectService(); service.updateStartDate(quoteId, System.today()); ``` **Common Scenario - Start Quote Immediately After Approval:** ```apex public static void startQuoteImmediately(Id quoteId) { try { GlobalHeaderObjectService service = new GlobalHeaderObjectService(); // Set start date to today service.updateStartDate(quoteId, Date.today()); System.debug('Quote ' + quoteId + ' is now active starting today!'); } catch (Exception e) { System.debug('Failed to activate Quote: ' + e.getMessage()); throw e; } } ``` *** ## Method 2: Bulk Quote Start Date Updates **Use Case:** Update multiple Quotes' start dates in a single operation for better performance. ### Example Code ```apex // Initialize the service GlobalHeaderObjectService service = new GlobalHeaderObjectService(); // Create update requests for multiple Quotes List updateRequests = new List(); // Add first Quote update updateRequests.add(new GlobalHeaderObjectStartDateUpdate( '0Q0XX0000000001', // Quote ID Date.newInstance(2024, 2, 1) // New start date: February 1, 2024 )); // Add second Quote update updateRequests.add(new GlobalHeaderObjectStartDateUpdate( '0Q0XX0000000002', // Quote ID Date.newInstance(2024, 2, 15) // New start date: February 15, 2024 )); // Add third Quote update updateRequests.add(new GlobalHeaderObjectStartDateUpdate( '0Q0XX0000000003', // Quote ID Date.newInstance(2024, 3, 1) // New start date: March 1, 2024 )); // Execute bulk update service.updateStartDate(updateRequests); System.debug('All Quotes updated successfully!'); ``` ### Performance Benefits - Single database transaction for all updates - Reduced API calls to the pricing engine - Better governor limit management - Improved performance for large-scale operations *** ## Method 3: Quote Start Date Update with Old Date Validation **Use Case:** Update Quote start date with validation against the current start date to ensure data integrity. ### Example Code ```apex // Initialize the service GlobalHeaderObjectService service = new GlobalHeaderObjectService(); // Query the Quote to get current start date Quote currentQuote = [SELECT Id, nue__SubscriptionStartDate__c FROM Quote WHERE Id = '0Q0XX0000000001']; // Create update request with old date validation GlobalStartDateUpdateWithOldStartDate updateRequest = new GlobalStartDateUpdateWithOldStartDate( currentQuote.Id, // Quote ID currentQuote.nue__SubscriptionStartDate__c, // Current start date Date.newInstance(2024, 4, 1) // New start date: April 1, 2024 ); // Execute update with validation service.updateStartDate(updateRequest); System.debug('Quote start date updated with validation!'); ``` ### When to Use This Method - When you need to ensure the Quote hasn't been modified by another process - For critical business operations requiring data integrity validation - When implementing optimistic locking patterns - In multi-user environments to prevent conflicts *** ## Method 4: Advanced Quote Update with Object Manipulation **Use Case:** Update Quote start date when you already have Quote and QuoteLineItem objects in memory and want to manipulate them directly. ### Example Code ```apex // Initialize the service GlobalHeaderObjectService service = new GlobalHeaderObjectService(); // Query Quote and its line items Quote quoteToUpdate = [SELECT Id, nue__SubscriptionStartDate__c, nue__SubscriptionEndDate__c FROM Quote WHERE Id = '0Q0XX0000000001']; List lineItemsToUpdate = [SELECT Id, nue__SubscriptionStartDate__c, nue__SubscriptionEndDate__c, QuoteId, Product2Id, Quantity FROM QuoteLineItem WHERE QuoteId = :quoteToUpdate.Id]; // Create update request with objects List updateRequests = new List(); updateRequests.add(new GlobalStartDateUpdateWithObjects( quoteToUpdate, // Quote object lineItemsToUpdate, // List of QuoteLineItem objects Date.newInstance(2024, 5, 1) // New start date: May 1, 2024 )); // Execute update with object manipulation service.updateStartDate(updateRequests); // After this call, your quoteToUpdate and lineItemsToUpdate objects // will be populated with the new calculated dates from the pricing engine System.debug('Quote object start date: ' + quoteToUpdate.nue__SubscriptionStartDate__c); System.debug('Quote object end date: ' + quoteToUpdate.nue__SubscriptionEndDate__c); for (QuoteLineItem lineItem : lineItemsToUpdate) { System.debug('Line item ' + lineItem.Id + ' start date: ' + lineItem.nue__SubscriptionStartDate__c); System.debug('Line item ' + lineItem.Id + ' end date: ' + lineItem.nue__SubscriptionEndDate__c); } ``` ### Benefits of This Method - No additional database queries after the update - Direct manipulation of objects already in memory - Useful for complex business logic that operates on the updated objects - More efficient when you need to work with the updated data immediately *** ## Error Handling Examples ### Example 1: Handling Null Parameters ```apex try { GlobalHeaderObjectService service = new GlobalHeaderObjectService(); // This will throw an IllegalArgumentException service.updateStartDate(null, Date.today()); } catch (IllegalArgumentException e) { System.debug('Error: ' + e.getMessage()); // Handle the error gracefully } ``` ### Example 2: Handling Invalid Quote IDs ```apex try { GlobalHeaderObjectService service = new GlobalHeaderObjectService(); // Using a non-existent Quote ID Id invalidQuoteId = '0Q0XX0000000999'; service.updateStartDate(invalidQuoteId, Date.today()); } catch (QueryException e) { System.debug('Quote not found: ' + e.getMessage()); // Handle missing Quote scenario } ``` ### Example 3: Comprehensive Error Handling ```apex public static void updateQuoteStartDateSafely(Id quoteId, Date newStartDate) { try { // Validate inputs if (quoteId == null) { throw new IllegalArgumentException('Quote ID cannot be null'); } if (newStartDate == null) { throw new IllegalArgumentException('New start date cannot be null'); } // Check if Quote exists and is editable List quotes = [SELECT Id, nue__SubscriptionStartDate__c, IsSyncing, Status__c FROM Quote WHERE Id = :quoteId LIMIT 1]; if (quotes.isEmpty()) { throw new IllegalArgumentException('Quote not found with ID: ' + quoteId); } Quote quote = quotes[0]; // Business validation if (quote.IsSyncing) { throw new IllegalArgumentException('Cannot update Quote while it is syncing'); } // Execute the update GlobalHeaderObjectService service = new GlobalHeaderObjectService(); service.updateStartDate(quoteId, newStartDate); System.debug('Quote start date updated successfully from ' + quote.nue__SubscriptionStartDate__c + ' to ' + newStartDate); } catch (Exception e) { System.debug('Failed to update Quote start date: ' + e.getMessage()); // Log error, send notification, etc. throw e; // Re-throw if needed } } ``` ## Common Use Cases ### 1. Project Delay Handling When a project is delayed, update all related Quotes to reflect new start dates: ```apex // Get all Quotes for a specific opportunity List quotesToUpdate = [SELECT Id FROM Quote WHERE OpportunityId = :opportunityId]; List updates = new List(); Date delayedStartDate = Date.today().addDays(30); // 30-day delay for (Quote q : quotesToUpdate) { updates.add(new GlobalHeaderObjectStartDateUpdate(q.Id, delayedStartDate)); } new GlobalHeaderObjectService().updateStartDate(updates); ``` ### 2. Fiscal Year Alignment Align Quote start dates to the beginning of fiscal periods: ```apex Date fiscalYearStart = Date.newInstance(2024, 4, 1); // April 1, 2024 GlobalHeaderObjectService service = new GlobalHeaderObjectService(); service.updateStartDate(quoteId, fiscalYearStart); ``` ### 3. Contract Renewal Preparation Update Quote start dates for contract renewals: ```apex // Set renewal to start when current contract ends Date renewalStartDate = currentContractEndDate.addDays(1); GlobalHeaderObjectService service = new GlobalHeaderObjectService(); service.updateStartDate(renewalQuoteId, renewalStartDate); ``` ## Troubleshooting ### Common Issues and Solutions | Issue | Cause | Solution | | ------------------------------------------------------------------------------------- | ---------------------------------- | ------------------------------------------------- | | `IllegalArgumentException: StartDateUpdateWithOldStartDate cannot be null` | Null parameter passed | Always validate parameters before calling methods | | `QueryException: List has no rows for assignment` | Quote ID doesn't exist | Verify Quote exists before updating | | `RubyException: Cannot find the header object with pricing engine calculation result` | Pricing engine communication issue | Check org settings and try again | | `System.LimitException: Too many DML statements` | Too many individual updates | Use bulk update methods instead | ### Debug Tips 1. **Enable Debug Logs** for the GlobalHeaderObjectService class 2. **Check Quote Status** - ensure Quote is not locked or in an invalid state 3. **Verify Pricing Engine** connectivity in your org 4. **Test with Small Datasets** first before bulk operations