tokfc RefSheet

Codici valuta (ISO 4217)

Utile quando si creano moduli di pagamento, tabelle di cambio o esportazioni di fatture.

Aggiornato:

ValutaCodiceSimboloDecimali
dollaro statunitenseUSD$2
euroEUR€2
sterlina britannicaGBP£2
yen giapponeseJPY¥0
yuan cineseCNY¥ / 元2
dollaro di Hong KongHKDHK$2
dollaro taiwaneseTWDNT$2
won sudcoreanoKRW₩0
franco svizzeroCHFCHF2
dollaro canadeseCADC$2
dollaro australianoAUDA$2
dollaro neozelandeseNZDNZ$2
dollaro di SingaporeSGDS$2
rupia indianaINR₹2
rupia indonesianaIDRRp2
baht thailandeseTHB฿2
dong vietnamitaVND₫0
ringgit maleseMYRRM2
peso filippinoPHP₱2
real brasilianoBRLR$2
peso messicanoMXNMex$2
peso argentinoARS$2
lira turcaTRY₺2
rublo russoRUB₽2
riyal sauditaSAR﷼2
dirham degli EmiratiAEDد.إ2
rand sudafricanoZARR2
zloty polaccoPLNzł2
corona svedeseSEKkr2
corona norvegeseNOKkr2
corona daneseDKKkr2

Note

Cosa specifica realmente ISO 4217

ISO 4217 è lo standard internazionale che assegna a ogni valuta un codice alfanumerico di tre lettere, un codice numerico e un numero definito di cifre decimali. Le lettere non sono casuali: le prime due identificano solitamente il paese o la regione, la terza il nome della valuta; così USD indica il dollaro degli Stati Uniti, JPY lo yen giapponese ed EUR l'euro. Lo standard fissa anche la frazione minore — quante cifre seguono il punto decimale — che è ciò che il software utilizza per arrotondare gli importi correttamente. Quando un sistema dice «memorizzare il codice», si riferisce al codice alfabetico ISO 4217, non al simbolo, e questa distinzione previene una vasta categoria di errori nei pagamenti.

Perché il simbolo non basta mai

I simboli valutarie sono ambigui in modi che i codici non sono. Il segno del dollaro è utilizzato dal dollaro statunitense, canadese, australiano, neozelandese, di Hong Kong e di Singapore, tra gli altri; i simboli dello yen e dello yuan si sovrappongono; il segno della sterlina copre la sterlina britannica e diverse altre. Un prezzo scritto come «10 $» non dice nulla sulla valuta intesa. Nelle fatture, nelle API e nei database, memorizzare il codice a tre lettere elimina del tutto l'ambiguità, e il simbolo diventa un dettaglio di presentazione scelto al momento della visualizzazione in base al pubblico. La regola pratica per qualsiasi sistema che gestisce denaro a livello internazionale è semplice: memorizzare il codice, visualizzare il simbolo.

Frazioni minori, esponenti e arrotondamento

Il numero di cifre decimali è una proprietà della valuta, non un'impostazione globale. La maggior parte delle valute utilizza due cifre, quindi USD, EUR, GBP e CNY prevedono tutte i centesimi. Ma lo yen e il won sudcoreano non hanno frazioni minori — 100 JPY sono cento yen, senza decimali — mentre alcune valute basate sul dinaro, tra cui il dinaro kuwaitiano, quello bahreinita, il rial omanita e il dinaro tunisino, utilizzano tre cifre decimali. Alcune valute hanno inoltre una frazione minore diversa per il contante rispetto alla contabilità. Un arrotondamento errato tra questi casi può creare discrepanze di cento volte, quindi leggere sempre l'esponente dallo standard piuttosto che presumere due cifre decimali.

Un codice breve, una lunga lista di casi limite

Oltre alle principali valute presenti in qualsiasi tabella di riferimento si trovano i casi più complessi. Le valute subiscono redenominazioni — lo Zimbabwe ha eliminato zeri più di una volta — e i codici soppressi restano nei record storici. Alcuni territori utilizzano direttamente la valuta di un altro paese, pertanto non esiste un codice locale. Le criptovalute si collocano volutamente al di fuori di ISO 4217 e utilizzano i propri ticker, motivo per cui un ledger che gestisce entrambi i tipi deve sapere in quale namespace si trova. Inoltre, alcune valute condividono lo stesso nome tra paesi diversi, pur avendo codici e valori differenti. Comprendere che il codice è l'identificatore stabile, mentre i simboli, i nomi e persino le cifre decimali possono cambiare, è il messaggio pratico da trarre.

Domande frequenti

A quale valuta corrisponde il codice EUR?
EUR è il codice ISO 4217 dell'euro, la valuta della maggior parte dei paesi dell'UE. Il suo simbolo è €.
Qual è il codice valuta del Giappone?
Lo yen giapponese ha codice ISO 4217 JPY e simbolo ¥. Non ha cifre decimali.
Perché salvare un codice di tre lettere invece del simbolo?
I simboli si ripetono: $ può indicare USD, CAD, AUD e altri. Il codice ISO 4217 di tre lettere è univoco.

Fonti

Vedi anche