Job Cost Forecast
Inspect the job cost subledger and approve dated cost-to-complete forecasts that feed WIP.
Job Cost Forecast shows every posted cost by job, cost code and cost type, and collects the project manager’s estimate at completion. Only approved forecasts feed the WIP schedule. Open it from the company app launcher under Accounting > Job Cost Forecast; it appears when your accounting access includes it.
- Who uses it
- Project managers forecast their own projects; accountants review; a different person approves.
- When
- Monthly, before WIP.
- What it holds
- Job cost entries linked to their GL lines, dated forecast inputs per cost code, approvals and frozen forecast snapshots.
Key workflow
- Read the subledger. Every posted line on a job cost account with a project becomes a job cost entry (labor, burden, material, subcontract, equipment or other) linked to its GL line. Job cost inquiry lists them by project, cost type and date. Payroll posts labor and employer burden to each job, at actual cost or at a standard burden rate that a monthly true-up settles.
- Enter the forecast. Choose a projection method per cost code: manual cost to complete, physical percent complete, unit rate or budget. With no input, the estimate at completion is the greater of revised budget and actual plus open commitments, and the code is flagged.
- Approve. A different person approves each input. Approving the last pending input for a date freezes the forecast there.
- Assign scope. Assign each project’s sources to one entity, and set its WIP revenue method (cost-to-cost, or as-invoiced for T&M and cost-plus jobs) and whether its retainage is conditional.
Controls
- The last editor cannot approve a forecast input.
- Frozen forecasts are append-only. A later input supersedes an earlier freeze without deleting it.
- Forecasts are refused in a closed job cost period and on or before the latest posted WIP period end.
Current boundaries
For the full procedure, exceptions and examples, read the Job cost and WIP workflow guide.
API operations
7 operations · 3 read · 4 write · base path /rest/v1.0/companies/{company_id}/accounting
- GET
/job_cost_entriesList job cost entries - GET
/jobcost/forecastReview a tenant/entity-scoped forecast from dated sources - PUT
/jobcost/forecastSave a dated PM forecast input: projection method per cost code (manual cost to complete, physical percent complete, unit rate, budget) and its inputs (jobForecastEdit permission; PM grants only on projects they belong to). With no PM input a cost code's EAC is max(revised budget, actual + remaining commitments) (flag unforecast_budget when the budget is higher); a null cost_to_complete selects actual + remaining commitments explicitly and, like any input, needs approval before WIP reads it. Saving clears any approval; saving on a later date than the carried-forward input adds a new dated input. Frozen forecasts dated on or after the input are superseded (kept, with supersededAt), never deleted; the audit lists their ids. Refused (409) in a soft- or hard-closed job cost period and on or before the latest posted WIP period end for the entity. - POST
/jobcost/forecast/approveApprove the PM input shown for a cost code on the worksheet date (approveJournal permission; the last editor cannot approve). Only approved inputs may feed WIP. Approving the last pending input for the date freezes the forecast there, superseding (not deleting) an earlier freeze on the same date. Refused (409) in a hard-closed period or on or before the latest posted WIP period end; allowed in a soft-closed period, so a month-end approval freezes at the period end. - GET
/jobcost/scopeList accessible projects, entities and source assignments - POST
/jobcost/scopeAssign a project's sources to one entity and base currency (unrestricted manageCoa permission) - PATCH
/jobcost/scopeSet a job's WIP contract terms (manageCoa): revenue method (cost_to_cost, or as_invoiced for T&M / cost-plus jobs: revenue equals billings, ASC 606-10-55-18) and/or whether retainage is conditional (WIP presents it as a contract asset, ASC 606-10-45-3). Audited with the reason.
Parameters, request and response fields, errors and a generated example for each operation are in the REST reference for this app. Read scopes, step-up and permissions in the Accounting API guide.
Keep exploring
Related across os.construction
- BlogHow to close the month in construction accounting: a step list from cutoff to lockA construction month-end close gets every cost and every billing into the right month, proves cash and the subledgers against the ledger, updates the WIP schedule from current cost-to-complete, has someone else review it, and then locks the period. Here is the step list, an example close calendar and a worked example of what one late invoice does to WIP.
- DocsJob cost and WIPReview job cost forecasts, then compute, approve and post the WIP schedule.
- GlossaryMonth-end closeThe process of finishing a period's accounting: reconciling, accruing, reviewing and locking the month so its numbers stop changing.
- BlogHow to prepare a WIP schedule, step by stepA work-in-progress schedule turns four numbers per job into earned revenue, gross profit and over or under billing. Here's the month-end procedure in order, from cost cutoff to the journal entry, with a three-job percentage-of-completion example that ties out and the review questions that catch a bad forecast.
- GlossaryCost-to-cost methodMeasuring a contract's progress as cost incurred to date divided by estimated total cost, then recognizing that percentage of the contract price as revenue.
- DocsJob cost reports and cost-to-completeHow the job cost report is built by cost code from budget, commitments, actual cost and the forecast, how cost-to-complete is set in the Budget tool, and which flags are planned.
Was this helpful?
Run it on your own project.
Start a 14-day free trial. Want a say in what ships next? Join the founding program.
14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →