REFERENCE
Field DefinitionsUpdates an existing company job record in CompAnalyst.
PUT
Authorization: Bearer {AccessToken}
Content-Type: application/json
Include all fields with existing values in the PUT request. If not, the existing values will be set to null.
To add multiple structures, plans, grades, or competencies on a single job, separate the values by three pipes ||| (see example request below).
To update custom fields, use the UDF DB name e.g. UDFCmjTXS02. To get the DB name of custom fields, please contact API-Integration@salary.com and include your company name and the label of the field(s).
Refer to Company Jobs
Only update job family, the existing value will be set to null.
{ "JobFamily": "Accounting & Finance" }
Instead, use the following request to preserve values of the existing fields.
{ "CompanyJobTitle": "Accountant I", "JobFamily": "Accounting & Finance", "JobFunction": "Accounting", "JobFocus": "General Accounting", "JobLevel": "P1", "CompanyJobDesc": "Assists in maintaining financial records and ensuring that financial transactions are properly recorded. Ensures the accuracy of entries to ledger accounts and reconciles subsidiary ledger accounts to the general ledger. Compiles financial data to aid more senior accountants in the preparation of balance sheets, profit and loss statements and other financial reports. Assists in analyzing current costs, revenues, financial commitments, and obligations incurred to predict future revenues and expenses. Requires a bachelor's degree. May require eligibility to sit for CPA exam. Typically reports to a supervisor or manager. Works on projects/matters of limited complexity in a support role. Work is closely managed. Typically requires 0-2 years of related experience.", "JobFLSAStatus": "Exempt", "JobCode": "FA06000001", "CAMDCountryCodes": "USA|||USA|||USA|||USA", "JobMatchCode": "JM02", "JobAdjustment": 0.12, "StructureCodesForGrade": "EXE|||EXE02", "StructureCodesForPlan": "||| EXE ||| EXE ||| EXE ", "GradeCodes": "01|||05", "SalaryPlanCodes": "|||Plan1||| Plan2|||Plan3", "LTI1s": "|||1|||0|||1", "LTI2s": "|||1|||0|||1", "LTI3s": "|||1|||0|||1", "LTI4s": "|||1|||0|||1", "LTI5s": "|||1|||0|||1", "LTI6s": "|||1|||0|||1", "LTI7s": "|||1|||0|||1", "LTI8s": "|||1|||0|||1", "LTI9s": "|||1|||0|||1", "IsBonusEligibles": "0|||1|||0|||1", "BonusTargetPercents": "0.1|||0.2|||0.5|||0.1", "JobPointss": "|||5|||3|||1", "BasePhilPercentiles": "0.5|||0.5|||0.5|||0.5", "TCCPhilPercentiles": "0.5|||0.5|||0.5|||0.5", "SalaryRangeMins": "25|||30138.8||||||", "SalaryRangeMids": "26|||36550.9||||||", "SalaryRangeMaxs": "27|||44283.5||||||", "CurrencyCodes": "USD|||USD|||USD|||USD", "DefaultComparisonCodes": "2|||2|||2|||3", "IsUseDefaultMarketDatas": "1|||0|||1|||1", "IndustryFamilyCodes": "I50|||I50|||I00|||I10", "RangeTypeCodes": "3|||3|||3|||3", "RangeCodes": "0|||0|||0|||0", "GeoTypeCodes": "33|||33|||33|||33", "GeoCodes": "0|||0|||0|||0", "Department": "FIN", "EEOCategorycode": "2", "PlansUsingDefaultPlan": "Plan1", "StructuresUsingDefaultPlan": "EXE", "CompetencyNames": "Communication", "CompetencyDescs": "test", "TimeSpents": 0.5, "JobAdjustmentComment": "OK", "UDFCmjDCM01":"0.56", "UDFCmjTXS02": "Finance" }
200: OK - The request was successful, the corresponding content of this company job had been updated.
{ "WEBAPIStatusCode": 0, "WEBAPIStatusDesc": "Success." }
200: OK - The company job code entered does not exist in the system
{ "WEBAPIStatusCode": 1, "WEBAPIStatusDesc": "This companyjob does not exist." }
400: Bad Request - The call parameter is incorrect or the parameter content is not match the format
{ "StatusCode": 400, "Reason": "Bad Request" }