@ducatjs/money 0.0.0 → 0.2.0

package/data/cash-rounding.json

@@ -0,0 +1,520 @@
+{
+  "retrieved": "2026-11-07",
+  "note": "Smallest cash increment where it differs from the ISO minor unit. 'verified': false means only secondary sources (press, Wikipedia) were found; treat as a default you should confirm. Rules added later carry their own 'retrieved' date. A rule's optional 'rounding' is the tie rule its source prescribes (default halfExpand).",
+  "rules": [
+    {
+      "currency": "CHF",
+      "increment": "0.05",
+      "scope": "cash (practice; card/electronic to 0.01)",
+      "countries": [
+        "CH",
+        "LI"
+      ],
+      "source": "https://www.snb.ch/en/the-snb/mandates-goals/cash/coins",
+      "note": "1-centime coin withdrawn 1 Jan 2007; 5 centimes is the smallest coin. No statutory rounding rule found; rounding to 0.05 is market practice.",
+      "verified": false
+    },
+    {
+      "currency": "SEK",
+      "increment": "1.00",
+      "scope": "cash only",
+      "countries": [
+        "SE"
+      ],
+      "source": "https://archive.riksbank.se/en/Web-archive/Published/Notices/2009/50-ore-coin-to-be-abolished-in-2010/index.html",
+      "note": "50-öre coin ceased to be legal tender 30 Sep 2010. Riksbank: card payments not affected; cash rounded to nearest krona (1-49 öre down, 50-99 up). Öre remains an accounting unit.",
+      "verified": true
+    },
+    {
+      "currency": "DKK",
+      "increment": "0.50",
+      "scope": "cash only",
+      "countries": [
+        "DK",
+        "GL",
+        "FO"
+      ],
+      "source": "https://lex.dk/afrunding",
+      "note": "Since 1 Oct 2008 (25-øre coin withdrawn). 1-24 øre down, 25-49 up to 50, 51-74 down to 50, 75-99 up. Card payments exact. Danmarks Nationalbank primary page not retrieved (URL 404); secondary sources only. Greenland/Faroe applicability assumed.",
+      "verified": false
+    },
+    {
+      "currency": "NOK",
+      "increment": "1.00",
+      "scope": "cash only",
+      "countries": [
+        "NO",
+        "SJ",
+        "BV"
+      ],
+      "source": "https://www.norges-bank.no/en/news-events/news/Circulars/2011/Regulation-relating-to-withdrawal-of-50-ore-coins-as-legal-tender/",
+      "note": "From 1 May 2012 (50-øre coin withdrawn): øre 1-49 rounded down, 50-99 rounded up, in final settlement of cash transactions.",
+      "verified": true
+    },
+    {
+      "currency": "CAD",
+      "increment": "0.05",
+      "scope": "cash only",
+      "countries": [
+        "CA"
+      ],
+      "source": "https://www.canada.ca/en/revenue-agency/services/forms-publications/publications/gi-131/phasing-penny.html",
+      "note": "Since 4 Feb 2013. CRA GI-131: cash totals rounded to nearest 5 cents; cheque and electronic (card) payments still to the cent; GST computed before rounding. Penny remains legal tender. (Page content seen via search summary; direct fetch returned 404.)",
+      "verified": true
+    },
+    {
+      "currency": "AUD",
+      "increment": "0.05",
+      "scope": "cash only",
+      "countries": [
+        "AU",
+        "CX",
+        "CC",
+        "NF",
+        "NR",
+        "KI",
+        "TV",
+        "HM"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "1c/2c coins withdrawn Feb 1992; cash totals ending 1,2,6,7 down, 3,4,8,9 up. Electronic not usually rounded. No primary RBA/ACCC page fetched; applicability to other AUD-using territories assumed.",
+      "verified": false
+    },
+    {
+      "currency": "NZD",
+      "increment": "0.10",
+      "scope": "cash only",
+      "countries": [
+        "NZ",
+        "CK",
+        "NU",
+        "PN",
+        "TK"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "5c coin demonetised 1 Nov 2006 (1c/2c in 1990). Rounding of total of cash transactions only; treatment of 5c is at retailer discretion (RBNZ advised rounding down). Primary RBNZ page (newcoins.govt.nz) is dead; secondary sources only.",
+      "verified": false
+    },
+    {
+      "currency": "EUR",
+      "increment": "0.05",
+      "scope": "cash only (mandatory for in-person cash; optional for other methods; not allowed for distance sales)",
+      "countries": [
+        "BE"
+      ],
+      "source": "https://economie.fgov.be/en/themes/sales/mandatory-rounding-cash",
+      "note": "Since 1 Dec 2019. Verbatim: \"The rounding obligation applies to all cash payments.\" \"For other payment methods, you are free to decide whether or not to apply rounding.\" \"Rounding is not permitted for distance sales (e.g. via internet).\"",
+      "verified": true
+    },
+    {
+      "currency": "EUR",
+      "increment": "0.05",
+      "scope": "cash only (permitted, must be signposted)",
+      "countries": [
+        "NL"
+      ],
+      "source": "https://www.rijksoverheid.nl/documenten/vraag-en-antwoord/betalingsverkeer/mogen-winkeliers-betalingen-afronden-op-0-eurocent-of-5-eurocent",
+      "note": "Since Sept 2004. Rijksoverheid: shops may round the cash total to 0 or 5 cent if clearly indicated; card payments exact. Voluntary, not mandatory.",
+      "verified": true
+    },
+    {
+      "currency": "EUR",
+      "increment": "0.05",
+      "scope": "cash only (statutory)",
+      "countries": [
+        "FI"
+      ],
+      "source": "https://www.finlex.fi/fi/lainsaadanto/2000/890",
+      "note": "Act 890/2000 on rounding of euro payments; in force since euro cash introduction 2002. 1c/2c remain legal tender. Statute not fetched directly (cited via Wikipedia).",
+      "verified": false
+    },
+    {
+      "currency": "EUR",
+      "increment": "0.05",
+      "scope": "cash only (voluntary)",
+      "countries": [
+        "IE"
+      ],
+      "source": "https://www.irishtimes.com/news/ireland/irish-news/coin-rounding-begins-as-use-of-1-cent-2-cent-coins-reduced-1.2408459",
+      "note": "National rounding since 28 Oct 2015 (Central Bank of Ireland scheme). Applies to total bill paid in cash; card payments unaffected; voluntary for customer and retailer; 1c/2c remain legal tender. Press source, not CBI primary page.",
+      "verified": false
+    },
+    {
+      "currency": "EUR",
+      "increment": "0.05",
+      "scope": "cash only (voluntary practice)",
+      "countries": [
+        "IT"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "Italy stopped minting 1c/2c from 1 Jan 2018 (DL 50/2017 art. 13-quater). Some sellers round cash to 0.05; no general mandatory rule.",
+      "verified": false
+    },
+    {
+      "currency": "EUR",
+      "increment": "0.05",
+      "scope": "cash only",
+      "countries": [
+        "SK"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "From 1 July 2022 per Wikipedia (1c/2c removed from general circulation). Legal basis/mandatory status not confirmed from NBS or Slovak law.",
+      "verified": false
+    },
+    {
+      "currency": "EUR",
+      "increment": "0.05",
+      "scope": "cash only, at physical point of sale",
+      "countries": [
+        "EE"
+      ],
+      "source": "https://www.eestipank.ee/en/press/rounding-rule-will-start-apply-payments-cash-new-year-27122024",
+      "note": "Since 1 Jan 2025. Eesti Pank: final price of a basket paid in cash at a physical point of sale rounded to nearest five cents. 1c/2c remain legal tender.",
+      "verified": true
+    },
+    {
+      "currency": "EUR",
+      "increment": "0.05",
+      "scope": "cash only",
+      "countries": [
+        "LT"
+      ],
+      "source": "https://www.baltictimes.com/lithuania_starts_rounding_off_cash_payments_to_phase_out_1__2_cent_coins",
+      "note": "Since 1 May 2025. Ending 1,2,6,7 down; 3,4,8,9 up. Not applied to non-cash payments, currency exchange, cash transfers, deposits/withdrawals. Press source.",
+      "verified": false
+    },
+    {
+      "currency": "HUF",
+      "increment": "5",
+      "scope": "cash only (statutory)",
+      "countries": [
+        "HU"
+      ],
+      "source": "https://njt.jog.gov.hu/jogszabaly/2008-3-00-00",
+      "note": "Act III of 2008; 1 and 2 Ft coins withdrawn 1 Mar 2008. Cash total not ending in 0 or 5 Ft rounded per the act (1-2 down to 0, 3-4 up to 5, 6-7 down to 5, 8-9 up to 10). Card/transfer to 1 Ft. Note fillér (0.01) is still ISO minor unit but unused.",
+      "verified": true
+    },
+    {
+      "currency": "CZK",
+      "increment": "1.00",
+      "scope": "cash only",
+      "countries": [
+        "CZ"
+      ],
+      "source": "https://www.cnb.cz/en/faq/How-to-round-after-the-withdrawal-of-50-heller-coins",
+      "note": "50-heller coins invalid from 31 Aug 2008. Consumer Protection Act 634/1992 art. 3(c): cash total rounded to nearest valid denomination (whole koruna). Non-cash payments unaffected; prices may still be shown in hellers.",
+      "verified": true
+    },
+    {
+      "currency": "ILS",
+      "increment": "0.10",
+      "scope": "cash only",
+      "countries": [
+        "IL",
+        "PS"
+      ],
+      "source": "https://boi.org.il/en/communication-and-publications/press-releases/the-bank-of-israel-asks-the-government-to-approve-abolishing-the-5-agorot-coin-as-legal-tender/",
+      "note": "5-agorot coin withdrawn from circulation 1 Jan 2008; cash totals rounded to nearest 10 agorot (1-4 down, 5-9 up); non-cash to 1 agora. Sources conflict on formal legal-tender status of the 5 agorot coin (a 2020 BoI release asks to abolish it).",
+      "verified": false
+    },
+    {
+      "currency": "MYR",
+      "increment": "0.05",
+      "scope": "over-the-counter payments (originally cash and non-cash per 2007 announcement; current practice cash only)",
+      "countries": [
+        "MY"
+      ],
+      "source": "https://www.bnm.gov.my/-/introduction-of-a-rounding-mechanism-for-over-the-counter-payments",
+      "note": "Since 1 Apr 2008. Total bill: ending 1,2,6,7 sen down; 3,4,8,9 up. Not applicable to online transactions. Scope conflict: 2007 statement covers cash and non-cash OTC; later sources say cash only.",
+      "verified": false
+    },
+    {
+      "currency": "SGD",
+      "increment": "0.05",
+      "scope": "cash (informal practice; always rounded down per Wikipedia)",
+      "countries": [
+        "SG"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "1-cent coin no longer produced (still legal tender). No MAS rounding rule found; treat as optional retailer practice.",
+      "verified": false
+    },
+    {
+      "currency": "RON",
+      "increment": "0.05",
+      "scope": "cash (practice)",
+      "countries": [
+        "RO"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "1 ban coins legal tender but rare.",
+      "verified": false
+    },
+    {
+      "currency": "XPF",
+      "increment": "5",
+      "scope": "cash only",
+      "countries": [
+        "PF",
+        "NC",
+        "WF"
+      ],
+      "source": "https://www.ieom.fr/nouvelles-pieces/",
+      "note": "1 and 2 franc coins ceased legal tender 30 Nov 2022; rounding does not apply to non-cash transactions. Cited via Wikipedia.",
+      "verified": false
+    },
+    {
+      "currency": "BSD",
+      "increment": "0.05",
+      "scope": "cash",
+      "countries": [
+        "BS"
+      ],
+      "source": "https://www.centralbankbahamas.com/download/075913500.pdf",
+      "note": "One cent coins ceased to be legal tender 2021; cash rounded to nearest 5 cents. Cited via Wikipedia.",
+      "verified": false
+    },
+    {
+      "currency": "TTD",
+      "increment": "0.05",
+      "scope": "cash",
+      "countries": [
+        "TT"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "1c lost legal tender 2018.",
+      "verified": false
+    },
+    {
+      "currency": "ZAR",
+      "increment": "0.10",
+      "scope": "cash (practice)",
+      "countries": [
+        "ZA"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "5c production stopped 2012 but coins remain legal tender; prices rounded to 10c in practice.",
+      "verified": false
+    },
+    {
+      "currency": "HKD",
+      "increment": "0.10",
+      "scope": "cash (practice)",
+      "countries": [
+        "HK"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "5-cent coin eliminated 1989; smallest coin 10 cents.",
+      "verified": false
+    },
+    {
+      "currency": "UAH",
+      "increment": "0.10",
+      "scope": "cash",
+      "countries": [
+        "UA"
+      ],
+      "source": "https://www.bank.gov.ua/news/all/natsionalniy-bank-uporyadkovuye-nominalniy-ryad-banknot-i-monet-grivni",
+      "note": "From 1 Oct 2019, 1/2/5 kopiyka coins withdrawn; cash rounded to nearest 10 kopiyok. Cited via Wikipedia.",
+      "verified": false
+    },
+    {
+      "currency": "CLP",
+      "increment": "10",
+      "scope": "cash only",
+      "countries": [
+        "CL"
+      ],
+      "source": "https://www.dgac.gob.cl/monedas-de-1-y-5-pesos-pasaran-a-la-historia-ley-n-20-956-ministerio-de-hacienda/",
+      "note": "Ley 20.956, since 1 Nov 2017: cash totals ending 1-5 rounded down, 6-9 up, to nearest 10 pesos. Cited via Wikipedia.",
+      "verified": false
+    },
+    {
+      "currency": "PEN",
+      "increment": "0.10",
+      "scope": "cash (practice)",
+      "countries": [
+        "PE"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "5-céntimo coin discontinued 2019.",
+      "verified": false
+    },
+    {
+      "currency": "THB",
+      "increment": "0.25",
+      "scope": "cash (practice)",
+      "countries": [
+        "TH"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "Coins below 25 satang not issued for general circulation.",
+      "verified": false
+    },
+    {
+      "currency": "AED",
+      "increment": "0.25",
+      "scope": "cash (practice)",
+      "countries": [
+        "AE"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "25 fils smallest coin in general circulation; 1/5/10 fils rarely seen. Wikipedia lists AED under both 0.05 and 0.25 sections; inconsistent.",
+      "verified": false
+    },
+    {
+      "currency": "INR",
+      "increment": "1.00",
+      "scope": "cash (practice)",
+      "countries": [
+        "IN"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "25 paise and lower demonetised 2011 (0.50 rounding); 50 paise seldom seen since ~2019, so whole-rupee rounding in practice.",
+      "verified": false
+    },
+    {
+      "currency": "JMD",
+      "increment": "1.00",
+      "scope": "cash",
+      "countries": [
+        "JM"
+      ],
+      "source": "https://jis.gov.jm/information/get-the-facts/demonetisation-of-coins/",
+      "note": "Coins below 1 dollar demonetised 15 Feb 2018.",
+      "verified": false
+    },
+    {
+      "currency": "USD",
+      "increment": "0.05",
+      "scope": "cash (permitted, not required; varies by state)",
+      "countries": [
+        "US"
+      ],
+      "source": "https://en.wikipedia.org/wiki/Cash_rounding",
+      "note": "Penny production for circulation ended Nov 2025; businesses may round cash to nearest 5c or in customer's favour; state laws vary. Not a uniform rule; do not apply by default.",
+      "verified": false
+    },
+    {
+      "currency": "AMD",
+      "increment": "10",
+      "scope": "cash (practice)",
+      "countries": [
+        "AM"
+      ],
+      "source": "https://old.cba.am/en/SitePages/nccracoinscirculated.aspx",
+      "note": "The Central Bank of Armenia lists 10, 20, 50, 100, 200 and 500 dram coins as circulating; the luma and 1, 3 and 5 dram coins are on its 'coins not circulated' page (https://old.cba.am/en/SitePages/nccracoinsnotcirculated.aspx). No statutory rounding rule found. CLDR has whole dram.",
+      "verified": true,
+      "retrieved": "2026-11-08"
+    },
+    {
+      "currency": "CRC",
+      "increment": "10",
+      "scope": "cash (practice)",
+      "countries": [
+        "CR"
+      ],
+      "source": "https://www.bccr.fi.cr/cr/es/noticias/listado-de-noticias/2026/monedas-de-5-10-y-25-del-diseno-anterior-dejaran-de-funcionar-como-medio-de-pago-el-1-de-julio-del-2.html",
+      "note": "Banco Central de Costa Rica: from 1 July 2026 the old 5, 10 and 25 colón coins 'perderán su valor como medio de pago', and the new 10 colón coin is 'la denominación más pequeña del nuevo cono monetario'; 1 and 5 colón coins are listed as out of circulation (https://www.bccr.fi.cr/monedas-y-billetes/monedas-fuera-de-circulacion.html). No statutory rounding rule found. CLDR has whole colones.",
+      "verified": true,
+      "retrieved": "2026-11-08"
+    },
+    {
+      "currency": "GYD",
+      "increment": "1.00",
+      "scope": "cash",
+      "countries": [
+        "GY"
+      ],
+      "source": "https://bankofguyana.org.gy/bog/images/communications/press_release/Notice%20to%20stop%20minting%20one%20dollar%20coin.pdf",
+      "note": "No cent coins in use; the 1 dollar coin is still legal tender though no longer minted. This Bank of Guyana notice (seen only through search results; the site blocks automated reads) says that where the 1 dollar coin is not available merchants 'may round payments to the nearest five dollar'.",
+      "verified": false,
+      "retrieved": "2026-11-08"
+    },
+    {
+      "currency": "MNT",
+      "increment": "1.00",
+      "scope": "cash",
+      "countries": [
+        "MN"
+      ],
+      "source": "https://www.mongolbank.mn/en/p/1416",
+      "note": "Bank of Mongolia: banknotes in circulation for payments go down to 1 tögrög; möngö are not in use.",
+      "verified": true,
+      "retrieved": "2026-11-08"
+    },
+    {
+      "currency": "MRU",
+      "increment": "0.20",
+      "scope": "cash",
+      "countries": [
+        "MR"
+      ],
+      "source": "https://cridem.org/media/documents/bcm-presentation-gr-2017.pdf",
+      "note": "The smallest coin is the 1/5 ouguiya (khoums), per a 2017 Banque Centrale de Mauritanie presentation hosted by a third party (seen only in search results); bcm.mr has no denomination list. Matches CLDR (cashRounding 20).",
+      "verified": false,
+      "retrieved": "2026-11-08"
+    },
+    {
+      "currency": "PKR",
+      "increment": "1.00",
+      "scope": "cash",
+      "countries": [
+        "PK"
+      ],
+      "source": "https://www.sbp.org.pk/press/2014/Coins-15-Sep-2014.pdf",
+      "note": "State Bank of Pakistan: the paisa coins 'will cease to be legal tender on October 1, 2014'; the smallest coin is Re 1. No rounding rule found.",
+      "verified": true,
+      "retrieved": "2026-11-08"
+    },
+    {
+      "currency": "RSD",
+      "increment": "1.00",
+      "scope": "cash (statutory)",
+      "countries": [
+        "RS"
+      ],
+      "source": "https://www.nbs.rs/export/sites/NBS_site/documents/propisi/propisi-trz/opticaj_povlacenje_50_para.pdf",
+      "rounding": "halfTrunc",
+      "note": "National Bank of Serbia, decision of 27 Sep 2007: the 50 para coin ceases to be legal tender from 1 January 2008, and final cash totals are rounded 'од 1 паре до 50 пара – на 0 пара; од 51 паре до 99 пара – на 1 динар' (1 to 50 para down, 51 to 99 para up): ties go down, so the rule's rounding is halfTrunc.",
+      "verified": true,
+      "retrieved": "2026-11-08"
+    },
+    {
+      "currency": "TZS",
+      "increment": "50",
+      "scope": "cash (practice)",
+      "countries": [
+        "TZ"
+      ],
+      "source": "https://www.bot.go.tz/Publications/Regular/Quarterly%20statistical%20Bulletin/en/2025090409030924.pdf",
+      "note": "The 50 shilling coin is the smallest issued now; a Bank of Tanzania bulletin (June 2025, Table 3.5) still lists 5 to 50 senti coins as in circulation, so the legal minimum is unconfirmed. CLDR has whole shillings.",
+      "verified": false,
+      "retrieved": "2026-11-08"
+    },
+    {
+      "currency": "TWD",
+      "increment": "1.00",
+      "scope": "cash (practice)",
+      "countries": [
+        "TW"
+      ],
+      "source": "https://www.cbc.gov.tw/tw/cp-769-26060-37841-1.html",
+      "note": "Central Bank of the Republic of China (Taiwan): the commonly used coins are 1, 5, 10, 20 and 50 dollars; the 0.5 dollar coin is still listed as circulating (https://www.cbc.gov.tw/public/data/issue/money/a1/t04.htm) but rarely used.",
+      "verified": true,
+      "retrieved": "2026-11-08"
+    },
+    {
+      "currency": "UZS",
+      "increment": "50",
+      "scope": "cash (practice)",
+      "countries": [
+        "UZ"
+      ],
+      "source": "https://cbu.uz/en/banknotes-coins/coins/",
+      "note": "Central Bank of Uzbekistan: the tiyin and the 1 to 25 sum coins 'was in circulation until March 1, 2020'; the smallest circulating coin is 50 sum (2018 series). No rounding rule found. CLDR has whole sum.",
+      "verified": true,
+      "retrieved": "2026-11-08"
+    }
+  ]
+}