International Support

The Kibo Composable Commerce Platform (KCCP) offers international support for a number of languages and currencies when it comes to processing orders from sites. Orders can be created and paid for in supported currencies, but these currencies may not always have their associated language translated in notifications or messaging. User interfaces are more limited, as the Fulfiller interface is the only one that is currently translated to another language (French), but additional language packs may be developed in the future as needed.

This guide lists the supported languages and currencies in these different areas of KCCP.

Commerce Languages

Event notifications sent from Kibo during the fulfillment process are only available in English, but consumer email messaging in other languages may be supported depending on the site. This is determined by the locale that is set at site creation; the same site cannot send emails or translations for languages from other locales. For more information about customizing email templates in both English and other languages, see Email Template Customization

When creating a site (System > Structure > Sites), a country code is chosen that determines the locale. If localized data for that country code and associated language does not exist, then American English will be used instead. 

The site provisioning configurations with options for country codes

In general, it is best to assume that the platform will use English and test for other languages as needed with the assistance of Kibo. However, here is a list of common IETF language tags that Kibo supports. Contact your Kibo Project Team or Kibo Support if you have questions about any additional languages not listed below.

LanguageIETF Code
American Englishen-US
UK Englishen-GB
Canadian Frenchfr-CA
Germande-DE
Frenchfr-FR
Italianit-IT
Spanishes-ES
Japaneseja-JP
Cantonesezh-yue-CN
Mandarinzh-cmn-CN
Hong Kong Englishen-HK
Koreanko-KR
Indian Englishen-IN
Dutchnl-NL
Greekel-GR
Swedishsv-SE
Norwegianno-NO

Interface Languages

KCCP currently supports American English and French languages for the Admin UI and the Fulfiller UI. These versions are provided as "language files" in your UI theme, which are prepopulated with text labels in the appropriate language but can be customized as needed.

For more information about language files and customization see the Admin and Fulfiller theme guides. The labels used in language files also extend to translated email templates.

Other language packs may be made available as part of your implementation if desired. Contact your Kibo Project Team or Kibo Support for more information.

Non-ZIP Code Addresses

Some countries, such as the United Arab Emirates, do not use addresses with ZIP codes. Although the Order Routing service usually references ZIP codes to obtain latitude/longitude coordinates of location candidates during routing, the system does support addresses without ZIP codes. In these cases, Inventory and Order Routing will use the entire provided address to look up the latitude/longitude instead.

See the Order Routing documentation for more information on how locations are selected for routing.

Metric vs. Imperial Measurements

You can select whether a fulfillment location uses the metric or imperial system for entering package measurements in their location group configurations.

However, the product catalog does not currently have an option to use metric units. When configuring a product's shipping options, the Admin UI will only display inches. Even if you specify metric units via the Product API (using the packageHeight, packageWidth, packageDepth, and packageWeight fields), those values will still be displayed as inches in the UI. Support for the metric system in the catalog will be added in the future.

Supported Currencies

Many ISO-4217 currency codes can be supported by Kibo, but each site can only use one currency and no-operation payment gateways may need to be built to process some currencies. This means that one site cannot support orders in multiple currencies. If an implementation needs to create orders in different currencies, then a site must be made for each currency. Then the necessary payment gateways can be configured on a per-site basis. 

Currencies that use three decimal places (such as Kuwaiti Dinar, Rial Omani, and Bahraini Dinar) are also supported in the Kibo Composable Commerce Platform APIs and UIs. This includes the Cart, Checkout, and My Account pages on the Storefront as well as the Orders, Customer, B2B, Returns, and Shipping Setting UIs in the Admin. Currencies that typically only use two decimal places, such as USD, will always show two decimal points.

The full list of ISO codes supported by KCCP is provided below.

{
 "totalCount": 162,
 "items": [
  {
   "code": "AED",
   "name": "United Arab Emirates Dirham"
  },
  {
   "code": "AFN",
   "name": "Afghanistan Afghani"
  },
  {
   "code": "ALL",
   "name": "Albania Lek"
  },
  {
   "code": "AMD",
   "name": "Armenia Dram"
  },
  {
   "code": "ANG",
   "name": "Netherlands Antilles Guilder"
  },
  {
   "code": "AOA",
   "name": "Angola Kwanza"
  },
  {
   "code": "ARS",
   "name": "Argentina Peso"
  },
  {
   "code": "AUD",
   "name": "Australia Dollar"
  },
  {
   "code": "AWG",
   "name": "Aruba Guilder"
  },
  {
   "code": "AZN",
   "name": "Azerbaijan New Manat"
  },
  {
   "code": "BAM",
   "name": "Bosnia and Herzegovina Convertible Marka"
  },
  {
   "code": "BBD",
   "name": "Barbados Dollar"
  },
  {
   "code": "BDT",
   "name": "Bangladesh Taka"
  },
  {
   "code": "BGN",
   "name": "Bulgaria Lev"
  },
  {
   "code": "BHD",
   "name": "Bahrain Dinar"
  },
  {
   "code": "BIF",
   "name": "Burundi Franc"
  },
  {
   "code": "BMD",
   "name": "Bermuda Dollar"
  },
  {
   "code": "BND",
   "name": "Brunei Darussalam Dollar"
  },
  {
   "code": "BOB",
   "name": "Bolivia Boliviano"
  },
  {
   "code": "BRL",
   "name": "Brazil Real"
  },
  {
   "code": "BSD",
   "name": "Bahamas Dollar"
  },
  {
   "code": "BTN",
   "name": "Bhutan Ngultrum"
  },
  {
   "code": "BWP",
   "name": "Botswana Pula"
  },
  {
   "code": "BYR",
   "name": "Belarus Ruble"
  },
  {
   "code": "BZD",
   "name": "Belize Dollar"
  },
  {
   "code": "CAD",
   "name": "Canada Dollar"
  },
  {
   "code": "CDF",
   "name": "Congo/Kinshasa Franc"
  },
  {
   "code": "CHF",
   "name": "Switzerland Franc"
  },
  {
   "code": "CLP",
   "name": "Chile Peso"
  },
  {
   "code": "CNY",
   "name": "China Yuan Renminbi"
  },
  {
   "code": "COP",
   "name": "Colombia Peso"
  },
  {
   "code": "CRC",
   "name": "Costa Rica Colon"
  },
  {
   "code": "CUC",
   "name": "Cuba Convertible Peso"
  },
  {
   "code": "CUP",
   "name": "Cuba Peso"
  },
  {
   "code": "CVE",
   "name": "Cape Verde Escudo"
  },
  {
   "code": "CZK",
   "name": "Czech Republic Koruna"
  },
  {
   "code": "DJF",
   "name": "Djibouti Franc"
  },
  {
   "code": "DKK",
   "name": "Denmark Krone"
  },
  {
   "code": "DOP",
   "name": "Dominican Republic Peso"
  },
  {
   "code": "DZD",
   "name": "Algeria Dinar"
  },
  {
   "code": "EGP",
   "name": "Egypt Pound"
  },
  {
   "code": "ERN",
   "name": "Eritrea Nakfa"
  },
  {
   "code": "ETB",
   "name": "Ethiopia Birr"
  },
  {
   "code": "EUR",
   "name": "Euro Member Countries"
  },
  {
   "code": "FJD",
   "name": "Fiji Dollar"
  },
  {
   "code": "FKP",
   "name": "Falkland Islands (Malvinas) Pound"
  },
  {
   "code": "GBP",
   "name": "United Kingdom Pound"
  },
  {
   "code": "GEL",
   "name": "Georgia Lari"
  },
  {
   "code": "GGP",
   "name": "Guernsey Pound"
  },
  {
   "code": "GHS",
   "name": "Ghana Cedi"
  },
  {
   "code": "GIP",
   "name": "Gibraltar Pound"
  },
  {
   "code": "GMD",
   "name": "Gambia Dalasi"
  },
  {
   "code": "GNF",
   "name": "Guinea Franc"
  },
  {
   "code": "GTQ",
   "name": "Guatemala Quetzal"
  },
  {
   "code": "GYD",
   "name": "Guyana Dollar"
  },
  {
   "code": "HKD",
   "name": "Hong Kong Dollar"
  },
  {
   "code": "HNL",
   "name": "Honduras Lempira"
  },
  {
   "code": "HRK",
   "name": "Croatia Kuna"
  },
  {
   "code": "HTG",
   "name": "Haiti Gourde"
  },
  {
   "code": "HUF",
   "name": "Hungary Forint"
  },
  {
   "code": "IDR",
   "name": "Indonesia Rupiah"
  },
  {
   "code": "ILS",
   "name": "Israel Shekel"
  },
  {
   "code": "IMP",
   "name": "Isle of Man Pound"
  },
  {
   "code": "INR",
   "name": "India Rupee"
  },
  {
   "code": "IQD",
   "name": "Iraq Dinar"
  },
  {
   "code": "IRR",
   "name": "Iran Rial"
  },
  {
   "code": "ISK",
   "name": "Iceland Krona"
  },
  {
   "code": "JEP",
   "name": "Jersey Pound"
  },
  {
   "code": "JMD",
   "name": "Jamaica Dollar"
  },
  {
   "code": "JOD",
   "name": "Jordan Dinar"
  },
  {
   "code": "JPY",
   "name": "Japan Yen"
  },
  {
   "code": "KES",
   "name": "Kenya Shilling"
  },
  {
   "code": "KGS",
   "name": "Kyrgyzstan Som"
  },
  {
   "code": "KHR",
   "name": "Cambodia Riel"
  },
  {
   "code": "KMF",
   "name": "Comoros Franc"
  },
  {
   "code": "KPW",
   "name": "Korea (North) Won"
  },
  {
   "code": "KRW",
   "name": "Korea (South) Won"
  },
  {
   "code": "KWD",
   "name": "Kuwait Dinar"
  },
  {
   "code": "KYD",
   "name": "Cayman Islands Dollar"
  },
  {
   "code": "KZT",
   "name": "Kazakhstan Tenge"
  },
  {
   "code": "LAK",
   "name": "Laos Kip"
  },
  {
   "code": "LBP",
   "name": "Lebanon Pound"
  },
  {
   "code": "LKR",
   "name": "Sri Lanka Rupee"
  },
  {
   "code": "LRD",
   "name": "Liberia Dollar"
  },
  {
   "code": "LSL",
   "name": "Lesotho Loti"
  },
  {
   "code": "LTL",
   "name": "Lithuania Litas"
  },
  {
   "code": "LVL",
   "name": "Latvia Lat"
  },
  {
   "code": "LYD",
   "name": "Libya Dinar"
  },
  {
   "code": "MAD",
   "name": "Morocco Dirham"
  },
  {
   "code": "MDL",
   "name": "Moldova Leu"
  },
  {
   "code": "MGA",
   "name": "Madagascar Ariary"
  },
  {
   "code": "MKD",
   "name": "Macedonia Denar"
  },
  {
   "code": "MMK",
   "name": "Myanmar (Burma) Kyat"
  },
  {
   "code": "MNT",
   "name": "Mongolia Tughrik"
  },
  {
   "code": "MOP",
   "name": "Macau Pataca"
  },
  {
   "code": "MRO",
   "name": "Mauritania Ouguiya"
  },
  {
   "code": "MUR",
   "name": "Mauritius Rupee"
  },
  {
   "code": "MVR",
   "name": "Maldives (Maldive Islands) Rufiyaa"
  },
  {
   "code": "MWK",
   "name": "Malawi Kwacha"
  },
  {
   "code": "MXN",
   "name": "Mexico Peso"
  },
  {
   "code": "MYR",
   "name": "Malaysia Ringgit"
  },
  {
   "code": "MZN",
   "name": "Mozambique Metical"
  },
  {
   "code": "NAD",
   "name": "Namibia Dollar"
  },
  {
   "code": "NGN",
   "name": "Nigeria Naira"
  },
  {
   "code": "NIO",
   "name": "Nicaragua Cordoba"
  },
  {
   "code": "NOK",
   "name": "Norway Krone"
  },
  {
   "code": "NPR",
   "name": "Nepal Rupee"
  },
  {
   "code": "NZD",
   "name": "New Zealand Dollar"
  },
  {
   "code": "OMR",
   "name": "Oman Rial"
  },
  {
   "code": "PAB",
   "name": "Panama Balboa"
  },
  {
   "code": "PEN",
   "name": "Peru Nuevo Sol"
  },
  {
   "code": "PGK",
   "name": "Papua New Guinea Kina"
  },
  {
   "code": "PHP",
   "name": "Philippines Peso"
  },
  {
   "code": "PKR",
   "name": "Pakistan Rupee"
  },
  {
   "code": "PLN",
   "name": "Poland Zloty"
  },
  {
   "code": "PYG",
   "name": "Paraguay Guarani"
  },
  {
   "code": "QAR",
   "name": "Qatar Riyal"
  },
  {
   "code": "RON",
   "name": "Romania New Leu"
  },
  {
   "code": "RSD",
   "name": "Serbia Dinar"
  },
  {
   "code": "RUB",
   "name": "Russia Ruble"
  },
  {
   "code": "RWF",
   "name": "Rwanda Franc"
  },
  {
   "code": "SAR",
   "name": "Saudi Arabia Riyal"
  },
  {
   "code": "SBD",
   "name": "Solomon Islands Dollar"
  },
  {
   "code": "SCR",
   "name": "Seychelles Rupee"
  },
  {
   "code": "SDG",
   "name": "Sudan Pound"
  },
  {
   "code": "SEK",
   "name": "Sweden Krona"
  },
  {
   "code": "SGD",
   "name": "Singapore Dollar"
  },
  {
   "code": "SHP",
   "name": "Saint Helena Pound"
  },
  {
   "code": "SLL",
   "name": "Sierra Leone Leone"
  },
  {
   "code": "SOS",
   "name": "Somalia Shilling"
  },
  {
   "code": "SPL",
   "name": "Seborga Luigino"
  },
  {
   "code": "SRD",
   "name": "Suriname Dollar"
  },
  {
   "code": "STD",
   "name": "Sao Principe and Tome Dobra"
  },
  {
   "code": "SVC",
   "name": "El Salvador Colon"
  },
  {
   "code": "SYP",
   "name": "Syria Pound"
  },
  {
   "code": "SZL",
   "name": "Swaziland Lilangeni"
  },
  {
   "code": "THB",
   "name": "Thailand Baht"
  },
  {
   "code": "TJS",
   "name": "Tajikistan Somoni"
  },
  {
   "code": "TMT",
   "name": "Turkmenistan Manat"
  },
  {
   "code": "TND",
   "name": "Tunisia Dinar"
  },
  {
   "code": "TOP",
   "name": "Tonga Pa anga"
  },
  {
   "code": "TRY",
   "name": "Turkey Lira"
  },
  {
   "code": "TTD",
   "name": "Trinidad and Tobago Dollar"
  },
  {
   "code": "TVD",
   "name": "Tuvalu Dollar"
  },
  {
   "code": "TWD",
   "name": "Taiwan New Dollar"
  },
  {
   "code": "TZS",
   "name": "Tanzania Shilling"
  },
  {
   "code": "UAH",
   "name": "Ukraine Hryvna"
  },
  {
   "code": "UGX",
   "name": "Uganda Shilling"
  },
  {
   "code": "USD",
   "name": "US Dollar"
  },
  {
   "code": "UYU",
   "name": "Uruguay Peso"
  },
  {
   "code": "UZS",
   "name": "Uzbekistan Som"
  },
  {
   "code": "VEF",
   "name": "Venezuela Bolivar Fuerte"
  },
  {
   "code": "VND",
   "name": "Viet Nam Dong"
  },
  {
   "code": "VUV",
   "name": "Vanuatu Vatu"
  },
  {
   "code": "WST",
   "name": "Samoa Tala"
  },
  {
   "code": "XDR",
   "name": "IMF Special Drawing Rights"
  },
  {
   "code": "XOF",
   "name": "CFA (BCEAO) Franc"
  },
  {
   "code": "XPF",
   "name": "CFP Franc"
  },
  {
   "code": "YER",
   "name": "Yemen Rial"
  },
  {
   "code": "ZAR",
   "name": "South Africa Rand"
  },
  {
   "code": "ZMK",
   "name": "Zambia Kwacha"
  },
  {
   "code": "ZWD",
   "name": "Zimbabwe Dollar"
  }
 ]
}

Reporting Currencies

However, standard out-of-the-box reports and Reporting dashboards display all values in USD by default and will convert any non-USD values. If you want to display reports in currencies other than USD, you must have Kibo change your default during implementation or make create custom reports based on the "transactional" field instead. 

For more information, see the Reporting documentation.