AvaTax
AccountCurrencyRoundingRuleModel
A currency-rounding-rule model controls how AvaTax rounds calculated tax for a given account and currency.
Each rule is effective-dated: it applies to transactions whose tax date falls within the
effDate/endDate window. When no account-specific rule applies for a currency on a
transaction's tax date, the tax engine uses standard decimal precision (no rounding).
An account may hold several rules for the same currency, and their windows may overlap: for a
given tax date the rule with the latest effDate whose window contains that date applies, so
adding a later-dated rule supersedes an earlier one. Two rules sharing a currencyCode and
effDate are ambiguous and are rejected.
A rule can only be created for a currency that already has an Avalara system default (see
the ListCurrencyRoundingRuleDefaults definitions API). The rounding method is fixed
(rounds halves away from zero) and is an internal implementation detail, not exposed here;
precision - 0 for the whole currency unit, or 2 for standard decimal cents - is the
only control over the rounding behavior.
This model is used in the following APIs:
A unique ID number representing this currency rounding rule.
The ID number of the account that owns this currency rounding rule.
The three-character ISO 4217 currency code this rule applies to, for example INR, TWD, or JPY.
The number of decimal places the tax is rounded to: 0 for the whole currency unit, or
2 for standard decimal cents. This is the only control over the rounding method.
The first tax date, inclusive, for which this rule applies.
The last tax date, inclusive, for which this rule applies. If omitted, the rule applies
through 9998-12-31; a later date is also stored as 9998-12-31.
The date when this record was created.
The user ID of the user who created this record.
The date/time when this record was last modified.
The user ID of the user who last modified this record.