1. Overview
The Accounts Payable Vouchers (APV) module lets you turn supplier invoices (bills) into formal vouchers that go through validation and approval before they are posted to payables.
You’ll find it in:
Financials → Accounts Payable → Accounts Payable Vouchers
URL: /dashboard/accounts-payable-vouchers
From this screen you can:
See all APVs that have been created for your business.
Create a new APV from a supplier bill.
Send APVs for approval and track their status.
2. Key Features
From the repository docs and UI, the APV module provides these features:
APV list with status tabs
Tabs across the top: All, Draft, Ready for Approval, In Review, Approved.
Each tab shows vouchers in that status.
Search and columns
Search bar: “Search by vendor, invoice, or APV number” (from the UI screenshot).
Columns in the table: APV Number, Vendor, Invoice, Amount, Status, Created.
New APV creation form
Button on the top-right: New APV (opens the “Generate an Accounts Payable Voucher” screen).
Required invoice fields: Vendor name, Invoice number, Invoice date, Invoice amount.
Optional fields: Currency, Tax amount, Invoice description, Supporting documents.
A Select Bill control at the top that lets you choose an existing bill to pre-fill these details (seen in the wireframe and screenshot).
Bill validation and APV number assignment
When you click Validate & Generate APV, the system first validates the bill details (/validate-bill).
If valid, it creates the voucher, assigns an APV-YYYY-#### number, and sets status to READY_FOR_APPROVAL.
Approval workflow
Route for approval: moves an APV from READY_FOR_APPROVAL to IN_REVIEW and stores optional approval notes.
Approve: moves an APV from IN_REVIEW to APPROVED.
Status changes are visible in the list and via the Statuses endpoint.
Attachments / Supporting documents
You can add file keys or URLs as supportingDocuments (e.g. scanned invoice PDF).
3. Getting Started
3.1 Open the Accounts Payable Vouchers module
Log in to your DizLog account.
In the left menu, go to Financials → Accounts Payable → Accounts Payable Vouchers.
The APV list page opens with the All tab selected.
You should now see:
Status tabs across the top.
A search box.
An empty list (if you have no vouchers yet) or a table of existing APVs.
3.2 Understand how this module connects to other modules
From the repository and navigation structure:
Bills (Financials → Accounts Payable → Bill)
APVs are created from supplier bills. The Select Bill popup in the APV form shows bills with reference, supplier, dates, and outstanding balance, and lets you pick one to generate an APV. (As seen in the “Select Bill” modal screenshot.)
Accounts Payable area
APVs live alongside Bill, Expense, Cheque Voucher, Cheque, Accounts Payable Summary, Accounts Payable Detail in the Accounts Payable menu. This reflects the typical flow:
Bill → Accounts Payable Voucher (APV) → Approval → (then payment and reporting).
You normally:
Record the supplier invoice in Bill.
Generate an APV for that invoice and get it approved.
Use your payment modules (for example Cheque Voucher / Cheque) and reports knowing the invoice has gone through approval.
4. How to Use
4.1 View existing Accounts Payable Vouchers
Open Accounts Payable Vouchers.
Choose a status tab:
All – everything.
Draft – saved but not yet ready for approval.
Ready for Approval – waiting to be routed or reviewed.
In Review – with approvers.
Approved – completed vouchers.
Use the Search bar to filter by:
Vendor name
Invoice number
APV number
The table will show matching APVs with their APV Number, Vendor, Invoice, Amount, Status, Created date.
4.2 Create a new Accounts Payable Voucher from a Bill
Step 1 – Start a new APV
On the APV list page, click New APV (top-right).
You land on the Generate an Accounts Payable Voucher screen. (The heading in the UI matches the docs.
Step 2 – Select the bill
In the Select Bill* field, click the dropdown or button.
A Select Bill popup appears showing:
Bill number and reference
Supplier
Bill and due dates
Outstanding amount (from the screenshot).
You can filter bills in the popup by:
Status
Date From / Date To
Search by bill number
Click the bill you want. The popup closes and the main form is filled with that bill’s:
Vendor name
Invoice number
Invoice date
Amount
Tax amount (if any)
Description
(If you don’t select a bill, you can type these fields manually.)
Step 3 – Check and fill in invoice details
In the Voucher form, make sure the following are correct:
Vendor name* – supplier’s name (required).
Invoice number* – supplier invoice number (required).
Invoice date* – the date on the invoice (required).
Invoice amount* – total amount of the invoice (required, must be ≥ 0).
Currency – defaults to your business currency if empty; up to 4 characters (e.g. PHP).
Tax amount – optional, can be zero or more.
Invoice description – short text like “May corrugated boxes” (optional).
Supporting documents – paste or upload file keys / URLs of invoice scans (optional).
Step 4 – Validate the bill
Click Validate & Generate APV.
The system calls Validate bill (/accounts-payable-vouchers/validate-bill) to check that required fields are filled and properly formatted.
If the data passes validation, you’ll see a success response and the form remains with the cleaned values. Docs suggest showing a message like “Bill looks good. You can generate the APV now.”
Step 5 – Generate the APV
After validation, the system creates the voucher (POST /accounts-payable-vouchers) using the same data.
The backend:
Saves the voucher.
Assigns the next APV number like APV-2024-0007.
Sets status = READY_FOR_APPROVAL.
You are returned to the list or a detail page showing the new APV.
4.3 Route an APV for approval
Once an APV is READY_FOR_APPROVAL:
Open the APV (from the list) or select its action menu.
Choose Route for approval (wording may vary but it calls /accounts-payable-vouchers/:id/route-for-approval).
Optionally add approval notes such as “Rush payment before month-end”.
Confirm. The status changes to IN_REVIEW.
4.4 Approve an APV
When reviewers have checked the invoice:
Open the APV that is in IN_REVIEW.
Choose Approve (calls /accounts-payable-vouchers/:id/approve).
The status updates to APPROVED and the timestamps are refreshed.
Approved vouchers can then be used as the basis for posting to payables and, together with your payment modules (such as cheques), form your full Accounts Payable flow.
5. Troubleshooting
This section is based on the error handling described for the APV API.
5.1 “Missing required bill fields”
When it happens
After clicking Validate & Generate APV, you see an error message like:
Missing required bill fields with a list of fields.
What to do
Check that Vendor name, Invoice number, Invoice date, Invoice amount are all filled in.
Correct any highlighted fields.
Click Validate & Generate APV again.
5.2 “Only vouchers ready for approval can be routed.”
When it happens
You try to route an APV but its status is not READY_FOR_APPROVAL.
What to do
Go back to the APV list and check the Status column.
If the APV is still DRAFT, make sure it has been properly generated (validation + creation).
Once it shows READY_FOR_APPROVAL, try routing again.
5.3 “Only APVs in review can be approved.”
When it happens
You click Approve but the APV is not in IN_REVIEW status.
What to do
Confirm that the voucher was routed for approval first.
If it is still READY_FOR_APPROVAL, route it again and then approve.
5.4 “Accounts payable voucher not found”
When it happens
You open or act on an APV that has been deleted or belongs to another business.
What to do
Return to the Accounts Payable Vouchers list.
Search again by APV number, vendor, or invoice.
If you still cannot find it, check that you are in the correct business account or ask an admin if it was removed.
If you follow the steps above, you can confidently create, route, and approve Accounts Payable Vouchers in DizLog, keeping a clear, auditable trail from each supplier bill through to final approval.