Esc

↑↓ move↵ openIndex · Pagefind
Accounting apps / Accounts Payable

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.

Key workflow

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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

  1. GET /ap/agingAP aging as of a date
  2. GET /ap/automation/settingsGet AP automation settings
  3. PATCH /ap/automation/settingsUpdate AP automation settings
  4. GET /ap/backup_noticesList CP2100 B notices
  5. POST /ap/backup_noticesRecord a CP2100 B notice
  6. PATCH /ap/backup_notices/{id}Mark a B notice letter sent or record the cure
  7. GET /ap/backup_notices/{id}/letterB notice letter
  8. GET /ap/billsList bills and vendor credits
  9. POST /ap/billsCreate a draft bill or vendor credit
  10. GET /ap/bills/{id}Show a bill
  11. PATCH /ap/bills/{id}Edit a draft or pending bill
  12. DELETE /ap/bills/{id}Delete a draft bill
  13. POST /ap/bills/{id}/apply_creditApply a vendor credit to a bill
  14. POST /ap/bills/{id}/approveApprove a bill
  15. GET /ap/bills/{id}/attachmentsList attachments on a bill
  16. POST /ap/bills/{id}/attachmentsAttach a file to a bill
  17. POST /ap/bills/{id}/override_holdOverride a hold
  18. POST /ap/bills/{id}/rejectReject a bill (return to the preparer)
  19. POST /ap/bills/{id}/release_retainageRelease retainage payable
  20. POST /ap/bills/{id}/rematchRe-run the three-way match
  21. POST /ap/bills/{id}/submitSubmit a bill for approval
  22. POST /ap/bills/{id}/unapply_creditUndo a vendor credit application
  23. POST /ap/bills/{id}/voidVoid a posted bill
  24. POST /ap/bills/from_sourceDraft a bill from a requisition or direct cost
  25. GET /ap/capture/documentsList the capture inbox
  26. POST /ap/capture/documentsUpload a bill document to the capture inbox
  27. GET /ap/capture/documents/{id}Get a captured document
  28. PATCH /ap/capture/documents/{id}Key, assign or progress a captured document
  29. POST /ap/capture/documents/{id}/draft_billDraft a bill from a captured document
  30. GET /ap/capture/documents/{id}/fileDownload a captured file
  31. POST /ap/capture/documents/{id}/rejectReject a captured document
  32. GET /ap/capture/documents/{id}/suggestionsCoding suggestions for a captured document
  33. POST /ap/checks/{id}/reprintReprint a check under a new number
  34. GET /ap/compliance_requirementsList compliance requirements
  35. POST /ap/compliance_requirementsRequire a compliance document
  36. DELETE /ap/compliance_requirements/{id}Drop a compliance requirement
  37. GET /ap/form_10991099 review
  38. GET /ap/form_1099/copy_b1099 recipient Copy B
  39. POST /ap/form_1099/irisExport 1099s as IRIS Taxpayer Portal CSV files
  40. POST /ap/form_1099/pub1220Export 1099s as an IRS Pub 1220 file
  41. GET /ap/form_945Form 945 data
  42. POST /ap/form_945/eftpsEFTPS 945 deposits
  43. GET /ap/match_exceptionsList three-way match exceptions
  44. GET /ap/match_exceptions/{id}Show a match exception
  45. POST /ap/match_exceptions/{id}/overrideOverride a match exception
  46. GET /ap/payment_runsList payment runs
  47. POST /ap/payment_runsCreate a draft payment run
  48. GET /ap/payment_runs/{id}Show a payment run
  49. DELETE /ap/payment_runs/{id}Delete a draft run
  50. GET /ap/payment_runs/{id}/checksCheck print data
  51. GET /ap/payment_runs/{id}/nachaACH (NACHA) file
  52. POST /ap/payment_runs/{id}/nachaRe-send the ACH (NACHA) file
  53. GET /ap/payment_runs/{id}/positive_payPositive pay file (CSV)
  54. POST /ap/payment_runs/{id}/rejectReject a payment run release
  55. POST /ap/payment_runs/{id}/releaseRelease (approve) and post a payment run
  56. GET /ap/payment_selectionPayment selection
  57. GET /ap/paymentsList payments
  58. POST /ap/paymentsCreate one manual payment
  59. GET /ap/payments/{id}Show a payment
  60. GET /ap/payments/{id}/remittanceGet a payment's remittance advice
  61. POST /ap/payments/{id}/remittance/sendEmail a payment's remittance advice
  62. POST /ap/payments/{id}/virtual_card/issueRetry a virtual card issue
  63. POST /ap/payments/{id}/voidVoid a payment
  64. GET /ap/receiptsList PO receipts
  65. POST /ap/receiptsReceive against a purchase order
  66. POST /ap/receipts/{id}/voidVoid a PO receipt
  67. POST /ap/retainage_releases/{id}/voidVoid a retainage release
  68. GET /ap/settingsAP settings
  69. PATCH /ap/settingsUpdate AP settings
  70. GET /ap/tie_outAP subledger tie-out
  71. POST /ap/tin_matching/exportExport an IRS bulk TIN Matching request file
  72. POST /ap/tin_matching/importImport IRS bulk TIN Matching results
  73. GET /ap/vendor_portal/bank_change_requestsList portal bank change requests
  74. POST /ap/vendor_portal/bank_change_requests/{id}/forwardForward a bank change request for approval
  75. POST /ap/vendor_portal/bank_change_requests/{id}/rejectReject a bank change request
  76. GET /ap/vendor_portal/grantsList vendor portal users
  77. POST /ap/vendor_portal/grants/{id}/revokeRevoke a vendor portal user's access
  78. GET /ap/vendor_portal/invitationsList vendor portal invitations
  79. POST /ap/vendor_portal/invitationsInvite a user to a vendor's portal
  80. POST /ap/vendor_portal/invitations/{id}/revokeRevoke a pending invitation
  81. GET /ap/vendor_portal/submissionsList portal compliance submissions
  82. POST /ap/vendor_portal/submissions/{id}/acceptAccept a portal compliance submission
  83. POST /ap/vendor_portal/submissions/{id}/rejectReject a portal compliance submission
  84. GET /ap/vendorsList AP vendors
  85. GET /ap/vendors/{id}Show an AP vendor
  86. GET /ap/vendors/{id}/attachmentsList attachments on a vendor
  87. POST /ap/vendors/{id}/attachmentsAttach a file to a vendor
  88. GET /ap/vendors/{id}/automationGet a vendor's remittance and capture settings
  89. PATCH /ap/vendors/{id}/automationUpdate a vendor's remittance and capture settings
  90. POST /ap/vendors/{id}/complianceRecord a compliance document
  91. PATCH /ap/vendors/{id}/compliance/{compliance_id}Lift or reinstate a compliance record
  92. GET /ap/vendors/{id}/compliance/{compliance_id}/attachmentsList attachments on a vendor compliance record (COI, W-9, license)
  93. POST /ap/vendors/{id}/compliance/{compliance_id}/attachmentsAttach a file to a vendor compliance record (COI, W-9, license)
  94. POST /ap/vendors/{id}/lien_waiversRecord a lien waiver received
  95. GET /ap/vendors/{id}/lien_waivers/{waiver_id}/attachmentsList attachments on a lien waiver
  96. POST /ap/vendors/{id}/lien_waivers/{waiver_id}/attachmentsAttach a file to a lien waiver
  97. GET /ap/virtual_cardsList virtual card payments
  98. 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

Run it on your own project.

Start a 14-day free trial. Want a say in what ships next? Join the founding program.

Your role (optional)

14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →

Ask the OS

Reading this page

Ask anything about this page. Answers use what you're reading as context.

Suggested

    AI · may be imperfect · sample data where shown

    Open file