Skip to content

CLAIM_MODEL.md

Latest commit

 

History

History
46 lines (31 loc) · 1.12 KB

CLAIM_MODEL.md

File metadata and controls

46 lines (31 loc) · 1.12 KB

CLAIM MODEL

Purpose

This document defines the canonical structure of a VATFIX claim.

A claim is a statement about VAT validity that can be evaluated.

Claim Structure

A valid claim contains:

Field Type Required Description
country_code string yes ISO 3166-1 alpha-2
vat_number string yes VAT number without country prefix
timestamp ISO 8601 yes When claim was made
requester string no Who requested validation

Claim Evaluation

A claim is evaluated against:

  1. Format rules (syntactic validity)
  2. Registry rules (authority response)
  3. Evidence rules (what proof exists)

Claim Outcomes

Outcome Meaning
VALID Claim satisfied all rules
INVALID Claim failed one or more rules
UNAVAILABLE Authority could not be reached
INDETERMINATE Evaluation could not complete

Evidence Binding

Every evaluated claim produces evidence:

  • Timestamp of evaluation
  • Authority consulted
  • Response received (or failure)
  • Evaluation outcome

Evidence is immutable once produced.