Promote

Job promote

promotes a job

To promote a job it follows the same rules as updating a job. However, to promote a job it is important that the value of input follows this structure:

Parameter	Description	Examples	More info
API	The API area	jobs.json
Action	Promote an opportunity to a live job	action=update
General	Parameters described in overview	user=user&password=user	Overview
Input	JSON string	input="data": ...
input>jobNumber	Job number	"jobNumber": "1/00008772"
input>jobStatus	1=Quote 2=Live 3=In house 4=On hold 5=Special	"jobStatus": "2"
input optional>jobSalesStatusReason	Change the sales status	3-6

To get the valid jobSalesStatusReason codes see: Sales status
Note: This code is made up of two parts <salesreasonSalesStatus>-<salesreasonReasonId>

Example request:
Request to promote an opportunity to a live job

http: //<SERVER>/jsonAPI/jobs.json?user=user&password=user&version=3.3&action=update&input={
  "data": [
    {
      "jobNumber": "1/00008772",
      "jobStatus": "2",
      "jobSalesStatusReason": "3-6"
    }
  ]
}

To list valid Sales status/reasons see Job sales status

Example response:

{
  "responsecode": 1,
  "responsestatus": "OK",
  "errorcode": 0,
  "errormessage": "",
  "responsemessage": "data processed successfully.",
  "warningmessage": "",
  "success": true,
  "data": [
    {
      "jobLeadPromotedDate": "2018-02-22",
      "jobLeadPromotedTime": "11:17:57",
      "jobLeadPromotedTimeZone": "UTCA",
      "jobLeadPromotedDateUTC": "2018-02-22",
      "jobLeadPromotedTimeUTC": "11:17:57",
      "jobLeadPromotedUserID": 54,
      "jobSalesStatusReason": "3-6",
      "jobPrefixOnly": "",
      "jobNumberOnly": 8772,
      "jobNumber": "1/00008772",
      "jobUuid": "19C1C231B8DE43B5BD2BC80F8A23E699",
      "jobTimeStampModified": 1519298277,
      "jobRecommendedVersionNumber": 108
    }
  ]
}