Job – Developer Support

About Job

This associates bill expenses with Jobs or Customers. In the system, expenses can be tracked by Jobs or Customers. Jobs can sync from your accounting software or is imported via a CSV file.

Note: With QuickBooks for Windows and QuickBooks Online, Job is a subcategory of Customer classifications. With Netsuite and Xero, Job is not supported.

To turn on Job tracking for Payables in the Bill.com account, follow these steps:

Log into your Bill.com account.
Hover on the gear icon, and click Settings.
In the Accounting section, click Preferences, then Edit.
In Use Customers/Jobs in Payables field, select Yes.

Create

Request

<API_URL_EndPoint>/Crud/Create/Job.json

data={
  "obj" : {
    "entity" : "Job",
    "name" : "Music Organizations",
    "shortName" : "MO",
    "isActive" : "1",
    "description" : "This tracks sales to music organizations",
    "parentJobId" : "00000000000000000000"
  }
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Job",
    "id" : "job01MXFYJVLCSSFd0aj",
    "name" : "Music Organizations",
    "shortName" : "MO",
    "isActive" : "1",
    "description" : "This tracks sales to music organizations",
    "parentJobId" : "00000000000000000000",
    "createdTime" : "2016-12-11T20:14:04.000+0000",
    "updatedTime" : "2016-12-11T20:14:04.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Read

Request

<API_URL_EndPoint>/Crud/Read/Job.json

data={
   "id" : "job01VXPGYSRUULE3com"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Job",
    "id" : "job01MXFYJVLCSSFd0aj",
    "name" : "Music Organizations",
    "shortName" : "MO",
    "isActive" : "1",
    "description" : "This tracks sales to music organizations",
    "parentJobId" : "00000000000000000000",
    "createdTime" : "2016-12-11T20:14:04.000+0000",
    "updatedTime" : "2016-12-11T20:14:04.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Update

Request

<API_URL_EndPoint>/Crud/Update/Job.json

data={
   "obj" : {
    "entity" : "Job",
    "id" : "job01MXFYJVLCSSFd0aj",
    "name" : "Music Organizations in schools",
    "shortName" : "MO",
    "isActive" : "1",
    "description" : "This tracks sales to school music organizations",
    "parentJobId" : "00000000000000000000"
   }
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Job",
    "id" : "job01MXFYJVLCSSFd0aj",
    "name" : "Music Organizations in schools",
    "shortName" : "MO",
    "isActive" : "1",
    "description" : "This tracks sales to school music organizations",
    "parentJobId" : "00000000000000000000",
    "createdTime" : "2016-12-11T20:14:04.000+0000",
    "updatedTime" : "2016-12-11T20:18:56.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Delete

Once the Job is deleted, it is marked as inactive ["isActive" : "2"].

Request

<API_URL_EndPoint>/Crud/Delete/Job.json

data={
   "id" : "job01MXFYJVLCSSFd0aj"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Job",
    "id" : "job01MXFYJVLCSSFd0aj",
    "name" : "Music Organizations",
    "shortName" : "MO",
    "isActive" : "2",
    "description" : "This tracks sales to music organizations",
    "parentJobId" : "00000000000000000000",
    "createdTime" : "2016-12-11T20:14:04.000+0000",
    "updatedTime" : "2016-12-11T20:14:04.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Undelete

Once the Job is undeleted, it is marked as active ["isActive" : "1"].

Request

<API_URL_EndPoint>/Crud/Undelete/Job.json

data={
   "id" : "job01MXFYJVLCSSFd0aj"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Job",
    "id" : "job01MXFYJVLCSSFd0aj",
    "name" : "Music Organizations",
    "shortName" : "MO",
    "isActive" : "1",
    "description" : "This tracks sales to music organizations",
    "parentJobId" : "00000000000000000000",
    "createdTime" : "2016-12-11T20:14:04.000+0000",
    "updatedTime" : "2016-12-11T20:14:04.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Resources

Parameters