رفع خطای Invalid ISO 4217 currency code در ووکامرس

یکی از خطاهای رایج که در سیستم‌هایی مانند ووکامرس مشاهده می‌شود، خطای Invalid ISO 4217 Currency Code است. در فروشگاه‌های اینترنتی مبتنی بر وردپرس و ووکامرس، داده‌های ساختاری نقش کلیدی در دیده‌شدن محصولات در گوگل، افزایش نرخ کلیک و پذیرش در سیستم‌های تبلیغاتی مانند Google Merchant Center دارند. با این حال، خطاهایی نظیر Invalid ISO 4217 Currency Code می‌توانند به‌سادگی تمام زحمات تیم توسعه و تولید محتوا را از بین ببرند.

در نگاه اول، این خطا ممکن است صرفا یک هشدار ساده در سرچ کنسول یا مارک‌آپ JSON-LD به‌نظر برسد، اما در عمل، تاثیری مستقیم بر عملکرد سئوی فنی، قابلیت نمایش محصولات در rich snippets، پذیرش فیدهای تبلیغاتی و حتی اعتبار برند دارد.

در این مقاله تخصصی، با نگاهی فنی، دقیق و کاربردی به بررسی این خطا، دلایل وقوع آن، روش‌های اصلاح و استراتژی‌های پیشگیرانه پرداخته‌ایم تا فروشگاه شما از اساس، عاری از این خطا باشد و زیرساخت فنی‌ای قابل‌اعتماد داشته باشد.

در فروشگاه‌های اینترنتی، داده‌های ساختاری نقش حیاتی‌ای در نحوه‌ دیده‌شدن محصولات توسط موتورهای جست‌وجو دارند. یکی از خطاهای رایج که در سیستم‌هایی مانند ووکامرس مشاهده می‌شود، خطای Invalid ISO 4217 Currency Code است. این خطا به‌طور خاص در شرایطی ظاهر می‌شود که کد ارز معرفی‌شده در داده‌های ساختاری یا فید محصول، با استاندارد بین‌المللی ISO 4217 هم‌خوانی نداشته باشد.

داده‌های ساختاری محصولات (مانند قیمت، موجودی، نام برند و…) معمولا با فرمت JSON-LD در هدر HTML صفحه درج می‌شوند. گوگل برای درک این اطلاعات، به فیلدهایی مانند price Currency متکی است. اگر مقدار این فیلد برابر با کدی غیر از کدهای رسمی ISO باشد (برای مثال “IRT” به‌جای “IRR”)، داده مربوطه نادیده گرفته شده و در Search Console با پیام خطا مواجه می‌شوید.

"priceCurrency": "toman" // نادرست
"priceCurrency": "IRT" // نادرست
"priceCurrency": "IRR" // صحیح

در بخش تنظیمات عمومی ووکامرس، گزینه‌ای برای تعیین ارز پیش‌فرض فروشگاه وجود دارد. مقدار انتخاب‌شده در این قسمت در لایه‌های مختلف سایت (مانند نمایش در صفحه محصول و داده‌های ساختاری) تاثیرگذار است. اگر این مقدار با یک نام محلی، نماد یا شناسه‌ غیراستاندارد جایگزین شود، افزونه‌های سئو نیز این مقدار را به‌صورت نادرست در مارک‌آپ schema درج خواهند کرد.

درصورتی که در تنظیمات واحد پولی ووکامرس را روی تومان قرار دهید به جای واحد استاندادر IRR از IRT استفاده می‌شود که باعث بروزخطای Invalid ISO 4217 Currency Code خواهد شد.

افزونه‌هایی مانند Rank Math، Yoast SEO یا Google Listings & Ads، معمولا با خواندن مقدار ارز از تنظیمات ووکامرس، اقدام به تولید مارک‌آپ JSON-LD می‌کنند. در صورتی‌که توسعه‌دهنده قالب یا افزونه، داده‌های مربوط به ارز را با ساختار نادرست در متادیتای محصولات وارد کرده باشد یا در فیلترهای وردپرس مقدار دلخواهی را جایگزین کرده باشد، این خطا تشدید می‌شود.

گوگل ابزارهایی مانند Rich Results Test و Schema Validator را در اختیار توسعه‌دهندگان قرار داده است تا بتوانند قبل از ایندکس صفحات، خروجی دقیق داده‌های ساختاری را ببینند. استفاده‌ی منظم از این ابزارها، به‌ویژه در صفحاتی که محصول جدید منتشر می‌شود یا تنظیمات تغییر کرده، به شناسایی زودهنگام خطا کمک می‌کند.

این خطا نه‌تنها بر سئوی فنی سایت تأثیر منفی می‌گذارد، بلکه مانع نمایش کامل اطلاعات محصول در نتایج جست‌وجو می‌شود. شناسایی ریشه‌های آن در ساختار مارک‌آپ، تنظیمات ووکامرس و تعامل بین افزونه‌های سئو، نخستین گام در فرآیند اصلاح و بهینه‌سازی فنی فروشگاه است.

خطای Invalid ISO 4217 Currency Code در Merchant listings سرچ کنسول نیز قابل مشاهده است.

در ساختار فنی یک فروشگاه اینترنتی، خطاهای ساختاری کوچک می‌توانند تبعاتی بزرگ در نمایه‌سازی، نمایش محصول در نتایج جست‌وجو و پذیرش تبلیغات ایجاد کنند. خطای Invalid ISO 4217 Currency Code دقیقا یکی از همین موارد است که در عین سادگی، قادر است تعامل کاربران با محصول و کارایی کل سیستم مارکتینگ را به‌طور چشم‌گیری تحت‌تاثیر قرار دهد.

داده‌های ساختاری یا structured data امکان نمایش Rich Results را برای محصولات فراهم می‌کنند؛ مانند نمایش قیمت، موجودی و امتیاز در صفحه نتایج گوگل. اگر مقدار فیلد price Currency در JSON-LD نامعتبر باشد، موتور جست‌وجو قادر به تفسیر دقیق قیمت نخواهد بود و نمایش محصول در قالب rich snippet منتفی می‌شود.

خروجی ناقص:

"offers":{
	"@type": "Offer",
	"price": "89000",
	"priceCurrency": "IRT" // نامعتبر
}

نتیجه: کاهش نرخ کلیک (CTR) به دلیل نبود نمایش قیمت در نتایج سرچ

Google Merchant Center برای تایید فید محصولات به دنبال کدهای استاندارد ISO 4217 در ستون ارز می‌گردد. هرگونه داده غیر معتبر مانند “rial”, “IRT” یا معادل‌های فارسی، منجر به ریجکت شدن محصول خواهد شد. پیام‌های رایج خطا در این شرایط عبارت‌اند از:

• “Unsupported or invalid currency code”
• “Missing value price currency”

در نتیجه، کمپین Google Ads یا Shopping متوقف شده و فروشگاه از دسترسی به بازار تبلیغاتی گوگل محروم می‌شود.

وقتی کاربر وارد صفحه‌ای می‌شود که قیمت واضح ندارد یا ارز آن برایش نامفهوم است، احساس بی‌اعتمادی و گم‌گشتگی ایجاد می‌شود. در نتیجه:

• احتمال تکمیل خرید کاهش می‌یابد
• نرخ بازگشت (bounce rate) بالا می‌رود
• وفاداری کاربران آسیب می‌بیند

گوگل صفحات دارای داده‌های ساختاری ناقص را به‌مرور از اولویت بررسی خارج می‌کند. این یعنی:

• کاهش سرعت ایندکس
• کاهش امتیاز کیفیت صفحه
• کاهش سهم نمایش در صفحه اول نتایج

افزونه‌هایی مانند Rank Math، Yoast SEO یا ابزارهای crawl خودکار مانند Ahrefs و Screaming Frog، معمولا هنگام بررسی داده‌های محصول هشدارهایی دربارهٔ ارز نامعتبر ثبت می‌کنند. این هشدارها از ادامهٔ بهینه‌سازی ساختار جلوگیری کرده و حتی موجب بروز ارورهای دیگر در زنجیره داده‌ها می‌شود.

پس از شناسایی اهمیت خطای Invalid ISO 4217 Currency Code، وقت آن رسیده که به سراغ روش‌های عملی و تخصصی برای بررسی و رفع این خطا در وردپرس و ووکامرس برویم. این اقدامات برای توسعه‌دهندگان، سئوکاران فنی و مدیران سایت طراحی شده تا با دقت بالا، ساختار ارز را بررسی کرده و خروجی‌ای بی‌نقص به موتورهای جست‌وجو ارائه دهند.

ابتدا با استفاده از ابزارهای Rich Results Test و Schema Markup Validator صفحه محصول مورد نظر را آنالیز کنید. اگر مقدار price Currency به‌جای کد رسمی (مثل IRR) از عبارت‌هایی مانند "تومان" یا "rial" یا "IRT" استفاده کرده باشد، خطا دقیقا مشخص می‌شود.

در قالب‌های سفارشی یا فارسی‌سازی‌شده، ممکن است بخشی از داده‌های ساختاری یا اسنیپت JSON به‌صورت دستی در فایل‌هایی مانند functions.php، single-product.php یا حتی افزونه‌های سفارشی تولید شده باشند. در این موارد، باید با جست‌وجوی عبارت‌هایی مانند “priceCurrency” یا “schema” در کد، محل درج کد ارز را یافته و بررسی کرد که از کدام تابع استفاده شده است.

اگر در وب‌سایت خود از RankMath استفاده میکنید، کافیست قطعه کد زیر را به فایل functions.php قالب خود اضافه کنید:

add_filter( "rank_math/snippet/rich_snippet_product_entity", function( $entity ) {
	$entity['offers']['priceCurrency'] = "IRR";
	$entity['offers']['priceSpecification']['priceCurrency'] = "IRR";
}

پس از انجام مراحل بالا میتوانید مجددا صفحه محصول خود را از طریق یکی از سایت‌های ذکر شده بررسی نمایید. در صورتی که خطا رفع شده باشد می‌توانید وارد سرچ کنسول شده روی Merchant listings کلیک کنید، در صفحه باز شده روی Invalid ISO 4217 currency code (in “offers”) کلیک کنید تا وارد شوید سپس از طریق دکمه VALIDATE FIX حل شدن این خطا را به گوگل اعلام نمایید.

پیشگیری موثر، همیشه ارزان‌تر و کم‌هزینه‌تر از اصلاح مشکلات پس از وقوع آن‌هاست. در حوزه داده‌های ساختاری و پیاده‌سازی کدهای ارزی، این اصل حیاتی‌تر نیز می‌شود. اگر تیم توسعه و مدیریت فروشگاه سیاست‌ها و ساختار دقیقی برای ارزها تعیین کند، خطای Invalid ISO 4217 Currency Code دیگر باز نخواهد گشت.

قرار دادن تست با ابزار Rich Results Test یا Schema Validator در چک‌لیست ماهانه یا هفتگی توسعه، باعث می‌شود خطاهایی که به‌مرور در قالب یا افزونه‌ها ایجاد می‌شوند، زودتر کشف شوند. به‌خصوص پس از هر به‌روزرسانی افزونه یا پوسته، این تست باید به‌صورت روتین اجرا شود.

به‌جای ذخیره دستی لیست کدهای ارز در فایل‌های پروژه، می‌توان از منابع زنده مانند APIهای نرخ ارز استفاده کرد (برای مثال OANDA یا XE.com) و فقط کدهایی را در فیلد price Currency درج کرد که در این منابع وجود دارند. این کار احتمال درج ارزهای منسوخ یا نادرست را از بین می‌برد.

برای جلوگیری از بروز خطای Invalid ISO 4217 Currency Code، دسترسی به منابع رسمی و ابزارهای اعتبارسنجی حرفه‌ای ضروری است. این منابع به توسعه‌دهندگان، کارشناسان سئو و مدیران فروشگاه کمک می‌کنند تا از صحت کدهای ارزی استفاده‌شده در ساختارهای داده‌ای اطمینان حاصل کنند و داده‌هایی منطبق با استانداردهای جهانی ارائه دهند.

سازمان ISO مرجع اصلی تعریف کدهای استاندارد ارز در قالب ISO 4217 است. این فهرست شامل کد سه‌حرفی (مانند USD، IRR)، شماره معادل عددی، کشور منتشرکننده ارز، و وضعیت ارز (فعال یا منسوخ) می‌باشد.

لینک رسمی: https://www.iso.org/iso-4217-currency-codes.html

این وب‌سایت‌ها منابع غیر رسمی اما بسیار معتبر برای بررسی نرخ ارز، کد سه‌حرفی، کشور مرجع و وضعیت جهانی ارز هستند. همچنین برخی از این پلتفرم‌ها API هایی برای توسعه‌دهندگان ارائه می‌دهند که امکان استفاده از لیست زنده و به‌روز کدهای ISO را فراهم می‌کند.

کاربردها:

• اعتبارسنجی خودکار ارز در هنگام ذخیره داده
• تهیه لیست ارزهای فعال
• بررسی نرخ تبادل زنده برای افزونه‌های چندارزی

در مستندات WooCommerce، تمام توابع مرتبط با تعیین وخواندن ارز مانند get woocommerce currency woocommerce_currency filter و ساختارهای JSON شرح داده شده‌اند. استفاده از این مستندات، تضمین می‌کند که کد ارز مستقیما از تنظیمات ووکامرس خوانده شده و با استانداردها هم‌خوانی دارد.

مستندات ووکامرس

پروژه Schema.org مرجع اصلی در تعریف ساختار داده‌های قابل‌فهم برای موتورهای جست‌وجو است. در بخش Product و Offer توضیح داده شده که مقدار price Currency باید مطابق ISO 4217 باشد. مطالعه دقیق این مستندات به توسعه‌دهندگان کمک می‌کند مارک‌آپ‌های سازگار با گوگل تولید کنند.

مستندات Product Schema

• Rich Results Test: برای بررسی داده‌های ساختاری صفحه‌ای خاص
• Schema Markup Validator: برای تست اعتبار مارک‌آپ schema.org
• Google Search Console: برای مانیتورینگ کلی خطاهای سایت در مقیاس بزرگ

اجرای تست در این ابزارها بخش مهمی از فرآیند نگهداری فنی فروشگاه‌های حرفه‌ای به‌شمار می‌رود.