--- title: "Create a JC Job Cost Code (Job Phases)" slug: "create-a-jc-job-cost-code-job-phases" updated: 2026-05-26T12:53:14Z published: 2026-05-26T12:53:48Z canonical: "developers.cmicglobal.com/create-a-jc-job-cost-code-job-phases" --- > ## Documentation Index > Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a JC Job Cost Code (Job Phases) 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)](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/JC_-_Job_Costing/Reference/Creating_a_Job/Assign_Cost_Code/Assign_Cost_Codes_Phases_Screen.htm?Highlight=assign%20cost%20codes) [Job Costing – Enter Cost Codes](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/JC_-_Job_Costing/Reference/Setup/Enter_Cost_Code_Screen.htm?Highlight=assign%20cost%20codes) ## 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 | | SecurityHTTPType basic Basic authentication Header parametersContent-TypestringExampleapplication/vnd.oracle.adf.resourceitem+json Body parametersobject Example{ "GjjpCompCode": "ZZ", "GjjpJobCode": "PHTEST", "GjjpCode": "01", "GjjpName": "550 name", "GjjpStoreFcastApprovedFlg": "N", "GjjpActiveFlag": "Y", "GjjpFactorableFlg": "N", "GjjpCtrlCode": "ALL", "GjjpJobCtrlCode": "ALL", "GjjpVUuid": "" } Responses201 Created HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourceitem+json ```json { "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