Start free trial

Send bill for approval

POST/api/v1/bills/{bill_id}/submit-for-approval

Submit a cleaned-up draft bill into the AP approval workflow. The bill moves to 'pending_approval' and is NOT posted to the general ledger until an approver signs off, at which point it posts to 'received'. Requires the business to have the approval workflow enabled.

Operation ID: submit_bill_for_approval_api_v1_bills__bill_id__submit_for_approval_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: BillReceivedRequest

bill_idstring

UUID of the bill (set automatically from URL path).

amountintegerrequired

Actual bill amount in cents. Must be greater than 0.

ledger_idstringrequired

UUID of the expense ledger account to categorize this bill. Required for creating the journal entry.

s3_keystring

S3 key of the bill document.

journal_entry_datestring · date-time | string · date | string

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

received_onstring · date-time | string · date | string

Date the bill/goods were received (ISO 8601 or YYYY-MM-DD).

due_onstring · date-time | string · date | string

Payment due date (ISO 8601 or YYYY-MM-DD).

Responses

201Successful Response

Schema: SuccessEnvelope_BillResponse_

successboolean
messagestring
codestring
dataBillResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

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