taxExemptions
#List tax exemptions for the current tenant.
Returns[!]!
tax22 ops
Tax API
Tax rates, jurisdictions, and invoice tax computation.
Queries
taxPolicies
#List tax policies for the current tenant.
Arguments
- input!
Default
{ "vertical": null, "taxType": null, "activeOnly": false, "search": null, "pagination": { "limit": 10, "page": 1, "after": null } }
Returns!
taxPolicy
#Get a single tax policy with its rates.
Arguments
- idString!
Returns!
taxPolicyVersions
#Get all versions of a tax policy by key.
Arguments
- policyKeyString!
Returns[!]!
taxProviderConfigs
#List all tax provider configs for the current tenant.
Arguments
- activeOnlyBoolean!
Default
true
Returns[!]!
taxZones
#List tax zones for the current tenant.
Arguments
- input!
Default
{ "countryCode": null, "adminRegionId": null, "cityId": null, "activeOnly": false, "search": null, "pagination": { "limit": 10, "page": 1, "after": null } }
Returns!
Mutations
activateTaxPolicy
#Activate a tax policy version (deactivates other versions with the same key).
Arguments
- idString!
Returns!
createTaxExemption
#Create a tax exemption rule.
Arguments
- input!
Returns!
createTaxPolicy
#Create a new tax policy with optional inline rates.
Arguments
- input!
Returns!
createTaxProviderConfig
#Create a tax engine provider configuration for the tenant.
Arguments
- input!
Returns!
createTaxRate
#Add a tax rate to a policy.
Arguments
- input!
Returns!
createTaxZone
#Create a new tax zone (jurisdiction).
The (country, admin_region, city) chain is validated by a trigger on
tax.zones — inconsistent FKs surface as a Postgres error here.
Arguments
- input!
Returns!
deactivateTaxPolicy
#Deactivate a tax policy version.
Arguments
- idString!
Returns!
deleteTaxExemption
#Delete a tax exemption.
Arguments
- idString!
ReturnsBoolean!
deleteTaxProviderConfig
#Delete (deactivate) a tax provider config.
Arguments
- idString!
ReturnsBoolean!
deleteTaxRate
#Delete a tax rate.
Arguments
- idString!
ReturnsBoolean!
deleteTaxZone
#Soft-delete a tax zone (sets active = false).
Arguments
- idString!
ReturnsBoolean!
updateTaxExemption
#Update a tax exemption.
Arguments
- idString!
- input!
Returns!
updateTaxPolicy
#Update an existing tax policy.
Arguments
- idString!
- input!
Returns!
updateTaxProviderConfig
#Update a tax engine provider configuration.
Arguments
- idString!
- input!
Returns!
updateTaxRate
#Update a tax rate.
Arguments
- idString!
- input!
Returns!
updateTaxZone
#Update an existing tax zone. Geographic consistency is enforced by
the trg_tax_zones_validate_geography trigger.
Arguments
- idString!
- input!
Returns!
