Sign in

v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB
classifications

Create multiple items

Create multiple items with one API request. You can create up to 50 items with one POST /v3/classifications/items/bulk request.

post/v3/classifications/items/bulk

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

type'UNKNOWN' | 'SERVICE' | 'INVENTORY' | 'NON_INVENTORY' | 'PAYMENT' | 'DISCOUNT' | 'SALES_TAX' | 'SUBTOTAL' | 'OTHER_CHARGE' | 'INVENTORY_ASSEMBLY' | 'GROUP' | 'SALES_TAX_GROUP' | 'FIXED_ASSET' | 'CATEGORY' | 'EXPENSE' required

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 multiple items response