Create bill in received status

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

Schema: BillReceivedCreateRequest

vendor_idstringrequired

UUID of the vendor this bill is from (required).

amountintegerrequired

Bill amount in cents (required).

descriptionstring

Description of what the bill is for.

bill_numberstring

Bill/invoice number from the vendor. Auto-generated if not provided.

currencystring

Currency for the bill (USD, CAD, AUD, EUR, or GBP). Defaults to business default.

typestring

Bill type: 'recurring' or 'one_time'. Defaults to 'one_time'.

received_onstring · date-time | string

Date the bill was received (ISO 8601). Defaults to now.

due_onstring · date-time | string

Payment due date (ISO 8601).

s3_keystring

S3 key of uploaded bill document (PDF/image).

ledger_idstring

UUID of the expense ledger for journal entry creation. If provided, creates journal entry automatically. Ignored when line_items is provided.

line_itemsarray · JournalEntryLineItem

Split journal entry lines. Each line specifies a debit account and amount. The credit side is always Accounts Payable. When provided, ledger_id is ignored.

journal_entry_datestring · date-time | string · date | string

Date for the accounting journal entry (ISO 8601 or YYYY-MM-DD). Defaults to received_on if not provided.

Responses