Zip Code Territory Factor Lookup
Audit caller verified full territory/rate-edition key and factor, preserving ZIP leading zeros as text; no inferred ZIP geographic risk or territorial/legal rating approval.
Description
Territory rating keys can include ZIP postal-code text and rate edition.
Territory rating keys can include ZIP postal-code text and rate edition. Keeping keys as text preserves leading zeros and avoids inventing geographic risk factors.1
The returned values include Caller matched territory factor basis points, Caller territory adjusted premium minor. The How section below explains the calculation, input rules and interpretation.
When to use Zip Code Territory Factor Lookup
Use Zip Code Territory Factor Lookup when you need to evaluate the supplied records under the calculation and evidence rules below. No ZIP-risk inference, current rate table or territorial/legal rating approval is supplied.
Prepare the observed policy, claim or quote evidence and independently verified policy tables. Monetary fields use integer minor units in one currency: for a currency with 100 minor units per major unit, enter 12345 for 123.45. One basis point is 0.01 percentage points, so 10000 basis points represents 100%.
How to use Zip Code Territory Factor Lookup and understand its results
- Prepare the observed policy, claim or quote evidence and independently verified policy tables. Monetary fields use integer minor units in one currency: for a currency with 100 minor units per major unit, enter 12345 for 123.45. One basis point is 0.01 percentage points, so 10000 basis points represents 100%.
- Enter callerTerritoryKeyIds, callerVerifiedTerritoryFactorBasisPoints, queryTerritoryKeyId, callerUntieredAnnualPremiumMinor using the field table and calculation rules, then run the tool.
- Read callerMatchedTerritoryFactorBasisPoints, callerTerritoryAdjustedPremiumMinor. The explanation below defines the units, signs, ordering and any flags or placeholder values.
- If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
| Input field | Meaning | Value type; see rules below | Requirement |
|---|---|---|---|
| callerTerritoryKeyIds | Caller territory key ids | list of string | Required |
| callerVerifiedTerritoryFactorBasisPoints | Caller verified territory factor basis points | list of number | Required |
| queryTerritoryKeyId | Query territory key id | string | Required |
| callerUntieredAnnualPremiumMinor | Caller untiered annual premium minor | number | Required |
Enter aligned nonempty unique nonblank territory keys and integer factors 0–100000, an exact existing query key and nonnegative integer base premium at most 10¹² minor units. Return matched factor and adjusted premium using exact rational rounding, with half ties away from zero.
adjustedPremium=roundMinor(basePremium×factorBasisPoints/10000) Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| callerMatchedTerritoryFactorBasisPoints | Caller matched territory factor basis points | number |
| callerTerritoryAdjustedPremiumMinor | Caller territory adjusted premium minor | number |
{
"input": {
"callerTerritoryKeyIds": [
"00123:edition",
"10001:edition"
],
"callerVerifiedTerritoryFactorBasisPoints": [
12000,
9000
],
"queryTerritoryKeyId": "00123:edition",
"callerUntieredAnnualPremiumMinor": 10000
},
"output": {
"callerMatchedTerritoryFactorBasisPoints": 12000,
"callerTerritoryAdjustedPremiumMinor": 12000
}
}Limitations and assumptions
No ZIP-risk inference, current rate table or territorial/legal rating approval is supplied.
Numeric inputs, where present, must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Numeric lists are limited to 10,000 entries; string lists to 128 strings of at most 128 characters each. The rules above may impose smaller limits. Extremely large text inputs are rejected. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.
Alternative or Complementary methods
Use Auto Premium Base Class Lookup: An auto base-class quote audit compares observed money with a verified class rate. Premium modifications belong to separate scenarios. For a complementary task, use Credit Based Insurance Score Tier Lookup: Credit-based insurance rating uses its own supplied score tiers. A consumer credit score conversion is not built into this calculation.
References
-
Zip Code Territory Factor Lookup — tool.io
Similar or alternative tools
- Auto Premium Base Class Lookup
An auto base-class quote audit compares observed money with a verified class rate. Premium modifications belong to separate scenarios.
- Credit Based Insurance Score Tier Lookup
Credit-based insurance rating uses its own supplied score tiers. A consumer credit score conversion is not built into this calculation.