v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB

classifications

Create an item

Create a new item.

post/v3/classifications/items

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 required

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,
  "name": "State Sales Tax"
}

Response

Create an item response

idstring

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