Create New Job
Type
- Post
Example:
- URL: https://ws.cenpoint.com/cpwc.wc?custcode=bogusCustCode&token=bogusToken&appName=sweetAppName&prg=cpapi&proc=createNewJob
- Body: custId=0000000043&tsDate=2020-06-03T00:00:00&workDesc=Scan and core 28 holes... rest of desc... contact Scott for questions&siteContFName=Scott&siteContLName=CenPoint&addr1=13134 S 5800 W&city=Herriman&state=UT
Base URL (includes authentication + end point)
- https://ws.cenpoint.com/cpwc.wc?custcode=<<Company Code>>&token=<<API Key>>&appName=<<YourAppName>>&prg=cpapi&proc=createNewJob
Body Parameters (Required): (please see Escaping Body Parameters)
Name Type Description Example custId String The 10 character custId to tie this job to 0000000043 tsDate Date (or String) The tentative start date for the job. Can be passed either as a date (time will be ignored) or as a string with MM/DD/YYYY formatting 2020-06-03T00:00:00 or 06/03/2020 workDesc String Description of work to be performed. No length limit Scan and core 28 holes... rest of desc... contact Scott for questions siteContFName String First name of the site contact. Max of 15 characters Scott siteContLName String Last name of the site contact. Max of 25 characters CenPoint
Body Parameters (Optional):
Name Type Description Example addr1 String First line of the job address. Max length of 35 characters 131314 S. 5800 W. addr2 String Second line of the job address. Max length of 35 characters. Suite 204 city String City of the job address. Max length of 25 characters Herriman state String State abbreviation of the job address. Max length of 2 characters UT zip String Zip code of the job address. Max length of 10 characters 84096 po String Job PO (if applicable). Max of 20 characters 12345678910 jobTitle String Job Title / Desc. Max of 35 characters Walmart Job siteContCell String Cell phone of the site contact. Only used if contact doesn't already exist. Formatting will be stripped away. Max of 10 characters 8014786822
Returns:
- Array of with the newly created jobsId
- {"VFPData":{"rows":[{"jobsid":"0000000021"}]}}
- Returned Fields:
Name Type Description Example jobsid String 10 character id for the job that was created 0000000021
- or Error Msg Object
- {"errorCode":"-4","errorDesc":"CustId 0000000273 does not exist or is not available at the requested branch. Try creating a job request alert instead."}
- Customer does not exist or is not available at the branch you authenticated with.
- A user with access to CenPoint must open the customer -> Branch Availability -> Check the desired branch
- {"errorCode":"-5","errorDesc":"New job alert department is not set up under branch settings"}
- A user with access to CenPoint must go to File -> Company / Branch Info -> Pick Branch and Modify -> Misc. Tab -> Specify the 'New Job Alert' Department
- {"errorCode":"-4","errorDesc":"CustId 0000000273 does not exist or is not available at the requested branch. Try creating a job request alert instead."}