Get Started

Generate bill journal entry

POST/api/v1/bills/{bill_id}/journal-entry

Create the outstanding AP journal entry for a received bill that has none linked.

Operation ID: generate_bill_journal_entry_api_v1_bills__bill_id__journal_entry_post·View as markdown·OpenAPI slice

Authentication

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

Parameters

Path

bill_idstringrequired

Request body

Schema: BillJournalEntryGenerateRequest

ledger_idstringrequired

UUID of the expense ledger account to debit.

journal_entry_datestring · date-time | string · date | string

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

Responses

201Successful Response

Schema: BillResponse

idstringrequired

Bill UUID.

business_idstringrequired

Business UUID.

currencystring

Currency for the bill (USD, CAD, AUD, EUR, or GBP).

statusinteger | stringrequired

Bill status (see schema description).

descriptionstring

Bill description.

bill_numberstring

Bill/invoice number from vendor.

vendor_idstringrequired

Vendor UUID.

vendor_namestring

Vendor name (resolved).

vendor_emailstring

Vendor email (resolved).

typeinteger | stringrequired

Type: 'recurring' or 'one_time'.

expected_amountinteger

Expected amount in cents.

expected_paid_on_datestring · date-time

Expected payment date.

total_paidinteger

Total amount paid so far in cents.

amountinteger

Actual bill amount in cents.

s3_keystring

S3 key of attached document.

received_onstring · date-time

Date bill/goods received.

due_onstring · date-time

Payment due date.

paid_onstring · date-time

Date fully paid.

payment_methodstring

Payment method (Wire Transfer, ACH, Check, Credit Card). Prefers the user-set override; otherwise inferred from a linked payment.

created_atstring · date-timerequired

Creation timestamp.

updated_atstring · date-timerequired

Last update timestamp.

signed_urlstring

Signed URL to view attached document.

paymentsarray · object

List of payments made.

journal_entriesarray · object

Associated accounting entries.

recurring_template_idstring

ID of recurring template if this bill was generated from one, or if one was created.

source_inventory_order_idstring

Source PO that produced this bill via the PO lifecycle. Non-null means this bill is visible on the Inventory -> Accounts Payable tab.

match_statusstring

Three-way match outcome: matched, qty_variance, price_variance, qty_and_price_variance, unmatched, no_po. None until the matcher has run on the bill.

match_variance_qtyinteger

Signed unit variance across all lines (received - ordered). Positive = over-received; negative = short.

match_variance_amount_centsinteger

Signed amount variance in cents (bill amount - PO total). Positive = vendor billed more than ordered; negative = less.

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

409Conflict - Resource already exists

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject