Skip to content

EntiHub Documentation

Finance Tax Code & Jurisdiction

Finance — Tax Code & Jurisdiction Rule Registry

Tax rules as governed entities reduce wrong invoice tax codes and give billing agents an approved rule set.

Why this is needed

Wrong tax codes create compliance and customer friction.
Country/product applicability is often tribal.
AI billing assistants need approved rules.

Proposed entities in EntiHub

Governance settings

Setting	Recommended value	Why
`approvalRequired`	`true`	Tax rule changes are highly controlled.
`historyEnabled`	`true`	History for tax audits.
`allowSameAuthorApproval`	`false`	Maker/checker separation for sensitive changes.
`deletedRetentionDays`	`90` (or higher)	Soft-delete retention for auditability.

Entity definition (YAML sketch)

name: tax_rule
displayName: Tax rule
domain: Tax
description: Tax rule
version: "1.0.0"
approvalRequired: true
historyEnabled: true
deletedRetentionDays: 90
displayRefColumn: rule_code
uniqueConstraints:
  - name: uq_tax_rule_rule_code
    columns: [rule_code]
columns:
  - name: rule_code
    dataType: string
    nullable: false
    maxLength: 64
  - name: tax_code
    dataType: string
    nullable: false
    maxLength: 32
  - name: country_code
    dataType: string
    nullable: false
    maxLength: 2
  - name: applies_to
    dataType: string
    nullable: false
    maxLength: 64
  - name: rate_pct
    dataType: decimal
    nullable: true
  - name: status
    dataType: string
    nullable: false
    maxLength: 16
  - name: effective_from
    dataType: date
    nullable: false

YAML sketches

Sketches highlight the important fields and governance flags. Trim or extend columns to match your domain. See Setup Entity for the full YAML reference.

Sample data

rule_code	tax_code	country_code	applies_to	rate_pct	status	effective_from
TAX-SK-STD	SK-DPH-23	SK	B2B goods	23	active	2025-01-01

Benefits for the company

Fewer wrong invoice tax codes.
Clear applicability by country/product.
Agents use only approved rule sets.