{ "tool_id": "art-490-fatca-crs-submission-check", "note": "Vectors computed directly from the shipped kernel. clean-submission has zero findings; findings-present exercises sequencing/uniqueness/referencing/mandatory-identifier/caller-rule failures together; suppressed-rule-excluded shows a stood-down rule_code producing no finding at all (F3), only an audit-trail count.", "vectors": [ { "name": "clean-submission", "description": "All records well-formed, unique DocRefIds, corrected record properly references a prior DocRefId, no suppression needed.", "policy_parameters": { "submission_id": "SUB-2025-US-0001", "schema_version": "OECD-CRS-XML-SCHEMA-v2.0", "certification_period": "2025", "suppressed_rule_codes": [], "mandatory_element_rules": [ { "rule_code": "BR-ACCTNUM-001", "element_path": "account_number", "applies_to": "all", "description": "AccountNumber element is required on every record (BR-ACCTNUM-001)." } ], "records": [ { "doc_ref_id": "US2025DOC0001", "doc_type_indic": "OECD1", "tin": "000000001", "birth_date": "1980-01-15", "address_street": "1 Synthetic Way", "address_city": "Springfield", "address_country_code": "US", "element_values": { "account_number": "ACCT-0001" } }, { "doc_ref_id": "US2025DOC0002", "corr_doc_ref_id": "US2025DOC0001", "doc_type_indic": "OECD2", "tin": "000000002", "birth_date": "1975-06-30", "address_street": "2 Synthetic Way", "address_city": "Springfield", "address_country_code": "US", "element_values": { "account_number": "ACCT-0002" } } ] }, "output_payload": { "submission_id": "SUB-2025-US-0001", "schema_version": "OECD-CRS-XML-SCHEMA-v2.0", "certification_period": "2025", "record_count": 2, "findings": [], "finding_count": 0, "fail_count": 0, "suppressed_rule_codes": [], "suppressed_finding_count": 0, "note": "Deterministic FATCA/CRS submission conformance evaluator over a caller-declared record set, DocTypeIndic sequencing/uniqueness/referencing (public OECD CRS/FATCA XML Schema v2.0 structural vocabulary), mandatory-identifier structural checks, and a caller-supplied business-rule set keyed by published error code + element path. Schema version and error-code sets are pinned policy inputs, never kernel source. A suppressed rule_code produces no finding at all for any record. This tool evaluates conformance only; it does not itself submit, transmit, or file anything, and it is not legal or tax advice." }, "golden_hash": "8633184a16936683bc93adc536adf8f741fb0bc2b85bdc25c56e9a8d9a40e8e9" }, { "name": "findings-present", "description": "Duplicate DocRefId, a corrected record with a dangling CorrDocRefId, missing TIN, malformed BirthDate, incomplete address, missing caller-supplied element, and an unrecognized DocTypeIndic.", "policy_parameters": { "submission_id": "SUB-2025-US-0002", "schema_version": "OECD-CRS-XML-SCHEMA-v2.0", "certification_period": "2025", "suppressed_rule_codes": [], "mandatory_element_rules": [ { "rule_code": "BR-ACCTNUM-001", "element_path": "account_number", "applies_to": "all", "description": "AccountNumber element is required on every record (BR-ACCTNUM-001)." } ], "records": [ { "doc_ref_id": "US2025DOC0100", "doc_type_indic": "OECD1", "tin": "", "birth_date": "1980-13-40", "address_street": "", "address_city": "Springfield", "address_country_code": "US", "element_values": {} }, { "doc_ref_id": "US2025DOC0100", "doc_type_indic": "OECD9", "tin": "000000003", "birth_date": "1990-02-02", "address_street": "3 Synthetic Way", "address_city": "Springfield", "address_country_code": "US", "element_values": { "account_number": "ACCT-0003" } }, { "doc_ref_id": "US2025DOC0101", "corr_doc_ref_id": "US2025DOC9999", "doc_type_indic": "OECD2", "tin": "000000004", "birth_date": "1985-05-05", "address_street": "4 Synthetic Way", "address_city": "Springfield", "address_country_code": "US", "element_values": { "account_number": "ACCT-0004" } } ] }, "output_payload": { "submission_id": "SUB-2025-US-0002", "schema_version": "OECD-CRS-XML-SCHEMA-v2.0", "certification_period": "2025", "record_count": 3, "findings": [ { "rule_code": "MAND-TIN-001", "element_path": "records[0].tin", "doc_ref_id": "US2025DOC0100", "pass": false, "message": "TIN is missing or empty." }, { "rule_code": "MAND-BIRTHDATE-FORMAT-001", "element_path": "records[0].birth_date", "doc_ref_id": "US2025DOC0100", "pass": false, "message": "BirthDate \"1980-13-40\" is not well-formed ISO-8601 (YYYY-MM-DD)." }, { "rule_code": "MAND-ADDRESS-COMPLETENESS-001", "element_path": "records[0].address", "doc_ref_id": "US2025DOC0100", "pass": false, "message": "Address is incomplete (street, city, and country code are all required)." }, { "rule_code": "BR-ACCTNUM-001", "element_path": "records[0].element_values.account_number", "doc_ref_id": "US2025DOC0100", "pass": false, "message": "AccountNumber element is required on every record (BR-ACCTNUM-001)." }, { "rule_code": "SEQ-DOCTYPEINDIC-001", "element_path": "records[1].doc_type_indic", "doc_ref_id": "US2025DOC0100", "pass": false, "message": "doc_type_indic \"OECD9\" is not a recognized OECD CRS/FATCA XML Schema v2.0 DocTypeIndic value." }, { "rule_code": "SEQ-DOCREFID-DUP-001", "element_path": "records[1].doc_ref_id", "doc_ref_id": "US2025DOC0100", "pass": false, "message": "DocRefId \"US2025DOC0100\" duplicates the DocRefId first seen at records[0]." }, { "rule_code": "REF-CORRDOCREFID-DANGLING-001", "element_path": "records[2].corr_doc_ref_id", "doc_ref_id": "US2025DOC0101", "pass": false, "message": "CorrDocRefId \"US2025DOC9999\" does not resolve to any DocRefId in this submission." } ], "finding_count": 7, "fail_count": 7, "suppressed_rule_codes": [], "suppressed_finding_count": 0, "note": "Deterministic FATCA/CRS submission conformance evaluator over a caller-declared record set, DocTypeIndic sequencing/uniqueness/referencing (public OECD CRS/FATCA XML Schema v2.0 structural vocabulary), mandatory-identifier structural checks, and a caller-supplied business-rule set keyed by published error code + element path. Schema version and error-code sets are pinned policy inputs, never kernel source. A suppressed rule_code produces no finding at all for any record. This tool evaluates conformance only; it does not itself submit, transmit, or file anything, and it is not legal or tax advice." }, "golden_hash": "3117bd88e6ca3d1e767e9b89aa650190aa9ea03d57e427af487a9087bfb602cc" }, { "name": "suppressed-rule-excluded", "description": "Same missing-TIN defect as findings-present, but MAND-TIN-001 is on the suppression list so it produces no finding at all; a suppressed_finding_count of 1 records the exclusion.", "policy_parameters": { "submission_id": "SUB-2025-US-0003", "schema_version": "OECD-CRS-XML-SCHEMA-v2.0", "certification_period": "2025", "suppressed_rule_codes": ["MAND-TIN-001"], "mandatory_element_rules": [], "records": [ { "doc_ref_id": "US2025DOC0200", "doc_type_indic": "OECD1", "tin": "", "birth_date": "1980-01-01", "address_street": "5 Synthetic Way", "address_city": "Springfield", "address_country_code": "US", "element_values": {} } ] }, "output_payload": { "submission_id": "SUB-2025-US-0003", "schema_version": "OECD-CRS-XML-SCHEMA-v2.0", "certification_period": "2025", "record_count": 1, "findings": [], "finding_count": 0, "fail_count": 0, "suppressed_rule_codes": ["MAND-TIN-001"], "suppressed_finding_count": 1, "note": "Deterministic FATCA/CRS submission conformance evaluator over a caller-declared record set, DocTypeIndic sequencing/uniqueness/referencing (public OECD CRS/FATCA XML Schema v2.0 structural vocabulary), mandatory-identifier structural checks, and a caller-supplied business-rule set keyed by published error code + element path. Schema version and error-code sets are pinned policy inputs, never kernel source. A suppressed rule_code produces no finding at all for any record. This tool evaluates conformance only; it does not itself submit, transmit, or file anything, and it is not legal or tax advice." }, "golden_hash": "90340ee734d20d83045f0022e0108fa4807eb063010c2c94dcb4196c921da7f1" } ] }