About Item
For customers, an Item defines products or services provided by the organization. For vendors, this describes the products or services provided to the organization. Items can be used in both bills and invoices. Items sync with accounting software or is imported via a CSV file.
Note: With QuickBooks for Windows, Items are synced only from QuickBooks.
To turn on Items tracking for Payables in Bill.com UI, follow these steps:
- Log into your Bill.com account.
- Hover over the gear icon, and then click Settings.
- Under Accounting, click Preferences, then Edit.
- Change the value of the "Use Items in Payables" field to Yes.
Create
Request
<API_URL_EndPoint>/Crud/Create/Item.json
data={
"obj" : {
"entity" : "Item",
"name" : "Back Up Vocal Machine",
"type" : "3",
"description" : "Vocal machine with male, female, and combined selections.",
"price" : 100.00,
"percentage" : null,
"parentItemId" : "00000000000000000000",
"hasPurInfo" : false,
"expenseAccount" : "00000000000000000000",
"purDescription" : null,
"purCost" : null,
"chartOfAccountId" : "0ca01AJKBYXPHRFFdgng",
"taxable" : false,
"shortName" : null,
"mergedIntoId" : "00000000000000000000"}
}Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : {
"entity" : "Item",
"id" : "0ii01YCDSBIDTPTJbhcb",
"isActive" : "1",
"createdTime" : "2016-09-20T23:13:10.000+0000",
"updatedTime" : "2016-12-09T00:12:18.000+0000",
"name" : "Back Up Vocal Machine",
"type" : "3",
"description" : "Vocal machine with male, female, and combined selections.",
"price" : 100.00,
"percentage" : null,
"parentItemId" : "00000000000000000000",
"hasPurInfo" : false,
"expenseAccount" : "00000000000000000000",
"purDescription" : null,
"purCost" : null,
"chartOfAccountId" : "0ca01AJKBYXPHRFFdgng",
"taxable" : false,
"shortName" : null,
"mergedIntoId" : "00000000000000000000"
}
}Read
Request
<API_URL_EndPoint>/Crud/Read/Item.json
data={
"id" : "0ii01BDNPKQGSBBX9l2w"
}Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : {
"entity" : "Item",
"id" : "0ii01YCDSBIDTPTJbhcb",
"isActive" : "1",
"createdTime" : "2016-09-20T23:13:10.000+0000",
"updatedTime" : "2016-12-09T00:12:18.000+0000",
"name" : "Back Up Vocal Machine",
"type" : "3",
"description" : "Vocal machine with male, female, and combined selections.",
"price" : 100.00,
"percentage" : null,
"parentItemId" : "00000000000000000000",
"hasPurInfo" : false,
"expenseAccount" : "00000000000000000000",
"purDescription" : null,
"purCost" : null,
"chartOfAccountId" : "0ca01AJKBYXPHRFFdgng",
"taxable" : false,
"shortName" : null,
"mergedIntoId" : "00000000000000000000"
}
}Update
Request
<API_URL_EndPoint>/Crud/Update/Item.json
data={
"obj" : {
"entity" : "Item",
"id" : "0ii01YCDSBIDTPTJbhcb",
"isActive" : "1",
"name" : "Back Up Vocal Machine with amplifier",
"type" : "3",
"description" : "Vocal machine with male, female, and combined selections.",
"price" : 100.00,
"percentage" : null,
"parentItemId" : "00000000000000000000",
"hasPurInfo" : false,
"expenseAccount" : "00000000000000000000",
"purDescription" : null,
"purCost" : null,
"chartOfAccountId" : "0ca01AJKBYXPHRFFdgng",
"taxable" : false,
"shortName" : null,
"mergedIntoId" : "00000000000000000000"}
}Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : {
"entity" : "Item",
"id" : "0ii01YCDSBIDTPTJbhcb",
"isActive" : "1",
"createdTime" : "2016-09-20T23:13:10.000+0000",
"updatedTime" : "2016-12-11T20:09:01.000+0000",
"name" : "Back Up Vocal Machine with amplifier",
"type" : "3",
"description" : "Vocal machine with male, female, and combined selections.",
"price" : 100.00,
"percentage" : null,
"parentItemId" : "00000000000000000000",
"hasPurInfo" : false,
"expenseAccount" : "00000000000000000000",
"purDescription" : null,
"purCost" : null,
"chartOfAccountId" : "0ca01AJKBYXPHRFFdgng",
"taxable" : false,
"shortName" : null,
"mergedIntoId" : "00000000000000000000"
}
}Delete
Once the Item is deleted, it is marked as inactive ["isActive" : "2"].
Request
<API_URL_EndPoint>/Crud/Delete/Item.json
data={
"id" : "0ii01BDNPKQGSBBX9l2w"
}Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : {
"entity" : "Item",
"id" : "0ii01YCDSBIDTPTJbhcb",
"isActive" : "2",
"createdTime" : "2016-09-20T23:13:10.000+0000",
"updatedTime" : "2016-12-09T00:12:18.000+0000",
"name" : "Back Up Vocal Machine",
"type" : "3",
"description" : "Vocal machine with male, female, and combined selections.",
"price" : 100.00,
"percentage" : null,
"parentItemId" : "00000000000000000000",
"hasPurInfo" : false,
"expenseAccount" : "00000000000000000000",
"purDescription" : null,
"purCost" : null,
"chartOfAccountId" : "0ca01AJKBYXPHRFFdgng",
"taxable" : false,
"shortName" : null,
"mergedIntoId" : "00000000000000000000"
}
}Undelete
Once the Item is undeleted, it is marked as active ["isActive" : "1"].
Request
<API_URL_EndPoint>/Crud/Undelete/Item.json
data={
"id" : "0ii01BDNPKQGSBBX9l2w"
}Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : {
"entity" : "Item",
"id" : "0ii01YCDSBIDTPTJbhcb",
"isActive" : "1",
"createdTime" : "2016-09-20T23:13:10.000+0000",
"updatedTime" : "2016-12-09T00:12:18.000+0000",
"name" : "Back Up Vocal Machine",
"type" : "3",
"description" : "Vocal machine with male, female, and combined selections.",
"price" : 100.00,
"percentage" : null,
"parentItemId" : "00000000000000000000",
"hasPurInfo" : false,
"expenseAccount" : "00000000000000000000",
"purDescription" : null,
"purCost" : null,
"chartOfAccountId" : "0ca01AJKBYXPHRFFdgng",
"taxable" : false,
"shortName" : null,
"mergedIntoId" : "00000000000000000000"
}
}Resources
Parameters