پرش به مطلب اصلی
نسخه: 1.0.2

راه‌اندازی اولیه

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

پیش‌نیازهای اتصال​

قبل از شروع این مرحله، اطمینان حاصل کنید که:

  1. افزونه را طبق راهنمای قبلی، نصب و لایسنس آن را فعال کرده باشید.
  2. نرم‌افزار حسابداری ته‌حساب شما باید نسخه 10.1404.08.21 یا بالاتر باشد.
  3. شما باید ماژول «وب‌سرویس (API)» را در نرم‌افزار ته‌حساب خود خریداری و فعال کرده باشید.
  4. در نرم‌افزار ته‌حساب، از منوی "پرونده" > "API"، وضعیت سرویس را روی «فعال» تنظیم کرده باشید.
  5. اطلاعات اتصال API (کلید، هاست و پورت) را در اختیار داشته باشید.

مراحل اتصال به API​

  1. در پیشخوان وردپرس، به منوی «ته‌حساب» > «تنظیمات» بروید.
  2. صفحه به صورت پیش‌فرض روی تب «تنظیمات وب‌سرویس» (API Settings) باز می‌شود.
  3. فیلدهای این بخش را بر اساس اطلاعات دریافتی از نرم‌افزار ته‌حساب خود تکمیل کنید:
    • کلید وب‌سرویس (API Key):
      • مقدار «Bearer Token» را وارد کنید.
      • راهنما: برای یافتن این کلید، در برنامه ته‌حساب، به منوی "پرونده" > "API" بروید و "Bearer Token" را کپی کنید.
    • نام میزبان (Hostname):
      • آدرس IP یا دامنه سروری که نرم‌افزار ته‌حساب روی آن نصب است را وارد کنید (مثلاً 192.168.1.100).
    • پورت (Port):
      • پورت دسترسی به API را وارد کنید (پیش‌فرض 8081).
      • راهنما: برای یافتن پورت، در برنامه ته‌حساب، به منوی "پرونده" > "API" بروید و شماره پورت را مشاهده کنید.
    • محیط (Environment):
      • نام محیط حسابداری خود را وارد کنید (پیش‌فرض TahesabDB).
  4. ابتدا روی دکمه «ذخیره تنظیمات» کلیک کنید. این کار برای ذخیره شدن اطلاعات شما در دیتابیس وردپرس ضروری است.
  5. پس از ذخیره شدن تنظیمات، روی دکمه «تست اتصال وب‌سرویس» کلیک کنید.
  6. کمی صبر کنید. اگر اطلاعات ذخیره‌شده صحیح باشد، پیام سبز رنگ «اتصال موفقیت‌آمیز! وب‌سرویس به‌درستی پاسخ داد.» نمایش داده خواهد شد.
  7. در صورت مشاهده هرگونه خطای قرمز رنگ، اطلاعات ورودی، نسخه ته‌حساب، فعال بودن ماژول API و تنظیمات شبکه را مجدداً بررسی کنید، دوباره «ذخیره تنظیمات» را بزنید و سپس «تست اتصال» را امتحان کنید.
تبریک!

اتصال شما برقرار است. اکنون می‌توانید به بخش «پیکربندی افزونه» بروید تا سایر تنظیمات مانند قیمت‌گذاری، ارسال سفارشات و نگاشت مشتریان را انجام دهید.