CRS / FATCA Reporting
CRSfree10 data-quality rules for automatic exchange of financial account information under the OECD Common Reporting Standard (CRS) and US FATCA (Form 8966), exchanged as XML to tax authorities. Covers required reporting elements, TIN presence/validity, ISO 4217 currency and ISO 3166 country codes, account-balance format, controlling persons for passive NFEs, and DocRefId uniqueness. Use it to pass schema/business-rule validation before transmission.
Checks included (10)
Required Reporting Elements Present
Each reportable account must carry the Reporting FI, account number, account holder, and account balance.
TIN Present (or Documented Reason)
A Tax Identification Number must be reported for each account holder; if omitted, a valid reason/code must be present. Missing TINs generate record-level errors.
MessageRefId Present(message_ref_id)
The message header must carry a MessageRefId identifying the transmission.
Account Number Present(account_number)
Each reportable account must carry an account number (or the documented "NANUM" indicator where no number exists).
Currency Code Is Valid ISO 4217
Every monetary amount's currCode must be a valid three-character ISO 4217 currency code.
Country Code Is Valid ISO 3166
Residence country and TIN-issuing country must be valid two-character ISO 3166-1 codes.
Account Balance Is Non-Negative(account_balance)
Reported account balance should not be negative (a closed account is reported as 0).
Account Holder Type Is Valid(account_holder_type)
Account holder type must be a valid CRS code (e.g. CRS101 Passive NFE with controlling person, CRS102 reportable person, CRS103 passive NFE that is a reportable person).
Passive NFE Has a Controlling Person
A passive NFE account holder (CRS101) must report at least one controlling person.
DocRefId Is Unique(doc_ref_id)
Each DocRefId must be globally unique within the reporting jurisdiction; duplicates are rejected.