Esc

↑↓ move↵ openIndex · Pagefind
Accounting apps / Accounting Settings

Accounting Settings

Editions and guided setup, legal entities, control-account mapping, approval thresholds, terms, and contractor sales and use tax setup.

On this page

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. Set terms. Add payment terms such as Net 30 or 2% 10, net 30, used for due and discount dates.
  6. 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.
  7. 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.
  8. 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.

  1. 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.
  2. Load jurisdictions and rates. Under Import rates (CSV), upload or paste a file with jurisdiction_code, effective_from, sales_rate, use_rate, source_citation; add jurisdiction_name, level, state_code, parent_code to 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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

  1. GET /dimensionsList dimensions
  2. POST /dimensionsCreate a dimension
  3. GET /dimensions/{id}Show a dimension
  4. PATCH /dimensions/{id}Update a dimension
  5. GET /dimensions/{id}/historyDimension history
  6. GET /dimensions/{id}/rulesList a dimension's requirement rules
  7. PUT /dimensions/{id}/rulesReplace a dimension's requirement rules
  8. GET /dimensions/{id}/valuesList a dimension's values
  9. POST /dimensions/{id}/valuesCreate a dimension value
  10. GET /dimensions/{id}/values/{value_id}Show a dimension value
  11. PATCH /dimensions/{id}/values/{value_id}Update a dimension value
  12. GET /entitiesList legal entities
  13. POST /entitiesCreate a legal entity
  14. GET /entities/{id}Show a legal entity
  15. PATCH /entities/{id}Update a legal entity
  16. GET /job_tax_profiles/{id}Get a job tax profile
  17. PUT /job_tax_profiles/{id}Set a job tax profile
  18. GET /party_profilesList party profiles
  19. POST /party_profilesCreate a party profile
  20. GET /party_profiles/{id}Show a party profile
  21. PATCH /party_profiles/{id}Update a party profile
  22. POST /party_profiles/{id}/sensitive_changeApprove or reject a routing/bank/TIN change
  23. GET /sales_tax/ar_invoices/{id}/determinationsAn invoice's sales tax determinations
  24. GET /sales_tax/category_mappingsList cost type taxability categories
  25. PUT /sales_tax/category_mappingsSet a cost type taxability category
  26. GET /sales_tax/certificatesList exemption and resale certificates
  27. POST /sales_tax/certificatesAdd a certificate
  28. GET /sales_tax/certificates/{id}Show a certificate
  29. PATCH /sales_tax/certificates/{id}Renew or revoke a certificate
  30. GET /sales_tax/filingsList sales tax returns
  31. POST /sales_tax/filingsPrepare a sales tax return
  32. GET /sales_tax/filings/{id}Show a sales tax return
  33. POST /sales_tax/filings/{id}/decisionMark a return filed, or cancel it
  34. GET /sales_tax/filings/{id}/exportFiling-prep export (CSV)
  35. POST /sales_tax/filings/{id}/paymentLink a return's payment
  36. GET /sales_tax/jurisdiction_setsList jurisdiction sets
  37. POST /sales_tax/jurisdiction_setsAdd a jurisdiction set
  38. GET /sales_tax/jurisdiction_sets/{id}Show a jurisdiction set
  39. PATCH /sales_tax/jurisdiction_sets/{id}Change a jurisdiction set
  40. GET /sales_tax/jurisdictionsList tax jurisdictions
  41. POST /sales_tax/jurisdictionsAdd a tax jurisdiction
  42. GET /sales_tax/jurisdictions/{id}Show a tax jurisdiction
  43. PATCH /sales_tax/jurisdictions/{id}Change a tax jurisdiction
  44. GET /sales_tax/liabilitySales and use tax liability by jurisdiction
  45. GET /sales_tax/project_sitesList job sites
  46. GET /sales_tax/project_sites/{id}Show a project's job site
  47. PUT /sales_tax/project_sites/{id}Set a project's job site
  48. GET /sales_tax/ratesList tax rates
  49. DELETE /sales_tax/rates/{id}Delete an unused tax rate
  50. POST /sales_tax/rates/{id}/reviewRecord a qualified review of a rate
  51. POST /sales_tax/rates/importImport tax rates from CSV
  52. POST /sales_tax/rates/provider_syncImport rates from a provider adapter
  53. GET /sales_tax/rulesList taxability rules
  54. POST /sales_tax/rulesAdd a taxability rule
  55. PATCH /sales_tax/rules/{id}Change or end a taxability rule
  56. GET /sales_tax/settingsSales tax settings
  57. PUT /sales_tax/settingsUpdate sales tax settings
  58. GET /sales_tax/use_tax/accrualsList use tax accruals
  59. POST /sales_tax/use_tax/accrualsAccrue use tax on a posted bill
  60. GET /sales_tax/use_tax/accruals/{id}Show a use tax accrual
  61. POST /sales_tax/use_tax/accruals/{id}/reverseReverse a use tax accrual
  62. GET /sales_tax/use_tax/candidatesBills that may owe use tax
  63. GET /settingsShow accounting settings
  64. PATCH /settingsUpdate accounting settings
  65. GET /settings/editionGet the accounting edition
  66. PATCH /settings/editionOverride edition areas
  67. PUT /settings/editionApply an edition
  68. GET /settings/edition/previewPreview an edition change
  69. GET /settings/setupGet guided setup progress
  70. PUT /settings/setupRecord a setup step
  71. GET /tax_codesList tax codes
  72. POST /tax_codesCreate a tax code
  73. PATCH /tax_codes/{id}Update a tax code
  74. GET /tax_exemption_certificatesList customer tax exemption certificates
  75. POST /tax_exemption_certificatesRecord a customer tax exemption certificate
  76. PATCH /tax_exemption_certificates/{id}Change a certificate expiry
  77. GET /termsList payment terms
  78. POST /termsCreate a payment term
  79. 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

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