Accounts Payable
Subcontractor-ready AP: a bill capture inbox and vendor portal, retainage, lien waiver and COI payment holds, joint checks, NACHA, positive pay, virtual cards, remittance advice and 1099 outputs.
On this page
Accounts Payable takes a bill from capture to payment with the controls construction payables need: retainage payable, three-way and commitment matching, compliance holds that stop payment when a COI or lien waiver is missing, joint checks, ACH, check and positive pay files, virtual cards and emailed remittance advice. Vendors and subcontractors follow their bills and payments in their own portal. Open it from the company app launcher under Accounting > Accounts Payable; it appears when your accounting access includes it.
- Who uses it
- AP clerks enter bills; approvers approve and override holds; payment releasers release runs and download files.
- When
- As invoices arrive; weekly or on a pay cycle for payment runs; at year end for 1099s.
- What it holds
- Bills and vendor credits, lines coded to jobs and cost codes, holds, approvals, payment runs, checks, lien waivers, compliance documents and 1099 data.
- Connects to
- BankingApprovalsJob Cost Forecast
Key workflow
- Enter or draft the bill. Code lines to accounts, projects, cost codes and cost types. Retainage defaults from the commitment, then the vendor profile; due and discount dates come from terms. Ready to bill drafts bills from approved subcontract requisitions (for the period amount, never the cumulative claim) and approved direct costs. A suspected duplicate invoice is stopped unless an approver records an override reason.
- Submit and match. Submission runs the commitment and three-way match against purchase order receipts and applies the over-commitment rule. The approval route is resolved and shown before anyone approves.
- Clear holds. The bill’s Payment holds panel lists what blocks payment: an expired certificate of insurance or license, a required compliance document missing, a missing W-9, a missing lien waiver (or a prior unconditional waiver whose amount or through date does not cover the prior payment), a stop pay, a TIN mismatch, backup withholding held instead of withheld, a returned ACH payment, an unpaid owner pay app on a pay-when-paid bill, or a recent vendor bank change (a cool-off that cannot be overridden). Override needs AP approval rights and a reason, compliance and payment holds also need payment release permission, and an override can expire.
- Build the payment run. Select open bills with their payable amount (pay-when-paid aware) and any early-pay discount, choose the pay-from bank and see the cash left after the run. Pay by check or ACH, add up to five joint payees, or record an owner-direct payment.
- Release and produce files. A different person releases the run. Then download printable checks with the MICR line, the NACHA file (CCD+ for business accounts, PPD for consumer accounts) and the positive pay file.
- Reconcile. Match the bank activity in Banking, and tie out the AP and retainage subledgers to the general ledger.
Retainage, lien waivers and compliance
Retainage payable is held per bill line and released with its own posting. A final release requires the vendor’s conditional final waiver, prior unconditional progress waivers and every lower tier’s unconditional final waiver. Pay-when-paid bills also need the owner payment. A release can be voided while it is still unpaid.
Record conditional or unconditional, progress or final waivers for the vendor or a lower-tier party in the vendor’s Lien waivers received panel, or accept one a vendor uploaded through the portal. An unconditional waiver can name the AP payment it covers. Lien waivers required for in AP settings (Nobody, Subcontracts or All vendors) decides which bills are held without one. Compliance requirements make a document kind, such as a COI or license, mandatory for every vendor, one vendor or the vendor on one commitment. AP users get a daily email of documents expiring in 30 days, 15 days or today. Company administrators also see vendor-linked insurance records and pending supplier COIs on the vendor page; that panel is for navigation and changes no hold.
Employee reimbursements
An independently approved employee expense claim from the project Expense Reports tool can be handed off as one draft AP bill to a verified employee payee. The claimant, the claim reviewer and the person converting it must all differ, none of them can approve the bill, and the bill then follows the normal approval and payment run. A claim produces at most one bill.
Capture inbox, vendor portal and virtual cards
None of these AP automation features uses AI.
- Bill capture inbox. Bills arrive by upload, by email to the company’s capture address (your mail provider forwards each message to a signed webhook), or from the vendor portal. Files from outside the company are security scanned and kept as downloads. Each captured document is checked for duplicates by file hash and by vendor and invoice number, can be assigned to a clerk, and moves from new to in progress to drafted or rejected with every change audited. The clerk keys the header and codes the lines; suggestions for the vendor, account and cost code coding, and open commitment lines come from fixed rules over the vendor’s posted bills and commitments. Drafting creates an unapproved bill through the normal rules, with the file attached; the drafter cannot approve it.
- Vendor and subcontractor portal. An AP approver invites a vendor contact to a separate, isolated portal account. Vendors see their own bills, payments, remittance advice and retainage held, plus which compliance documents are current, expired or missing. They can submit invoices and pay apps to the capture inbox, upload COIs and lien waivers that stay pending until an AP user accepts them under Compliance uploads to review on the Vendor portal tab, and (as a vendor admin) request a bank detail change. That change is forwarded by one internal user with step-up and approved by a different one before it applies, followed by the usual cool-off.
- Virtual cards. With virtual cards turned on, a payment run can pay a vendor by single-use virtual card. Release posts the payment to a clearing account and issues one card per payment, locked to the payment amount. Settlements pulled from the provider post once each to the funding bank account and are matched to a statement line when exactly one fits. A card can be voided while unused; the void also finds and cancels a card the provider issued even if its answer never arrived. If the provider reports the card already charged, the void is refused: sync settlements, then record a refund. Virtual card payments never appear in NACHA or positive pay files.
- Remittance advice. Every released payment, by any method, can email remittance advice to the vendor’s remittance address and portal users. It lists each bill paid with the invoice number, amount applied, discount, backup withholding and retainage still held, and never shows a bank or card number. Resends are audited.
1099 and backup withholding
1099 review totals the year’s AP payments plus Banking checks and withdrawals by payer entity, applying the $2,000 NEC threshold and excluding card payments reported on a 1099-K. Export the IRS IRIS Taxpayer Portal CSV (Pub 5717) or a Pub 1220 FIRE file, print recipient Copy B, and run IRS bulk TIN Matching. Vendors without a tax ID are paid net of 24% backup withholding; CP2100 B notices, Form 945 data and EFTPS deposit records are supported.
Controls
- The preparer or last editor of a bill cannot approve it, override its holds or release its payment. The preparer of a run cannot release it.
- A vendor bank or tax ID change applies only after a second person approves it, with a cool-off before payments to the new account.
- Payment files need payment-release permission and identity step-up. A NACHA re-send needs a reason and two people, and checks the bank configuration again.
- Bills carry a revision number; a stale edit is refused instead of overwriting someone else’s change.
Current boundaries
For the full procedure, exceptions and examples, read the Accounts payable workflow guide.
API operations
98 operations · 40 read · 58 write · base path /rest/v1.0/companies/{company_id}/accounting
- GET
/ap/agingAP aging as of a date - GET
/ap/automation/settingsGet AP automation settings - PATCH
/ap/automation/settingsUpdate AP automation settings - GET
/ap/backup_noticesList CP2100 B notices - POST
/ap/backup_noticesRecord a CP2100 B notice - PATCH
/ap/backup_notices/{id}Mark a B notice letter sent or record the cure - GET
/ap/backup_notices/{id}/letterB notice letter - GET
/ap/billsList bills and vendor credits - POST
/ap/billsCreate a draft bill or vendor credit - GET
/ap/bills/{id}Show a bill - PATCH
/ap/bills/{id}Edit a draft or pending bill - DELETE
/ap/bills/{id}Delete a draft bill - POST
/ap/bills/{id}/apply_creditApply a vendor credit to a bill - POST
/ap/bills/{id}/approveApprove a bill - GET
/ap/bills/{id}/attachmentsList attachments on a bill - POST
/ap/bills/{id}/attachmentsAttach a file to a bill - POST
/ap/bills/{id}/override_holdOverride a hold - POST
/ap/bills/{id}/rejectReject a bill (return to the preparer) - POST
/ap/bills/{id}/release_retainageRelease retainage payable - POST
/ap/bills/{id}/rematchRe-run the three-way match - POST
/ap/bills/{id}/submitSubmit a bill for approval - POST
/ap/bills/{id}/unapply_creditUndo a vendor credit application - POST
/ap/bills/{id}/voidVoid a posted bill - POST
/ap/bills/from_sourceDraft a bill from a requisition or direct cost - GET
/ap/capture/documentsList the capture inbox - POST
/ap/capture/documentsUpload a bill document to the capture inbox - GET
/ap/capture/documents/{id}Get a captured document - PATCH
/ap/capture/documents/{id}Key, assign or progress a captured document - POST
/ap/capture/documents/{id}/draft_billDraft a bill from a captured document - GET
/ap/capture/documents/{id}/fileDownload a captured file - POST
/ap/capture/documents/{id}/rejectReject a captured document - GET
/ap/capture/documents/{id}/suggestionsCoding suggestions for a captured document - POST
/ap/checks/{id}/reprintReprint a check under a new number - GET
/ap/compliance_requirementsList compliance requirements - POST
/ap/compliance_requirementsRequire a compliance document - DELETE
/ap/compliance_requirements/{id}Drop a compliance requirement - GET
/ap/form_10991099 review - GET
/ap/form_1099/copy_b1099 recipient Copy B - POST
/ap/form_1099/irisExport 1099s as IRIS Taxpayer Portal CSV files - POST
/ap/form_1099/pub1220Export 1099s as an IRS Pub 1220 file - GET
/ap/form_945Form 945 data - POST
/ap/form_945/eftpsEFTPS 945 deposits - GET
/ap/match_exceptionsList three-way match exceptions - GET
/ap/match_exceptions/{id}Show a match exception - POST
/ap/match_exceptions/{id}/overrideOverride a match exception - GET
/ap/payment_runsList payment runs - POST
/ap/payment_runsCreate a draft payment run - GET
/ap/payment_runs/{id}Show a payment run - DELETE
/ap/payment_runs/{id}Delete a draft run - GET
/ap/payment_runs/{id}/checksCheck print data - GET
/ap/payment_runs/{id}/nachaACH (NACHA) file - POST
/ap/payment_runs/{id}/nachaRe-send the ACH (NACHA) file - GET
/ap/payment_runs/{id}/positive_payPositive pay file (CSV) - POST
/ap/payment_runs/{id}/rejectReject a payment run release - POST
/ap/payment_runs/{id}/releaseRelease (approve) and post a payment run - GET
/ap/payment_selectionPayment selection - GET
/ap/paymentsList payments - POST
/ap/paymentsCreate one manual payment - GET
/ap/payments/{id}Show a payment - GET
/ap/payments/{id}/remittanceGet a payment's remittance advice - POST
/ap/payments/{id}/remittance/sendEmail a payment's remittance advice - POST
/ap/payments/{id}/virtual_card/issueRetry a virtual card issue - POST
/ap/payments/{id}/voidVoid a payment - GET
/ap/receiptsList PO receipts - POST
/ap/receiptsReceive against a purchase order - POST
/ap/receipts/{id}/voidVoid a PO receipt - POST
/ap/retainage_releases/{id}/voidVoid a retainage release - GET
/ap/settingsAP settings - PATCH
/ap/settingsUpdate AP settings - GET
/ap/tie_outAP subledger tie-out - POST
/ap/tin_matching/exportExport an IRS bulk TIN Matching request file - POST
/ap/tin_matching/importImport IRS bulk TIN Matching results - GET
/ap/vendor_portal/bank_change_requestsList portal bank change requests - POST
/ap/vendor_portal/bank_change_requests/{id}/forwardForward a bank change request for approval - POST
/ap/vendor_portal/bank_change_requests/{id}/rejectReject a bank change request - GET
/ap/vendor_portal/grantsList vendor portal users - POST
/ap/vendor_portal/grants/{id}/revokeRevoke a vendor portal user's access - GET
/ap/vendor_portal/invitationsList vendor portal invitations - POST
/ap/vendor_portal/invitationsInvite a user to a vendor's portal - POST
/ap/vendor_portal/invitations/{id}/revokeRevoke a pending invitation - GET
/ap/vendor_portal/submissionsList portal compliance submissions - POST
/ap/vendor_portal/submissions/{id}/acceptAccept a portal compliance submission - POST
/ap/vendor_portal/submissions/{id}/rejectReject a portal compliance submission - GET
/ap/vendorsList AP vendors - GET
/ap/vendors/{id}Show an AP vendor - GET
/ap/vendors/{id}/attachmentsList attachments on a vendor - POST
/ap/vendors/{id}/attachmentsAttach a file to a vendor - GET
/ap/vendors/{id}/automationGet a vendor's remittance and capture settings - PATCH
/ap/vendors/{id}/automationUpdate a vendor's remittance and capture settings - POST
/ap/vendors/{id}/complianceRecord a compliance document - PATCH
/ap/vendors/{id}/compliance/{compliance_id}Lift or reinstate a compliance record - GET
/ap/vendors/{id}/compliance/{compliance_id}/attachmentsList attachments on a vendor compliance record (COI, W-9, license) - POST
/ap/vendors/{id}/compliance/{compliance_id}/attachmentsAttach a file to a vendor compliance record (COI, W-9, license) - POST
/ap/vendors/{id}/lien_waiversRecord a lien waiver received - GET
/ap/vendors/{id}/lien_waivers/{waiver_id}/attachmentsList attachments on a lien waiver - POST
/ap/vendors/{id}/lien_waivers/{waiver_id}/attachmentsAttach a file to a lien waiver - GET
/ap/virtual_cardsList virtual card payments - POST
/ap/virtual_cards/sync_settlementsSync virtual card settlements
Parameters, request and response fields, errors and a generated example for each operation are in the REST reference for this app. Read scopes, step-up and permissions in the Accounting API guide.
Keep exploring
Related across os.construction
- DocsAccounts payableEnter, approve and pay company bills with entity-scoped controls.
- GlossaryPayment runA batch process that selects approved bills due for payment, applies holds, gets release approval, and produces checks or electronic payments.
- GlossaryAccounts payableMoney your company owes to subcontractors, suppliers and vendors for work, materials and services already billed.
- BlogThe 3-way match, explained for construction APThe textbook 3-way match is a purchase order, a receiving report and an invoice. Construction AP needs a version that works for subcontracts, progress billing, retainage and lien waivers. Here's what to match, and where it breaks.
- BlogHow to review a subcontractor pay application before you approve itA general contractor's review of a subcontractor pay application checks the contract and change orders, verifies progress with the field, tests stored materials and retainage, confirms insurance, lien waivers and other compliance, and checks the math, before approving an amount AP can pay. Here is each step with a worked review that cuts a $384,000 request to $307,000.
- DocsAccounting security and controlsUnderstand company accounting access, approvals and correction controls.
Was this helpful?
Run it on your own project.
Start a 14-day free trial. Want a say in what ships next? Join the founding program.
14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →