Approve bill

PATCH /api/v1/bills/{bill_id}/approval

Approve a bill and change status to 'forecasted'

Operation ID: approve_bill_api_v1_bills__bill_id__approval_patch · 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_id string required

Responses

200 Successful Response

Schema: BillResponse

id string required

Bill UUID.

business_id string required

Business UUID.

currency string

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

status integer | string required

Bill status (see schema description).

description string

Bill description.

bill_number string

Bill/invoice number from vendor.

vendor_id string required

Vendor UUID.

vendor_name string

Vendor name (resolved).

vendor_email string

Vendor email (resolved).

type integer | string required

Type: 'recurring' or 'one_time'.

expected_amount integer

Expected amount in cents.

expected_paid_on_date string · date-time

Expected payment date.

total_paid integer

Total amount paid so far in cents.

amount integer

Actual bill amount in cents.

s3_key string

S3 key of attached document.

received_on string · date-time

Date bill/goods received.

due_on string · date-time

Payment due date.

paid_on string · date-time

Date fully paid.

created_at string · date-time required

Creation timestamp.

updated_at string · date-time required

Last update timestamp.

signed_url string

Signed URL to view attached document.

payments array · object

List of payments made.

journal_entries array · object

Associated accounting entries.

recurring_template_id string

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

source_inventory_order_id string

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

401 Unauthorized - Authentication required

403 Forbidden - Insufficient permissions

404 Not Found - Resource does not exist

422 Validation Error

Schema: HTTPValidationError

detail array · ValidationError ValidationError
5 fields
loc array · string | integer required
msg string required
type string required
input object
ctx object