Create bill

Endpoint for creating a new bill.

Query Params
string

Comma-separated relationships to expand. Pass journal to replace the journal ID with its object (ID, date, currency, reference, notes and timestamps). Documents without a journal still return null. Journal line items are retrieved separately with GET /v1/journal-line-items/?journal={journal_id}.

Body Params

A bill received from a supplier.

attachments
array of strings

List of attachments linked to this bill.

attachments
date
required

The date when the bill was issued.

date
required

The date by which the bill should be paid.

string
required

The unique identifier or number assigned to this bill.

string | null

The branch associated with this bill, if applicable.

string

The contact (vendor) associated with this bill.

string
enum
required

The currency in which the bill is issued.

View the enum reference

custom_fields
object

A mapping of custom field IDs to their values.

debit_notes
array of objects

The debit notes applied to this bill. Sending this field replaces the whole set, and entries left out are unapplied. To apply, change or remove a single debit note, use /v1/bill-debit-notes/.

debit_notes
double | null

The exchange rate to the organization base currency at the time of the document.

string
length ≤ 255

External identifier for the bill.

string
enum

The language of the document.

View the enum reference

Allowed:
line_items
array of objects
required

The individual line items that make up the bill.

line_items*
string

Any additional notes or comments related to the bill.

string

The order number associated with this bill, if any.

string | null

The project associated with this bill, if any.

string

Any additional reference information for this bill.

string
enum
Defaults to DRAFT

The current status of the bill (Draft, Authorized, or Paid).

View the enum reference

Allowed:
string
enum

Specifies whether the tax amount is inclusive or exclusive of the line item amounts.

View the enum reference

Allowed:
Headers
string

Client-provided UUID to uniquely identify a request

string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json