Валюти: коди ISO 4217

У кожної валюти в ECMS9 три окремих поля. Плутанина між ними — найчастіша причина попередження Google Search Console «Недійсний код валюти ISO 4217 (у вузлі "offers")» і відхилених прайс-фідів.

Поле	Що це	Приклад (гривня)
Ім'я	Людська назва, видно лише в адмінці	Гривня
ISO код	Три великі латинські літери за стандартом ISO 4217. Його читають машини: Google, маркетплейси, платіжні шлюзи, аналітика	UAH
Символ	Те, що покупець бачить біля ціни на вітрині	грн, ₴

Вітрина ніколи не показує покупцю ISO код, а машини ніколи не читають символ. Тому код має бути точно стандартним, а символ — будь-яким звичним для ваших покупців.

Де задати

Адмінка → Магазин → Валюта, відкрийте валюту і перевірте поле ISO Код. Збережіть, потім очистіть кеш сайту (Адмінка → Очистити кеш), щоб закешовані сторінки товарів і фіди підхопили нове значення.

Найуживаніші правильні коди:

Валюта	Код
Українська гривня	UAH
Долар США	USD
Євро	EUR
Польський злотий	PLN
Британський фунт	GBP

Повний перелік публікує ISO: https://www.iso.org/iso-4217-currency-codes.html

Помилкові значення, які трапляються найчастіше

• грн, грн., гривня — це символ, а не код. грн пишеться в Символ, UAH — в ISO Код.
• uah, Uah — малі літери. Google приймає лише великі.
• ₴, $, € — знову символи.
• Код з пробілом або крапкою в кінці.

Хто читає ISO код

Код основної валюти потрапляє в усе, що споживають машини:

• Розмітка товару (Product → offers → priceCurrency і shippingDetails → shippingRate → currency у JSON-LD). Google Search Console показує неправильне значення як попередження на кожній сторінці товару; з правильним кодом розширений результат показує ціну.
• Прайс-фіди модуля «Експорт прайсів»: Rozetka, Prom.ua, Hotline, Google Merchant (там валюта — окреме налаштування фіда, за замовчуванням UAH), Privat, Nadavi та інші. Маркетплейс відхиляє фід з не-ISO валютою або імпортує його без цін.
• Події аналітики (GA4 purchase, add_to_cart тощо): поле currency події — це ISO код; GA4 відкидає дохід із невідомою валютою.
• Платіжні шлюзи (Privat24 та інші), які беруть код валюти з налаштувань магазину.

Як перевірити самому

1. Відкрийте будь-яку сторінку товару на вітрині, перегляньте вихідний код сторінки і знайдіть "priceCurrency". Має бути "priceCurrency":"UAH" (або код вашої валюти).
2. Вставте URL товару в Google Rich Results Test (https://search.google.com/test/rich-results) — елемент Product не повинен мати попередження про валюту.
3. У Google Search Console → Покращення → Товари після виправлення натисніть Помилку виправлено. Google перескановує зачеплені сторінки протягом кількох днів і закриває попередження.

Дані, а не система

Система бере код як є із запису валюти — не виправляє і не перевіряє його. Якщо з'явилось попередження, виправлення завжди в Магазин → Валюта, а не в темі чи модулі.

Див. також: Події Google Analytics 4.