خطاهای رایج
در این بخش، به بررسی مشکلات و خطاهای رایج هنگام کار با افزونه تهحساب و راهحلهای آنها میپردازیم.
راهنمای گام به گام عیبیابی
اگر افزونه مطابق انتظار شما کار نمیکند (مثلاً سفارشات ارسال نمیشوند)، مراحل زیر را به ترتیب دنبال کنید:
-
بررسی پیشنیازها:
- آیا نسخه PHP شما ۸.۱ یا بالاتر است؟
- آیا نسخه نرمافزار تهحساب شما
10.1404.08.21یا بالاتر است؟ - آیا ماژول API در نرمافزار تهحساب شما خریداری و فعال شده است؟
- آیا در نرمافزار تهحساب، از منوی "پرونده" > "API"، وضعیت سرویس «فعال» است؟
-
تست اتصال API:
- به «تهحساب» > «تنظیمات» > تب «تنظیمات وبسرویس» بروید.
- اطلاعات اتصال را بررسی و روی «ذخیره تنظیمات» کلیک کنید.
- دکمه «تست اتصال وبسرویس» را بزنید.
- اگر اتصال ناموفق بود، متن خطا را بررسی کنید (به بخش خطاهای اتصال در ادامه مراجعه کنید).
-
بررسی صف ارسال:
- به «تهحساب» > «صف ارسال» بروید.
- ببینید آیا سفارشات شما در صف با وضعیت
Failed(ناموفق) وجود دارند یا خیر. - ستون «آخرین خطا» را مطالعه کنید. این ستون معمولاً دقیقترین دلیل عدم ارسال را به شما میگوید.
-
فعالسازی و بررسی گزارشات وبسرویس:
- اگر خطای صف ارسال واضح نیست، به «تهحساب» > «تنظیمات» > تب «گزارشگیری» بروید و «فعالسازی گزارشگیری» را روشن و ذخیره کنید.
- به صف ارسال برگردید و روی دکمه «تلاش مجدد» برای سفارش ناموفق کلیک کنید.
- اکنون به «تهحساب» > «گزارشات وبسرویس» بروید.
- آخرین گزارش ثبتشده را پیدا کنید و روی «مشاهده جزئیات» کلیک کنید.
- محتوای
Response Body(پاسخ دریافتی) را به دقت بررسی کنید. این بخش حاوی پاسخ خام از سرور تهحساب است.
خطاهای رایج در «صف ارسال»
-
Customer billing phone number is missing. Cannot create customer.- علت: کاربر (مشتری) شماره تلفن خود را در بخش صورتحساب وارد نکرده است. تهحساب برای ایجاد مشتری به شماره تلفن نیاز دارد.
- راهحل: اطلاعات صورتحساب مشتری را در ووکامرس ویرایش کرده و شماره تلفن را اضافه کنید. سپس «تلاش مجدد» را بزنید.
-
Orders from guest users cannot be submitted.- علت: سفارش توسط کاربر مهمان (ثبتنام نشده) ثبت شده است. افزونه نمیتواند برای کاربران مهمان مشتری در تهحساب ایجاد کند.
- راهحل: کاربر را در وردپرس ایجاد کرده و سفارش را به آن کاربر اختصاص دهید.
-
API credentials are not configured...- علت: اطلاعات اتصال وبسرویس در تنظیمات افزونه به درستی ذخیره نشدهاند.
- راهحل: به تب «تنظیمات وبسرویس» بروید، اطلاعات را مجدداً وارد و «ذخیره تنظیمات» کنید.
-
The API response could not be decoded.- علت: پاسخی که از سرور تهحساب دریافت شده، یک JSON معتبر نیست. این معمولاً به دلیل خطای سرور تهحساب یا مشکلات شبکه رخ میدهد.
- راهحل: لاگ وبسرویس را بررسی کنید (
Response Body) تا پاسخ خام دریافتی را ببینید.
-
Invalid currency for submission.- علت: ارز سفارش یکی از ارزهای مجاز (IRR, IRT, IRHR, IRHT) نیست.
- راهحل: تنظیمات ارز ووکامرس خود را بررسی کنید.
خطاهای رایج در «تست اتصال»
-
Connection failed. Details: cURL error ...(مانند: Connection timed out یا Connection refused)- علت: سرور سایت شما (هاست وردپرس) نمیتواند به آدرس (هاستنیم و پورت) سرور تهحساب شما دسترسی پیدا کند.
- راهحل:
- بررسی کنید آیا IP یا دامنه و پورت را درست وارد کردهاید.
- مطمئن شوید فایروال سرور تهحساب، به IP سرور سایت شما اجازه دسترسی میدهد.
- با پشتیبانی هاست خود تماس بگیرید و بپرسید آیا دسترسی خروجی به آن IP و پورت باز است یا خیر.
-
Connection failed. Details: ... 401 Unauthorized(یا خطای مربوط به توکن)- علت: «کلید وبسرویس» (Bearer Token) شما نادرست است یا منقضی شده.
- راهحل: کلید وبسرویس را مجدداً از نرمافزار تهحساب کپی و در تنظیمات جایگزین کنید و ذخیره نمایید.
مشکلات مربوط به همگامسازی محصولات
- مشکل: همگامسازی محصول انجام نمیشود و وضعیت روی
Pausedمانده است.- علت: این یک خطا نیست. افزونه به انتهای لیست محصولات در تهحساب رسیده و چون محصول جدیدی پیدا نکرده، به مدت ۱۲ ساعت متوقف شده است تا از درخواستهای اضافی جلوگیری کند.
- راهحل: اگر محصولات جدیدی در تهحساب اضافه کردهاید و میخواهید بلافاصله همگامسازی شوند، به تنظیمات ← همگامسازی محصولات بروید و روی دکمه «بازنشانی همگامسازی» کلیک کنید.