SolariumSolariumDocs
Dashboard
Browse The Docs

Docs/Guides/Country & Tax Setup

POST

Update Country Settings

For an organization outside Canada: its region, tax registration number, and either its own sales tax rates (generic countries) or its business type (US). The currency (generic countries) and the business type (US) can only change before any transactions are booked. Changing the business type re-codes every account to the new form's lines. Requires the owner or admin role. A Canadian organization's province and filing frequency are set with updateOrganization.

View as MarkdownOpen in ClaudeOpen in ChatGPT

Parameters

organizationIdUUID!required

Organization ID

regionString

US: a state code. Elsewhere: free text

currencyString

Generic countries, before any transactions

taxRates[TaxRateInput!]

Generic countries: replaces the rates. Each has name, ratePercent and recoverable (tax paid on purchases is claimed back)

registrationNumberString

Sales tax registration number

businessTypeString

US, before any transactions: sch_c, 1065, 1120 or 1120s

PreviousCountry Options
Request
mutation {
  updateJurisdiction(
    organizationId: "a1b2c3d4-..."
    taxRates: [
      { name: "VAT", ratePercent: "20", recoverable: true }
      { name: "Reduced VAT", ratePercent: "5", recoverable: true }
    ]
  ) {
    success
    error
    jurisdiction { currency taxRates { code name ratePercent recoverable } }
  }
}
Response
{
  "data": {
    "updateJurisdiction": {
      "success": true,
      "error": null,
      "jurisdiction": {
        "currency": "GBP",
        "taxRates": [
          { "code": "vat", "name": "VAT", "ratePercent": "20", "recoverable": true },
          { "code": "reduced_vat", "name": "Reduced VAT", "ratePercent": "5", "recoverable": true }
        ]
      }
    }
  }
}