Overview
Bill tools provide full CRUD operations, approval workflow, and payment processing for accounts payable.CRUD Tools
finance_bill_create
Create a new vendor bill. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Unique bill ID |
vendor_id | string | Yes | Vendor ID |
ap_account_id | string | Yes | AP account ID |
tran_date | string | Yes | Transaction date |
due_date | string | Yes | Payment due date |
posting_period_id | string | Yes | Accounting period |
currency | string | No | Currency code (default: USD) |
memo | string | No | Bill description |
lines | array | Yes | Bill line items |
finance_bill_get
Retrieve a bill by ID. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
finance_bill_list
List bills with filters. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status |
vendor_id | string | No | Filter by vendor |
start_date | string | No | Filter by date |
end_date | string | No | Filter by date |
overdue | boolean | No | Only overdue bills |
finance_bill_update
Update a draft bill. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
due_date | string | No | Updated due date |
memo | string | No | Updated memo |
lines | array | No | Updated lines |
finance_bill_delete
Delete a draft bill. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
Workflow Tools
finance_bill_submit
Submit a bill for approval. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
idempotency_key | string | No | Prevent duplicates |
finance_bill_approve_l1
Level 1 approval. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
comments | string | No | Approval comments |
idempotency_key | string | No | Prevent duplicates |
finance_bill_approve_l2
Level 2 approval. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
comments | string | No | Approval comments |
idempotency_key | string | No | Prevent duplicates |
finance_bill_reject
Reject a bill. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
reason | string | Yes | Rejection reason |
finance_bill_request_change
Request changes to a bill. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
comments | string | Yes | Requested changes |
finance_bill_hold
Place a bill on hold. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
reason | string | No | Hold reason |
finance_bill_unhold
Remove a bill from hold. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
Payment Tools
finance_bill_pay
Create a payment for a bill. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
payment_account_id | string | Yes | Bank account ID |
payment_date | string | Yes | Payment date |
amount | number | Yes | Payment amount |
payment_method | string | No | Payment method |
reference | string | No | Payment reference |
finance_bill_payment_get
Get payment details. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
payment_id | string | Yes | Payment ID |
finance_bill_payment_list
List payments for a bill. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | No | Filter by bill |
vendor_id | string | No | Filter by vendor |
status | string | No | Filter by status |
finance_bill_payment_void
Void a bill payment. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
payment_id | string | Yes | Payment ID |
reason | string | Yes | Void reason |
finance_bill_void
Void a bill. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
bill_id | string | Yes | Bill ID |
reason | string | Yes | Void reason |