Orrery.
← All Stars

public Star · 0.1.0

orrery/tax-region

Validate tax-jurisdiction record shape against a named static profile.

Use this when

  • You need to validate jurisdiction codes before commerce joins
  • You want schema errors without tax API egress
  • You are checking sales-jurisdiction record shape offline

Not for

  • Tax remittance, filing, or payout logic
  • Live rate lookup or nexus determination
  • Profiles outside the allowlist

Inputs / Outputs

Inputs

NameTypeNotes
profile string named static profile (sales-jurisdiction)
jurisdiction required object country, region, jurisdiction_key

Outputs

NameTypeNotes
valid boolean
errors array shape validation errors when invalid
profile_digest string deterministic schema identifier
envelope signed-envelope

Example

{
  "method": "tools/call",
  "params": {
    "name": "validate",
    "arguments": {
      "profile": "sales-jurisdiction",
      "jurisdiction": {}
    }
  }
}

Tools

validate Validate one small tax-jurisdiction record against a named static profile · schema
{
  "type": "object",
  "properties": {
    "profile": {
      "type": "string",
      "enum": [
        "sales-jurisdiction"
      ],
      "default": "sales-jurisdiction"
    },
    "jurisdiction": {
      "type": "object",
      "properties": {
        "country": {
          "type": "string",
          "pattern": "^[A-Z]{2}$",
          "description": "ISO 3166-1 alpha-2 country code."
        },
        "region": {
          "type": "string",
          "pattern": "^[A-Z]{2}$",
          "description": "Uppercase subdivision code (state/province)."
        },
        "jurisdiction_key": {
          "type": "string",
          "pattern": "^[A-Z]{2}-[A-Z]{2}$",
          "description": "Composite jurisdiction identifier (country-region)."
        }
      },
      "required": [
        "country",
        "region",
        "jurisdiction_key"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "profile",
    "jurisdiction"
  ],
  "additionalProperties": false
}

In constellations

No constellation references this Star yet.