{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.iso-4217","code":"thing-q37431","url":"https://ver.cy/models/thing/q37431/","name":"ISO 4217","alternateNames":[],"kind":"thing","status":"published","version":"0.1.0-research.1","language":"en","classifiers":{"family":"Thing Registry","category":"Information and virtual systems","entryKind":"thing","plane":"INF","domain":["INF.MED"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"ISO 4217 is the International Organization for Standardization's three-letter alphabetic and three-digit numeric code system that uniquely identifies currencies, funds, and precious metals used in international financial transactions.","purpose":"Enable an AI agent to recognise ISO 4217 as a maintained currency identification standard, assess which assignments apply in context, and decide whether to accept, translate, preserve or escalate a currency designation.","scope":{"in":["Standard edition and authoritative code-list provenance","Alphabetic and numeric currency-code assignments and their correspondence","Distinctions among currency, fund and special-purpose assignments","Entity associations and limits on inferring geography from codes","Minor-unit interpretation and explicit treatment of unavailable information","Assignment changes, historical interpretation and application eligibility"],"out":["Currencies as monetary institutions, including issuance and monetary policy","Exchange rates, valuations and redenomination calculations","Legal-tender status and jurisdiction-specific payment obligations","Payment-network support, settlement rules and transaction authorization","Locale-specific currency symbols, formatting and cash-rounding rules","Country-code governance and financial instrument or digital-token identification"],"boundaries":[]},"distinguishingFeatures":["Identify a standard governing currency representations, rather than a particular currency, monetary amount or exchange-rate feed.","Check for three-letter alphabetic and corresponding three-digit numeric representations, together with minor-unit relationships where applicable. [ISO standard description](https://www.iso.org/standard/64758.html?browse=tc)","Require an authoritative assignment lookup; a plausible three-letter ticker or currency symbol alone does not establish ISO 4217 membership.","Distinguish current currency and funds lists from registered funds and historical lists. [SIX currency-code maintenance](https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html?printout=1)","Treat a code's identification role separately from claims that the represented unit is legal tender, exchangeable or supported by a payment service."],"structure":{"bundles":[{"id":"standard-and-maintenance-authority","name":"Standard and Maintenance Authority","description":"Identify the governing ISO 4217 specification and the authority behind the assignments being applied.","layers":[{"id":"governing-specification","name":"Governing Specification","description":"Establish which specification supplies the interpretation rules.","findings":[{"id":"edition-and-rule-basis","name":"Edition and Rule Basis","description":"Record the verified edition and distinguish consulted normative provisions from public summaries.","questions":[{"text":"Which ISO 4217 edition governs this interpretation, and what evidence establishes its status?","id":"edition-and-rule-basis-q01","kind":"provenance"},{"text":"Which interpretation rules were read in the specification, and which remain supported only by summaries?","id":"edition-and-rule-basis-q02","kind":"boundary"}]}]},{"id":"maintained-assignment-evidence","name":"Maintained Assignment Evidence","description":"Establish the authority and coverage of the list snapshot.","findings":[{"id":"authoritative-list-basis","name":"Authoritative List Basis","description":"Record the source list, retrieval context and amendment coverage; SIX identifies itself as the official maintenance agency. [SIX maintenance authority](https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html?printout=1)","questions":[{"text":"Which authoritative list or amendment establishes the assignment being used?","id":"authoritative-list-basis-q01","kind":"provenance"},{"text":"What evidence shows that this snapshot includes changes effective on the decision date?","id":"authoritative-list-basis-q02","kind":"measurement"}]}]}]},{"id":"code-recognition-and-correspondence","name":"Code Recognition and Correspondence","description":"Resolve code representations without mistaking syntactic plausibility for assignment.","layers":[{"id":"representation-recognition","name":"Representation Recognition","description":"Distinguish a supplied token's form from its authoritative meaning.","findings":[{"id":"syntax-versus-assignment","name":"Syntax Versus Assignment","description":"Record the original token, any normalization and the evidence that it matches an assignment.","questions":[{"text":"Is the input an alphabetic code, numeric code, currency name, symbol or external alias?","id":"syntax-versus-assignment-q01","kind":"definition"},{"text":"After any explicitly recorded normalization, does the token match an authoritative assignment?","id":"syntax-versus-assignment-q02","kind":"provenance"},{"text":"Should an unassigned but syntactically plausible token be rejected or referred for alias resolution?","id":"syntax-versus-assignment-q03","kind":"action"}]}]},{"id":"paired-designations","name":"Paired Designations","description":"Preserve the meaning shared by the two code representations.","findings":[{"id":"verified-code-pair","name":"Verified Code Pair","description":"Record the list-backed alphabetic-to-numeric correspondence, retaining all three numeric positions.","questions":[{"text":"Which alphabetic and numeric codes identify the same assignment in the selected snapshot?","id":"verified-code-pair-q01","kind":"definition"},{"text":"Can conversion preserve leading zeros and detect a supplied pair whose components disagree?","id":"verified-code-pair-q02","kind":"action"}]}]}]},{"id":"assignment-role-and-entity-context","name":"Assignment Role and Entity Context","description":"Establish what a designation represents and what its entity associations actually support.","layers":[{"id":"represented-unit-role","name":"Represented Unit Role","description":"Identify the assignment's documented economic or special-purpose role.","findings":[{"id":"assignment-purpose","name":"Assignment Purpose","description":"Record the assigned name, list membership and documented purpose before allowing currency-like operations.","questions":[{"text":"Does this assignment designate a currency, fund, precious metal or another documented purpose?","id":"assignment-purpose-q01","kind":"definition"},{"text":"What authoritative wording limits its interpretation as an ordinary currency?","id":"assignment-purpose-q02","kind":"boundary"},{"text":"Does the requested operation accommodate that role, or require a different model or explicit policy?","id":"assignment-purpose-q03","kind":"action"}]}]},{"id":"entity-association-boundaries","name":"Entity Association Boundaries","description":"Represent listed associations without inventing territorial exclusivity or legal status.","findings":[{"id":"listed-entity-meaning","name":"Listed Entity Meaning","description":"Record all relevant listed entities and separate those associations from independently governed monetary facts.","questions":[{"text":"Which entities are explicitly associated with this assignment at the reference date?","id":"listed-entity-meaning-q01","kind":"provenance"},{"text":"Would inferring a single country, legal-tender status or universal local acceptance exceed the list's evidence?","id":"listed-entity-meaning-q02","kind":"boundary"}]}]}]},{"id":"minor-unit-and-amount-interpretation","name":"Minor Unit and Amount Interpretation","description":"Establish what the listed minor-unit information permits an agent to infer about amount representation.","layers":[{"id":"listed-minor-unit","name":"Listed Minor Unit","description":"Interpret the listed decimal relationship while preserving absent or inapplicable information.","findings":[{"id":"minor-unit-evidence","name":"Minor Unit Evidence","description":"Record the documented exponent and distinguish a numeric value from an explicit non-applicable marker or missing evidence.","questions":[{"text":"What minor-unit value is documented for this assignment in the relevant snapshot?","id":"minor-unit-evidence-q01","kind":"measurement"},{"text":"Does the source specify an exponent, declare the field inapplicable or leave its meaning unresolved?","id":"minor-unit-evidence-q02","kind":"definition"}]}]},{"id":"amount-use-boundaries","name":"Amount Use Boundaries","description":"Check the amount convention before applying a minor-unit relationship.","findings":[{"id":"scaling-preconditions","name":"Scaling Preconditions","description":"Require evidence about major-unit versus minor-unit encoding and delegate rounding or interface exceptions to the relevant model.","questions":[{"text":"Does the receiving interface express this amount in major units, ISO minor units or another documented scale?","id":"scaling-preconditions-q01","kind":"boundary"},{"text":"Can the proposed scaling preserve the amount exactly, or does it require a separately authorized rounding rule?","id":"scaling-preconditions-q02","kind":"action"},{"text":"Which external rule governs cash rounding or permitted accounting precision for this use?","id":"scaling-preconditions-q03","kind":"provenance"}]}]}]},{"id":"assignment-lifecycle-and-history","name":"Assignment Lifecycle and History","description":"Apply amendments according to their effective timing and preserve historical meaning.","layers":[{"id":"amendment-effect","name":"Amendment Effect","description":"Distinguish publication timing from the time a change takes effect.","findings":[{"id":"dated-assignment-change","name":"Dated Assignment Change","description":"Record what an amendment changes, when it takes effect and any unresolved precision in its timing.","questions":[{"text":"Does the amendment change a code, name, entity association, minor-unit value or list membership?","id":"dated-assignment-change-q01","kind":"definition"},{"text":"What effective date is stated, and how does it differ from the announcement or retrieval date?","id":"dated-assignment-change-q02","kind":"measurement"},{"text":"Which dependent validations should change when the amendment becomes effective?","id":"dated-assignment-change-q03","kind":"action"}]}]},{"id":"historical-resolution","name":"Historical Resolution","description":"Interpret older designations without silently rewriting the represented unit.","findings":[{"id":"historical-record-continuity","name":"Historical Record Continuity","description":"Preserve the original designation and distinguish assignment withdrawal from conversion or legal circulation; an amendment can place a currency in the historical list while describing parallel circulation. [SIX amendment 174](https://www.six-group.com/dam/download/financial-information/data-center/iso-currrency/amendments/dl-currency-iso-amendment-174.pdf)","questions":[{"text":"Which assignment evidence supports this designation for the record's own date?","id":"historical-record-continuity-q01","kind":"provenance"},{"text":"Would replacing the historical code change the unit of account or require an independently sourced conversion?","id":"historical-record-continuity-q02","kind":"boundary"},{"text":"Should the designation remain valid for historical interpretation while being restricted for new operational use?","id":"historical-record-continuity-q03","kind":"action"}]}]}]},{"id":"application-decisions-and-exceptions","name":"Application Decisions and Exceptions","description":"Translate ISO assignment evidence into a justified decision for a specific consuming workflow.","layers":[{"id":"contextual-acceptance","name":"Contextual Acceptance","description":"Combine assignment status with the consumer's declared requirements.","findings":[{"id":"use-eligibility","name":"Use Eligibility","description":"Record whether the proposed operation requires recognition, current assignment, a particular assignment role or explicit consumer support.","questions":[{"text":"Is the task archival interpretation, display, data interchange or initiation of a new monetary operation?","id":"use-eligibility-q01","kind":"definition"},{"text":"Which consumer rule determines whether this recognised designation is accepted for that task?","id":"use-eligibility-q02","kind":"provenance"},{"text":"Given the date, assignment role and consumer rule, should the agent accept, preserve, reject or escalate it?","id":"use-eligibility-q03","kind":"action"}]}]},{"id":"unresolved-code-handling","name":"Unresolved Code Handling","description":"Handle aliases and conflicting snapshots without inventing assignments.","findings":[{"id":"exception-resolution","name":"Exception Resolution","description":"Retain unresolved input and identify the evidence needed to resolve an external alias, stale list or conflicting interpretation.","questions":[{"text":"Is the unresolved token an external convention, an assignment absent from the local snapshot or an input error?","id":"exception-resolution-q01","kind":"boundary"},{"text":"What authoritative update or documented external mapping would justify resolving it?","id":"exception-resolution-q02","kind":"provenance"},{"text":"Which operation must remain pending until that evidence is available?","id":"exception-resolution-q03","kind":"action"}]}]}]},{"id":"evidence-and-external-alignment","name":"Evidence and external alignment","description":"What the world already says about this thing, gathered so the model can be checked against it.","layers":[{"id":"reported-evidence","name":"Reported evidence","description":"Findings from the breadth pass, kept separate from the structural claims.","findings":[{"id":"evidence-kinds","name":"Kinds and varieties","description":"Reported by the breadth pass; each item needs checking against its source before it becomes normative.","questions":[{"text":"Which of these kinds and varieties hold for the sense of ISO 4217 this model covers, and on what evidence?","id":"evidence-kinds-q01","kind":"provenance"}]},{"id":"evidence-identifiers","name":"Identifiers and schemes","description":"Reported by the breadth pass; each item needs checking against its source before it becomes normative.","questions":[{"text":"Which of these identifiers and schemes hold for the sense of ISO 4217 this model covers, and on what evidence?","id":"evidence-identifiers-q01","kind":"provenance"}]},{"id":"evidence-standards-and-regulation","name":"Standards and regulation","description":"Reported by the breadth pass; each item needs checking against its source before it becomes normative.","questions":[{"text":"Which of these standards and regulation hold for the sense of ISO 4217 this model covers, and on what evidence?","id":"evidence-standards-and-regulation-q01","kind":"provenance"}]},{"id":"evidence-real-world-use","name":"Real-world use","description":"Reported by the breadth pass; each item needs checking against its source before it becomes normative.","questions":[{"text":"Which of these real-world use hold for the sense of ISO 4217 this model covers, and on what evidence?","id":"evidence-real-world-use-q01","kind":"provenance"}]},{"id":"evidence-measurements","name":"Typical measurements","description":"Reported by the breadth pass; each item needs checking against its source before it becomes normative.","questions":[{"text":"Which of these typical measurements hold for the sense of ISO 4217 this model covers, and on what evidence?","id":"evidence-measurements-q01","kind":"provenance"}]},{"id":"evidence-failure-modes-and-hazards","name":"Failure modes and hazards","description":"Reported by the breadth pass; each item needs checking against its source before it becomes normative.","questions":[{"text":"Which of these failure modes and hazards hold for the sense of ISO 4217 this model covers, and on what evidence?","id":"evidence-failure-modes-and-hazards-q01","kind":"provenance"}]},{"id":"evidence-regional-variation","name":"Regional variation","description":"Reported by the breadth pass; each item needs checking against its source before it becomes normative.","questions":[{"text":"Which of these regional variation hold for the sense of ISO 4217 this model covers, and on what evidence?","id":"evidence-regional-variation-q01","kind":"provenance"}]},{"id":"evidence-neighbours","name":"Neighbouring kinds and how to tell them apart","description":"Reported by the breadth pass; each item needs checking against its source before it becomes normative.","questions":[{"text":"Which of these neighbouring kinds and how to tell them apart hold for the sense of ISO 4217 this model covers, and on what evidence?","id":"evidence-neighbours-q01","kind":"provenance"}]}]}]}]},"agentConduct":{"may":["Look up currency codes from the official list.","Validate currency codes in data the agent is authorized to edit."],"mustNot":["Use withdrawn codes as current.","Invent codes for unofficial currencies.","Present codes as recognition of a state."],"requiresHuman":["Changing codes in financial systems."]},"ethics":{"considerations":["Errors in codes can misroute payments.","Currency changes affect people's money."],"affectedParties":["Banks","Businesses","Data users"]},"owners":{"steward":"The standardization body and its maintenance agency.","roles":[],"masterSystems":["The standard's published code lists"]},"relations":[{"target":"Q6545185","type":"parent","note":"registry parent class"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.iso-4217","Wikidata: Q37431 (https://www.wikidata.org/wiki/Q37431)"]},"properties":{"applicability":"not-applicable","items":["Standard edition: Verified ISO edition designation; unknown if unverified","Assignment evidence: Links to authoritative list snapshots and applicable amendment notices","Alphabetic and numeric correspondence: Assigned three-letter representation paired with its three-digit representation","Assignment role: Currency, fund, precious metal, other documented special purpose, or unresolved","Temporal assignment state: Effective at reference date, announced for future effect, historical at reference date, or unresolved","Listed entity associations: Documented associations between a designation and listed entities, qualified by date","Minor-unit exponent: Documented decimal exponent n, where one minor unit equals 10^-n major units; retain explicit not-applicable and unknown states","List currency: Checked through a specified amendment or date, superseded, or freshness unresolved","Consumer acceptance: Link to the receiving application's accepted codes and amount conventions"]},"recognition":{"applicability":"optional","items":["Three letters such as USD or EUR in financial data.","Three-digit numeric codes."]},"capabilities":{"applicability":"required","items":["Resolve a supplied designation against an authoritative ISO 4217 assignment at a stated date.","Translate between alphabetic and numeric representations while preserving the original input and leading zeros.","Classify a recognised assignment before deciding whether its use fits the requested operation.","Interpret a documented minor-unit exponent when the receiving interface uses that convention.","Compare list snapshots and assess which validations or stored interpretations an amendment affects.","Preserve historical designations and escalate unresolved aliases, conflicting evidence or unsupported application use."]},"hazards":{"applicability":"required","items":["Payment errors from wrong codes."]},"interfaces":{"applicability":"required","items":["ISO 4217, Codes for the representation of currencies, International Organization for Standardization."]},"context":{"applicability":"required","items":["ISO 4217 is used in payment messages, accounting records, exchange rate data and commercial systems to identify currencies consistently.","Its codes help distinguish currencies that share names or symbols and support automated processing across countries.","Historical records require attention to the validity dates of assignments because currencies and their codes can change."]}},"sources":[{"title":"ISO 4217 Currency codes","url":"https://www.iso.org/iso-4217-currency-codes.html","note":"Official definition and maintenance of the ISO 4217 currency code standard"},{"title":"ISO 4217","url":"https://en.wikipedia.org/wiki/ISO_4217","note":"Overview of alphabetic and numeric codes, special codes, and historical currencies"},{"title":"Wikidata item Q37431: ISO 4217","url":"https://www.wikidata.org/wiki/Q37431","note":"identity and sense of the item"}],"openQuestions":["Which normative edition and complete amendment baseline should this publication adopt, and has the full specification been read?","What exact rules govern assignment roles, exceptional code construction and possible code reuse across editions?","How complete and temporally precise are the available historical lists for reconstructing assignments at arbitrary past dates?","What precise semantics do authoritative minor-unit markers have for each special-purpose assignment?","Which target applications require documented departures from ISO minor-unit conventions, restrict recognised codes or use external aliases?"],"resources":{"spec":"/models/things/publications/thing-q37431/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q37431/spec.json"],"providers":["Codex","Grok"],"researchStatus":"unreviewed","generatedAt":"2026-09-07T11:56:06Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"not-applicable","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T10:10:30+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass","interaction.properties":"Plane INF: no invented physical properties."},"score":1.0}}