Post
/jc-rest-api/rest/1/jccontforecaststaff
Create Contract Forecasting Staff
jccontforecaststaff manages contract forecast staffing records, including planned resources by period, job/phase/category, and employee/resource details.
Body Parameters
| CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example |
|---|---|---|---|---|---|---|
| JcfsYr | jccontforecaststaff | JcfsYr | Forecast year (required). | integer | 4 | 2026 |
| JcfsPer | jccontforecaststaff | JcfsPer | Forecast period (required). | integer | 2 | 8 |
| JcfsYrPer | jccontforecaststaff | JcfsYrPer | Combined year-period value. | number | - | 202608 |
| JcfsCompCode | jccontforecaststaff | JcfsCompCode | Company code (required). | string | 8 | US01 |
| JcfsContCode | jccontforecaststaff | JcfsContCode | Contract code (required). | string | 10 | CONT000123 |
| JcfsContName | jccontforecaststaff | JcfsContName | Contract name. | string | 60 | HQ Tower Expansion |
| JcfsType | jccontforecaststaff | JcfsType | Forecast type code. | string | 3 | ETC |
| JcfsResource | jccontforecaststaff | JcfsResource | Resource identifier (required). | string | 16 | RES00045 |
| JcfsResourceName | jccontforecaststaff | JcfsResourceName | Resource name. | string | 121 | John Smith |
| JcfsResourceType | jccontforecaststaff | JcfsResourceType | Resource type code. | string | 30 | LABOR |
| JcfsResourceTypeDesc | jccontforecaststaff | JcfsResourceTypeDesc | Resource type description. | string | 30 | Labor Resource |
| JcfsEmpNo | jccontforecaststaff | JcfsEmpNo | Employee number. | string | 16 | E10234 |
| JcfsEmpName | jccontforecaststaff | JcfsEmpName | Employee name. | string | 121 | John Smith |
| JcfsBillCode | jccontforecaststaff | JcfsBillCode | Billing code (required). | string | 50 | BILL-LAB-SR |
| JcfsBillName | jccontforecaststaff | JcfsBillName | Billing code description. | string | 60 | Senior Labor Billing |
| JcfsJobCode | jccontforecaststaff | JcfsJobCode | Job code (required). | string | 10 | JOB1001 |
| JcfsJobName | jccontforecaststaff | JcfsJobName | Job name. | string | 60 | Main Office Build |
| JcfsBillingRateTableCode | jccontforecaststaff | JcfsBillingRateTableCode | Billing rate table code. | string | 10 | BRT2026 |
| JcfsPhsCode | jccontforecaststaff | JcfsPhsCode | Phase code (required). | string | 16 | PHS-STR-01 |
| JcfsPhsName | jccontforecaststaff | JcfsPhsName | Phase name. | string | 50 | Structural Work |
| JcfsCatCode | jccontforecaststaff | JcfsCatCode | Category code (required). | string | 16 | CAT-LAB |
| JcfsCatName | jccontforecaststaff | JcfsCatName | Category name. | string | 30 | Labor |
| JcfsStartDate | jccontforecaststaff | JcfsStartDate | Forecast start date (required). | datetime | - | 2026-08-01T00:00:00Z |
| JcfsEndDate | jccontforecaststaff | JcfsEndDate | Forecast end date (required). | datetime | - | 2026-12-31T00:00:00Z |
| JcfsDurationMonths | jccontforecaststaff | JcfsDurationMonths | Forecast duration in months. | number | - | 5 |
| JcfsTradeCode | jccontforecaststaff | JcfsTradeCode | Trade code (required). | string | 30 | ELECTRICAL |
| JcfsTradeName | jccontforecaststaff | JcfsTradeName | Trade name. | string | 30 | Electrical |
| JcfsLastRefreshDate | jccontforecaststaff | JcfsLastRefreshDate | Last refresh timestamp. | datetime | - | 2026-08-24T09:30:00Z |
| JcfsWeeklyCostHrs | jccontforecaststaff | JcfsWeeklyCostHrs | Weekly cost hours. | number | 10,2 | 40.00 |
| JcfsWeeklyBillHrs | jccontforecaststaff | JcfsWeeklyBillHrs | Weekly billable hours. | number | 10,2 | 40.00 |
| JcfsCostHrRate | jccontforecaststaff | JcfsCostHrRate | Cost hourly rate. | number | 18,4 | 55.2500 |
| JcfsCostHrRateOverride | jccontforecaststaff | JcfsCostHrRateOverride | Override cost hourly rate. | number | 18,4 | 57.0000 |
| JcfsBillHrRate | jccontforecaststaff | JcfsBillHrRate | Billing hourly rate. | number | 18,4 | 95.5000 |
| JcfsBillHrRateOverride | jccontforecaststaff | JcfsBillHrRateOverride | Override billing hourly rate. | number | 18,4 | 98.0000 |
| JcfsEstTotalCostHrs | jccontforecaststaff | JcfsEstTotalCostHrs | Estimated total cost hours. | number | - | 800 |
| JcfsEstTotalBillHrs | jccontforecaststaff | JcfsEstTotalBillHrs | Estimated total billable hours. | number | - | 780 |
| JcfsEstToCompleteCostAmt | jccontforecaststaff | JcfsEstToCompleteCostAmt | Estimated cost amount to complete. | number | - | 44200.75 |
| JcfsEstToCompleteBillAmt | jccontforecaststaff | JcfsEstToCompleteBillAmt | Estimated bill amount to complete. | number | - | 74490.00 |
| JcfsTimesheetPostDate | jccontforecaststaff | JcfsTimesheetPostDate | Timesheet post date. | datetime | - | 2026-08-20T00:00:00Z |
| JcfsUnionCode | jccontforecaststaff | JcfsUnionCode | Union code. | string | 30 | IBEW |
| JcfsUnionName | jccontforecaststaff | JcfsUnionName | Union name. | string | 30 | IBEW Local 134 |
| JcfsRateType | jccontforecaststaff | JcfsRateType | Rate type. | string | 10 | STANDARD |
| JcfsBudgetCostHrs | jccontforecaststaff | JcfsBudgetCostHrs | Budgeted cost hours. | number | 5,2 | 160.00 |
| JcfsBudgetCostHrRate | jccontforecaststaff | JcfsBudgetCostHrRate | Budgeted cost hourly rate. | number | 18,4 | 52.0000 |
| JcfsBudgetBillHrs | jccontforecaststaff | JcfsBudgetBillHrs | Budgeted billable hours. | number | 5,2 | 160.00 |
| JcfsBudgetBillHrRate | jccontforecaststaff | JcfsBudgetBillHrRate | Budgeted billing hourly rate. | number | 18,4 | 90.0000 |
| JcfsBudgetTotalCostHrs | jccontforecaststaff | JcfsBudgetTotalCostHrs | Total budgeted cost hours. | number | - | 960 |
| JcfsBudgetTotalBillHrs | jccontforecaststaff | JcfsBudgetTotalBillHrs | Total budgeted billable hours. | number | - | 960 |
| JcfsBudgetToComplCostAmt | jccontforecaststaff | JcfsBudgetToComplCostAmt | Budget cost amount to complete. | number | 18,4 | 49920.0000 |
| JcfsBudgetToComplBillAmt | jccontforecaststaff | JcfsBudgetToComplBillAmt | Budget bill amount to complete. | number | 18,4 | 86400.0000 |
| JcfsBidJobFlag | jccontforecaststaff | JcfsBidJobFlag | Bid job flag. | string | 1 | N |
| JcfsActualHrToDate | jccontforecaststaff | JcfsActualHrToDate | Actual hours to date. | number | - | 320 |
| JcfsActualCostToDate | jccontforecaststaff | JcfsActualCostToDate | Actual cost to date. | number | - | 17680.50 |
| JcfsBudgetHrToDate | jccontforecaststaff | JcfsBudgetHrToDate | Budget hours to date. | number | - | 300 |
| JcfsBudgetCostToDate | jccontforecaststaff | JcfsBudgetCostToDate | Budget cost to date. | number | - | 15600.00 |
| JcfsActualBillHrToDate | jccontforecaststaff | JcfsActualBillHrToDate | Actual billable hours to date. | number | - | 315 |
| JcfsActualBillToDate | jccontforecaststaff | JcfsActualBillToDate | Actual billing amount to date. | number | - | 30082.50 |
| JcfsDescription | jccontforecaststaff | JcfsDescription | Free-text description. | string | 300 | Senior electrician forecast for Q3 |
| JcfsCostQty | jccontforecaststaff | JcfsCostQty | Cost quantity. | number | 18,4 | 120.0000 |
| JcfsBillQty | jccontforecaststaff | JcfsBillQty | Billing quantity. | number | 18,4 | 118.5000 |
| JcfsBudgetCostQty | jccontforecaststaff | JcfsBudgetCostQty | Budgeted cost quantity. | number | 18,4 | 125.0000 |
| JcfsBudgetBillQty | jccontforecaststaff | JcfsBudgetBillQty | Budgeted billing quantity. | number | 18,4 | 124.0000 |
| JcfsProjPosition | jccontforecaststaff | JcfsProjPosition | Project position/title. | string | 100 | Senior Superintendent |
| JcfsSeqNum | jccontforecaststaff | JcfsSeqNum | Sequence number. | number | - | 1 |
| JcfsDetailOverrideFlag | jccontforecaststaff | JcfsDetailOverrideFlag | Detail override flag. | string | 1 | Y |
| JcfsRpAvailableFlag | jccontforecaststaff | JcfsRpAvailableFlag | Resource planning availability flag. | string | 1 | Y |
| JcfsTotalProjCostHrs | jccontforecaststaff | JcfsTotalProjCostHrs | Total projected cost hours. | number | - | 1120 |
| JcfsTotalProjCostAmt | jccontforecaststaff | JcfsTotalProjCostAmt | Total projected cost amount. | number | - | 61880.25 |
| JcfsTotalProjBillAmt | jccontforecaststaff | JcfsTotalProjBillAmt | Total projected bill amount. | number | - | 106960.00 |
| JcfsAutoCreatedFlag | jccontforecaststaff | JcfsAutoCreatedFlag | Auto-created record flag. | string | 1 | N |
| JcfsEtcOnlyFlag | jccontforecaststaff | JcfsEtcOnlyFlag | ETC-only flag. | string | 1 | Y |
| JcfsJobStatusCode | jccontforecaststaff | JcfsJobStatusCode | Job status code. | string | 1 | A |
| JcfsOrigCostBudgAmt | jccontforecaststaff | JcfsOrigCostBudgAmt | Original cost budget amount. | number | - | 50000 |
| JcfsOrigCostBudgQty | jccontforecaststaff | JcfsOrigCostBudgQty | Original cost budget quantity. | number | - | 1000 |
| JcfsOrigBillBudgAmt | jccontforecaststaff | JcfsOrigBillBudgAmt | Original bill budget amount. | number | - | 85000 |
| JcfsOrigBillBudgQty | jccontforecaststaff | JcfsOrigBillBudgQty | Original bill budget quantity. | number | - | 980 |
| JcfsEmpFlsaExemptFlag | jccontforecaststaff | JcfsEmpFlsaExemptFlag | FLSA exempt flag. | string | 1 | N |
| JcfsEmpUnionizedFlag | jccontforecaststaff | JcfsEmpUnionizedFlag | Unionized employee flag. | string | 1 | Y |
| JcfsWbsMappingFlag | jccontforecaststaff | JcfsWbsMappingFlag | WBS mapping flag. | string | - | Y |
| JcfsHiredFlag | jccontforecaststaff | JcfsHiredFlag | Hired flag. | string | 1 | Y |
| DiscriminatorCode | jccontforecaststaff | DiscriminatorCode | Discriminator code for subtype handling. | string | - | STAFF |
| JcfsIuCreateDate | jccontforecaststaff | JcfsIuCreateDate | Record create timestamp. | datetime | - | 2026-08-01T14:22:10Z |
| JcfsIuUpdateDate | jccontforecaststaff | JcfsIuUpdateDate | Record update timestamp. | datetime | - | 2026-08-24T10:45:00Z |
| JcfsVUuid | jccontforecaststaff | JcfsVUuid | Unique row identifier (UUID). | string | 64 | 1b9f8e87-6f5f-4b9f-9ed2-4f5f5855a8f2 |
Security
HTTP
Type basic
Basic authentication
Header parameters
Content-Type
string
Exampleapplication/vnd.oracle.adf.resourceitem+json
Body parameters
object
Example{
"FbhJcCompCode": "001",
"FbhJcDistTypeCode": "J",
"FbhJcSrcCode": "SRC1",
"FbhJcRefDate": "2023-08-20",
"FbhJcJobCode": "14002",
"FbhJcPhsCode": "01-100x",
"FbhJcCatCode": "3000",
"FbhJcDeptCode": "00",
"FbhJcAccCode": "1000.100",
"FbhJcAmt": 999.99,
"FbhJcWmCode": "NA",
"FbhJcValidFlag": "N",
"FbhJcLineNum": 1,
"FbhJcDsrcCompCode": "001",
"FbhPostDate": "2023-08-31",
"FbhVUuid": ""
}
Responses
201
Successful response