EIGENN.
docsguidesapichangelogpricingsign in
EIGENN.

Configure Planning Time and Actuals

Set the model range and granularity, place the last actual date, verify source periods, and roll the forecast forward safely.

Summary

This guide aligns a planning model's calendar, actuals, and forecast periods.

Capabilities

You can align the planning model’s calendar and time periods, configure granularity, place the last actuals boundary, refresh source actuals, recalculate forecasts after changes, and roll forward to reflect recently closed periods. Display settings help tailor calendar views for distinct audiences without impacting source data. Ensures smooth transition between actual and forecast periods while supporting audit trails and collaboration.

Prerequisites

Before You Start

  • Identify the decision horizon.
  • Confirm the latest closed source period.
  • Refresh the required planning sources.
  • Save a named version before changing an established timeline.
  • Tell active collaborators when the change affects shared views or reviews.

Concepts

The planning model applies a timeline consisting of historical actuals followed by forecast periods, divided into selectable time units such as daily, weekly, monthly, quarterly, or yearly. The last actual date defines where source data ends and forecasts begin. Versioning preserves snapshots for auditing and comparison through changes or roll-forwards. Display conventions (relative dates, fiscal years) help fit differing review needs.

Workflow

1. Choose Granularity

Open Model settings and select:

  • Daily
  • Weekly
  • Monthly
  • Quarterly
  • Yearly

Choose the smallest period the decision requires.

DecisionTypical granularity
Short-term liquidityWeekly
Operating forecastMonthly
Board or long-range planMonthly or quarterly
Multi-year strategic caseQuarterly or yearly

2. Set the Date Range

Enter the start and end periods.

Check that the range includes:

  • enough actual history to establish the starting point
  • every forecast period needed for the decision
  • seasonal periods when seasonality matters
  • any covenant, board, or cash milestone under review

Changing granularity aligns dates to the selected period boundaries. Review the resulting start and end after the change.

3. Configure the Display

Choose the display settings needed by the audience.

  • Turn on Use relative dates for Month 1, Quarter 1, or Year 1 sequences.
  • Turn on Start relative dates at 0 when the model convention starts at Period 0.
  • Turn on Use fiscal years and select the fiscal start month when needed.
  • Turn on Highlight today to mark the current period visually.

Display settings do not refresh source data or move the actuals boundary.

4. Verify Actuals

  1. Open the source controls.
  2. Refresh each required source.
  3. Wait for success or review the error.
  4. Compare one known source period with the model.
  5. Check units, signs, currency, and dimension mapping.

Do not move the last actual date beyond an unverified period.

5. Set the Last Actual Date

Turn on Last actual date and select the latest reviewed period.

The selected period becomes the cut-off for imported data. The next period becomes the first forecast period.

Check:

  • actuals end at the boundary
  • forecast formulas begin after the boundary
  • no assumption unintentionally overwrites an imported period
  • the first forecast period has every required opening balance

6. Recalculate and Review

If calculation is automatic, wait for the status to return to Up to date.

If manual mode is active:

  1. Select Run calculation.
  2. Wait for completion.
  3. Review any failed or stale status.
  4. Check the first forecast period.

7. Roll Forward After Close

When a new period closes:

  1. Save a version of the pre-close forecast.
  2. Refresh actuals.
  3. Verify the newly closed period.
  4. Open the roll-forward control.
  5. Review included sources and linked models.
  6. Move the last actual date.
  7. Recalculate.
  8. Compare the new forecast with the saved pre-close version.

Use a version label such as Pre-close forecast, June.

8. Update Views and Exports

Review saved views, charts, and export definitions after a timeline change.

Confirm:

  • expected periods remain visible
  • fiscal labels still make sense
  • relative-date views still describe the right sequence
  • comparison versions remain comparable
  • exported columns match the new horizon

Behavior specification

Troubleshoot

The new actual period does not appear

Refresh the source, confirm the dataset includes the period, and check the model's source link and date range.

The first forecast period is blank

Check opening balances, formulas, last actual date, and whether inputs begin in the correct period.

The model cannot shorten the range

Clear or move the last actual date first. Then check formulas or artifacts that reference removed periods.

A comparison version is marked Not comparable

The saved version can use a different granularity or currency. Preview it for context rather than treating the values as a direct comparison.

The roll-forward changed a linked model unexpectedly

Restore the pre-roll version if necessary, then repeat with the correct linked-model and source scope.

Diagrams

Configure Planning Time and Actuals Workflow

Rendering diagram…

Screenshots

Model time settings for monthly periods, the actuals cutoff, relative dates, and fiscal years.

Model time settings for monthly periods, the actuals cutoff, relative dates, and fiscal years.

Shown with synthetic data in a local workspace.

Verification

  1. Open model settings and confirm the chosen granularity appears (e.g., 'Weekly') and matches the decision context.
  2. Set date start and end; check the periods visible in the main view align with the specified history and forecast range.
  3. In display options, enable relative or fiscal dates as needed and verify the visual labels reflect your choice.
  4. Refresh all source actuals; the data in the latest period should match an external reference source for that period.
  5. Set the last actual date and verify that actuals end exactly at that boundary and forecasts begin immediately after.
  6. Trigger recalculation if needed; on completion, verify no errors and that the first forecast period contains expected data.
  7. After a roll-forward, check the last actual date, visible periods, and that saved views/exports now reflect the new timeline.
  8. For any issue (e.g., missing period, blank forecast, comparison warning), follow the troubleshooting steps and confirm resolution.

Related

Next Steps

  • Planning Time and Actuals
  • Connect Planning Data and Actuals
  • Review, Restore, and Export a Planning Model

Configure Notifications and Branding

Set personal alert channels, confirm a custom sender domain, and test which brand settings reach customer output.

Configure Receivables Controls

Save team collection preferences, build the active recovery sequence, and test Auto-chase with a controlled invoice.

On this page

SummaryCapabilitiesPrerequisitesBefore You StartConceptsWorkflow1. Choose Granularity2. Set the Date Range3. Configure the Display4. Verify Actuals5. Set the Last Actual Date6. Recalculate and Review7. Roll Forward After Close8. Update Views and ExportsBehavior specificationTroubleshootThe new actual period does not appearThe first forecast period is blankThe model cannot shorten the rangeA comparison version is marked Not comparableThe roll-forward changed a linked model unexpectedlyDiagramsScreenshotsVerificationRelatedNext Steps

Eigenn docs

current product

Overview
Overview
OverviewAccount PreferencesApproval PoliciesAssistant AutomationAssistant Command CenterAssistant Workspace and Saved WorkBank ConnectionsBilling and UsageBudgets and ForecastCommand CenterCustomer FieldsCustomer LifecycleCustomer RecordsCustomersDeveloper PlatformDocument Processing and ExtractionFiles and Document VaultFinancial Analytics and ReportsFinancial OverviewInbox and ApprovalsInvoice InsightsInvoice ProductsInvoicesMarketplace IntegrationsNotifications and BrandingOnboarding and SupportOverviewPlanning Data and DimensionsPlanning Models and FormulasPlanning Time and ActualsPlanning UncertaintyPlanning Versions and CollaborationPlanning Views and ExportsPlans and AdjustmentsReceivablesReceivables AnalyticsReceivables ControlsRolling Budget CloseScenario PlanningSecurity and AccessSettings OverviewStress TestsTeams and OrganizationsTone Profiles and ExperimentsTransaction Categories and RulesTransaction CodingTransactionsWeekly Finance RitualWorkflow ExecutionsWorkflow OutcomesWorkflow PausesWorkflows
OverviewBuild a Driver-Based Planning ModelBuild and Review a ForecastBuild Your First WorkflowCollaborate on a Planning ModelCompare and Share Planning ScenariosConfigure Approval PoliciesConfigure Assistant OperationsConfigure Customer FieldsConfigure Notifications and BrandingConfigure Planning Time and ActualsConfigure Receivables ControlsConnect Planning Data and ActualsConnect Transaction RecordsCreate and Manage CustomersCreate and Send InvoicesCreate Your First Planning ModelDeveloper API SetupFirst Cash ReviewInvoice Collection WorkflowMaintain Transaction RulesManage Security and BillingManage Team AccessManage the Invoice LifecycleMCP WorkflowsMonitor and Recover WorkflowsOrganize and Share DocumentsProcess Inbox ItemsReconcile and Categorize TransactionsReview a Customer Finance RecordReview, Restore, and Export a Planning ModelRun a Finance Operating ReviewRun a Receivables Tone ExperimentRun a Runway Stress TestRun Planning Uncertainty AnalysisRun Your First Command Center ReviewSave and Share Assistant WorkSet Up a WorkspaceTroubleshoot Account AccessWebhook DeliveryWeekly CFO Review
OverviewIntegrationsMCPSDKsWebhooks
OverviewAuthenticationBank Accounts APICustomers APIErrorsForecasts and Stress Tests APIInvoice Payments APIInvoices APIPaginationRate LimitsRemote Tracker API StatusTracker Categories APITracker Entries and Timers APITracker Projects APITransactions APIWebhooks API StatusWorkflows API
Overview
Overview