Create New Job

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