| name | currency |
| description | Use when a value carries money — amount + ISO-4217 currency, exchange rates, rounding, multi-currency ledgers/totals. The CurrencyConcern/AmountConcern field-factory; money is amount+currency, never a currency-baked field name. |
| atomPath | currency |
| coordinate | currency · 8/crest · cbf15042 |
| contentUuid | 1e579efe-bad1-5191-8252-9442b6da4b7d |
| diamondUuid | 07027f69-2eba-81d4-aa42-1c9570e60798 |
| uuid | cbf15042-4b14-8536-8ab3-16e70fa01662 |
| horo | 8 |
| typography | {"partition":"currency","bondDegree":118} |
| standards | ["EN-16931","IFRS-9","ISO-13616-1","ISO-13616-1`","ISO-3166-1`","ISO-4217`","ISO-7064","ISO-7064`","ISO-9362","ISO-9362`","RFC-8785","SAF-T"] |
| bindings | [] |
| signatures | {"computationUuid":"40aadb77-d503-8dee-a4fb-b503eeae0def","stages":[{"stage":"path","stageUuid":"88086f14-e2e7-866a-8bde-e04e3b3e732a"},{"stage":"trinity","stageUuid":"62def698-4f7c-85a9-a029-c66373135fa8"},{"stage":"boundary","stageUuid":"22a53d4c-2fd3-817b-954a-d1bf89445b2a"},{"stage":"links","stageUuid":"6b6671b3-2c21-87db-bb34-d6069c80d5fd"},{"stage":"horo","stageUuid":"e6d1b8e0-d809-8e80-80da-f6a73d8665bf"},{"stage":"seal","stageUuid":"b3024b56-3245-8e63-8c3d-aa51dde15274"},{"stage":"uuid","stageUuid":"717897ed-6b5d-8de9-82c3-a2f232303c6b"}]} |
| version | 2 |
currency — money is amount + ISO-4217 code (never baked into the name)
currency is the money field-factory atom (Rails CurrencyConcern/AmountConcern, Money gem monetize), sequence position 1 ([[field]]). Law: a monetary value is a minor-unit integer amount + an ISO-4217 currency — NEVER a currency-baked name (monthlyUSD → price + currency). Multi-currency everywhere: each amount keeps its own currency; an exchangeRate (a [[rate]]) converts to the entity's functional currency at a point in time ([[versions]]). A blank currency routes to its identity element XXX ([[identity]] categorical currency — never an ad-hoc ?? 'EUR' default). Rates fall back along the jurisdiction cascade БНБ → ECB (matter = the rate-fetch via [[hooks]]/[[jobs]]; antimatter = the cascade fallback).
Composes: [[accounting]] (multi-currency journals), [[commerce]] (totals), [[identity]] (XXX element + rates), [[field]], [[bindings]] (rate-sync job), [[measure]] (the substance twin — quantity+unit).
Standards
@standard ISO-4217
@standard ISO-3166-1
@standard ISO-13616-1
@standard ISO-9362
@standard ISO-7064
Applying this skill is how these standards are implemented — the field-factory is the answer-path; its [[standard]] banners must be true, not decoration.
- ISO 4217:2015 (third edition, 2015-08; current — NOT superseded, kept live by Maintenance Agency amendments via SIX Financial Information AG, e.g. Amendment No. 177 effective 2024-06-25 adding ZWG). Form: every currency is an uppercase three-letter ALPHABETIC code (
EUR, USD, BGN, ZWG) from the current published list; where numeric/decimal handling is needed, pair it with the matching three-digit NUMERIC code and the published minor-unit/exponent (JPY=0, USD=2, BHD=3) — never assume two decimals. The code list is controlled and amendable: never a baked literal, and withdrawn codes are never reused. Cite as ISO 4217:2015 (year is correct, edition not superseded); cite the code as the alphabetic (alpha-3) code without a clause number (avoid the brittle "§5").