Accounts Receivable
Bill certified G702/G703 pay apps and five other billing methods, manage retainage receivable, collect with dunning, disputes and promises, and take online payments in the customer billing portal.
On this page
Accounts Receivable turns certified owner pay apps and other contract billings into invoices, tracks retainage receivable through closeout, and applies customer cash. Collections runs dunning, disputes and promises to pay, and customers can view and pay invoices in the customer billing portal. Every invoice, receipt and reversal needs an independent approver. Open it from the company app launcher under Accounting > Accounts Receivable; it appears when your accounting access includes it.
- Who uses it
- AR clerks prepare invoices and receipts and work collections; AR approvers approve, post, deposit, reverse and manage dunning and portal links; customers pay through the billing portal.
- When
- Each billing cycle; as payments arrive; at closeout for retainage.
- What it holds
- Invoices with revisions, receipts and allocations, deposits, credit memos, refunds, collection notes and activities, disputes, promises to pay, dunning policies and sends, portal billing links, online payments and closeout documents.
Key workflow
- Bill the pay app. For a progress contract, create the invoice from an approved owner pay app. The pay app is recalculated with the G702 math against retainage already billed and must reproduce its certified amount before the invoice is drafted. Download a G702/G703-style PDF of the certified pay app.
- Bill other contract types. Time and materials, cost-plus, unit price, GMP and milestone contracts bill from their approved billing terms. Terms changes are proposed by one person and approved by another before billing uses them.
- Approve, post and send. An independent approver approves the invoice, then it posts. Queue a posted invoice to email the billing contact with the PDF attached.
- Record and deposit cash. Record a receipt allocated to open invoice lines, approve and post it, then deposit posted receipts from undeposited funds to the bank in one entry.
- Follow collections. Work the collections worklist, let dunning policies send reminders, and record calls, disputes and promises to pay. Use aging as of any date and customer statements. Customers can see and pay their invoices in the customer billing portal.
- Bill in the customer’s currency. An invoice and its receipts can carry a foreign currency and exchange rate (by default the spot rate on the posting date). Collecting at a different rate posts the realized gain or loss automatically; see Foreign Currency.
Retainage receivable and closeout
Retainage is calculated separately on completed work and stored materials and tracked by contract. To bill held retainage, open a posted invoice and use Release retainage: Draft retainage release creates a retainage release invoice that is submitted, approved and posted like any invoice. An AR approver keeps each prime contract’s closeout checklist under Invoices > Contract closeout (or Contract closeout checklist on a posted contract invoice): manual requirements such as consent of surety, final waivers or punch list complete, marked received after review, and approved submittal revisions linked as evidence, which count only while they stay approved and current. A release that empties the contract’s open retainage, from a pay app or a retainage release invoice, is refused until every required item is complete; partial releases are not gated. Customer tax exemption certificates valid on the invoice date remove sales tax from pay-app invoices, and on a project with a job site, sales tax is computed per jurisdiction by the sales and use tax engine.
Collections and dunning
Collections is fully rule-based: no prediction, scoring model or AI. Open it under Accounting > Accounts Receivable > Collections.
- Dunning. One policy per customer class, with steps at a number of days before or after the due date (for example −5, +1, +15, +30 and +60), each with its own email subject and body. Sends fall on business days, skip company holidays and wait out quiet hours in the accounting time zone. A step can also email the customer’s collector to escalate. The daily run sends each step for an invoice at most once, even when it is re-run or two runs overlap; after a pause only the latest due step goes out.
- Dunning follows the edition. The Professional and Enterprise editions switch dunning on, adding the default policy only when the company has none; Essentials leaves it off. Applying an edition cannot switch dunning off while any open invoice is part-way through its reminder sequence, and switching it off needs a reason. You can still pause customers with a hold, or switch dunning off on the collections settings page, which is audited.
- Pauses and suppression. No reminder goes out while an invoice is disputed, covered by an open promise to pay, or its customer is on hold. Paid and fully credited invoices are never reminded, and retainage is not collected until a release bills it.
- Worklist. Customers with open current AR, ranked by open amount weighted by age and by risk (broken promises in the last year, and paying slower than terms). Disputed invoices are shown separately. Each customer has a collector, hold, next follow-up date, days to pay, and a log of calls, emails and notes.
- Disputes and promises. A dispute has a reason code (pricing, quantity, quality, not received, duplicate, retainage, change order, documentation or other) and an amount, and moves the invoice into the aging’s Disputed column. A promise to pay has a date and amount, for named invoices or the whole customer, and is marked kept when posted receipts reach it within its window, or broken the day after the window closes.
- Reports. Collection effectiveness index (CEI), days sales outstanding (DSO), promise-kept rate and dispute aging, with retainage left out of the receivables.
Customer billing portal and online payment
Billing pages are added to the existing customer portal; there is no separate sign-in. An AR approver links a customer’s portal grant to one AR customer, and revoking the link takes effect at once. The customer then sees only its own posted invoices billed on that grant’s project:
- open invoices and pay apps, the statement and aging, and payment history;
- invoice PDFs and the G702/G703 for a pay app;
- a dispute form on each invoice, and a promise-to-pay form, both landing in the staff collections workbench;
- online payment of selected current invoices by card or ACH.
Starting a payment creates a draft receipt against a clearing account. When the provider confirms it through a signed, replay-safe webhook, the receipt posts and applies the cash; if an invoice was paid meanwhile, the remainder lands as unapplied cash. A failed payment cancels the draft. Before any of these steps the books are checked against the provider: if the captured amount or currency differs from the charge, or a payout’s gross, fees and net differ from the payments it names, the payment is held with the reason, finance is alerted and nothing posts. The provider’s payout posts the net deposit and the processing fees and clears the clearing account, and the bank statement line matches it in the matching inbox. Optional surcharges and convenience fees are off by default; whether you may charge them depends on state law and card rules, which the software does not check.
Controls
- Invoices, receipts, credit applications, deposits and refunds each need an approver who did not prepare or contribute to them.
- Writes carry a request key, so a retried request returns the original document instead of a duplicate.
- Collections reads are entity-scoped and refused to project-scoped grants. Disputes, promises, profiles and runs need AR entry rights; dunning settings, policies and portal billing links need AR approval rights.
- Portal reads and writes are limited to the linked customer’s posted invoices on the grant’s project. Another customer’s or another project’s invoice answers exactly like an unknown one, and nothing is written. Portal mutations need the configured origin and the session CSRF token.
- An online payment’s receipt is prepared by a dedicated portal user who cannot sign in and approved by the automation user, so maker-checker still holds. Each provider event is recorded once; a replayed or forged event changes nothing.
- Posted documents are corrected by source-owned reversals that need an independent approver, a reason and an open period. Reconciled bank lines block a receipt reversal.
Current boundaries
For the full procedure, exceptions and examples, read the Accounts receivable workflow guide.
API operations
78 operations · 34 read · 44 write · base path /rest/v1.0/companies/{company_id}/accounting
- GET
/ar/collections/disputesDisputes - POST
/ar/collections/disputesOpen a dispute on a posted invoice (arEnter) - GET
/ar/collections/disputes/{id}A dispute - POST
/ar/collections/disputes/{id}/resolveResolve or withdraw a dispute (arEnter) - GET
/ar/collections/paymentsOnline payments - GET
/ar/collections/payments/{id}An online payment - GET
/ar/collections/policiesDunning policies - POST
/ar/collections/policiesCreate a dunning policy (arApprove) - PATCH
/ar/collections/policies/{id}Replace a dunning policy's cadence (arApprove) - GET
/ar/collections/portal_accessCustomer portal billing links - POST
/ar/collections/portal_accessLink a customer portal grant to an AR customer (arApprove) - POST
/ar/collections/portal_access/{id}/revokeRevoke a billing link (arApprove) - GET
/ar/collections/promisesPromises to pay - POST
/ar/collections/promisesRecord a promise to pay (arEnter) - POST
/ar/collections/promises/{id}/cancelCancel an open promise (arEnter) - POST
/ar/collections/runRun collections now (arEnter) - GET
/ar/collections/settingsCollections and online payment settings - PATCH
/ar/collections/settingsUpdate collections settings (arApprove) - GET
/ar/collections/worklistPrioritized collections worklist - GET
/ar/customersList AR customers - GET
/ar/customers/{id}Customer open balances net of posted receipts and reversals; paginated invoice history - GET
/ar/customers/{id}/collection_notesLatest 100 collection notes for the customer in permitted entities. - POST
/ar/customers/{id}/collection_notesAdd a collection note (optional invoice and promise to pay). arEnter. - GET
/ar/customers/{id}/collectionsA customer's collections view - PATCH
/ar/customers/{id}/collectionsUpdate a customer's collections profile (arEnter) - GET
/ar/customers/{id}/statementCustomer statement: open posted invoices, unapplied cash and balance due, with the billing contact. - POST
/ar/depositsDeposit posted receipts held in UNDEPOSITED_FUNDS to a bank account as one journal (Dr bank / Cr undeposited funds). arApprove; idempotent by request_key. - GET
/ar/gmp_applications/{id}Get a GMP application - PATCH
/ar/gmp_applications/{id}Edit a GMP application - POST
/ar/gmp_applications/{id}/billBill a GMP application - POST
/ar/gmp_applications/{id}/certifyCertify a GMP application - GET
/ar/gmp_applications/{id}/packageGMP application owner package - GET
/ar/gmp_applications/{id}/registerGMP application cost register - POST
/ar/gmp_applications/{id}/returnReturn a GMP application - POST
/ar/gmp_applications/{id}/submitSubmit a GMP application - POST
/ar/gmp_applications/{id}/voidVoid a GMP application - POST
/ar/gmp_applications/{id}/withdrawWithdraw a GMP certification - POST
/ar/gmp_draws/{id}/decisionDecide a GMP draw - GET
/ar/gmp/statusGMP status of a project - GET
/ar/invoicesList scoped invoices (default 100, maximum 100 per page) - POST
/ar/invoicesCreate a draft; a retry with the same request key and payload returns the original invoice - GET
/ar/invoices/{id}Get scoped invoice - PATCH
/ar/invoices/{id}Replace current draft revision; all editors are excluded from approval - GET
/ar/invoices/{id}/attachmentsList attachments on a AR invoice - POST
/ar/invoices/{id}/attachmentsAttach a file to a AR invoice - POST
/ar/invoices/{id}/credit_applicationsApply a posted on-account credit memo to open invoice lines (Dr AR control / Cr receivable line). arApprove; idempotent by request_key. - POST
/ar/invoices/{id}/disputeFlag or clear a collections dispute on a posted invoice. Disputed invoices age in the Disputed column. arEnter. - GET
/ar/invoices/{id}/pdfInvoice PDF - POST
/ar/invoices/{id}/reverseAppend a source-owned reversal. Independent arApprove required. Identical retries return the original reversal. - POST
/ar/invoices/{id}/sendQueue a posted invoice for email to the customer's billing contact, with the invoice PDF attached. - POST
/ar/invoices/{id}/transitionSubmit, return to draft, independently approve, or post an invoice - POST
/ar/invoices/from_billingDraft an AR invoice from a non-progress billing - POST
/ar/invoices/from_payment_applicationBill a certified owner pay app in AR (once per pay app) - GET
/ar/payment_applications/{id}/pdfG702/G703 PDF of a certified owner pay app - PUT
/ar/prime_contracts/{id}/billing_methodSet a prime contract's billing method - GET
/ar/prime_contracts/{id}/billing_termsGet a prime contract's billing terms - PUT
/ar/prime_contracts/{id}/billing_termsPropose a prime contract's billing terms - POST
/ar/prime_contracts/{id}/billing_terms/approveApprove a prime contract's proposed billing terms - GET
/ar/prime_contracts/{id}/closeoutGet a prime contract's closeout documents - PUT
/ar/prime_contracts/{id}/closeoutSet a prime contract's closeout documents - GET
/ar/prime_contracts/{id}/gmp_applicationsList a GMP contract's applications - POST
/ar/prime_contracts/{id}/gmp_applicationsStart a GMP application - GET
/ar/prime_contracts/{id}/gmp_closeoutGMP close-out reconciliation - GET
/ar/prime_contracts/{id}/gmp_drawsList GMP contingency and allowance draws - POST
/ar/prime_contracts/{id}/gmp_drawsPropose a GMP contingency or allowance draw - GET
/ar/receiptsReceipt history, 50 per page - POST
/ar/receiptsRecord a fully allocated draft; matching request-key retries return the original receipt - GET
/ar/receipts/{id}Receipt detail and immutable applications - POST
/ar/receipts/{id}/applicationsApply a posted receipt's unapplied cash to open invoice lines, or transfer its allocations between lines. arApprove; idempotent by request_key. - GET
/ar/receipts/{id}/attachmentsList attachments on a AR receipt - POST
/ar/receipts/{id}/attachmentsAttach a file to a AR receipt - POST
/ar/receipts/{id}/reverseAppend a source-owned reversal. Independent arApprove required. Identical retries return the original reversal. - POST
/ar/receipts/{id}/transitionIndependently approve or post; balances are revalidated under the company lock - GET
/ar/receipts/open_itemsOpen original AR distributions for one customer/entity; pages over open invoices only, oldest due first - GET
/ar/refundsCustomer refunds, newest first (paginated). - POST
/ar/refundsDraft a refund of customer credit: a posted receipt's unapplied cash or an on-account credit memo. arEnter; idempotent by request_key. - GET
/ar/refunds/{id}Refund detail. - POST
/ar/refunds/{id}/transitionPost, cancel or reverse a customer refund.
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 receivable and customer receiptsInvoice customers, take and deposit receipts, hold unapplied cash, issue credit memos, and work collections.
- GlossaryAccounts receivableMoney owners and clients owe your company for work you've billed, including retainage held until completion.
- DocsPayment applications: G702/G703 progress billingCreate a pay app against a prime contract, subcontract or purchase order. Enter this period's progress on the G703, check the G702, then submit and approve.
- GlossaryRetainage receivableRetainage the owner has withheld from your pay applications: billed and earned, but not collectible until release.
- ExplainerGetting Paid: Pay Apps, Lien Waivers, Stop Payment NoticesHow construction payment works: pay apps, retainage, the four lien waiver types, preliminary notices, notices of nonpayment, stop notices and liens.
- BlogRetainage, lien waivers and pay apps on one recordA pay app, the retainage it withholds and the lien waivers that release it are one transaction. Most contractors track them in three places. Here's how each piece works and why they belong together.
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 →