ISO/IEC JTC 1/SC 32 N 0699 Date: 2001-10-15 REPLACES: --

ISO/IEC JTC 1/SC 32

Data Management and Interchange

Secretariat: United States of America (ANSI) Administered by Pacific Northwest National Laboratory on behalf of ANSI

DOCUMENT TYPE Other document (Open) TITLE International Standards Organization (ISO) 4217 Currency Codes and XML Schema: Proposed tML ISO 4217 Standard SOURCE Technical Expert - Raymond E. Reeves, Sprint PROJECT NUMBER 1.32.18.01.00.00 and 1.32.20.01.00.00 STATUS The contribution pertains to both WG1 work on ISO/18038 and WG2 work on ISO/IEC18022. REFERENCES ACTION ID. FYI REQUESTED ACTION DUE DATE Number of Pages 42 LANGUAGE USED English DISTRIBUTION P & L Members SC Chair WG Conveners and Secretaries

Douglas Mann, Secretariat, ISO/IEC JTC 1/SC 32 Pacific Northwest National Laboratory *, 901 D Street, SW., Suite 900, Washington, DC, 20024-2115, United States of America Telephone: +1 703 379 6915 x 111; Facsimile; +1 703 379 8934; E-mail: [email protected] available from the JTC 1/SC 32 WebSite http://www.jtc1sc32.org/ *Pacific Northwest National Laboratory (PNL) administers the ISO/IEC JTC 1/SC 32 Secretariat on behalf of ANSI TITLE: International Standards Organization (ISO) 4217 Currency Codes and XML Schema: Proposed tML ISO 4217 Standard

Source: US TAG to JTC 1/SC 32/WG 1 [Prepared by Raymond E. Reeves, Sprint]

Status: Contribution to work on ISO/IEC 18022 (and 18038) [See also a similar contributions on proposed tML ISO 3166 standard and on proposed tML ISO 10646/Unicode standard, the latter already contributed as JTC1/SC32/WG1 N177]

Action: For consideration in relation to work on 18022 (and 18038). The document represents a proposed standard of a telecommunications Markup Language (tML) schema following the rules and guidelines defined in the tML standard framework. The document was originally prepared to assist the ANSI Accredited Standards Committee T1 – Telecommunications, i.e. ANSI ASC - T1. Contribution will be modified to reflect progress of work on ISO/IEC 18022. COMMITTEE T1 – TELECOMMUNICATIONS Working Group T1M1 T1M1.5/2001-116 R1 Kansas City, MO, September 10-11, 2001

DRAFT STANDARD

TITLE: International Standards Organization (ISO) 4217 Currency Code: UML Model & XML Schema SOURCE*: Sprint PROJECT: tML ______

ABSTRACT

This proposed standard presents a UML Model and telecommunications Markup Language (tML) schema for the current International Standards Organization (ISO) 4217 Codes for the representation of currencies and funds.

This document uses XML Schema’s following the XML Schema Specifications (W3C Recommendation, 2 May 2001). This proposed standard follows the rules and guidelines defined in the tML standard Framework.

NOTICE This contribution has been prepared to assist Accredited Standards Committee T1–Telecommunications. This document is offered to the Committee as a basis for discussion and is not a binding proposal on Sprint or any other company. The requirements are subject to change in form and numerical value after more study. Sprint specifically reserves the right to add to, amend, or withdraw the statements contained herein. * CONTACT: Raymond E. Reeves; email: [email protected]; Tel: 1-913-534-3405; Fax: 1-913-534-5136 T1M1.5/2001-116 R1

Table of Contents 1. INTRODUCTION 3

1.1 PURPOSE 3 1.2 SCOPE AND ISSUES 3 1.3 CONVENTIONS USED IN THIS DOCUMENT 3 1.4 REFERENCES 4 2. DEFINITION OF THE XML SCHEMA 5

2.1. TML-ISO-4217.XSD 5 2.1.1. Currency code and abbreviations 5 2.1.2. UML Model 10 2.1.3. XML Schema 10 2.1.3.1 currencyCodeAlpha3Type 11 2.1.3.2 currencyCodeDigit3Type 26

LIST OF FIGURES

Figure 1. Currency codes model...... 10

2 T1M1.5/2001-116 R1

1. Introduction

As part of the work requested from the Digital Subscriber Line (DSL) forum to create standard XML Schemas for their service provisioning interfaces, some standardized data elements have been found. Some of these codes fall into the category of elements standardized by the International Standards Organization (ISO). The specific ISO standard referenced is the ISO-4217 standard for the representation of currencies and funds using Alpha 3 codes.

1.1 Purpose

This contribution presents a proposed standard XML Schema for the several ISO-4217 standardized currency code representations and considers the guidelines established by the telecommunication Markup Language (tML) Ad-Hoc Group (AHG).

1.2 Scope and issues

This proposed standard presents the XML Schema corresponding to the requirements set forth in ISO-4217 for Alpha 3 currency codes. The semantics expressed in the herein contained schema have the inherent limitations of the XML Schema description language.

Because the tML standards Framework is still a document in review, it is expected that some aspects of the propose schema might be subject to review. Especially subject to review are the namespace names and the location of some highly reusable tag names.

1.3 Conventions Used in this Document

The reader should be aware of several conventions used in this document. The most important one is that code (either XML Schema -.xsd-, XML instance document -.xml-) will be shown in tahoma 8 point font.

nd The XML Schema version used is http://www.w3.org/2001/XMLSchema, May 2 , 2001 XML Schema Recommendation.

3 T1M1.5/2001-116 R1

1.4 References

At the time of publication, the editions indicated were valid. All Recommendations and other references are subject to revision; all users of this Recommendation are therefore encouraged to investigate the possibility of applying the most recent edition of the Recommendations and other references listed below.

[1] Extensible Markup Language (XML) 1.0, Second Edition, Tim Bray et al., eds,. W3C, 6 October 2000. See http://www.w3.org/TR/2000/REC-xml-20001006.

[2] Namespaces in XML, Tim Bray et al., eds,. W3C, 14 January 1999. See http://www.w3.org/TR/1999/REC-xml-names-19990114.

[3] XML Schema Part 0: Primer. David C. Fallside, et al., eds,. W3C Recommendation, 2 May 2001. See http://www.w3.org/TR/2001/REC-xmlschema-0-200010502.

[4] XML Schema Part 1: Structures. Henry Thompson et al., eds,. W3C Recommendation, 2 May 2001. See http://www.w3.org/TR/2001/REC-xmlschema- 1-200010502.

[5] XML Schema Part 2: Datatypes . Paul Biron et al., eds,. W3C Recommendation, 2 May 2001. See http://www.w3.org/TR/2001/REC-xmlschema-2-200010502.

[6] ISO-4217, Codes for the Representation of Names of Countries. International Standards Organization (ISO)

[7] T1M1/2001-100R2: tML Guidelines for mapping UML notation to XML Schemas and vice versa

[8] T1M1/2001-002 R6: tML Framework Document

4 T1M1.5/2001-116 R1

2. Definition of the XML Schema

The following sections provide the proposed standard implementation of XML Schemas and XML tags corresponding to the current ISO-4217 standard country codes. All XML Schemas presented in this document have been validated and could be revalidated, with minimum changes, by any XML Schema validating editor.

2.1. tML-ISO-4217.xsd

2.1.1. Currency code and abbreviations

The current standard describes the following list of currencies and corresponding three character abbreviation1:

Code Currency Name Alpha 3 Numeric 3 Afghani AFA 004 Algerian Dinar DZD 012 Andorran Peseta ADP 020 Argentine Peso ARS 032 Armenian Dram AMD 051 Aruban Guilder AWG 533 Australian Dollar AUD 036 Azerbaijanian Manat AZM 031 Bahamian Dollar BSD 044 Bahraini Dinar BHD 048 Baht THB 764 Balboa PAB 590 Barbados Dollar BBD 052 Belarussian Ruble BYB 112 Belarussian Ruble BYR 974 Belgian Franc BEF 056 Belize Dollar BZD 084 Bermudian Dollar BMD 060 Bolivar VEB 862 Boliviano BOB 068 Brazilian Real BRL 986 Brunei Dollar BND 096 Bulgarian Lev BGN 975 Burundi Franc BIF 108 Canadian Dollar CAD 124 Cape Verde Escudo CVE 132 Cayman Islands Dollar KYD 136 Cedi GHC 288 CFA Franc BCEAO XOF 952

1 http://www.bsi-global.com/Technical+Information/04_Publications+Catalogue_Publications/_Publications/tig90x.doc is published by the BSI Currency Code Service ISO 4217 Maintenance Agency.

5 T1M1.5/2001-116 R1

Code Currency Name Alpha 3 Numeric 3 CFA Franc BEAC XAF 950 CFP Franc XPF 953 Chilean Peso CLP 152 Colombian Peso COP 170 Comoro Franc KMF 174 Convertible Marks BAM 977 Cordoba Oro NIO 558 Costa Rican Colon CRC 188 Croatian kuna HRK 191 Cuban Peso CUP 192 Cyprus Pound CYP 196 Czech Koruna CZK 203 Dalasi GMD 270 Danish Krone DKK 208 Denar MKD 807 Deutsche Mark DEM 276 Djibouti Franc DJF 262 Dobra STD 678 Dominican Peso DOP 214 Dong VND 704 Drachma GRD 300 East Caribbean Dollar XCD 951 Egyptian Pound EGP 818 El Salvador Colon SVC 222 Ethiopian Birr ETB 230 Falkland Islands Pound FKP 238 Fiji Dollar FJD 242 Forint HUF 348 Franc Congolais CDF 976 French Franc FRF 250 Gibraltar Pound GIP 292 Gourde HTG 332 Guarani PYG 600 Guinea Franc GNF 324 Guinea-Bissau Peso GWP 624 Guyana Dollar GYD 328 Hong Kong Dollar HKD 344 Hryvnia UAH 980 Iceland Krona ISK 352 Indian Rupee INR 356 Iranian Rial IRR 364 Iraqi Dinar IQD 368 Irish Pound IEP 372 Italian Lira ITL 380 Jamaican Dollar JMD 388 Jordanian Dinar JOD 400

6 T1M1.5/2001-116 R1

Code Currency Name Alpha 3 Numeric 3 Kenyan Shilling KES 404 Kina PGK 598 Kip LAK 418 Kroon EEK 233 Kuwaiti Dinar KWD 414 Kwacha MWK 454 Kwacha ZMK 894 Kwanza AOA 973 Kyat MMK 104 Lari GEL 981 Latvian Lats LVL 428 Lebanese Pound LBP 422 Lek ALL 008 Lempira HNL 340 Leone SLL 694 Leu ROL 642 Lev BGL 100 Liberian Dollar LRD 430 Libyan Dinar LYD 434 Lilangeni SZL 748 Lithuanian Litus LTL 440 Loti LSL 426 Luxembourg Franc LUF 442 Malagasy Franc MGF 450 Malaysian Ringgit MYR 458 Maltese Lira MTL 470 Manat TMM 795 Markka FIM 246 Mauritius Rupee MUR 480 Metical MZM 508 Mexican Peso MXN 484 Mexican Unidad de Inversion (UDI) MXV 979 Moldovan Leu MDL 498 Moroccan Dirham MAD 504 Mvdol BOV 984 Naira NGN 566 Nakfa ERN 232 Namibia Dollar NAD 516 Nepalese Rupee NPR 524 Netherlands Antillian Guilder ANG 532 Netherlands Guilder NLG 528 New Israeli Sheqel ILS 376 New Taiwan Dollar TWD 901 New Zealand Dollar NZD 554 Ngultrum BTN 064 North Korean Won KPW 408

7 T1M1.5/2001-116 R1

Code Currency Name Alpha 3 Numeric 3 Norwegian Krone NOK 578 Nuevo Sol PEN 604 Ouguiya MRO 478 Pa’anga TOP 776 Pakistan Rupee PKR 586 Pataca MOP 446 Peso Uruguayo UYU 858 Philippine Peso PHP 608 Portuguese Escudo PTE 620 Pound Sterling GBP 826 Pula BWP 072 Qatari Rial QAR 634 Quetzal GTQ 320 Rand ZAR 710 Rial Omani OMR 512 Riel KHR 116 Rufiyaa MVR 462 Rupiah IDR 360 Russian Ruble RUB 643 Russian Ruble RUR 810 Rwanda Franc RWF 646 Saint Helena Pound SHP 654 Saudi Riyal SAR 682 Schilling ATS 040 SDR XDR 960 Seychelles Rupee SCR 690 Singapore Dollar SGD 702 Slovak Koruna SKK 703 Solomon Islands Dollar SBD 090 Som KGS 417 Somali Shilling SOS 706 Spanish Peseta ESP 724 Sri Lanka Rupee LKR 144 Sudanese Dinar SDD 736 Suriname Guilder SRG 740 Swedish Krona SEK 752 Swiss Franc CHF 756 Syrian Pound SYP 760 Tajik Ruble TJR 762 Taka BDT 050 Tala WST 882 Tanzanian Shilling TZS 834 Tenge KZT 398 Timor Escudo TPE 626 Tolar SIT 705 Trinidad and Tobago Dollar TTD 780

8 T1M1.5/2001-116 R1

Code Currency Name Alpha 3 Numeric 3 Tugrik MNT 496 Tunisian Dinar TND 788 Turkish Lira TRL 792 UAE Dirham AED 784 Uganda Shilling UGX 800 Unidades de fomento CLF 990 US Dollar USD 840 Uzbekistan Sum UZS 860 Vatu VUV 548 Won KRW 410 Yemeni Rial YER 886 Yen JPY 392 Yuan Renminbi CNY 156 Yugoslavian Dinar YUM 891 Zimbabwe Dollar ZWD 716 Zloty PLN 985 Afghani AFA 004 Algerian Dinar DZD 012 Andorran Peseta ADP 020 Argentine Peso ARS 032 Armenian Dram AMD 051 Aruban Guilder AWG 533 Australian Dollar AUD 036 Azerbaijanian Manat AZM 031 Bahamian Dollar BSD 044 Bahraini Dinar BHD 048 Baht THB 764 Balboa PAB 590 Barbados Dollar BBD 052 Belarussian Ruble BYB 112 Belarussian Ruble BYR 974 Belgian Franc BEF 056 Belize Dollar BZD 084 Bermudian Dollar BMD 060 Bolivar VEB 862 Boliviano BOB 068 Brazilian Real BRL 986 Brunei Dollar BND 096 Bulgarian Lev BGN 975

2.1.2. UML Model

These code sets are defined within the ISO-4217 package and contains two enumeration datatypes, one for each currency code representation. Each enumeration contains a property-list with a series of “value” entries for each country code.

9 T1M1.5/2001-116 R1

ISO-4217 <> <> currencyCodeAlpha3 currencyCodeNumeric3

Figure 1. Currency codes model

2.1.3. XML Schema These code types are controlled by a maintenance authority and lend themselves for an enumeration of the permitted or listed values in the standard. As a result, the corresponding XML Schema follows:

Based on ISO-4217 A list of global currencies and the three-character currency code generally used to represent each currency are at: http://www.xe.com/iso4217.htm http://www.bsi-global.com/Technical+Information/04_Publications+Catalogue_Publications/_Publications/tig90.xhtml

Often, but not always, this code is the same as the ISO 4217 standard. In most cases, the ISO 4217 currency code is composed of the country's two-character ISO 3166 country code plus an extra character to denote the currency unit. For example, the code for Canadian Dollars is simply Canada's two-character ISO 3166 code ("CA") plus a one-character currency designator ("D").

Currency codes can be expressed as alpha 3 or numeric 3 codes. This standard schema only provides the Alpha 3 code. For the most current updates, refer to http://www.din.de/gremien/nas/nabd/iso4217ma/codlistp1/en_listp1.html.

Andorran Peseta UAE Dirham Afghani Lek

10 T1M1.5/2001-116 R1

Armenian Dram Netherlands Antillian Guilder Kwanza Argentine Peso Schilling Australian Dollar Aruban Guilder Azerbaijanian Manat

Convertible Marks Barbados Dollar Taka Belgian Franc Lev

11 T1M1.5/2001-116 R1

Bulgarian Lev Bahraini Dinar Burundi Franc Bermudian Dollar Brunei Dollar Boliviano Mvdol Brazilian Real

Bahamian Dollar Ngultrum Pula Belarussian Ruble Belarussian Ruble

12 T1M1.5/2001-116 R1

Belize Dollar Canadian Dollar Franc Congolais Swiss Franc Unidades de fomento Chilean Peso Yuan Renminbi Colombian Peso

Costa Rican Colon Cuban Peso Cape Verde Escudo Cyprus Pound Czech Koruna

13 T1M1.5/2001-116 R1

Deutsche Mark Djibouti Franc Danish Krone Dominican Peso Algerian Dinar Kroon Egyptian Pound Nakfa

Spanish Peseta Ethiopian Birr Markka Fiji Dollar Falkland Islands Pound

14 T1M1.5/2001-116 R1

French Franc Pound Sterling Lari Cedi Gibraltar Pound Dalasi Guinea Franc Drachma

Quetzal Guinea-Bissau Peso Guyana Dollar Hong Kong Dollar Lempira

15 T1M1.5/2001-116 R1

Croatian kuna Gourde Forint Rupiah Irish Pound New Israeli Sheqel Indian Rupee Iraqi Dinar

Iranian Rial Iceland Krona Italian Lira Jamaican Dollar Jordanian Dinar

16 T1M1.5/2001-116 R1

Yen Kenyan Shilling Som Riel Comoro Franc North Korean Won Won Kuwaiti Dinar

Cayman Islands Dollar Tenge Kip Lebanese Pound Sri Lanka Rupee

17 T1M1.5/2001-116 R1

Liberian Dollar Loti Lithuanian Litus Luxembourg Franc Latvian Lats Libyan Dinar Moroccan Dirham Moldovan Leu

Malagasy Franc Denar Kyat Tugrik Pataca

18 T1M1.5/2001-116 R1

Ouguiya Maltese Lira Mauritius Rupee Rufiyaa Kwacha Mexican Peso Mexican Unidad de Inversion (UDI) Malaysian Ringgit

Metical Namibia Dollar Naira Cordoba Oro Netherlands Guilder

19 T1M1.5/2001-116 R1

Norwegian Krone Nepalese Rupee New Zealand Dollar Rial Omani Balboa Nuevo Sol Kina Philippine Peso

Pakistan Rupee Zloty Portuguese Escudo Guarani Qatari Rial

20 T1M1.5/2001-116 R1

Leu Russian Ruble Russian Ruble Rwanda Franc Saudi Riyal Solomon Islands Dollar Seychelles Rupee Sudanese Dinar

Swedish Krona Singapore Dollar Saint Helena Pound Tolar Slovak Koruna

21 T1M1.5/2001-116 R1

Leone Somali Shilling Suriname Guilder Dobra El Salvador Colon Syrian Pound Lilangeni Baht

Tajik Ruble Manat Tunisian Dinar Pa’anga Timor Escudo

22 T1M1.5/2001-116 R1

Turkish Lira Trinidad and Tobago Dollar New Taiwan Dollar Tanzanian Shilling Hryvnia Uganda Shilling US Dollar Peso Uruguayo

Uzbekistan Sum Bolivar Dong Vatu Tala

23 T1M1.5/2001-116 R1

CFA Franc BEAC East Caribbean Dollar SDR CFA Franc BCEAO CFP Franc Yemeni Rial Yugoslavian Dinar Rand

Kwacha Zimbabwe Dollar

24 T1M1.5/2001-116 R1

Afghani Lek Algerian Dinar Andorran Peseta Azerbaijanian Manat Argentine Peso Australian Dollar Schilling Bahamian Dollar Bahraini Dinar Taka Armenian Dram

25 T1M1.5/2001-116 R1

Barbados Dollar Belgian Franc Bermudian Dollar Ngultrum Boliviano Pula Belize Dollar Solomon Islands Dollar Brunei Dollar Lev Kyat Burundi Franc Belarussian Ruble

26 T1M1.5/2001-116 R1

Riel Canadian Dollar Cape Verde Escudo Cayman Islands Dollar Sri Lanka Rupee Chilean Peso Yuan Renminbi Colombian Peso Comoro Franc Costa Rican Colon Croatian kuna Cuban Peso Cyprus Pound

27 T1M1.5/2001-116 R1

Czech Koruna Danish Krone Dominican Peso El Salvador Colon Ethiopian Birr Nakfa Kroon Falkland Islands Pound Fiji Dollar Markka French Franc Djibouti Franc Dalasi

28 T1M1.5/2001-116 R1

Deutsche Mark Cedi Gibraltar Pound Drachma Quetzal Guinea Franc Guyana Dollar Gourde Lempira Hong Kong Dollar Forint Iceland Krona Indian Rupee

29 T1M1.5/2001-116 R1

Indian Rupee Rupiah Rupiah Iranian Rial Iraqi Dinar Irish Pound New Israeli Sheqel Italian Lira Jamaican Dollar Yen Tenge Jordanian Dinar Kenyan Shilling

30 T1M1.5/2001-116 R1

North Korean Won Won Kuwaiti Dinar Som Kip Lebanese Pound Loti Latvian Lats Liberian Dollar Libyan Dinar Lithuanian Litus Luxembourg Franc Pataca

31 T1M1.5/2001-116 R1

Malagasy Franc Kwacha Malaysian Ringgit Rufiyaa Maltese Lira Ouguiya Mauritius Rupee Mexican Peso Tugrik Moldovan Leu Moroccan Dirham Metical Rial Omani

32 T1M1.5/2001-116 R1

Namibia Dollar Nepalese Rupee Netherlands Guilder Netherlands Antillian Guilder Aruban Guilder Vatu New Zealand Dollar Cordoba Oro Naira Norwegian Krone Pakistan Rupee Balboa Kina

33 T1M1.5/2001-116 R1

Guarani Nuevo Sol Philippine Peso Portuguese Escudo Guinea-Bissau Peso Timor Escudo Qatari Rial Leu Russian Ruble Rwanda Franc Saint Helena Pound Dobra Saudi Riyal

34 T1M1.5/2001-116 R1

Seychelles Rupee Leone Singapore Dollar Slovak Koruna Dong Tolar Somali Shilling Rand Zimbabwe Dollar Spanish Peseta Sudanese Dinar Suriname Guilder Lilangeni

35 T1M1.5/2001-116 R1

Swedish Krona Swiss Franc Syrian Pound Tajik Ruble Baht Pa’anga Trinidad and Tobago Dollar UAE Dirham Tunisian Dinar Turkish Lira Manat Uganda Shilling Denar

36 T1M1.5/2001-116 R1

Russian Ruble Egyptian Pound Pound Sterling Tanzanian Shilling US Dollar Peso Uruguayo Uzbekistan Sum Bolivar Tala Yemeni Rial Yugoslavian Dinar Kwacha New Taiwan Dollar

37 T1M1.5/2001-116 R1

CFA Franc BEAC East Caribbean Dollar CFA Franc BCEAO CFP Franc SDR Kwanza Belarussian Ruble Bulgarian Lev Franc Congolais Convertible Marks Mexican Unidad de Inversion (UDI) Hryvnia Lari

38 T1M1.5/2001-116 R1

Mvdol Zloty Brazilian Real Unidades de fomento Raymond E. Reeves

39