v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB

classifications

Update an item

Update details about an existing item.

patch/v3/classifications/items/{id}

Path parameters

idstring required

BILL-generated ID of the item. The value begins with 0ii.

Example:{{item_id}}

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}

devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Request body

Item type

shortNamestring

Item short name

namestring

Item name

descriptionstring

Item description

parentIdstring

BILL-generated ID of the parent item. You can set this field if this item is a child object.

pricenumber

Item price

expenseChartOfAccountIdstring

BILL-generated ID of the chart of accounts for the item when it is used for bills or purchases in your accounting system. The value begins with 0ca.

purchaseDescriptionstring

Item description when it is used for bills or purchases in your accounting system

purchaseCostnumber

Item purchase cost set in your accounting system

chartOfAccountIdstring

BILL-generated ID of the chart of accounts for the item. The value begins with 0ca.

taxableboolean

Set as true if the item is taxable

percentagenumber

Item tax percentage. You can set this field for a set of item type values.

DISCOUNT
SALES_TAX
OTHER_CHARGE

Example request

{
  "type": "SALES_TAX",
  "percentage": 3.25,
  "name": "State Sales Tax"
}

Response

Update an item response

idstring