ChartOfAccount – Developer Support

About ChartOfAccount

In this API, the accountType parameter is used to define different account type definitions.

Note: For QuickBooks, this is similar to "types".

To sync with other accounting systems, adjust the sync mapping to connect the different account type definitions. If it is not possible to create a sync mapping for the account type, use value = 0 (unspecified).

To turn on Account Numbers for Chart of Account tracking in the Bill.com website, follow these steps:

Log in to your Bill.com UI.
Hover over the gear icon, and click Settings.
Under Accounting, click Preferences, then Edit.
Change the value of the "Show Account Numbers" field to Yes.

Create

Request

<API_URL_EndPoint>/Crud/Create/ChartOfAccount.json

data={
  "obj" : {
    "entity" : "ChartOfAccount",
    "name" : "Office Expenses",
    "isActive" : "1",
    "accountNumber" : "651",
    "accountType" : "14",
    "description" : "Office supplies, equipment, etc.",
    "parentChartOfAccountId" : "00000000000000000000",
    "ca1099Type" : "0"
  }
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "ChartOfAccount",
    "id" : "0ca01UDEGLGDXULOdumd",
    "name" : "Office Expenses",
    "isActive" : "1",
    "accountNumber" : "651",
    "accountType" : "14",
    "description" : "Office supplies, equipment, etc.",
    "parentChartOfAccountId" : "00000000000000000000",
    "ca1099Type" : "0",
    "createdTime" : "2016-12-09T16:44:40.000+0000",
    "updatedTime" : "2016-12-09T16:44:40.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Read

Request

<API_URL_EndPoint>/Crud/Read/ChartOfAccount.json

data={
   "id" : "0ca01UDEGLGDXULOdumd"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "ChartOfAccount",
    "id" : "0ca01UDEGLGDXULOdumd",
    "name" : "Office Expenses",
    "isActive" : "1",
    "accountNumber" : "651",
    "accountType" : "14",
    "description" : ""Office supplies, equipment, etc.",
    "parentChartOfAccountId" : "00000000000000000000",
    "ca1099Type" : "0",
    "createdTime" : "2016-12-09T16:44:40.000+0000",
    "updatedTime" : "2016-12-09T16:51:08.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Update

Request

<API_URL_EndPoint>/Crud/Update/ChartOfAccount.json

data={
   "obj" : {
    "entity" : "ChartOfAccount",
    "id" : "0ca01UDEGLGDXULOdumd",
    "name" : "Office expenses",
    "isActive" : "1",
    "accountNumber" : "651",
    "accountType" : "12",
    "description" : "Office supplies, equipment, etc.",
    "parentChartOfAccountId" : "00000000000000000000",
    "ca1099Type" : "0",
    "mergedIntoId" : "00000000000000000000"
  }
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "ChartOfAccount",
    "id" : "0ca01UDEGLGDXULOdumd",
    "name" : "Office Expenses",
    "isActive" : "1",
    "accountNumber" : "651",
    "accountType" : "12",
    "description" : "Office supplies, equipment, etc.",
    "parentChartOfAccountId" : "00000000000000000000",
    "ca1099Type" : "0",
    "createdTime" : "2016-12-09T16:44:40.000+0000",
    "updatedTime" : "2016-12-09T16:51:08.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Delete

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

Request

<API_URL_EndPoint>/Crud/Delete/ChartOfAccount.json

{
   "id" : "0ca01UDEGLGDXULOdumd"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "ChartOfAccount",
    "id" : "0ca01UDEGLGDXULOdumd",
    "name" : "Office Expenses",
    "isActive" : "2",
    "accountNumber" : "651",
    "accountType" : "14",
    "description" : "Office supplies, equipment, etc.",
    "parentChartOfAccountId" : "00000000000000000000",
    "ca1099Type" : "0",
    "createdTime" : "2016-12-09T16:44:40.000+0000",
    "updatedTime" : "2016-12-09T16:48:19.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Undelete

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

Request

<API_URL_EndPoint>/Crud/Undelete/ChartOfAccount.json

{
   "id" : "0ca01UDEGLGDXULOdumd"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "ChartOfAccount",
    "id" : "0ca01UDEGLGDXULOdumd",
    "name" : "Office Expenses",
    "isActive" : "1",
    "accountNumber" : "651",
    "accountType" : "14",
    "description" : "Office supplies, equipment, etc.",
    "parentChartOfAccountId" : "00000000000000000000",
    "ca1099Type" : "0",
    "createdTime" : "2016-12-09T16:44:40.000+0000",
    "updatedTime" : "2016-12-09T16:48:19.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Resources

Parameters