ActgClass – Developer Support

About ActgClass

Accounting Classes (also known as Classes) can be used to track bill expenses. Classes can sync from your Accounting Software or be imported via a CSV file.

In accounting practice, Class and Department are interchangeably used for additional dimension tracking that is not maintained on the Chart of Account level. Accounting classifications are managed by the accountType parameter field for Chart of Accounts.

Note: QuickBooks for Windows Classes map to Departments in Bill.com.

Class tracking for Payables can be turned on in the Bill.com UI:

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

Create

Request

<API_URL_EndPoint>/Crud/Create/ActgClass.json

data={
  "obj" : {
    "entity" : "ActgClass",
    "shortName" : "Musical Tools",
    "isActive" : "1",
    "name" : "2223",
    "parentActgClassId" : "00000000000000000000",
    "description" : "Music Tools and related products."
  }
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "ActgClass",
    "id" : "cls01OXZSAKXAZNH8qb3",
    "shortName" : "Musical Tools",
    "isActive" : "1",
    "name" : "2223",
    "parentActgClassId" : "00000000000000000000",
    "description" : "Music Tools and related products.",
    "createdTime" : "2016-12-08T21:35:22.000+0000",
    "updatedTime" : "2016-12-08T21:35:22.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Read

Request

<API_URL_EndPoint>/Crud/Read/ActgClass.json

data={
   "id" : "cls01OXZSAKXAZNH8qb3"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "ActgClass",
    "id" : "cls01OXZSAKXAZNH8qb3",
    "shortName" : "Musical Tools",
    "isActive" : "1",
    "name" : "2223",
    "parentActgClassId" : "00000000000000000000",
    "description" : "Music Tools and related products.",
    "createdTime" : "2016-12-08T21:35:22.000+0000",
    "updatedTime" : "2016-12-08T21:35:22.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Update

Request

<API_URL_EndPoint>/Crud/Update/ActgClass.json

data={
   "obj" : {
      "entity" : "ActgClass",
      "id" : "cls01OXZSAKXAZNH8qb3",
      "shortName" : "Musical Tools-Toys",
      "isActive" : "1",
      "name" : "2223"
   }
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "ActgClass",
    "id" : "cls01OXZSAKXAZNH8qb3",
    "shortName" : "Musical Tools-Toys",
    "isActive" : "1",
    "name" : "2223",
    "parentActgClassId" : "00000000000000000000",
    "description" : "Music Tools and related products.",
    "createdTime" : "2016-12-08T21:35:22.000+0000",
    "updatedTime" : "2016-12-08T21:46:23.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Delete

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

Request

<API_URL_EndPoint>/Crud/Delete/ActgClass.json

data={
   "id" : "cls01MBCYMNEBCGO8qb2"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "ActgClass",
    "id" : "cls01MBCYMNEBCGO8qb2",
    "shortName" : "Musical Tools",
    "isActive" : "2",
    "name" : "2223",
    "parentActgClassId" : "00000000000000000000",
    "description" : "Music Tools and related products.",
    "createdTime" : "2016-12-08T21:34:08.000+0000",
    "updatedTime" : "2016-12-08T21:47:50.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Undelete

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

Request

<API_URL_EndPoint>/Crud/Undelete/ActgClass.json

data={
   "id" : "cls01MBCYMNEBCGO8qb2"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "ActgClass",
    "id" : "cls01MBCYMNEBCGO8qb2",
    "shortName" : "Musical Tools",
    "isActive" : "1",
    "name" : "2223",
    "parentActgClassId" : "00000000000000000000",
    "description" : "Music Tools and related products.",
    "createdTime" : "2016-12-08T21:34:08.000+0000",
    "updatedTime" : "2016-12-08T21:48:46.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Resources

Parameters