Accounting Settings
Editions and guided setup, legal entities, control-account mapping, approval thresholds, terms, and contractor sales and use tax setup.
Accounting Settings configures the shared foundation every app uses: the company’s edition, legal entities and intercompany accounts, the control-account map, approval thresholds and MFA requirements, payment terms, vendor and customer accounting profiles, and the contractor tax model, including the sales and use tax engine. Open it from the company app launcher under Accounting > Accounting Settings; it appears when your accounting access includes it.
- Who uses it
- Accounting owners and controllers with the chart-of-accounts permission.
- When
- At setup, then as entities, terms or tax rules change.
- What it holds
- The edition and its area overrides, setup progress, entities, control-account roles, thresholds, terms, tax codes and components, exemption certificates, job tax profiles, sales tax jurisdictions, rates, rules, job sites and returns, and party profiles.
Key workflow
- Choose an edition. Essentials, Professional and Enterprise are configuration presets, not licences. Each chooses which optional areas show in the navigation and launcher, sets default control policies such as journal approval thresholds and close requirements, and names recommended roles. Preview the change first: it lists every area and control that moves, marks each control stronger or weaker, and the apply must match that preview. Weakening a control needs an audited reason, or keep your stronger current values. Moving up never weakens a control. A guided setup wizard recommends an edition and a construction chart-of-accounts pack (general contractor, specialty, home builder, heavy civil or construction management) and ends in a go-live checklist.
- Let the edition set dunning. Professional and Enterprise switch on automatic AR dunning reminders, creating the default policy (−5, +1, +15, +30 and +60 days from the due date) only when the company has none; Essentials leaves dunning off. The edition writes AR collections’ own switch, so the collections settings page shows the same state. Switching dunning off through an edition needs a reason and is refused while any open invoice is part-way through a reminder sequence, so customers are never cut off mid-sequence silently. Existing companies did not start sending reminders because of this change.
- Create entities. Add each legal entity with its intercompany due-to and due-from accounts. Every posted entry balances per entity. An elimination entity holds consolidation eliminations. Who owns whom, and how each entity consolidates, is recorded under Accounting > Close > Consolidation, part of Fiscal Periods.
- Map control accounts. Point each system role, such as AP control or retained earnings, at a postable account, and set the manual journal approval threshold.
- Set terms. Add payment terms such as Net 30 or 2% 10, net 30, used for due and discount dates.
- Set up contractor tax. Either create sales and use tax codes with their components and set each job’s tax profile from its state and contract type (a state without an encoded contractor rule is refused rather than guessed, and customer exemption certificates carry expiry dates), or give the job a job site in the sales and use tax engine below. Use one model per project.
- Maintain party profiles. Vendor and customer profiles hold 1099 settings, W-9 status, terms, remit-to, payment method, retainage and credit limit, with tax IDs and bank numbers masked.
- Define dimensions. Under Settings > Dimensions, add your own dimensions, such as division, region or crew, with values in a roll-up hierarchy, optional entity restrictions and effective dates. Rules by account, account range or type make a dimension required or optional. Trial balance, GL detail and budget comparisons filter and group by them.
Sales and use tax
Accounting > Sales and use tax, in the Close group, computes job-site sales tax on AR invoices and self-assessed use tax on AP bills from jurisdictions, rates and rules the company maintains. It has three tabs: Jurisdictions, rates and rules, Job sites and certificates, and Liability, use tax and returns.
- Choose settings. Under Settings, pick the Rounding (Per line, per jurisdiction or Per document, per jurisdiction), the default Sales tax payable and Use tax payable accounts, and the Home (office) set used for bill lines with no project.
- Load jurisdictions and rates. Under Import rates (CSV), upload or paste a file with
jurisdiction_code, effective_from, sales_rate, use_rate, source_citation; addjurisdiction_name, level, state_code, parent_codeto create a missing jurisdiction. The file imports all or nothing. Import from provider loads fictional demo rates only. In the Jurisdictions table, set which jurisdiction each one Files with and its filing frequency. - Review real rates. A rate for a real jurisdiction must cite its source and shows Needs qualified review until a different user enters a review note and selects Record review. A rate used by any invoice or bill can no longer be changed or deleted.
- Group jurisdictions and set rules. Add a Jurisdiction set for each place you work, map cost types to categories (materials, installed property, labor, equipment rental) for AP lines, and add Taxability rules by jurisdiction, contract nature, contract type and category, saying whether the Contractor is the consumer or the retailer and whether sales tax or use tax applies.
- Give projects a job site. On Job sites and certificates, enter the project’s address, choose its Jurisdiction set, Contract nature, Contract type and Default category, and select Save job site. Nothing is geocoded; you choose the set.
- Record certificates. Add customer exemption or resale certificates, and resale certificates you gave vendors, with jurisdiction, optional project, number, reason, effective date and expiry. Renew sets a new expiry; Revoke is final.
- Accrue use tax. On Liability, use tax and returns, Bills that may owe use tax lists posted bills in the period with what is owed if untaxed. Enter any sales tax the vendor charged, exclude lines with an Override reason if needed, and select Accrue. The accrual debits each line’s job cost or expense and credits use tax payable by jurisdiction. One accrual per bill; reverse it to accrue again.
- Prepare and file returns. The liability report for the period shows tax collected and use tax accrued per jurisdiction and ties each payable account to the GL, listing any Other entries that explain a difference. Prepare return freezes a return for a filing jurisdiction, entity and period. A different user selects Mark filed with the filing date and confirmation number, then Link payment to the posted journal entry or AP bill that paid it. Export the return as CSV.
Setup needs the chart-of-accounts permission over every entity; project-scoped grants cannot change it. Accruing use tax and preparing returns need journal posting rights; reversing an accrual, marking a return filed and linking its payment need journal approval rights. The engine applies the company’s own rates and rules: it is not tax advice, and real rates and taxability rules should be confirmed by a qualified tax advisor. Demo jurisdictions use the fictional state code ZZ.
Controls
- Settings changes are audited in the same transaction. Payment-control settings need an accounting owner.
- Changing a remit-to, payment method, tax ID or bank account creates a pending change that a second person approves against the exact values reviewed.
- Applying an edition changes controls, so it needs chart-of-accounts and access-management rights on an unrestricted grant, plus step-up; changing dunning also needs AR approval rights. The apply is audited with each area and control that moved, what was kept and the reason.
Current boundaries
For the full procedure, exceptions and examples, read the Set up company accounting workflow guide.
API operations
79 operations · 38 read · 41 write · base path /rest/v1.0/companies/{company_id}/accounting
- GET
/dimensionsList dimensions - POST
/dimensionsCreate a dimension - GET
/dimensions/{id}Show a dimension - PATCH
/dimensions/{id}Update a dimension - GET
/dimensions/{id}/historyDimension history - GET
/dimensions/{id}/rulesList a dimension's requirement rules - PUT
/dimensions/{id}/rulesReplace a dimension's requirement rules - GET
/dimensions/{id}/valuesList a dimension's values - POST
/dimensions/{id}/valuesCreate a dimension value - GET
/dimensions/{id}/values/{value_id}Show a dimension value - PATCH
/dimensions/{id}/values/{value_id}Update a dimension value - GET
/entitiesList legal entities - POST
/entitiesCreate a legal entity - GET
/entities/{id}Show a legal entity - PATCH
/entities/{id}Update a legal entity - GET
/job_tax_profiles/{id}Get a job tax profile - PUT
/job_tax_profiles/{id}Set a job tax profile - GET
/party_profilesList party profiles - POST
/party_profilesCreate a party profile - GET
/party_profiles/{id}Show a party profile - PATCH
/party_profiles/{id}Update a party profile - POST
/party_profiles/{id}/sensitive_changeApprove or reject a routing/bank/TIN change - GET
/sales_tax/ar_invoices/{id}/determinationsAn invoice's sales tax determinations - GET
/sales_tax/category_mappingsList cost type taxability categories - PUT
/sales_tax/category_mappingsSet a cost type taxability category - GET
/sales_tax/certificatesList exemption and resale certificates - POST
/sales_tax/certificatesAdd a certificate - GET
/sales_tax/certificates/{id}Show a certificate - PATCH
/sales_tax/certificates/{id}Renew or revoke a certificate - GET
/sales_tax/filingsList sales tax returns - POST
/sales_tax/filingsPrepare a sales tax return - GET
/sales_tax/filings/{id}Show a sales tax return - POST
/sales_tax/filings/{id}/decisionMark a return filed, or cancel it - GET
/sales_tax/filings/{id}/exportFiling-prep export (CSV) - POST
/sales_tax/filings/{id}/paymentLink a return's payment - GET
/sales_tax/jurisdiction_setsList jurisdiction sets - POST
/sales_tax/jurisdiction_setsAdd a jurisdiction set - GET
/sales_tax/jurisdiction_sets/{id}Show a jurisdiction set - PATCH
/sales_tax/jurisdiction_sets/{id}Change a jurisdiction set - GET
/sales_tax/jurisdictionsList tax jurisdictions - POST
/sales_tax/jurisdictionsAdd a tax jurisdiction - GET
/sales_tax/jurisdictions/{id}Show a tax jurisdiction - PATCH
/sales_tax/jurisdictions/{id}Change a tax jurisdiction - GET
/sales_tax/liabilitySales and use tax liability by jurisdiction - GET
/sales_tax/project_sitesList job sites - GET
/sales_tax/project_sites/{id}Show a project's job site - PUT
/sales_tax/project_sites/{id}Set a project's job site - GET
/sales_tax/ratesList tax rates - DELETE
/sales_tax/rates/{id}Delete an unused tax rate - POST
/sales_tax/rates/{id}/reviewRecord a qualified review of a rate - POST
/sales_tax/rates/importImport tax rates from CSV - POST
/sales_tax/rates/provider_syncImport rates from a provider adapter - GET
/sales_tax/rulesList taxability rules - POST
/sales_tax/rulesAdd a taxability rule - PATCH
/sales_tax/rules/{id}Change or end a taxability rule - GET
/sales_tax/settingsSales tax settings - PUT
/sales_tax/settingsUpdate sales tax settings - GET
/sales_tax/use_tax/accrualsList use tax accruals - POST
/sales_tax/use_tax/accrualsAccrue use tax on a posted bill - GET
/sales_tax/use_tax/accruals/{id}Show a use tax accrual - POST
/sales_tax/use_tax/accruals/{id}/reverseReverse a use tax accrual - GET
/sales_tax/use_tax/candidatesBills that may owe use tax - GET
/settingsShow accounting settings - PATCH
/settingsUpdate accounting settings - GET
/settings/editionGet the accounting edition - PATCH
/settings/editionOverride edition areas - PUT
/settings/editionApply an edition - GET
/settings/edition/previewPreview an edition change - GET
/settings/setupGet guided setup progress - PUT
/settings/setupRecord a setup step - GET
/tax_codesList tax codes - POST
/tax_codesCreate a tax code - PATCH
/tax_codes/{id}Update a tax code - GET
/tax_exemption_certificatesList customer tax exemption certificates - POST
/tax_exemption_certificatesRecord a customer tax exemption certificate - PATCH
/tax_exemption_certificates/{id}Change a certificate expiry - GET
/termsList payment terms - POST
/termsCreate a payment term - PATCH
/terms/{id}Update a payment term
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
- DocsFinancial reportsReview company financial statements and understand reconciliation coverage.
- GlossaryTrial balanceA list of every account's debit or credit balance at a date; total debits equal total credits.
- DocsAccounting security and controlsUnderstand company accounting access, approvals and correction controls.
- GlossaryMonth-end closeThe process of finishing a period's accounting: reconciling, accruing, reviewing and locking the month so its numbers stop changing.
- BlogHow to close the month in construction accounting: a step list from cutoff to lockA construction month-end close gets every cost and every billing into the right month, proves cash and the subledgers against the ledger, updates the WIP schedule from current cost-to-complete, has someone else review it, and then locks the period. Here is the step list, an example close calendar and a worked example of what one late invoice does to WIP.
- BlogHow to read a contractor's financial statements: the lines a surety, lender or owner's rep checks firstA contractor's financial statements are read for one thing: can this company finish its work and pay its bills? Check the CPA's report level and date, then working capital, the over and under billings, retainage, the gross margin trend, leverage and the notes, and tie the balance sheet to the WIP schedule. Here is the order, with a worked balance sheet.
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 →