.png){kind=logo}
Create a JC Job Cost Code (Job Phases)
- 04 Nov 2025
- 3 Minutes to read
- Print
- DarkLight
Create a JC Job Cost Code (Job Phases)
- Updated on 04 Nov 2025
- 3 Minutes to read
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback!
Post
/jc-rest-api/rest/1/jcjobcostcodes
Overview
Cost codes are used in combination with categories (categories of cost types) to specify a job’s cost elements. For example, a cost code for electrical work can have categories for materials, labor, and equipment associated to the cost code to allow specification of the cost code’s type of cost. The JCJobCostCodes endpoint allows the create, update and query of cost codes under a specified company and job combination.
Notes
UI Navigation
Project Controls > Job Costing > Job > Assigned Cost Codes
Reference Article
Job Costing – Assign Cost Codes (Phases)
Job Costing – Enter Cost Codes
jcjobcostcodes Attributes (required)
| CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example |
|---|---|---|---|---|---|---|
| Cost Code Active Flag | jcjobcostcodes | GjjpActiveFlag | This flag identifies if the cost code is active on the system. | string | 1 | Y=Job-Phase is active; N=Job-Phase is inactive. |
| Cost Code | jcjobcostcodes | GjjpCode | This is the Cost (Phase) code. Can also be the sub-cost code. | string | 16 | 02 |
| Company Code | jcjobcostcodes | GjjpCompCode | string | 8 | 001 | |
| Cost Code Control Code | jcjobcostcodes | GjjpCtrlCode | This is the Controling Cost Code. The highest level of a cost code is designated the controlling cost code, which can consist of one or more sub-cost codes. The relationship between the cost code and sub-cost code is established via this code. efines the cost code hierarchy. If the cost code being entered in this line is a controlling cost code, select "All" to establish the highest level of the cost component. | string | 16 | Default – ‘ALL’, or any other alphanumeric combination. For example ‘02.100’ |
| Factorable Flag | jcjobcostcodes | GjjpFactorableFlg | This checkbox is only applicable to cost codes for public sector jobs. If checked, cost code quantity factoring (forecasting based on a factor) is allowed for this cost code. Also, the job’s 'Allow Cost Code Qty Factoring' checkbox must be checked on the Settings tab of the Enter Job screen. | string | 1 | Y/N |
| Job Code | jcjobcostcodes | GjjpJobCode | This is the Job Code this cost code is assigned to. Must be a valid Job Code in CMiC. | string | 10 | 15600GC |
| Job Control Code | jcjobcostcodes | GjjpJobCtrlCode | This is the Control Job Code this cost code record belongs to. Must be a valid Control Job Code in CMiC. | string | 10 | ALL |
| Cost Code Name | jcjobcostcodes | GjjpName | This is the name of the Cost code. | string | 50 | Masonry |
| Stored Forecast Approval Flag | jcjobcostcodes | GjjpStoreFcastApprovedFlg | This is the Stored Forecast Approval Flag. When ‘Y’, the forcast is stored as approved. | string | 1 | Y/N |
| Vuuid | jcjobcostcodes | GjjpVUuid | This is the unique identifier code used for the specific cost code record. | string | 64 |
Security
HTTP
Type basic
Basic authentication
Header parameters
Content-Type
string
Exampleapplication/vnd.oracle.adf.resourceitem+json
Body parameters
object
Example{ "GjjpCompCode": "001", "GjjpJobCode": "00100", "GjjpCode": "002", "GjjpActiveFlag": "Y", "GjjpStoreFcastApprovedFlg": "N", "GjjpFactorableFlg": "N", "GjjpCtrlCode": "00", "GjjpJobCtrlCode": "ALL", "GjjpName": "Drawings", "GjjpVUuid": "" }
Responses
201
Created
Headers
Content-Type
string
Exampleapplication/vnd.oracle.adf.resourceitem+json
example-0
Successful Response
{
"GjjpActComplDate": null,
"GjjpActStartDate": null,
"GjjpActiveFlag": "Y",
"GjjpAttachOraseq": null,
"GjjpBillCode": null,
"GjjpBillName": null,
"GjjpBillingRateTableCode": null,
"GjjpBillingTypeCode": null,
"GjjpBillingUnitFlag": null,
"GjjpBudgUnit": null,
"GjjpChgOrdUnit": null,
"GjjpClvValueCode1": null,
"GjjpClvValueCode2": null,
"GjjpClvValueCode3": null,
"GjjpClvValueCode4": null,
"GjjpClvValueCode5": null,
"GjjpClvValueCode6": null,
"GjjpCode": "002",
"GjjpCompCode": "001",
"GjjpComplUnit": null,
"GjjpCreateDate": null,
"GjjpCtrlCode": "00",
"GjjpEbudgCostAmt": null,
"GjjpEbudgRevenueAmt": null,
"GjjpEqpOraseq": null,
"GjjpEstComplDate": null,
"GjjpEstStartDate": null,
"GjjpFactor": null,
"GjjpFactorableFlg": "N",
"GjjpFinalProductFlag": null,
"GjjpHbRecAmt": null,
"GjjpHier": null,
"GjjpInvoiceFormatCode": null,
"GjjpItemCode": null,
"GjjpItemCompCode": null,
"GjjpItemTypeCode": null,
"GjjpIuCreateDate": null,
"GjjpIuUpdateDate": null,
"GjjpJobCode": "00100",
"GjjpJobCtrlCode": "ALL",
"GjjpMaxBillingAmt": null,
"GjjpMaxBillingBudgetAmt": null,
"GjjpName": "Drawings",
"GjjpObudgCostAmt": null,
"GjjpObudgRevenueAmt": null,
"GjjpObudgUnit": null,
"GjjpPhsTypeCode": null,
"GjjpPriorComplUnit": null,
"GjjpProjQty": null,
"GjjpProjThresholdPct": null,
"GjjpQraOverrideIndicator": null,
"GjjpRecAmt": null,
"GjjpSingleCatBudgFlag": null,
"GjjpStatusCode": null,
"GjjpStoreFcastApprovedFlg": "N",
"GjjpUeValidFlag": null,
"GjjpUnitFcastAttachOraseq": null,
"GjjpUserEnteredProjQty": null,
"GjjpWmCode": null,
"GjjpVUuid": "03210A6E8A8A6B82E06316821FACF1C1",
"links": [
{
"rel": "self",
"href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/jc-rest-api/rest/1/jcjobcostcodes/03210A6E8A8A6B82E06316821FACF1C1",
"name": "jcjobcostcodes",
"kind": "item"
},
{
"rel": "canonical",
"href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/jc-rest-api/rest/1/jcjobcostcodes/03210A6E8A8A6B82E06316821FACF1C1",
"name": "jcjobcostcodes",
"kind": "item"
}
]
}example-1
Successful Response
{
"GjjpActComplDate": null,
"GjjpActStartDate": null,
"GjjpActiveFlag": "Y",
"GjjpAttachOraseq": null,
"GjjpBillCode": null,
"GjjpBillName": null,
"GjjpBillingRateTableCode": null,
"GjjpBillingTypeCode": null,
"GjjpBillingUnitFlag": null,
"GjjpBudgUnit": null,
"GjjpChgOrdUnit": null,
"GjjpClvValueCode1": null,
"GjjpClvValueCode2": null,
"GjjpClvValueCode3": null,
"GjjpClvValueCode4": null,
"GjjpClvValueCode5": null,
"GjjpClvValueCode6": null,
"GjjpCode": "002",
"GjjpCompCode": "001",
"GjjpComplUnit": null,
"GjjpCreateDate": null,
"GjjpCtrlCode": "00",
"GjjpEbudgCostAmt": null,
"GjjpEbudgRevenueAmt": null,
"GjjpEqpOraseq": null,
"GjjpEstComplDate": null,
"GjjpEstStartDate": null,
"GjjpFactor": null,
"GjjpFactorableFlg": "N",
"GjjpFinalProductFlag": null,
"GjjpHbRecAmt": null,
"GjjpHier": null,
"GjjpInvoiceFormatCode": null,
"GjjpItemCode": null,
"GjjpItemCompCode": null,
"GjjpItemTypeCode": null,
"GjjpIuCreateDate": null,
"GjjpIuUpdateDate": null,
"GjjpJobCode": "00100",
"GjjpJobCtrlCode": "ALL",
"GjjpMaxBillingAmt": null,
"GjjpMaxBillingBudgetAmt": null,
"GjjpName": "Drawings",
"GjjpObudgCostAmt": null,
"GjjpObudgRevenueAmt": null,
"GjjpObudgUnit": null,
"GjjpPhsTypeCode": null,
"GjjpPriorComplUnit": null,
"GjjpProjQty": null,
"GjjpProjThresholdPct": null,
"GjjpQraOverrideIndicator": null,
"GjjpRecAmt": null,
"GjjpSingleCatBudgFlag": null,
"GjjpStatusCode": null,
"GjjpStoreFcastApprovedFlg": "N",
"GjjpUeValidFlag": null,
"GjjpUnitFcastAttachOraseq": null,
"GjjpUserEnteredProjQty": null,
"GjjpWmCode": null,
"GjjpVUuid": "03210A6E8A8A6B82E06316821FACF1C1",
"links": [
{
"rel": "self",
"href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/jc-rest-api/rest/1/jcjobcostcodes/03210A6E8A8A6B82E06316821FACF1C1",
"name": "jcjobcostcodes",
"kind": "item"
},
{
"rel": "canonical",
"href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/jc-rest-api/rest/1/jcjobcostcodes/03210A6E8A8A6B82E06316821FACF1C1",
"name": "jcjobcostcodes",
"kind": "item"
}
]
}object