Location – Developer Support

About Location

Use Locations to track bill expenses. Locations can sync from your Accounting Software or imported via a CSV file.

Note: QuickBooks for Windows does not support Location Tracking. Xero tracking must be named "Location".

To turn on Location Tracking for Payables in the Bill.com UI:

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

Create

Request

<API_URL_EndPoint>/Crud/Create/Location.json

data={
  "obj" : {
    "entity" : "Location",
    "name" : "US-West Coast",
    "shortName" : "WC",
    "isActive" : "1",
    "description" : "This is the West Coast market area.",
    "parentLocationId" : "00000000000000000000"
  }
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Location",
    "id" : "loc01MWBANNBKSBU9zc3",
    "name" : "US-West Coast",
    "shortName" : "WC",
    "isActive" : "1",
    "description" : "This is the West Cost market area.",
    "parentLocationId" : "00000000000000000000",
    "createdTime" : "2016-12-11T20:22:53.000+0000",
    "updatedTime" : "2016-12-11T20:22:53.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Read

Request

<API_URL_EndPoint>/Crud/Read/Location.json

data={
   "id" : "loc01MWBANNBKSBU9zc3"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Location",
    "id" : "loc01MWBANNBKSBU9zc3",
    "name" : "US-West Coast",
    "shortName" : "WC",
    "isActive" : "1",
    "description" : "This is the West Coast market area.",
    "parentLocationId" : "00000000000000000000",
    "createdTime" : "2016-12-11T20:22:53.000+0000",
    "updatedTime" : "2016-12-11T20:22:53.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Update

Request

<API_URL_EndPoint>/Crud/Update/Location.json

<codedata={
  "obj" : {
    "entity" : "Location",
    "id" : "loc01MWBANNBKSBU9zc3",
    "name" : "US-West Coast",
    "shortName" : "WC",
    "isActive" : "1",
    "description" : "This is the West Coast & Mountain states market area.",
    "parentLocationId" : "00000000000000000000"
  }
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Location",
    "id" : "loc01MWBANNBKSBU9zc3",
    "name" : "US-West Coast",
    "shortName" : "WC",
    "isActive" : "1",
    "description" : "This is the West Coast & Mountain states market area.",
    "parentLocationId" : "00000000000000000000",
    "createdTime" : "2016-12-11T20:22:53.000+0000",
    "updatedTime" : "2016-12-11T20:29:13.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Delete

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

Request

<API_URL_EndPoint>/Crud/Delete/Location.json

data={
   "id" : "loc01MWBANNBKSBU9zc3"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Location",
    "id" : "loc01MWBANNBKSBU9zc3",
    "name" : "US-West Coast",
    "shortName" : "WC",
    "isActive" : "2",
    "description" : "This is the West Coast market area.",
    "parentLocationId" : "00000000000000000000",
    "createdTime" : "2016-12-11T20:22:53.000+0000",
    "updatedTime" : "2016-12-11T20:22:53.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Undelete

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

Request

<API_URL_EndPoint>/Crud/Undelete/Location.json

data={
   "id" : "loc01MWBANNBKSBU9zc3"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
    "entity" : "Location",
    "id" : "loc01MWBANNBKSBU9zc3",
    "name" : "US-West Coast",
    "shortName" : "WC",
    "isActive" : "1",
    "description" : "This is the West Coast market area.",
    "parentLocationId" : "00000000000000000000",
    "createdTime" : "2016-12-11T20:22:53.000+0000",
    "updatedTime" : "2016-12-11T20:22:53.000+0000",
    "mergedIntoId" : "00000000000000000000"
  }
}

Resources

Parameters