PUT
/
api
/
bills
/
{id}

Headers

Authorization
string
required

Value must be 'Bearer <token>' where <token> is an API key prefixed with 'bc_' or a JWT token.

Example:

"Bearer bc_1234567890abcdef"

organization-id
string
required

Required if Authorization is a JWT token. The organization ID to operate within.

Path Parameters

id
number
required

The bill id

Body

application/json
billDate
string<date-time>
required

Date the bill was issued

Example:

"2024-03-15"

vendorId
number
required

Vendor identifier

Example:

1001

entries
object[]
required

Bill line items

billNumber
string

Unique bill number

Example:

"BILL-2024-001"

referenceNo
string

Reference number

Example:

"PO-2024-001"

dueDate
string<date-time>

Date the bill is due

Example:

"2024-04-15"

exchangeRate
number

Exchange rate applied to bill amounts

Example:

1.25

warehouseId
number

Warehouse identifier

Example:

101

branchId
number

Branch identifier

Example:

201

projectId
number

Project identifier

Example:

301

note
string

Additional notes about the bill

Example:

"Office supplies and equipment for Q2 2024"

open
boolean

Indicates if the bill is open

Example:

true

isInclusiveTax
boolean

Indicates if tax is inclusive in prices

Example:

false

attachments
object[]

File attachments associated with the bill

discountType
enum<string>

Type of discount applied

Available options:
percentage,
amount
Example:

"amount"

discount
number

Discount value

Example:

100

adjustment
number

Adjustment value

Example:

50