Employee – Developer Support

About Employee

Employee entity is only available when synced with Intacct, and can be used to track bill expenses.

Note: For any other software application sync (or no sync) other than Intacct, do not use Employee objects.

To turn on Employees Tracking for Payables in the Bill.com UI (Intacct sync required):

Log into Bill.com.
Hover over the gear icon, and then click Settings.
Under Accounting, click Preferences, then Edit.
Change the value of the Use Employees field to Yes.

Create

Request

<API_URL_EndPoint>/Crud/Create/Employee.json

data={
  "obj" : {
    "entity" : "Employee",
    "shortName" : "APS",
    "isActive" : "1",
    "firstName" : "Albert",
    "lastName" : "Passage",
    "parentEmployeeId" : "00000000000000000000"
  }
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Employee",
    "id" : "emp01OVBLNBWSHBP89kw",
    "shortName" : "APS",
    "isActive" : "1",
    "firstName" : "Albert",
    "lastName" : "Passage",
    "parentEmployeeId" : "00000000000000000000",
    "createdTime" : "2016-12-09T15:55:20.000+0000",
    "updatedTime" : "2016-12-09T15:55:20.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Read

Request

<API_URL_EndPoint>/Crud/Read/Employee.json

data={
   "id" : "emp01OVBLNBWSHBP89kw"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Employee",
    "id" : "emp01OVBLNBWSHBP89kw",
    "shortName" : "APS",
    "isActive" : "1",
    "firstName" : "Albert",
    "lastName" : "Passage",
    "parentEmployeeId" : "00000000000000000000",
    "createdTime" : "2016-12-09T15:55:20.000+0000",
    "updatedTime" : "2016-12-09T15:55:20.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Update

Request

<API_URL_EndPoint>/Crud/Update/Employee.json

data={
   "obj" : {
      "entity" : "Employee",
      "id" : "emp01OVBLNBWSHBP89kw",
      "shortName" : "APS",
      "isActive" : "1",
      "firstName" : "Albert",
      "lastName" : "Passage, Sr."
     "parentEmployeeId" : "00000000000000000000"
   }
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Employee",
    "id" : "emp01OVBLNBWSHBP89kw",
    "shortName" : "APS",
    "isActive" : "1",
    "firstName" : "Albert",
    "lastName" : "Passage, Sr.",
    "parentEmployeeId" : "00000000000000000000",
    "createdTime" : "2016-12-09T15:55:20.000+0000",
    "updatedTime" : "2016-12-09T15:55:20.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Delete

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

Request

<API_URL_EndPoint>/Crud/Delete/Employee.json

data={
   "id" : "emp01XBQMLQEURXH1qfe"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Employee",
    "id" : "emp01OVBLNBWSHBP89kw",
    "shortName" : "APS",
    "isActive" : "2",
    "firstName" : "Albert",
    "lastName" : "Passage",
    "parentEmployeeId" : "00000000000000000000",
    "createdTime" : "2016-12-09T15:55:20.000+0000",
    "updatedTime" : "2016-12-09T15:55:20.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Undelete

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

Request

<API_URL_EndPoint>/Crud/Undelete/Employee.json

data={
   "id" : "emp01XBQMLQEURXH1qfe"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Employee",
    "id" : "emp01OVBLNBWSHBP89kw",
    "shortName" : "APS",
    "isActive" : "1",
    "firstName" : "Albert",
    "lastName" : "Passage",
    "parentEmployeeId" : "00000000000000000000",
    "createdTime" : "2016-12-09T15:55:20.000+0000",
    "updatedTime" : "2016-12-09T15:55:20.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Resources

Create an Employee (manual)

Parameters